Getting Startedwith pureQuery

218
Getting Started with pureQuery
Iterator, pureQuery closes it automatically, freeing the
associated database resources. However, if you have an
application that does not retrieve all the rows, you must free the
database resources by closing the Iterator explicitly. Do
so by casting the Iterator object as a
com.ibm.pdq.runtime.ResultIterator object and
calling its close() method, like this:
((com.ibm.pdq.runtime.ResultIterator)
myIterator).close()
o
o
o
Only the first row, in the object used to contain the row: Specify
the object used to contain each row as the return type, such as
MyPureQueryBean. The method returns null if the query
result does not contain any rows.
An object of a specific type, constructed by a
com.ibm.pdq.runtime.handlers.ResultHandler
object: Specify the parameterized type (represented by RES) as
the return type of the method. You will have to specify the
ResultHandler that will construct the object.
A java.sql.ResultSet object: Specify
java.sql.ResultSet as the return type of the method.
11.4.1.2 Methods with the @Update annotation
• What do you want the method to return?
o
o
o
An update count: Specify int as the return type if you want the
method to return an update count indicating how many rows
were modified.
Update counts: Specify int[] as the return type if you want the
method to execute the SQL statement multiple times with
different parameters each time. In this case, the parameter to
the method must be a java.util.List,
java.util.Iterator, or array. Each entry in the List,
Iterator, or array must provide the parameters for one
execution of the SQL statement. pureQuery executes the SQL
statement once for each entry and returns the update count from
that statement in the corresponding location in the int[].
void: Specify void as the return type if the SQL statement will
not produce any results that you want the method to return.