PI33130: @HANDLERCHAIN ANNOTATION CAN NOT WORK WITH @WEBSERVICECLIENT ANNOTATION.

8.5.5.5: WebSphere Application Server V8.5.5 Fix Pack 5
8.5.5.6: WebSphere Application Server V8.5.5 Fix Pack 6
8.5.5.7: WebSphere Application Server V8.5.5 Fix Pack 7
8.5.5.8: WebSphere Application Server V8.5.5 Fix Pack 8
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16
8.5.5.21: WebSphere Application Server V8.5.5.21

APAR status

• Closed as program error.

Error description

• A @WebServiceClient like the following, which defines a
  @HandlerChain to reference to a handler.xml file:
  
  @HandlerChain(file = "handler.xml")
  @WebServiceClient(name = "AccountServiceImplService",
  targetNamespace =
  "http://bean.test.hsbc/", wsdlLocation =
  "WEB-INF/wsdl/AccountService.wsdl")
  public class AccountServiceImplService
  extends Service
  
  {
  
  ...
  
  }
  The above code does not work in 8.5.5.3 Liberty profile (but
  works in WAS full profile) and the handler chain is notinvoked.
  
  
  invoked.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server Liberty Profile - Web Services (JAX- *
  *                  WS, JAX-RS)                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: JAX-WS handler chain annotation not     *
  *                      support on generated web service client *
  *                      stub (@WebServiceClient)                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  @HandlerChain annotation can not work with @WebServiceClient
  annotation in a generated web service client stub:
  
  A generated web service client stub with @WebServiceClient
  annotation like the following, which defines a @HandlerChain to
  reference to a handler.xml file:
  
  @HandlerChain(file = "handler.xml")
  @WebServiceClient(name = "AccountServiceImplService",
  targetNamespace =
  "http://bean.test.hsbc/", wsdlLocation =
  "WEB-INF/wsdl/AccountService.wsdl")
  public class AccountServiceImplService extends Service
  {
  ...
  }
  
  The above code does not work in 8.5.5.3 Liberty profile (but
  works in full profile) and the handler chain is not invoked.
  

Problem conclusion

• To fix the problem, we updated
  com.ibm.ws.jaxws.metadataWebServiceRefPartialInfo class to scan
  the @HandlerChain annotation in the generated Web Service Stub
  class, then added the handler chain related info (if any)  to
  WebServiceRefInfo class. Then existing code can get the handler
  chain info to WebServiceRefInfo class and process the handlers.
  
  The fix for this APAR is currently targeted for inclusion in fix
  pack 8.5.5.5.  Please refer to the Recommended Updates page for
  delivery information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  

Temporary fix

• 1. Using @@HandlerChain(file = "handler.xml") in @WebServiceRef
  as below:
      @WebServiceRef(type = HelloWorldImplOneIris.class)
      @HandlerChain(file = "ims-handler.xml")
      HelloWorldImplOneIris service;
  
  2. Using <handler-chains> in your deployment descriptor:
  <service-ref>
    <service-ref-name>service/AddNumbers_Service</service-ref-
  name>
    <service-
  interface>faultbean.wsfvt.server.AddNumbers_Service</service-
  interface>
    <handler-chains>
      <handler-chain>
        <handler>
          <handler-name>MyHandler</handler-name>
          <handler-class>com.ibm.samples.jaxws2.MyHandler</handler
  class>
        </handler>
      </handler-chain>
    </handler-chains>
  </service-ref>
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  LIBERTY PROFILE

• Fixed component ID

  5724J0814

Applicable component levels

• R850 PSY

     UP