Getting Startedwith pureQuery

Chapter 11 – Annotated-Method Programming Style 221
and create the Iterator object of the employees. This is shown in
Listing 11.10.
// Search the database for all of the employees in the company
// and create an Iterator object to retrieve them.
employees = data.selectAllEmployees ();
Listing 11.10 - Modify the displayAllEmployees method to use the annotated
method
11.4.2.3 Close the Iterator object to free the associated database
resources
The user of Human Resources Manager might not view all of the employees. Therefore,
we need to close employees explicitly to free the database resources. Add code to close
employees.
finally {
// Close employees. This frees the associated database resources.
if (null != employees)
((ResultIterator) employees).close ();
}
Listing 11.11 - Add code to the displayAllEmployees method that closes the
Iterator when the application no longer needs it
11.4.2.3.1 Test the "Company Employees" screen
Save and test your application. As before, supply 000030 when the Human Resources
Manager asks for your employee number. On the main menu, select option 4 to display all
the employees in the company. You will then be able to see the employees, one page at a
time.
11.5 Executing SQL statements that have parameters
It is very easy to use parameters in SQL statements when you use the pureQuery
annotated method style. The four types of parameter markers that are available in the
inline style are also available in the annotated method style. With each of these types,
pureQuery automatically populates the SQL parameters with the information that you
provide. When you use multiple parameter markers in an SQL statement, all of the
parameter markers must be of the same type.
In the pureQuery method style, you specify the objects that pureQuery should use to
populate the parameters of your SQL statement as the parameters of the annotated
methods when you declare the methods.
Table 11.1 shows the four types of parameter markers. References to Map indicate the
class java.util.Map. Listing 11.12 shows the definitions of the objects that the “Sample
usage” column references.