A handler accesses a SOAP message that represents an RPC request or response. A handler class must implement the javax.xml.rpc.handler interface. Because it accesses a SOAP message, a handler can manipulate the message with the APIs of the javax.xml.soap.package().
A handler chain is a list of handlers. You may specify one handler chain for the client and one for the server. On the client, you include the handlerChains() element in the jaxrpc-ri.xml file. On the server, you include this element in the config.xml file. Here is an example of the handlerChains() element in the config.xml:
|
<handlerChains>
<chain runAt="server"
roles=
"http://acme.org/auditing
"http://acme.org/morphing"
xmlns:ns1="http://foo/foo-1">
<handler className="acme.MyHandler"
headers ="ns1:foo ns1:bar"/>
<property
name="property" value="xyz"/>
</handler>
</chain>
</handlerChains>
|
For more information on handlers, see the SOAP message Handlers chapter of the JAX-PRC specifications.
|