Previous Topic: Configure SOA Agent Security Interceptor Protection for JAX-WS Web Services Over JMS Transport (JBoss 5.x)

Next Topic: Configure the SOA Agent JAX-WS Handler for a Single JAX-WS JMS Web Service

Configure the SOA Agent JAX-WS JMS Handler for all JAX-WS JMS Web Services

To configure the SOA Agent JAX-WS JMS Handler to be invoked for all JAX-WS JMS web services, add the SOA agent JAX-WS JMS Handler class (com.ca.soa.agent.jmsplugin.JaxWsJMSHandler) to the standard JAX-WS endpoint configuration file, standard-jaxws-endpoint-config.xml.

The standard-jaxws-endpoint-config.xml file is located in JBOSS_HOME/server/instance_type/deployers/jbossws.deployer/META-INF.

instance_type

Specifies the JBoss Application Server instance type (one of default, minimal, production, standard, or web).

To add the SOA Agent JAX-WS Handler to the standard JAX-WS endpoint configuration file

  1. Navigate to JBOSS_HOME/server/default/deployers/jbossws.deployer/META-INF.
  2. Open the standard-jaxws-endpoint-config.xml file in a text editor.
  3. Add the following javaee:handler element to the "Standard Endpoint" endpoint-config element as the first such element defined:
    <javaee:handler>
       <javaee:handler-name>
          JBoss JAX-WS PEP Interceptor
       </javaee:handler-name>
       <javaee:handler-class>
          com.ca.soa.agent.jmsplugin.JaxWsJMSHandler
       </javaee:handler-class>
    </javaee:handler>
    
  4. Save the file and exit the text editor.

The JBoss SOA Agent JAX-WS Handler will be invoked for all JAX-WS web services.

Example standard-jaxws-endpoint-config.xml file

<jaxws-config xmlns="urn:jboss:jaxws-config:2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:javaee="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="urn:jboss:jaxws-config:2.0 schema/jaxws-config_2_0.xsd">

<endpoint-config>
    <config-name>Standard Endpoint</config-name>
    <pre-handler-chains>
      <javaee:handler-chain>
        <javaee:protocol-bindings>##SOAP11_HTTP</javaee:protocol-bindings>

        <javaee:handler>
           <javaee:handler-name>
           	JBoss JAX-WS PEP Interceptor
           </javaee:handler-name>
           <javaee:handler-class>
           	com.ca.soa.agent.jmsplugin.JaxWsJMSHandler
           </javaee:handler-class>
        </javaee:handler>

        <javaee:handler>
          <javaee:handler-name>Recording Handler</javaee:handler-name>
          <javaee:handler-class>
          	org.jboss.wsf.framework.invocation.RecordingServerHandler
          </javaee:handler-class>
        </javaee:handler>

      </javaee:handler-chain>
    </pre-handler-chains>
</endpoint-config>