Getting Startedwith pureQuery

What object do you want to use to contain all of the rows?
Chapter 10 – Inline Programming Style 189
• An array: queryArray methods return an array in which each entry represents a
row.
• A java.util.List object: queryList methods return a
java.util.List object in which each element represents a row.
• A java.util.Iterator object: queryIterator methods return a
java.util.Iterator object for which each call to the Iterator's next()
method returns a row. These methods do not fully materialize the information from
the database during the initial method call. Instead, pureQuery retrieves one row
each time the application calls the next method. This is particularly useful if your
application retrieves large amounts of information from the database, and you do
not want to store all of the information in memory at one time. When the application
calls next() to retrieve all of the rows from the 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()
• Only the first row, in the object used to contain the row: queryFirst methods
return only the first row. If the query result does not contain any rows, these
methods return null.
• An object of a specific type, constructed by a
com.ibm.pdq.runtime.handlers.ResultHandler object: query
methods use the parameter ResultHandler resultHandler to
construct the object that is returned. For this method, there is not a parameter for
specifying the format for each row. Instead, resultHandler determines the
format that is used for each row.
• A java.sql.ResultSet object: queryResults methods return an instance of
java.sql.ResultSet.
10.3.2 Overriding the default cursor attributes
By default, inline methods use the cursor type “forward only,” the cursor concurrency mode
“read only,” and the cursor holdability “close cursors at commit.” You can change the
values of these attributes by using an inline method that has these parameters: int
type, int concurrency, int holdability