Module jakarta.jws
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.
    Since:
    1.6
    • 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 Detail

      • 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).
      • name

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