modifyJAXWSHandler command
Use the modifyJAXWSHandler command to modify a Java™ API for XML-based Web Services (JAX-WS) handler configuration for a handler that is used, as part of a handler list, with Version 7.0 WS-Notification services.
You can modify a JAX-WS handler configuration by using the wsadmin tool as described in this topic, or by using the administrative console as described in Modifying an existing JAX-WS handler configuration.
如果您修改處理程式類別,但未變更類別名稱,就不需要依照這個主題中的說明來修改處理程式配置。 您只需要停止並重新啟動這個處理程式監視的服務,或服務點所在的伺服器或叢集。
如果要執行這個指令,請使用 wsadmin Scripting 用戶端的 AdminTask 物件。
wsadmin Scripting 用戶端是從 Qshell 執行.
如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.
- 如需可用的 WS-Notification 指令清單,以及每個指令的簡要說明,請在 wsadmin 提示下,輸入下列指令:
print AdminTask.help('WSNotificationCommands')
- 如需給定指令的概觀說明,請在 wsadmin 提示下,輸入下列指令:
print AdminTask.help('command_name')
AdminConfig.save()
Purpose
Java API for XML 型 Web 服務 (JAX-WS) 處理程式,是用來執行某範圍之處理作業的 Java 類別。 例如:記載訊息、轉換其內容或者終止送入的要求。 This command modifies a JAX-WS handler configuration that can be used, as part of a handler list, with Version 7.0 WS-Notification services.
配置物件會將唯一名稱(name 參數)關聯於參照 JAX-WS 處理程式實作的 Java 類別(className 參數)。
Target Object
A JAX-WS handler configuration object.
Required parameters
- -name
- JAX-WS 處理程式配置物件的名稱。這個名稱必須在 Cell 範圍是唯一的,且必須遵循下列語法規則:
- 不可以 "."(句點)開頭。
- 不可以空格開頭或結尾。
- 它不能包含下列中的任何字元:\ / , # $ @ : ; " * ? < > | = + & % '
- Note: 當您變更處理程式名稱時,系統會查閱所有參照它的物件並更新名稱。
- -className
- 這個配置物件所代表的 JAX-WS 處理程式類別的名稱。這個名稱必須是完整的 Java 類別名稱。例如,com.ibm.jaxws.handler.TestHandler。
- 如果您變更類別名稱,您也必須依照Loading JAX-WS handler classes中的詳細說明,將新的處理程式類別提供給您想要監視之 WS-Notification 服務點(處理入埠呼叫)或 WS-Notification 服務(處理出埠呼叫)所在的伺服器或叢集。Note: 您可以用不同的處理程式名稱來建立若干實例,讓各實例指向相同的處理程式類別,以配置單一處理程式的多重實例。
Conditional parameters
None.
Optional parameters
- -description
- JAX-WS 處理程式的說明。
Example
- Using Jython:
AdminTask.modifyJAXWSHandler(JAXWSHandler, ["-name", "newHandler1", "-className", "newHandlerClass", "-description", "newDesc"] )
- Using Jacl:
$AdminTask modifyJAXWSHandler JAXWSHandler {-name newHandler1 -className newHandlerClass -description newDesc}