1. 程式人生 > >WebService常見標籤詳解

WebService常見標籤詳解

@WebService標籤

使用@WebService標籤,需要配置在類上,代表這是一個提供WS的服務類。

endpointInterface:定義服務抽象WebService 協定的服務端點介面的完整名稱。不允許在端點上使用此成員值,該元素的值必須有WebService標籤。預設情況下,伺服器自動生成服務端介面。

name:服務介面名稱(對應wsdl: portType的name屬性,用在服務介面上);

serviceName:服務類名稱。預設為,實現類名+Service(對應service的name和definition上的name屬性對應,用在實現類上)。

portName:Web Service的埠名稱。此名稱被用作wsdl:port的名稱。

targetNamespace:目標名稱空間,描述服務的預定義WSDL的位置(同時用在實現類和服務介面上,需統一)。

wsdlLocation:WSDL地址(服務端除了WSDL優先的情況外可不寫,客戶端代理介面上必須配置此屬性,指向web端WSDL檔案地址)

@WebMethod標籤

使用@WebMethod標籤,需要把他配置到方法上。

operationName:指定暴露服務方法的別名。

exclude:是否暴露此標記的方法。

@WebResult標籤

使用@WebResult標籤,需要把他標記在方法上或者方法返回型別定義之前。

name:定義返回值的名稱。

header:布林型別,是否把值放到header元素中進行傳遞。

@WebParam標籤

使用@WebParam標籤,需要把他標記在形參宣告之前。

name:定義傳遞時引數的名稱(預設引數以arg0,arg1)。

header:布林型別,是否把值放到header元素中進行傳遞。

@SOAPBinding

使用@ SOAPBinding標籤,需要把他標記在類上。

SOAPBinding.ParameterStyleparameterStyle 確定方法引數是否表示整個訊息正文,或者引數是否是包裝在以操作命名的頂層元素中的元素。

SOAPBinding.ParameterStyle.WRAPPED,預設,使用對引數進行包裝

SOAPBinding.ParameterStyle.BARE,不對引數進行包裝

SOAPBinding.Style style 定義發 送到Web Service 的訊息 和從Web Service傳送的訊息的編碼樣式。

SOAPBinding.Style.RPC:面向RPC

SOAPBinding.Style.DOCUMENT 預設,面向文件

SOAPBinding.Useuse 定義傳送到WebService的訊息和從WebService傳送的訊息的格式樣式。

SOAPBinding.Use.LITERAL,預設,字面量風格,若服務端和客戶端不在一起開發,就應該使用這個

SOAPBinding.Use.ENCODED使用SOAP編碼風格,可能導致WS互操作方面失敗問題,儘量避免使用。