Web 服務用戶端埠資訊

請利用這個頁面來指定要求逾時值、置換端點，以及置換 Web 服務用戶端埠的連結名稱空間。

Web 服務可以有好幾個埠。您可以檢視和配置每一個所定義之 Web 服務埠的埠屬性。Web 服務會列在 Web 服務用戶端連結頁面中。

如果要檢視這個管理主控台頁面，請完成下列步驟：

按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式 > resource_name 。
按一下管理模組 > module_name > Web 服務用戶端連結。
在埠資訊之下，按一下編輯。

這個管理主控台頁面適用於 Java API for XML-Based Web Services (JAX-WS) 和 Java API for XML-Based RPC (JAX-RPC) Web 服務。置換端點 URL 欄位是唯一對 JAX-WS 用戶端支援的欄位。其他欄位不適用於 JAX-WS 用戶端。

埠

指定埠的名稱。

要求逾時值

指定 Web 服務用戶端在這個埠上等待要求完成的時間（秒）。如果沒有指定逾時值，則用戶端等待的預設要求逾時值為 300 秒。如果該值設定為 0（零），使用的逾時值就是基礎傳輸機制的預設值。這個欄位只對 JAX-RPC 用戶端支援。

這項設定的一般用法是當用戶端配置成使用 JMS 傳輸來存取 Web 服務時，用來自訂用戶端的行為，以延長等待時間使作業完成。根據網路狀況或是 Web 服務實作的本質，可能會需要調整逾時值。

置換端點 URL

是指置換現行端點所用的端點名稱。如果用戶端是在這個埠上呼叫要求，則會使用這個端點，而不是在 WSDL 檔指定的端點。這個欄位同時對 JAX-WS 和 JAX-RPC 用戶端支援。

[2013 年 3 月更新] 當呼叫 JAX-RPC 或 JAX-WS 用戶端時，要求會傳送到 WSDL（Web 服務說明語言）檔中埠的 SOAP 位址位置屬性所指定的 URL。兩個程式設計模型也可供用戶端以程式設計方式來設定端點位址 URL。如果是 JAX-RPC，用戶端會利用 javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY 內容來設定端點位址 URL；如果是 JAX-WS，用戶端會使用 javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY 內容。 [2013 年 3 月更新]

如果組合的應用程式含有以靜態方式連結的 Web 服務用戶端，則會利用在開發時使用之 WSDL 檔中識別的實作（服務端點），來鎖定用戶端。置換端點是配置已部署之 WSDL 屬性的另一個方法。

被置換的端點 URI 屬性是在每一個埠上指定。模組中不需要具備替代的 WSDL 檔。被置換的端點 URI，其重要性是排在已部署的 WSDL 屬性前面。用戶端會使用服務端點 URI 或 SOAP 位址的值，而不是靜態用戶端連結的值。

避免困難：

一般而言，這個欄位不會影響未受管理的 JAX-WS 用戶端，因為若是只有未受管理的用戶端，便無法編輯這個欄位。不過，如果您只有受管理的用戶端，或混用受管理和未受管理的用戶端，您可以編輯這個欄位，且內容設定可能會影響您的未受管理的用戶端。如果您不想將未受管理的 JAX-WS 用戶端服務所發出的要求傳送到這個欄位所指定的端點 URL，請新增下列自訂內容至您的 JVM 設定中：
```
com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri
```
新增這個自訂內容至應用程式伺服器的 JVM 設定中，將它設為 true，會防止未受管理的 JAX-WS 用戶端服務存取改寫 WSDL 檔中之端點的端點 URL。
在更新作業中取代模組或應用程式時，不會持續保存被置換的端點 URL 設定。

gotcha

置換的連結

是指要搭配此埠使用的 WSDL 檔案連結名稱空間 URI，而不是 WSDL 檔中的名稱空間。WSDL 檔中不必有這個連結存在。如果用戶端是在這個埠上呼叫要求，則會使用這個連結，而不是在 WSDL 檔指定的連結。除非指定置換的端點，否則不能指定置換的連結名稱空間。這個欄位只對 JAX-RPC 用戶端支援。

檔名： uwbs_portattribute.html