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. Handler überwachen Nachrichten an Ports und führen je nach Sender und Inhalt der Nachricht entsprechende Aktionen aus. Sie können
die Konfigurationsdetails eines JAX-RPC-Handler, der in einer Handlerliste für die über den Service Integration Bus implementierten Web Services konfiguriert wurde, ändern.
Vorbereitende Schritte
Wenn Sie eine Handler-Klasse ändern, aber den Klassennamen unverändert lassen,
müssen Sie die Handler-Konfiguration nicht ändern, wie in diesem Artikel beschrieben wird.
Sie müssen die Server oder
Cluster mit den von diesem Handler überwachten Ports stoppen und anschließend erneut starten.
Informationen zu diesem Vorgang
Führen Sie die folgenden Schritte aus, um die Handler aufzulisten und ihre Konfigurationsdetails
anzuzeigen oder zu ändern.
Vorgehensweise
- Starten Sie die Administrationskonsole.
- Klicken Sie im Navigationsfenster auf . Im Formular JAX-RPC-Handler wird eine Liste mit Handlern angezeigt.
- Klicken Sie in der Liste auf den Namen eines Handlers. Es werden die aktuellen JAX-RPC-Handler-Einstellungen für diesen Handler
angezeigt.
- Ändern Sie die folgenden allgemeinen Eigenschaften:
- Name
- Ändern Sie den Namen des Handlers.
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: \ / , # $
@ : ; " * ? < > | =
+ & % '
Anmerkung: Wenn Sie einen Handlernamen ändern, sucht das System alle Objekte, die auf diesen Namen verweisen und aktualisiert den Namen.
- Ändern Sie die (optionale) Beschreibung des Handlers.
- Klassenname
- Ändern Sie den Namen der zu instanziierenden Klasse. Wenn Sie den Klassennamen ändern, müssen Sie die
neue Klasse für die Server oder Cluster mit den von diesem Handler überwachten Ports verfügbar machen. Diesbezügliche
Informationen finden Sie im Artikel JAX-RPC-Handlerklassen laden.
- Ändern Sie die folgenden zusätzlichen Eigenschaften:
- SOAP-Rollen
- Sie können SOAP-Actor-Definitionen hinzufügen oder SOAP-Actor-Definitionen in der Liste der SOAP-Rollen, für die dieser Handler
zuständig ist, ändern oder entfernen. Nähere Informationen hierzu
finden Sie in der SOAP-Spezifikation.
- JAX-RPC-Header
- Sie können JAX-RPC-Hader-Definitionen (Namespace-URI und Lokal)
in der Liste der JAX-RPC-Header, für die dieser Handler arbeitet, hinzufügen, ändern und entfernen.
JAX-RPC-Header sind SOAP-Header, die von einem JAX-RPC-Handler verarbeitet werden.
- Angepasste Eigenschaft
- Angepasste Eigenschaften (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)
hinzufügen, ändern oder entfernen.
- Speichern Sie Ihre Änderungen in der Masterkonfiguration.
Ergebnisse
Wenn die Verarbeitung fehlerfrei abgeschlossen wird, wird die Liste der Handler
aktualisiert. Andernfalls
wird eine Fehlernachricht angezeigt.