Befehl 'modifyJAXWSHandlerList'
Verwenden Sie den Befehl modifyJAXWSHandlerList, um die Konfigurationsdetails für eine JAX-WS-Handlerliste (Java™ API for XML-based Web Services) zu ändern, die für die Verwendung mit WS-Notification-Services der Version 7.0 konfiguriert wurde.
Sie können eine JAX-WS-Handlerliste, wie in diesem Artikel beschrieben, mit dem Tool "wsadmin" ändern, oder Sie können, wie im Artikel Vorhandene JAX-WS-Handlerliste ändern beschrieben, die Administrationskonsole verwenden.
Sie können nur bereits konfigurierte Handler zu einer Handlerliste hinzufügen. Informationen zum Konfigurieren eines Handlers finden Sie im Artikel Befehl 'createJAXWSHandler'.
Verwenden Sie zum Ausführen des Befehls das Objekt AdminTask des Scripting-Clients wsadmin.
Der Scripting-Client wsadmin wird über die Qshell ausgeführt.
Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.
- Geben Sie den folgenden Befehl an der wsadmin-Eingabeaufforderung ein, um eine Liste der verfügbaren Befehle für WS-Notification und eine Kurzbeschreibung jedes einzelnen Befehls
anzuzeigen:
print AdminTask.help('WSNotificationCommands')
- Zum Anzeigen einer übersichtlichen Hilfe zu einem bestimmten Befehl geben Sie an der
wsadmin-Eingabeaufforderung den folgenden Befehl ein:
print AdminTask.help('Befehlsname')
AdminConfig.save()
Zweck
Ein JAX-WS-Handler (Java API for XML) ist eine Java-Klasse, die eine Reihe von Verarbeitungstasks ausführt. Beispiele: Nachrichten protokollieren, den Inhalt der Nachrichten umsetzen oder eine eingehende Anforderung beenden. Wenn Handler komplexere Operationen ausführen sollen, können Sie sie in Handlerlisten verketten. In WebSphere Application Server werden den WS-Notification-Servicepunkten (für die Bearbeitung eingehender Aufrufe) bzw. den WS-Notification-Services (für die Bearbeitung abgehender Aufrufe) Handlerlisten (anstelle einzelner Handler) bereitgestellt.
Zielobjekt
Ein JAX-WS-Handlerlistenobjekt.
Erforderliche Parameter
- -name
- Der Name der JAX-WS-Handlerliste.Dieser Name muss auf Zellenebene eindeutig sein und den folgenden Syntaxregeln entsprechen:
- Er darf nicht mit einem Punkt (".") beginnen.
- Er darf nicht mit einem Leerzeichen beginnen oder enden.
- Er darf keines der folgenden Zeichen enthalten: \ / , # $ @ : ; " * ? < > | = + & % '
Wenn Sie den Namen eines Service für eingehende Daten ändern, sucht das System alle Objekte, die auf diesen Listener verweisen, und aktualisiert den Namen.
Vorgegebene Parameter
Ohne.
Optionale Parameter
- -description
- Eine Beschreibung der JAX-WS-Handlerliste.
- -handlers
- Eine Liste der JAX-WS-Handlernamen, die der Liste hinzugefügt werden sollen.
Jeder angegebene Handlername muss als JAX-WS-Handlerobjekt auf Zellenebene vorhanden sein. Handler werden in der Reihenfolge angewendet, in der sie in der Handlerliste erscheinen.
Beispiel
- Mit Jython:
JAXWSHandlerList = AdminTask.modifyJAXWSHandlerList(JAXWSHandlerList, '[-name newHandlerList1 -description newDesc -handlers [[handler1] [handler2]]]')
- Mit Jacl:
$AdminTask modifyJAXWSHandlerList JAXWSHandlerList {-name handlerList1 -description newDesc -handlers {{handler1}{handler2}} }