Overview

The HTTP connector enables OpenJMS clients to connect to the OpenJMS server using HTTP.

This is typically used when firewall restrictions prevent the use of the RMI, TCP, and TCPS connectors.

Using the HTTP connector

Clients connect to the OpenJMS server via a webserver. To connect to OpenJMS via a webserver running on the local host, using the default HTTP configuration, construct an InitialContext as follows:

    Hashtable properties = new Hashtable();
    properties.put(Context.INITIAL_CONTEXT_FACTORY, 
                   "org.exolab.jms.jndi.InitialContextFactory");
    properties.put(Context.PROVIDER_URL, "http://localhost:8080/");
    Context context = new InitialContext(properties);
        

The JNDI Context.PROVIDER_URL property above, has the format:

"http://<webserver-host>:<webserver-port>/"
        

Where:

  • webserver-host specifies the host of the webserver running the OpenJMS servlet.
  • webserver-port specifies the port that the OpenJMS servlet is listening on.

Administration using the HTTP connector

To administer an OpenJMS server via the webserver running on the local host, using the default HTTP configuration, construct a JmsAdminServerIfc as follows:

    String url = "http://localhost:8080/";
    JmsAdminServerIfc admin = AdminConnectionFactory.create(url);
        

The URL argument has the same format as the Context.PROVIDER_URL described in Using the HTTP connector