The JBoss Remoting gateway is, by default, a synchronous gateway based on the JBoss Remoting project (http://www.jboss.org/jbossremoting). The gateway processes messages which are delivered over a number of the JBoss Remoting protocols, specifically HTTP, HTTPS, socket, and socketssl. This transport exposes its configuration using the <jbr-provider>
, <jbr-bus>
, and <jbr-listener>
elements.
The
<jbr-provider>
element supports the configuration of two attributes, the host
attribute specifying the name of the local network interface through which the messages will arrive and the protocol
attribute which declares the remoting protocol for the endpoint.
The
<jbr-bus>
element supports the configuration of the port
attribute, declaring the port number associated with the endpoint.
In addition to the standard configuration options it is possible to include other properties on any of the previous jbr
elements, by specifying nested property
elements. These properties include:
serviceInvokerTimeout
: used to specify the maximum time before which a response is expectedsynchronous
: used to define the endpoint as asynchronous when false
asyncResponse
: used to define a resource containing the contents used as the asynchronous responsecomposer-class
: used to override the default composerSometimes JBoss Remoting requires an additional configuration which is not covered by these properties, something specific to the connector. If additional properties are required then they can be added into the service configuration by declaring the property using a name prefixed by jbr-
.
A typical JBR provider configuration would look like this:
<jbr-provider name="JBRprovider" protocol="socket" host="localhost"> <property name="serviceInvokerTimeout" value="20000"/> <jbr-bus busid="chapter6JBRChannel" port="8081"/> </jbr-provider>