Creating the Handler Chain Configuration File
9.6 Creating the Handler Chain Configuration File
If you decide to use the HandlerChain annotation in your JWS file to associate a handler chain with a Web service, you must create an external configuration file that specifies the list of handlers in the handler chain, the order in which they execute, the initialization parameters, and so on. Because this file is external to the JWS file, you can configure multiple Web services to use this single configuration file to standardize the handler configuration file for all Web services in your enterprise. Additionally, you can change the configuration of the handler chains without needing to recompile all your Web services. Finally, if you include handlers in your handler chain that use a non-SOAP transport, then you are required to use the HandlerChain annotation rather than the SOAPMessageHandler annotation. The configuration file uses XML to list one or more handler chains, as shown in the following simple example: jwshc:handler-config xmlns:jwshc=http:www.bea.comxmlnsjws xmlns:soap1=http:HandlerInfo.orgServer1 xmlns:soap2=http:HandlerInfo.orgServer2 xmlns=http:java.sun.comxmlnsj2ee jwshc:handler-chain jwshc:handler-chain-nameSimpleChainjwshc:handler-chain-name jwshc:handler handler-namehandler1handler-name handler-classexamples.webservices.soap_handlers.global_ handler.ServerHandler1handler-class jwshc:handler jwshc:handler handler-namehandler2handler-name handler-classexamples.webservices.soap_handlers.global_ handler.ServerHandler2handler-class jwshc:handler jwshc:handler-chain jwshc:handler-config In the example, the handler chain called SimpleChain contains two handlers: handler1 and handler2, implemented with the class names specified with the handler-class element. The two handlers execute in forward order before the relevant Web service operation executes, and in reverse order after the operation executes. Use the init-param, soap-role, and soap-header child elements of the handler element to specify the handler initialization parameters, SOAP roles implemented by the handler, and SOAP headers processed by the handler, respectively. For the XML Schema that defines the external configuration file, additional information about creating it, and additional examples, see the Web services Metadata for the Java Platform specification at http:www.jcp.orgenjsrdetail?id=181 .9.7 Compiling and Rebuilding the Web Service
Parts
» Oracle Fusion Middleware Online Documentation Library
» Overview of the Asynchronous Request-Response Feature
» Using Asynchronous Request-Response: Main Steps
» Configuring the Host WebLogic Server Instance for the Asynchronous Web Service
» Example of a Synchronous Invoke
» Configuring the Source WebLogic Server Instance
» Creating a Custom WS-Policy File Using WS-ReliableMessaging Policy Assertions Version 1.1
» Using Multiple Policy Alternatives
» Programming Guidelines for the JWS File That Invokes a Reliable Web Service
» Overview of Conversational Web Services
» Creating a Conversational Web Service: Main Steps
» Programming Guidelines for the Conversational JWS File
» Programming Guidelines for the JWS File That Invokes a Conversational Web Service
» Updating a Stand-Alone Java Client to Invoke a Conversational Web Service
» ConversationService.java File Example Conversational Web Service .NET Client
» Service.cs File Example Conversational Web Service .NET Client
» build.xml File Example Conversational Web Service .NET Client
» Configuring the Host WebLogic Server Instance for the Buffered Web Service
» Programming Guidelines for the Buffered JWS File
» Using the Asynchronous Features Together
» Example of a JWS File That Implements a Reliable Conversational Web Service
» Overview of Callbacks Callback Implementation Overview and Terminology
» Programming Callbacks: Main Steps Programming Guidelines for Target Web Service
» Programming Guidelines for the Callback Client Web Service
» Programming Guidelines for the Callback Interface
» Updating the build.xml File for the Client Web Service
» Overview of Using JMS Transport
» Using JMS Transport Starting From Java: Main Steps
» Using JMS Transport Starting From WSDL: Main Steps
» Configuring the Host WebLogic Server Instance for the JMS Transport Web Service
» Using the WLJmsTransport JWS Annotation
» Using the WLJmsTransport Child Element of the jwsc Ant Task Updating the WSDL to Use JMS Transport
» Overriding the Default Service Address URL
» Using JMS BytesMessage Rather Than the Default TextMessage Disabling HTTP Access to the WSDL File
» Overview of SOAP Message Handlers
» Adding SOAP Message Handlers to a Web Service: Main Steps
» Designing the SOAP Message Handlers and Handler Chains
» Implementing the Handler.handleResponse Method
» javax.jws.HandlerChain Configuring Handlers in the JWS File
» javax.jws.soap.SOAPMessageHandlers
» Creating the Handler Chain Configuration File
» Compiling and Rebuilding the Web Service
» Using Client-Side SOAP Message Handlers: Main Steps
» Example of a Client-Side Handler Class Creating the Client-Side SOAP Handler Configuration File
» Database Call-out Overview of Database Web Services
» SQL to XML Type Mappings for Web Service Call-Ins
» UDDI and Web Services UDDI and Business Registry
» Configuring an External LDAP Server
» Description of Properties in the uddi.properties File
Show more