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)」。 |
|
@Retention(value = RetentionPolicy.RUNTIME)
@Target({TYPE})
public @interface BindingType{
String value() default SOAP11_HTTP_BINDING;
};
|
| @RequestWrapper | 此註釋在 JAXB 產生的要求封套 Bean、元素名稱,以及序列化和解除序列化的名稱空間中,提供執行時期所使用的要求封套 Bean。 當您從 Java 物件著手時,此元素用來解決文件文字模式下的超載衝突。在此情況下,只需要 className 屬性。 此註釋可以套用至用戶端或伺服器之「服務端點介面 (SEI)」中的方法,或 JavaBeans 端點之服務端點實作類別中的方法。 |
|
@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 端點之服務端點實作類別中的方法。 |
|
@Retention(value = RetentionPolicy.RUNTIME)
@Target({METHOD})
public @interface ResponseWrapper{
String localName() default “”;
String targetNamespace() default “”;
String className() default “”;
};
|
| @ServiceMode | 此註釋指定服務提供者必須具備整個訊息通訊協定的存取權,還是只要具備訊息有效負載的存取權即可。 重要: 只有具有 @WebServiceProvider 註釋的類別中,才支援 @ServiceMode 註釋。
|
|
@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 “”;
};
|