JAX-WS 2.0 注释 (JSR 224)
JSR 224 规范定义了用于 JAX-WS 2.0 的注释。
注: 包含 JST 224 标准中的每一个注释的 Java™ 类的名称为 javax.xml.ws.xxx,其中 xxx 是“@”字符后面的注释的名称。
例如,@BindingType 注释的 Java 类名为 javax.jws.webservice。
| 名称: | 描述: | 属性: | 定义: |
|---|---|---|---|
| @BindingType | 此注释指定在发布此类型的端点时要使用的绑定。如果未指定该注释,那么缺省值为 SOAP11_HTTP_BINDING。 您只能将此注释应用于基于服务端点接口或提供程序接口的服务端点的 JavaBeans 实现类。 要点 通过指定 SOAP11_HTTP_MTOM_BINDING 或 SOAP12_HTTP_MTOM_BINDING 作为该注释的值来对 JavaBeans 端点实现类使用 @BindingType 注释以启用消息传输优化机制 (MTOM)。 |
|
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface BindingType{
String value() default SOAP11_HTTP_BINDING;
};
|
| @RequestWrapper | 此注释提供 JAXB 生成的请求包装器 Bean、元素名称和名称空间,用于对在运行时使用的请求包装器 Bean 进行序列化和反序列化。 从 Java 对象开始时,此元素用来解决 document literal 方式下的重载冲突。在这种情况下,只有 className 特性是必需的。 可以将此注释应用于客户机或服务器服务端点接口 (SEI) 或 JavaBeans 端点的服务端点实现类中的方法。 |
|
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface RequestWrapper{
String localName() default “”;
String targetNamespace() default “”;
String className() default “”;
};
|
| @ResponseWrapper | 此注释提供 JAXB 生成的响应包装器 Bean、元素名称和名称空间,用于对在运行时使用的响应包装器 Bean 进行序列化和反序列化。 从 Java 对象开始时,使用此元素来解决文档文字方式下的重载冲突。在这种情况下,只有 className 特性是必需的。 您可以将此注释应用于客户机或服务器服务端点接口 (SEI) 或 Java Beans 端点的服务端点实现类中的方法。 |
|
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface ResponseWrapper{
String localName() default “”;
String targetNamespace() default “”;
String className() default “”;
};
|
| @ServiceMode | 此注释指定服务提供程序是必须对整个消息协议具有访问权还是只需对消息有效内容具有访问权。 要点: @ServiceMode 注释只在具有 @WebServiceProvider 注释的类上受支持。
|
|
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
@Inherited
public @interface ServiceMode{
Service.Mode value() default javax.xml.ws.Service.Mode.PAYLOAD;
};
|
| @WebFault | 此注释将 WSDL 故障映射到 Java 异常。使用此注释来捕获故障的名称;在从全局元素生成的由 WSDL 故障消息引用的 JAXB 类型的序列化期间,将发生此捕获。您还可以使用此注释来定制特定于服务的异常到 WSDL 故障的映射。 您可以将此注释应用于故障实现类。 |
|
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface WebFault{
String name() default “”;
String targetNamespace() default “”;
String faultBean() default “”;
};
|