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互操作方面失敗問題,儘量避免使用。