Handler Chains
The rwagent.xml file also configures the handler chains. Connectors pass incoming requests to a handler chain as specified in the connector configuration (see above). This is the default http handler chain definition:
<rwsf:handler-chain name="http">
<rwsf:handler name="httpServer"
class="rwsf_transport_http.createHttpServerHandlerImp" type="request"/>
<rwsf:handler name="servlet"
class="rwsf_servlet.createServletMessageInfoHandlerImp" type="request">
<rwsf:property name="rwsf:configDir" value="${RWSF_CONF}/servlet"/>
<rwsf:property name="rwsf:webappsDir" value="${RWSF_HOME}/apps/servlets"/>
<rwsf:property name="rwsf:librarySuffix" value="4612d"/>
<rwsf:property name="rwsf:debugLibrarySuffix" value="4615d"/>
</rwsf:handler>
</rwsf:handler-chain>
The http handler chain is the default chain for the HTTP, HTTPS and AJP 13 connectors. It contains just two handlers, httpServer, which prepares the request for handoff to the container, and servlet, which represents the entry point to the servlet container. HydraExpress web services are implemented as servlets.
The servlet container within the Agent has its own handler system. While you can create handlers at both the Agent and servlet container levels, we recommend that you use the servlet container handler system for any additional handlers you want to create.
Customizing Handlers and Their Properties
For the details on how to create and configure custom handlers in the servlet container, see
SOAP Message Handlers in the
HydraExpress Web Service Development Guide.
You can also add a custom property to the handler chain to customize the session ID used to identify each session. See
Sessions and State in the
HydraExpress Web Service Development Guide