Overview of Web Service Provider-based Endpoints and Dispatch Clients

16 Operating at the XML Message Level 16-1 16 Operating at the XML Message Level The following sections describes how to develop Web service provider-based endpoints and dispatch clients to operate at the XML message level: ■ Section 16.1, Overview of Web Service Provider-based Endpoints and Dispatch Clients ■ Section 16.2, Usage Modes and Message Formats for Operating at the XML Level ■ Section 16.3, Developing a Web Service Provider-based Endpoint ■ Section 16.4, Developing a Web Service Dispatch Client

16.1 Overview of Web Service Provider-based Endpoints and Dispatch Clients

Although the use of JAXB-generated classes is simpler, faster, and likely to be less error prone, there are times when you may want to generate your own business logic to manipulate the XML message content directly. Message-level access can be accomplished on the server side using Web service Provider-based endpoints, and on the client side using Dispatch clients. A Web service Provider-based endpoint, implemented using the javax.xml.ws.ProviderT interface, offers a dynamic alternative to the Java service endpoint interface SEI-based endpoint. Unlike the SEI-based endpoint that abstracts the details of converting between Java objects and their XML representation, the Provider interface enables you to access the content directly at the XML message level—without the JAXB binding. The steps to develop a Web service Provider-based endpoint are described in Section 16.3, Developing a Web Service Provider-based Endpoint. . For more information about the javax.xml.ws.ProviderT interface, see http:download.oracle.comjavaee5apijavaxxmlwsProvider.ht ml . A Web service Dispatch client, implemented using the javax.xml.ws.DispatchT interface, enables clients to work with messages at the XML level. The steps to develop a Web service Dispatch client are described in Section 16.4, Developing a Web Service Dispatch Client . For more information about the javax.xml.ws.DispatchT interface, see http:download.oracle.comjavaee5apijavaxxmlwsProvider.ht ml . Dispatch clients and Provider endpoints can be used in combination with other WebLogic Web services features as long as a WSDL is available, including: ■ WS-Security 16-2 Programming Advanced Features of JAX-WS Web Services for Oracle WebLogic Server ■ WS-ReliableMessaging ■ WS-MakeConnection ■ WS-AtomicTransaction

16.2 Usage Modes and Message Formats for Operating at the XML Level