Using the AQ XML Servlet to Access AQ

You can use the AQ XML servlet to access Oracle9i AQ using open protocols like HTTP and SMTP and using an XML message format called Internet Data Access Presentation (IDAP).

Using the AQ servlet, a client can perform the following actions:

• Send messages to single-consumer queues

• Publish messages to multi-consumer queues/topics

• Receive messages from queues

• Register to receive message notifications

The servlet can be created by defining a Java class that extends the oracle.AQ.xml.AQxmlServlet or oracle.AQ.xml.AQxmlServlet20 class. These classes in turn extend the javax.servlet.http.HttpServlet class.

The servlet can be deployed on any Web server or ServletRunner that implements Javasoft's Servlet 2.0 or Servlet 2.2 interfaces.

• To deploy the AQ Servlet with a Web server that implements Javasoft's Servlet2.0 interfaces, you must define a class that extends the oracle.AQ.xml.AQxmlServle20 class.

• To deploy the AQ Servlet with a Web server that implements Javasoft's Servlet2.2 interfaces, you must define a class that extends the oracle.AQ.xml.AQxmlServlet class.

The servlet can be compiled using JDK 1.1.x or JDK 1.2.x libraries.

• For JDK 1.1.x the CLASSPATH must contain:

  $ORACLE_HOME/jdbc/lib/classes111.jar 
  $ORACLE_HOME/jlib/jta.jar
  $ORACLE_HOME/jdbc/lib/nls_charset11.jar
  $ORACLE_HOME/jlib/jndi.jar
  $ORACLE_HOME/lib/lclasses11.zip
  $ORACLE_HOME/lib/xmlparserv2.jar
  $ORACLE_HOME/lib/xschema.jar
  $ORACLE HOME/rdbms/jlib/aqapi11.jar
  $ORACLE_HOME/rdbms/jlib/jmscommon.jar
  $ORACLE_HOME/rdbms/jlib/aqxml.jar
  $ORACLE_HOME/rdbms/jlib/xsu111.jar
  $ORACLE_HOME/lib/servlet.jar
  

• For JDK 1.2.x the CLASSPATH must contain:

  $ORACLE_HOME/jdbc/lib/classes12.jar
  $ORACLE_HOME/jlib/jta.jar
  $ORACLE_HOME/jdbc/lib/nls_charset12.jar
  $ORACLE_HOME/jlib/jndi.jar
  $ORACLE_HOME/lib/lclasses12.zip
  $ORACLE_HOME/lib/xmlparserv2.jar
  $ORACLE_HOME/lib/xschema.jar
  $ORACLE_HOME/rdbms/jlib/aqapi.jar
  $ORACLE_HOME/rdbms/jlib/jmscommon.jar
  $ORACLE_HOME/rdbms/jlib/aqxml.jar
  $ORACLE_HOME/rdbms/jlib/xsu12.jar
  $ORACLE_HOME/lib/servlet.jar
  
  

Since the servlet uses JDBC OCI drivers to connect to the Oracle9i database server, the 9i Oracle Client libraries must be installed on the machine that hosts the servlet. The LD_LIBRARY_PATH must contain $ORACLE_HOME/lib.

See Chapter 17, "Internet Access to Advanced Queuing" for more information on Internet access to Advanced Queuing.