Getting Startedwith pureQuery

11.4.1.3 Methods with the @Call annotation
Chapter 11 – Annotated-Method Programming Style 219
• What do you want the method to return?
o
o
o
o
A com.ibm.pdq.runtime.StoredProcedureResult object:
Specify com.ibm.pdq.runtime.StoredProcedureResult
as the return type. pureQuery automatically creates and return a
StoredProcedureResult object containing the query results.
void: Specify void as the return type if the stored procedure
will not produce any results that you want the method to return.
The first query result: If you want the method to return only the
first query result, using one of the return types allowed with the
@Select annotation, specify the return type that you want to
use. You can use any of the types that are allowed for @Select,
except for those that involve either a ResultHandler or a
RowHandler and those that return only a single row of the query
result.
An object of a specific type, constructed by a
com.ibm.pdq.runtime.handlers.CallHandlerWithPara
meters object: Specify the parameterized type
(represented by CAL) as the return type of the method. You will
have to specify the CallHandlerWithParameters that
will construct the object.
11.4.2 In practice: Execute a simple SELECT statement that uses cursor
attributes -- Complete the “Company Employees” screen
The Company Employees screen displays all of the employees in the company in pages of
10 employees each. It allows the user to request additional information about any
particular employee on the screen. The displayAllEmployees (Data data) method
creates this screen. Add the pureQuery code to it to get the employee information from the
database using the annotated-method style.
11.4.2.1 Add an annotated method to HumanResourcesData that executes the SQL
First, we need to determine an SQL statement to use. We will use the query shown in
Listing 11.8, which will select all the employees and sort them by their names.
SELECT * FROM EMPLOYEE ORDER BY LASTNAME, FIRSTNME, MIDINIT
Listing 11.8 - An SQL query for selecting all the employees in the company
Next, we need to declare an annotated method in
hrm.inProgress.pdqMethodStyle.HumanResourcesData that will execute this
query.