Module jakarta.xml.ws

Package jakarta.jws

Annotation Interface 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 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:

""