Getting Startedwith pureQuery

Chapter 12 – Stored Procedures 251
the code in Listing 12.7, which creates an Iterator object containing
the query result.
// Get the query result, which contains the bonuses for all the
// employees.
// Do this after getting the value of the OUT parameters from
// bonus_increase, since getting the last query result closes
// storedProcedureResult.
employees = storedProcedureResult.getIterator (EmployeeBean.class);
Listing 12.7 - Get the query result from the stored procedure call
pureQuery automatically closes the underlying database resources when the application
gets the last query result and when the application gets the last row of the
Iterator object, so in most cases our application will not need to
close employees and storedProcedureResult. However, an exception could occur
before the application retrieves the query result or processes all of the rows, so it would be
good for our application to close employees and storedProcedureResult explicitly.
Add the code in Listing 12.8 to the finally block.
finally {
// Close employees. This frees the associated database resources.
if (null != employees) ((ResultIterator) employees).close
();
// Close storedProcedureResult. This frees the associated database
// resources.
if (null != storedProcedureResult) storedProcedureResult.close ();
}
Listing 12.8 - Close employees and storedProcedureResult
Finally, test the application by logging in with the employee number 000010 and selecting
the option 5 on the main menu.
12.4 Executing SQL stored procedure calls in the annotated-method
style
Annotated methods that execute SQL stored procedure calls must have the @Call
annotation. The return type of the method can be one of the following:
• A com.ibm.pdq.runtime.StoredProcedureResult object
• void
• One of several of the return types allowed with the @Select
annotation
• An object of a specific type, constructed by a
com.ibm.pdq.runtime.handlers.CallHandlerWithParameters
object