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_BINDINGSOAP12_HTTP_MTOM_BINDING 作为该注释的值来对 JavaBeans 端点实现类使用 @BindingType 注释以启用消息传输优化机制 (MTOM)。

  • 注释目标:类型
  • 属性:
    - value
    指示绑定标识 Web 地址。(字符串)
@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 端点的服务端点实现类中的方法。

  • 注释目标:方法
  • 属性:
    - localName
    指定用于表示请求包装器的 XML 模式元素的局部名称。缺省值为在 javax.jws.WebMethod 注释中定义的 operationName。(字符串)
    - targetNamespace
    指定请求包装器方法的 XML 名称空间。缺省值为 SEI 的目标名称空间。(字符串)
    - className
    指定用于表示请求包装器的类的名称。(字符串)
@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 端点的服务端点实现类中的方法。

  • 注释目标:方法
  • 属性:
    - localName
    指定用于表示请求包装器的 XML 模式元素的局部名称。缺省值为 operationName + responseoperationName 是在 javax.jws.WebMethod 注释中定义的。(字符串)
    - targetNamespace
    指定请求包装器方法的 XML 名称空间。缺省值为 SEI 的目标名称空间。(字符串)
    - className
    指定用于表示响应包装器的类的名称。(字符串)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface ResponseWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ServiceMode 此注释指定服务提供程序是必须对整个消息协议具有访问权还是只需对消息有效内容具有访问权。
要点: @ServiceMode 注释只在具有 @WebServiceProvider 注释的类上受支持。
  • 注释目标:类型
  • 属性:
    - value
    指示提供程序类是接受消息的有效内容 PAYLOAD 还是整个消息 MESSAGE。缺省值为 PAYLOAD。(字符串)
@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 故障的映射。

您可以将此注释应用于故障实现类。

  • 注释目标:类型
  • 属性:
    - name
    指定用于表示 WSDL 文件中相应故障的 XML 元素的局部名称。必须指定实际值。(字符串)
    - targetNamespace
    指定用于表示 WSDL 文件中相应故障的 XML 元素的名称空间。(字符串)
    - faultBean
    指定故障 Bean 类的名称。(字符串)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface WebFault{
	String name() default “”; 
	String targetNamespace() default “”;
	String faultBean() default “”;
};
指示主题类型的图标 参考主题
信息中心的条款和条件 | 反馈

时间戳记图标 最近一次更新时间: 2014 年 4 月 17 日

文件名:rwsandoc004.html