javax.jws
註釋型別 WebService

@Retention(value=RUNTIME)
@Target(value=TYPE)
public @interface WebService

將 Java 類別標記為實作 Web Service，或者將 Java 介面標記為定義 Web Service 介面。

可選元素摘要

String	endpointInterface 定義服務抽象 Web Service 協定的服務端點介面的完整名稱。
String	name Web Service 的名稱。
String	portName Web Service 的埠號名稱。
String	serviceName Web Service 的服務名稱。
String	targetNamespace 如果 @WebService.targetNamespace 註釋是關於某一服務端點介面的，則 targetNamespace 用於 wsdl:portType（以及關聯的 XML 元素）的名稱空間。
String	wsdlLocation 描述服務的預定義 WSDL 的位置。

name

public abstract String name

Web Service 的名稱。

當映射到 WSDL 1.1 時，該名稱被用作 wsdl:portType 的名稱。

預設值：

""

targetNamespace

public abstract String targetNamespace

如果 @WebService.targetNamespace 註釋是關於某一服務端點介面的，則 targetNamespace 用於 wsdl:portType（以及關聯的 XML 元素）的名稱空間。

如果 @WebService.targetNamespace 註釋是關於某個沒有參考服務端點介面（通過 endpointInterface 屬性）的服務實作 bean 的，則 targetNamespace 既可以用於 wsdl:portType 也可以用於 wsdl:service（以及關聯的 XML 元素）。

如果 @WebService.targetNamespace 註釋是關於某個參考服務端點介面（通過 endpointInterface 屬性）的服務實作 bean 的，則 targetNamespace 僅用於 wsdl:service（以及關聯的 XML 元素）。

預設值：

""

serviceName

public abstract String serviceName

Web Service 的服務名稱。

當映射到 WSDL 1.1 時，此名稱被用作 wsdl:service 的名稱。

不允許在端點介面上使用此成員值。

預設值：

""

portName

public abstract String portName

Web Service 的埠號名稱。

當映射到 WSDL 1.1 時，此名稱被用作 wsdl:port 的名稱。

不允許在端點介面上使用此成員值。

從以下版本開始：

2.0

預設值：

""

wsdlLocation

public abstract String wsdlLocation

描述服務的預定義 WSDL 的位置。

wsdlLocation 是參考預先存在的 WSDL 檔案的 URL（相對或絕對）。wsdlLocation 值的存在指示服務實作 bean 將實作預先定義的 WSDL 協定。如果服務實作 bean 與此 WSDL 中宣告的 portType 和綁定不一致，則 JSR-181 工具必須提供反饋。注意，單個 WSDL 檔案可能包含多個 portType 和多個綁定。服務實作 bean 上的註釋確定對應於 Web Service 的特定 portType 和綁定。

預設值：

""

endpointInterface

public abstract String endpointInterface

定義服務抽象 Web Service 協定的服務端點介面的完整名稱。

此註釋允許開發人員將介面協定與實作分離。如果此註釋存在，則使用服務端點介面來確定抽象 WSDL 協定（portType 和綁定）。服務端點介面可以包含用來定制 Java 到 WSDL 的映射關係的 JSR-181 註釋。
服務實作 bean 可以實作服務端點介面，但並不要求這樣做。
如果此成員值不存在，則 Web Service 協定是根據服務實作 bean 上的註釋產生的。如果目標環境需要一個服務端點介面，則將產生一個由實作定義的套件，該套件具有由實作定義的名稱。

不允許在端點介面上使用此成員值。

預設值：

""