Define the logical handler and protocol handler as per the JAX-WS 2.2 specifications. The protocol handler also defines the SOAP handler. The following is a description of each of these handlers:

Logical handler

This handler implements the javax.xml.ws.handler.LogicalHandler interface.

Protocol handler

This handler implements all the inherited interfaces of javax.xml.ws.handler.Handler, except the javax.xml.ws.handler.LogicalHandler interface.

SOAP handler

This handler implements the javax.xml.ws.handler.soap.SOAPHandler interface.

The following figure shows the relationship of handlers (class hierarchy):

Figure 36-2 Class hierarchy of handlers

You can use the logical handler and SOAP handler in the Cosminexus JAX-WS functionality.

If a handler that is neither a logical handler nor a SOAP handler is specified in the handler chain, an error message (KDJW00009-E) is output to the log and standard error output when the Web Service is initialized in the JAX-WS engine on the Web Service. In the JAX-WS engine on the Web Service client, javax.xml.ws.WebServiceException is thrown when an attempt is made to acquire the port.

The handler that implements both, the javax.xml.ws.handler.LogicalHandler interface and the javax.xml.ws.handler.soap.SOAPHandler interface (handler that is logical handler as well as SOAP handler) is considered as the logical handler.