Erstellen
Sie eine JAX-WS-Handlerkonfiguration (Java™ API
for XML-based Web Services) für die Verwendung im Rahmen einer Handlerliste mit
JAX-WS-basierten WS-Notification-Services der Version 7.0.
Vorbereitende Schritte
Sie können eine neue JAX-WS-Handlerkonfiguration, wie in diesem Artikel beschrieben,
über die Administrationskonsole erstellen, oder Sie können den
Befehl 'createJAXWSHandler' 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.
Informationen zu diesem Vorgang
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. Um WebSphere Application Server
von Ihrem Handler in Kenntnis zu setzen und den Handler für den Einschluss in eine oder mehrere Handlerlisten bereitzustellen,
erstellen Sie in der Administrationskonsole eine neue Handlerkonfiguration.
Vorgehensweise
- Starten Sie die Administrationskonsole.
- Navigieren Sie zu . Das Formular JAX-WS-Handler wird angezeigt.
- Klicken Sie auf Neu. Das Formular mit den Einstellungen für JAX-WS-Handler wird angezeigt.
- Geben Sie die folgenden allgemeinen Eigenschaften an:
- Name
- Geben Sie den Namen für den Handler ein.
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: \ / , # $
@ : ; " * ? < > | =
+ & % '
Beispiel: TestHandler.
- Beschreibung
- Geben Sie die (optionale) Beschreibung für den Handler ein.
- Klassenname
- Geben Sie den Namen der zu instanziierenden Klasse ein. 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.
- Klicken Sie auf OK. Die allgemeinen Eigenschaften
für diesen Eintrag werden gespeichert, und die Optionen für zusätzliche Eigenschaften werden bereitgestellt.
- Speichern Sie Ihre Änderungen in der Masterkonfiguration.
Ergebnisse
Bei fehlerfreiem Abschluss der Verarbeitung wird der neue Handler in die Liste der Handler
aufgenommen. Andernfalls wird eine Fehlernachricht angezeigt.
Nächste Schritte
Wenn Sie diesen Handler verwenden möchten, fügen Sie ihn gemäß der Beschreibung im Artikel
Neue JAX-WS-Handlerliste erstellen bzw.
Vorhandene JAX-WS-Handlerliste ändern einer Handlerliste hinzu.