Package oracle.AQ

The Java AQ API supports both the administrative and operational features of Oracle AQ (Advanced Queueing). In developing Java programs for messaging applications, you will use JDBC to open a connection to the database and then the oracle.AQ, the Java AQ API for message queuing. You need not use PL/SQL interfaces.

The following sections describe the common interfaces and classes based on current PL/SQL interfaces.

• The common interfaces are prefixed with "AQ". These interfaces will have different implementations in Oracle8i and Oracle Lite.
• This document describes the common interfaces and their corresponding Oracle8i implementations, which are prefixed with "AQOracle".

Location of Java AQ Classes

The Java AQ classes are located in $ORACLE_HOME/rdbms/jlib/aqapi.jar. These classes can be used with any Oracle8i JDBC driver.

If your application uses the OCI8 or thin JDBC driver, for JDK 1.2 you must include $ORACLE_HOME/rdbms/jlib/aqapi.jar in the CLASSPATH; for JDK 1.1 you must include $ORACLE_HOME/rdbms/jlib/aqapi11.jar in the CLASSPATH.

If the application is using the Oracle Server driver and accessing the java AQ API from java stored procedures, the Java files are generally automatically pre-loaded in a Java-enabled database. If they are not loaded, you must first load the aqapi.jar and jmscommon.jar files into the database using the loadjava utility.

Class Summary Interfaces

AQSession             Open a session to the queuing system
AQQueueTable          AQ Queue Table interface
AQQueueAdmin          AQ Queue administrative interfaces
AQQueue               AQ Queue operational interfaces
AQMessage             AQ message
AQRawPayload          AQ Raw Payload
AQObjectPayload       AQ Object Payload
Classes: Common
AQConstants           Constants used in AQ operations
AQAgent               AQ Agent
AQDriverManager       Driver Manager for various AQ drivers
AQEnqueueOption       AQ Enqueue Options
AQDequeueOption       AQ Dequeue options
AQMessageProperty     AQ Message properties
AQQueueProperty       AQ Queue properties
AQQueueTableProperty  AQ Queue Table properties
Classes: Oracle8i [These classes are not described in this manual]
AQOracleSession       Oracle server implementation of AQSession
AQOracleMessage       Oracle Server implementation of AQMessage
AQOracleDriver        Oracle server implementation of AQDriver
AQOracleQueue         Oracle server implementation of AQQueue
AQOracleQueueTable    Oracle server implementation of AQQueueTable
AQOracleRawPayload    Oracle server implementation of AQRawPayload
AQOracleObjectPayload  Oracle server implementation of AQObjectPayload
Exceptions
AQException
AQOracleSQLException