Module jakarta.xml.ws
Package jakarta.jws

Annotation Type HandlerChain

@Retention(RUNTIME) @Target({TYPE,METHOD,FIELD}) public @interface HandlerChain
Associates the Web Service with an externally defined handler chain. This annotation is typically used in scenarios where embedding the handler configuration directly in the Java source is not appropriate; for example, where the handler configuration needs to be shared across multiple Web Services, or where the handler chain consists of handlers for multiple transports.

It is an error to combine this annotation with the @SOAPMessageHandlers annotation.

  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    String
    file
    Location of the handler chain file.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    String
    name
    Deprecated.
    As of JSR-181 2.0 with no replacement.

  • Element Details

    • file

      String file
      Location of the handler chain file.

      The location supports 2 formats:

      1. An absolute java.net.URL in externalForm (ex: http://myhandlers.foo.com/handlerfile1.xml).
      2. A relative path from the source file or class file (ex: bar/handlerfile1.xml).
      Returns:
      the handler chain

    • name

      @Deprecated String name
      Deprecated.
      As of JSR-181 2.0 with no replacement.
      Name of the handler chain in the configuration file
      Returns:
      the handler chain
      Default:
      ""