Java Doc for PersonQuery.java in  » J2EE » enhydra » jspPhoneBook » data » Java Source Code / Java DocumentationJava Source Code and Java Documentation

General usage:

In DODS: Create a Data Object named "Dog", and create an Attribute named "Name", and set that Attribute to "Can be queried." DODS will then generate the method DogQuery.setQueryName().

In your Business Layer, prepare the query:

 DogQuery	dq = new DogQuery();
 dq.setQueryName("Rex")
 if (	Rex	is a reserved name )
 dq.requireUniqueInstance();
 

#1:

 String names	= "";
 DogDO[] dogs	= dq.getDOArray();
 for ( int i = 0;	i < dogs.length;	i++	) {
 names +=	dogs[i].getName() +	" ";
 }
 

 String names	= "";
 DogDO dog;
 while ( null	!= ( dog = dq.getNextDO() )	) {
 names +=	dog.getName() +	" ";
 }
 

Note: If requireUniqueInstance() was called, then getDOArray() or getNextDO() will throw an exception if more than one "Rex" was found.

Note: Results of the query will come from the Data Object cache if: - The cache is available. - Matches were found in the cache. - No other tables (Data Objects of other types) were involved in the query. This can happen if you extend the DogQuery class and you make calls to the QueryBuilder object to add SQL involving other tables. If any of these conditions is not true, then any results from the query will come from the database.

To reuse the query object, call:

 dq.reset();