Getting Startedwith pureQuery

238
Getting Started with pureQuery
11.9 Advanced features
The annotated-method style provides many advanced features that are outside of the
scope of this book. This list describes some of them. For details about using these
features, refer to the IBM Optim pureQuery Runtime documentation.
• Positioned updates and deletes: You can associate @Select
annotated methods with @Update methods to allow you to perform
positioned updates and deletes on the query result created by an SQL
SELECT statement.
• Exception handling: The annotated-method style and inline style APIs
throw exceptions of the type
com.ibm.pdq.runtime.exception.DataRuntimeException.
Utility methods on these exceptions provide helpful information about the
causing exception.
• Hooks: You can use implementations of the interface
com.ibm.pdq.runtime.statement.Hook to provide methods that
bracket the execution of the annotated and inline methods.
• Batching SQL statements: If you are using the IBM Data Server Driver
for JDBC and SQLJ, you can use heterogeneous batching to execute
multiple different SQL statements that do not return query results in a
single trip to the database.
• Queries over collections: You can use the SQL syntax to perform
queries over in-memory collections of data.
• Combining the contents of two interfaces into a single package in
the database: You can create interfaces that extend multiple interfaces of
annotated methods. When you bind the extending interfaces in the
database, the StaticBinder utility puts the SQL statements from the
different interfaces into the same package.
• Specifying SQL statements in XML files: You can specify an XML file
to the Generator utility to provide the SQL statements for the annotated
methods. This allows you to use a single interface for SQL statements
that you need to execute against multiple databases, even if the SQL
syntax varies between the databases. Use the option -xmlFile to
specify this XML file.
11.10 Summary
The annotated-method style is an easy-to-use API for accessing databases. Under the
annotated-method style, you define annotated methods in an interface that specify the SQL
statements that you want processed, the input parameters that you will use to specify the