You can use an assembly tool to configure the webservices.xml deployment descriptor for user-provided handler classes.
You can configure deployment descriptors with assembly tools provided with the application server.
A handler class is a class that is written to modify a SOAP message that represents a remote procedure call (RPC) request or response. Handlers can be associated with a web service or a web service client.
Similar to Java API for XML-based RPC (JAX-RPC) web services, you can use deployment descriptors to describe Java API for XML Web Services (JAX-WS) web services. For JAX-WS web services, the use of the webservices.xml deployment descriptor is optional because you can use annotations to specify all of the information that is contained within the deployment descriptor file. You can use the deployment descriptor file to augment or override existing JAX-WS annotations. Any information that you define in the webservices.xml deployment descriptor overrides any corresponding information that is specified by annotations.
To complete this task, you need an enterprise archive (EAR) file for the applications that you want to configure. For some handler use, such as logging or tracing, only the server or client application require configuration. For other handler use, including sending information in the SOAP headers, the client and server applications must be configured with symmetrical handlers.
The modules in the EAR file contain the handler classes to configure. These classes implement the javax.xml.rpc.handler.Handler interface. For more information on writing handler classes, see chapter 6 of the Web Services for Java EE specification. See chapter 9 in the JAX-WS specification or chapter 12 in the JAX-RPC specification for additional information on the handler framework for your programming model. The application modules must contain the webservices.xml deployment descriptor. See the web services specifications and API information to review the JAX-RPC specification along with a complete list of the supported standards and specifications.
In this information ...Related concepts
| IBM Redbooks, demos, education, and more(Index) |