Erstellen
Sie eine JAX-RPC-Handlerkonfiguration für die über den Service Integration Bus implementierten Web-Services, die im
Rahmen einer Handlerliste verwendet wird.
Handler überwachen Nachrichten an Ports und führen je nach Sender und Inhalt der Nachricht entsprechende Aktionen aus.
Informationen zu diesem Vorgang
Ein JAX-RPC-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
- Klicken Sie im Navigationsfenster auf . Das Formular JAX-RPC-Handler erscheint.
- Klicken Sie auf Neu. Das Formular Einstellungen für JAX-RPC-Handler erscheint.
- Geben Sie die folgenden allgemeinen Eigenschaften an:
- Name
- Geben Sie den Namen für den Handler ein.
Dieser Name muss 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.
- Geben Sie die (optionale) Beschreibung für den Handler ein.
- Klassenname
- Geben Sie den Namen der zu instanziierenden Klasse ein. Beispiel: com.ibm.jaxrpc.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.
- Geben Sie die folgenden zusätzlichen Eigenschaften ein:
- SOAP-Rollen
- Der Liste der SOAP-Rollen, in denen dieser Handler arbeitet, SOAP-Actor-Definitionen hinzufügen.
Nähere Informationen hierzu
finden Sie in der SOAP-Spezifikation.
- JAX-RPC-Header
- Fügen Sie der Liste der JAX-RPC-Header, die dieser Handler bearbeitet, JAX-RPC-Headerdefinitionen
(Namespace-URI und Lokal) hinzu.
JAX-RPC-Header sind SOAP-Header, die von einem JAX-RPC-Handler verarbeitet werden.
- Angepasste Eigenschaft
- Angepasste Eigenschaften hinzufügen (Name/Wert-Paare, in denen Name für einen Eigenschaftsschlüssel und Wert für einen Zeichenfolgewert steht, mit dem Eigenschaften für die interne Systemkonfiguration definiert werden können).
- 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, müssen Sie ihn gemäß den Anleitungen
im Artikel
Neue
JAX-RPC-Handlerliste erstellen oder
Eine vorhandene JAX-RPC-Handlerliste ändern
zur Handlerliste hinzufügen.