User: danch
Date: 01/06/15 17:49:32
Modified: src/docs customizingjaws.xml
Log:
added doc for read-ahead option
Revision Changes Path
1.8 +42 -0 manual/src/docs/customizingjaws.xml
Index: customizingjaws.xml
===================================================================
RCS file: /cvsroot/jboss/manual/src/docs/customizingjaws.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- customizingjaws.xml 2001/06/02 08:09:08 1.7
+++ customizingjaws.xml 2001/06/16 00:49:32 1.8
@@ -442,6 +442,48 @@
<para>We strongly suggest you use SQL92 as default query
language. T-SQL is provided for ease-of-use if you have existing T-SQL queries.</para>
</section>
+ <section>
+ <title>Advanced options for declared finders</title>
+ <para>Author:
+ <author>
+ <firstname>Dan</firstname>
+ <surname>Christopherson</surname>
+ </author>
+ <email>[EMAIL PROTECTED]</email> or <email>[EMAIL PROTECTED]</email>
+ </para>
+ <para>As of JBoss version 2.3 beta (6/15/2001), it is possible to request
+ that JAWS preload data for all entities selected by a declared finder. This
+ avoids a performance problem where the database will be queried separately
+ to load data for each bean returned by the finder. To activate this
+ optimization, simply add <read-ahead>true</read-ahead> to
+ your finder declaration. Note that as of the same version, you can override
+ this option for the autogenerated findAll method as well.</para>
+
+ <para>This is an example jaws.xml showing use of this
option</para>
+ <programlisting><![CDATA[
+ <jaws>
+ <enterprise-beans>
+ <entity>
+ <ejb-name>ClassBean</ejb-name>
+ <finder>
+ <name>findBigClasses</name>
+ <query>studentCount > {0} AND teacherName = {1}</query>
+ <order>studentCount DESC</order>
+ <read-ahead>true</read-ahead>
+ </finder>
+ <finder>
+ <name>findAll</name>
+ <query />
+ <order />
+ <read-ahead>true</read-ahead>
+ </finder>
+ </entity>
+ </enterprise-beans>
+ ...
+ </jaws>
+
+]]></programlisting>
+ </section>
<section>
<title>Custom finders coded in your beans</title>
<para>Author:
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
http://lists.sourceforge.net/lists/listinfo/jboss-development
