HandlerChain (Jakarta XML Web Services API documentation)

```
@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 Detail
  - file
```
String file
```
    Location of the handler chain file.
    The location supports 2 formats:
    
    An absolute java.net.URL in externalForm (ex: http://myhandlers.foo.com/handlerfile1.xml).
    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:
    
    ""