Getting Startedwith pureQuery

Chapter 11 – Annotated-Method Programming Style 227
11.19 so that it uses the new annotated method to search the database for a employee’s
manager.
// Determine if the logged-in user manages the employee by going
// up the management chain until we either find the logged-in
// user, or until we reach the highest manager in the company.
EmployeeBean manager;
while (null != (manager = data.selectEmployeeManager (employee))) {
Listing 11.19 - Modify the isEmployeeManagedByLoggedInUser method to use the
annotated method
11.5.2.3 Test the "Company Employees" screen
Save and test your application. Supply 000030 when the Human Resources Manager
asks for your employee number. On the main menu, select option 1 to display information
about Sally Kwan.
11.5.3 Special case scenarios for parameter types
Some scenarios call for specific parameter types. When you declare an annotated
method, see if your application falls under one of these special cases.
11.5.3.1 Methods with the @Update annotation
• Executing an SQL statement multiple times with different parameters
each time: If you want pureQuery to execute the SQL statement multiple
times, using different parameters each time, specify a
java.util.List, java.util.Iterator, or array in which
entry provides objects for setting the parameters. pureQuery executes
the SQL statement once for each entry. If you use an array for this
purpose, you must not use an array of type Object[].
• Creating generated keys: If your method is executing an INSERT
statement, pureQuery can update the values of keys generated by the
statement. To use this feature, provide the parameters for the SQL
statement using one pureQuery bean, and provide the
com.ibm.pdq.annotation.GeneratedKey annotation on the
properties you want pureQuery to update.
11.5.3.2 Methods with the @Call annotation
• Updating the values of OUT and INOUT parameters: If the method
does not specify a CallHandlerWithParameters, and if the
method executes a stored procedure that has OUT or INOUT parameters,
pureQuery updates the corresponding properties in maps or pureQuery
beans provided as method parameters after the execution of the stored