Ein Beispiel für die Entwicklung einer Serviceschnittstelle mit dem
Serviceeditor.
Lesen Sie die Konzeptinformationen zu Services und
erstellen Sie einen völlig neuen Service. Weitere Informationen hierzu finden Sie unter Service erstellen.
Ein Service in
WebSphere Message
Broker ist eine
spezialisierte Anwendung, die eine Web-Service-Lösung enthält. Sie definiert eine
Schnittstelle mit Operationen, die als separate untergeordnete Nachrichtenflüsse
implementiert werden. Das folgende Beispiel zeigt, wie Sie eine Schnittstelle erstellen und
Operationen definieren. Eine Erläuterung der vollständigen Schnittstelle finden Sie im
Abschnitt
Beispiel für eine Serviceschnittstelle.
- Öffnen Sie den Service im Serviceeditor, indem Sie in der Ansicht Brokerentwicklung doppelt auf Servicebeschreibung klicken oder
indem Sie mit der rechten Maustaste darauf klicken und im Kontextmenü
Öffnen auswählen.
- Zeigen Sie die Serviceschnittstelle an, indem Sie im Serviceeditor die
Registerkarte Schnittstelle aufrufen.
- Beim Erstellen des Service wird automatisch die standardmäßige
Anfrage/Antwort-Operation operation1 erstellt. Benennen Sie
operation1 in getApproval um.
- Benennen Sie die Eingaben und Ausgaben um und bearbeiten Sie deren Typen.
- Benennen Sie input1 in balance um.
Wählen Sie im Feld Typ den Standardwert
Zeichenfolge aus.
Wählen Sie im Kontextmenü die Option
Doppelt aus. Der Typ wird entsprechend geändert.
- Benennen Sie output1 in approval um und
behalten Sie den Typ Zeichenfolge bei.

- Fügen Sie mit dem Symbol Hinzufügefehler der Ausgabe
getApproval zwei Fehler hinzu: Den Fehler timeout
(Zeitlimit) und den Fehler systemFailure (Systemfehler), beide mit dem
Typ Zeichenfolge.

Diese Fehler werden in den
Eigenschaften der Bindungen angezeigt, die Ihre Schnittstelle verwenden. Anschließend
können Sie die Fehler mit dem Fehlerselektor implementieren.
- Fügen Sie eine weitere Anfrage/Antwort-Operation hinzu, indem Sie auf das Symbol
Add Request Response Operation (Anfrage/Antwort-Operation
hinzufügen) klicken oder indem Sie mit der rechten Maustaste klicken und im Kontextmenü
die entsprechende Option auswählen. Daraufhin wird eine Anfrage/Antwort-Operation mit
einer Eingabe und einer Ausgabe erstellt. Geben Sie der Operation den Namen
getHistory (Verlauf abrufen), benennen Sie dann die Eingabe in
customerName (Kundenname) und die Ausgabe in
customerHistory (Kundenverlauf) um und
weisen Sie beiden den Typ Zeichenfolge zu.
Wählen
Sie für customerHistory den Typ Zeichenfolge aus
und ändern Sie den Namen in customerPastHistory (Bisheriger
Kundenverlauf).

- Fügen Sie dieser Operation dieselben Fehler timeout (Zeitlimit)
und systemFailure (Systemfehler) hinzu wie in der vorhergehenden
Operation. Diese Fehler geben entsprechende Fehlernachrichten zurück, wenn eine
Zeitlimitüberschreitung oder ein Systemfehler auftritt.
- Fügen Sie eine unidirektionale Operation mit dem Namen
updateCreditRating (Kreditbewertung aktualisieren) hinzu, entweder über das
Symbol Add One Way Operation (Unidirektionale Operation hinzufügen) oder über die
entsprechende Option im Kontextmenü, das Sie mit einem Rechtsklick öffnen können. Benennen
Sie die Eingabe in currentRating (Aktuelle Bewertung) um und weisen Sie
den Typ Zeichenfolge zu. Unidirektionale Operationen senden nur eine Eingabe,
weil keine Antwort erforderlich ist.

Implementieren Sie die im
Service definierten Operationen als separate
untergeordnete Nachrichtenflüsse.
Der Abschnitt
Serviceoperation implementieren enthält weitere Informationen hierzu.