JAX-WS 2.0 註釋(JSR 224)

JSR 224 規格定義了 JAX-WS 2.0 的註釋。

註: 含有 JSR 224 標準中之每一項註釋的 Java™ 類別會命名為 javax.xml.ws.xxx,其中 xxx 是 '@' 字元後的註釋名稱。舉例來說,@BindingType 註釋的 Java 類別名稱是 javax.xml.ws.bindingtype。
名稱: 說明: 內容: 定義:
@BindingType 此註釋指定當您發佈這種類型的端點時,所要使用的連結。如果沒有指定註釋,預設值是 SOAP11_HTTP_BINDING。

您可以將此註釋套用至服務端點的 JavaBeans 實作類別,而該服務端點是以服務端點介面或提供者介面為基礎。

重要事項:

指定 SOAP11_HTTP_MTOM_BINDING 或 SOAP12_HTTP_MTOM_BINDING 作為註釋值,以便在 JavaBeans 端點實作類別中使用 @BindingType 註釋,來啟用「訊息傳輸最佳化機制 (MTOM)」。

  • 註釋目標:類型
  • 內容:
    - value
    指出連結 ID 網址。(字串)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public  @interface BindingType{
	String value() default SOAP11_HTTP_BINDING;
};
@RequestWrapper 此註釋在 JAXB 產生的要求封套 Bean、元素名稱,以及序列化和解除序列化的名稱空間中,提供執行時期所使用的要求封套 Bean。

當您從 Java 物件著手時,此元素用來解決文件文字模式下的超載衝突。在此情況下,只需要 className 屬性。

此註釋可以套用至用戶端或伺服器之「服務端點介面 (SEI)」中的方法,或 JavaBeans 端點之服務端點實作類別中的方法。

  • 註釋目標:方法
  • 內容:
    - localName
    指定代表要求封套之 XML 綱目元素的本端名稱。預設值是 operationName,如 javax.jws.WebMethod 註釋中所定義。(字串)
    - targetNamespace
    指定要求封套方法的 XML 名稱空間。預設值是 SEI 的目標名稱空間。(字串)
    - className
    指定代表要求封套之類別的名稱。(字串)
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface RequestWrapper{
	String localName() default “”;
	String targetNamespace() default “”;
	String className() default “”;
};
@ResponseWrapper 此註釋使用執行時期所使用的回應封套 Bean,來提供 JAXB 產生的回應封套 Bean、元素名稱,以及序列化和解除序列化的名稱空間。

當您從 Java 物件著手時,此元素用來解決文件文字模式下的超載衝突。在此情況下,只需要 className 屬性。

您可以將此註釋套用至用戶端或伺服器之「服務端點介面 (SEI)」中的方法,或 Java Bean 端點之服務端點實作類別中的方法。

  • 註釋目標:方法
  • 內容:
    - localName
    指定代表要求封套之 XML 綱目元素的本端名稱。預設值是 operationName +response。operationName 定義在 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 此註釋指定服務提供者必須具備整個訊息通訊協定的存取權,還是只要具備訊息有效負載的存取權即可。
重要: 只有具有 @WebServiceProvider 註釋的類別中,才支援 @ServiceMode 註釋。
  • 註釋目標:類型
  • 內容:
    - 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 “”;
};
Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: rwsandoc004.html