HTTPConnectionFactory Configuration

JBossMQ connector using an http connection between the client and server.

The configuration can be found in jms/jbossmq-httpil.sar/META-INF/jboss-service.xml

Implementation Note

This connector uses polling to retrieve messages, by default it spends all its time waiting on the server.

This reduces latency but does block connections in the web server.

Stateless Connection

The connection is stateless. There is no way for this service to detect the client has crashed, use

the ClientMonitorInterceptor and set the ping period to do this.

Default Configuration

    <mbean code="org.jboss.mq.il.http.HTTPServerILService"
      name="jboss.mq:service=InvocationLayer,type=HTTP">
    <depends optional-attribute-name="Invoker">jboss.mq:service=Invoker</depends>
    <depends>jboss.web:service=WebServer</depends>
    <attribute name="ConnectionFactoryJNDIRef">HTTPConnectionFactory</attribute>
    <attribute name="XAConnectionFactoryJNDIRef">HTTPXAConnectionFactory</attribute>
    <attribute name="PingPeriod">0</attribute>
    <attribute name="TimeOut">60</attribute>
    <attribute name="RestInterval">0</attribute>
  </mbean>

Configurable Attributes

• Invoker

  - the ObjectName of the interceptor chain that leads to the JMSDestinationManager

• ConnectionFactoryJNDIRef

  - the jndi binding - default HTTPConnectionFactory

• XAConnectionFactoryJNDIRef

  - the jndi binding of the XA connection factory - default HTTPXAConnectionFactory

• PingPeriod

  - the period after which a ping is sent to the server, if the server does not pong within a further PingPeriod a connection failure is reported to any ExceptionListener

• ClientID

  - the fixed ClientID for this connection factory

• TimeOut

  - how long to wait (in seconds) on the server for a message to arrive

• RestInternal

  - how long to wait (in seconds) on the client before re-polling the server

• URL

  - override the URL clients use to connect to the web server

• URLPrefix

  - override the start of the url the clients use to connect to the web server, e.g.

  http://

  or

  https://

   

• URLSuffix

  - override the start of the url the clients use to connect to the web server, default jbossmq-il/HTTPServerILServlet

• URLHostName

  - override the host name clients use to connect to the web server

• URLPort

  - override the port clients use to connect to the web server

• UseHostName

  - whether clients should connect using host names or ip addresses