Befehl 'modifyJAXWSHandler'

Verwenden Sie den Befehl modifyJAXWSHandler, um eine JAX-WS-Handlerkonfiguration (Java™ API for XML-based Web Services) für einen Handler zu ändern, der im Rahmen einer Handlerliste mit WS-Notification-Services der Version 7.0 verwendet wird.

Sie können eine JAX-WS-Handlerkonfiguration, wie in diesem Artikel beschrieben, mit dem Tool "wsadmin" ändern, oder Sie können, wie im Artikel Vorhandene JAX-WS-Handler-Konfiguration ändern beschrieben, die Administrationskonsole verwenden.

Wenn Sie eine Handlerklasse ändern, aber den Klassennamen unverändert lassen, müssen Sie die Handlerkonfiguration nicht ändern, wie in diesem Artikel beschrieben wird. Sie müssen die Server oder Cluster mit den von diesem Handler überwachten Services bzw. Servicepunkten stoppen und anschließend erneut starten.

Verwenden Sie zum Ausführen des Befehls das Objekt AdminTask des Scripting-Clients wsadmin.

[IBM i][IBM i]Der Scripting-Client wsadmin wird über die Qshell ausgeführt. [IBM i]Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.

Für die SIB-Befehle wird jeweils eine Befehlszeilenhilfe bereitgestellt:
  • 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')

Speichern Sie Ihre Änderungen nach der Ausführung des Befehls in der Masterkonfiguration. Verwenden Sie hierfür beispielsweise den folgenden Befehl:

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. Dieser Befehl ändert eine JAX-WS-Handlerkonfiguration, die im Rahmen einer Handlerliste für WS-Notification-Services der Version 7.0 verwendet werden kann.

Das Konfigurationsobjekt ordnet einer Java-Klasse (Parameter className) einen eindeutigen Namen (Parameter name) zu, der auf die JAX-WS-Handlerimplementierung verweist.

Zielobjekt

Ein JAX-WS-Handlerkonfigurationsobjekt.

Erforderliche Parameter

-name
Der Name des JAX-WS-Handlerkonfigurationsobjekts.
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: \ / , # $ @ : ; " * ? < > | = + & % '
Anmerkung: Wenn Sie einen Handlernamen ändern, sucht das System alle Objekte, die auf diesen Namen verweisen und aktualisiert den Namen.
-className
Der Name der JAX-WS-Handlerklasse, die dieses Konfigurationsobjekt darstellt. Dieser Name muss ein vollständig qualifizierter Java-Klassenname sein, z. B. com.ibm.jaxws.handler.TestHandler.
Wenn Sie den Klassennamen ändern, müssen Sie auch die neue Handlerklasse dem Server oder Cluster mit den WS-Notification-Servicepunkten (für die Bearbeitung eingehender Aufrufe) bzw. den WS-Notification-Services (für die Bearbeitung abgehender Aufrufe) zur Verfügung stellen.JAX-WS-Handlerklassen laden.
Anmerkung: Sie können mehrere Instanzen eines Handler konfigurieren, indem Sie jede Instanz mit einem anderen Handlernamen erstellen und auf dieselbe Handlerklasse verweisen.

Vorgegebene Parameter

Ohne.

Optionale Parameter

-description
Eine Beschreibung des JAX-WS-Handlers.

Beispiel

Konfiguration für eine bestimmte JAX-WS-Handlerklasse ändern:
  • Mit Jython:
    AdminTask.modifyJAXWSHandler(JAXWSHandler, 
    ["-name", "newHandler1", "-className", "newHandlerClass",
     "-description", "newDesc"] )
  • Mit Jacl:
    $AdminTask modifyJAXWSHandler JAXWSHandler 
    {-name newHandler1 -className newHandlerClass
     -description newDesc}

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjwsn_cli_jaxws_handler_mod
Dateiname:rjwsn_cli_jaxws_handler_mod.html