javax.xml.ws.spi
類別 Provider

java.lang.Object
  javax.xml.ws.spi.Provider

public abstract class Provider
extends Object

ServiceDelegate 和 Endpoint 物件的服務提供者。

從以下版本開始：

JAX-WS 2.0

欄位摘要

static String

JAXWSPROVIDER_PROPERTY 表示用於尋找 Provider 實作類別名稱的屬性的常數。

建構子摘要

protected

Provider() 創建一個新的 Provider 實例。

方法摘要

abstract Endpoint	createAndPublishEndpoint(String address, Object implementor) 創建和發佈具有指定位址和實作物件的端點物件。
abstract Endpoint	createEndpoint(String bindingId, Object implementor) 創建具有提供的綁定和實作物件的端點物件。
abstract ServiceDelegate	createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class serviceClass) 創建一個服務委託物件。
static Provider	provider() 創建一個新的提供者物件。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

欄位詳細資訊

JAXWSPROVIDER_PROPERTY

public static final String JAXWSPROVIDER_PROPERTY

表示用於尋找 Provider 實作類別名稱的屬性的常數。

另請參見：

常數欄位值

建構子詳細資訊

Provider

protected Provider()

創建一個新的 Provider 實例。

方法詳細資訊

provider

public static Provider provider()

創建一個新的提供者物件。

用於尋找將要使用的提供者子類別的演算法由以下幾個步驟組成：

• 如果存在名為 META-INF/services/javax.xml.ws.spi.Provider 的資源，則它的第一行（如果存在）被用作實作類別的 UTF-8 編碼名稱。
• 如果存在 $java.home/lib/jaxws.properties 檔案，可以通過 java.util.Properties.load(InputStream) 方法讀取它，並且該檔案包含鍵為 javax.xml.ws.spi.Provider 的條目，則該條目的值被用作實作類別的名稱。
• 如果定義了名為 javax.xml.ws.spi.Provider 的系統屬性，則它的值被用作實作類別的名稱。
• 最後，使用預設的實作類別名稱。

createServiceDelegate

public abstract ServiceDelegate createServiceDelegate(URL wsdlDocumentLocation,
                                                      QName serviceName,
                                                      Class serviceClass)

創建一個服務委託物件。

參數：

wsdlDocumentLocation - 指向服務的 WSDL 文檔的 URL，如果不存在 URL，則該參數為 null。

serviceName - 服務的限定名。

serviceClass - 服務類別，它必須是 javax.xml.ws.Service 或其一個子類別。

返回：

新創建的服務委託。

createEndpoint

public abstract Endpoint createEndpoint(String bindingId,
                                        Object implementor)

創建具有提供的綁定和實作物件的端點物件。

參數：

bindingId - 指定所需綁定的 URI（例如 SOAP/HTTP）

implementor - 服務實作物件，傳入請求將被指派到該物件。必須使用所有必要的 Web 服務註釋對相應的類別進行註釋。

返回：

新創建的端點。

createAndPublishEndpoint

public abstract Endpoint createAndPublishEndpoint(String address,
                                                  Object implementor)

創建和發佈具有指定位址和實作物件的端點物件。

參數：

address - 指定要使用的位址和傳輸/協議的 URI。一個 http 位址：URI 必須指向正使用的 SOAP 1.1/HTTP。實作可以支持其他 URI 方案。

implementor - 服務實作物件，傳入請求將被指派到該物件。必須使用所有必要的 Web 服務註釋對相應的類別進行註釋。

返回：

新創建的端點。