Interfaces and classes in the sqlj.runtime package
The sqlj.runtime package defines the run-time classes and interfaces that are used directly or indirectly by the SQLJ programmer.
Classes such as AsciiStream are used directly by the SQLJ programmer. Interfaces such as ResultSetIterator are implemented as part of generated class declarations.
sqlj.runtime interfaces
The following table
summarizes the interfaces in sqlj.runtime.
| Interface name | Purpose |
|---|---|
| ConnectionContext | Manages the SQL operations that are performed during a connection to a data source. |
| ForUpdate | Implemented by iterators that are used in a positioned UPDATE or DELETE statement. |
| NamedIterator | Implemented by iterators that are declared as named iterators. |
| PositionedIterator | Implemented by iterators that are declared as positioned iterators. |
| ResultSetIterator | Implemented by all iterators to allow query results to be processed using a JDBC ResultSet. |
| Scrollable | Provides a set of methods for manipulating scrollable iterators. |
sqlj.runtime classes
The following table
summarizes the classes in sqlj.runtime.
| Class name | Purpose |
|---|---|
| AsciiStream | A class for handling an input stream whose bytes should be interpreted as ASCII. |
| BinaryStream | A class for handling an input stream whose bytes should be interpreted as binary. |
| CharacterStream | A class for handling an input stream whose bytes should be interpreted as Character. |
| DefaultRuntime | Implemented by SQLJ to satisfy the expected runtime behavior of SQLJ for most JVM environments. This class is for internal use only and is not described in this documentation. |
| ExecutionContext | Implemented when an SQLJ execution context is declared, to control the execution of SQL operations. |
| Indicator | Defines constants for indicator variable values. |
| RuntimeContext | Defines system-specific services that are provided by the runtime environment. This class is for internal use only and is not described in this documentation. |
| SQLNullException | Derived from the java.sql.SQLException class. An sqlj.runtime.SQLNullException is thrown when an SQL NULL value is fetched into a host identifier with a Java™ primitive type. |
| StreamWrapper | Wraps a java.io.InputStream instance. |
| UnicodeStream | A class for handling an input stream whose bytes should be interpreted as Unicode. |