Please note that the specifications and other information contained herein are not final and are subject to change. The information is being made available to you solely for purpose of evaluation.

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

Annotation Type HandlerChain

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
Modifier and Type Required Element and Description
 String file
          Location of the handler chain file.
Optional Element Summary
Modifier and Type Optional Element and Description
 String name
          Deprecated. As of JSR-181 2.0 with no replacement.

Element Detail


public abstract String file
Location of the handler chain file.

The location supports 2 formats:

  1. An absolute in externalForm (ex:
  2. A relative path from the source file or class file (ex: bar/handlerfile1.xml).


public abstract String name
Deprecated. As of JSR-181 2.0 with no replacement.

Name of the handler chain in the configuration file


Java™ Platform
Standard Ed. 7

DRAFT ea-b118

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2010, Oracle Corporation. All rights reserved.
DRAFT ea-b118

Scripting on this page tracks web page traffic, but does not change the content in any way. - all specs in one place