Befehl 'createJAXWSHandler'
Verwenden Sie den Befehl createJAXWSHandler, um eine neue JAX-WS-Handlerkonfiguration (Java™ API for XML-based Web Services) zu erstellen, damit der Handler im Rahmen einer Handlerliste für WS-Notification-Services der Version 7.0 verwendet werden kann.
Sie können eine neue JAX-WS-Handlerkonfiguration, wie in diesem Artikel beschrieben, mit dem Tool "wsadmin" erstellen, oder Sie können, wie im Artikel Neue JAX-WS-Handler-Konfiguration erstellen beschrieben, die Administrationskonsole verwenden.
Diese Task setzt voraus, dass Sie Ihren Handler bereits erstellt haben. Zum Erstellen des Handlers können Sie IBM® Rational Application Developer oder ein ähnliches Tool verwenden. Sie müssen die 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.
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. Dieser Befehl erstellt eine neue JAX-WS-Handlerkonfiguration, damit der Handler 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 Objekt auf Zellenebene.
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: \ / , # $ @ : ; " * ? < > | = + & % '
- -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.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
- Mit Jython:
targetCell = AdminConfig.list('Cell') JAXWSHandler = AdminTask.createJAXWSHandler(targetCell, ["-name", "handler1", "-className", "handlerClass", "-description", "desc"])
- Mit Jacl:
$AdminTask createJAXWSHandler targetCell {-name handler1 -className handlerClass -description desc}