Ein REST-Service-Binding liefert die Angaben, die für den Zugriff auf
einen REST- oder
EGL REST-RPC-Service erforderlich sind.
- Öffnen Sie den Editor für EGL-Implementierungsdeskriptoren, indem Sie doppelt auf einen
EGL-Implementierungsdeskriptor klicken. Ziehen Sie den Abschnitt 'EGL-Implementierungsdeskriptor
erstellen' zurate, wenn Sie die Implementierungsdeskriptordatei erstellen müssen.
- Klicken Sie auf Service-Bindings. Die Registerkarte
Konfiguration von Service-Bindings wird angezeigt.
- Klicken Sie auf Hinzufügen. Die Seite Service-Binding
hinzufügen wird angezeigt.
- Klicken Sie auf REST-Service-Binding und danach auf
Weiter.
Die Seite REST-Service-Binding hinzufügen wird angezeigt.
- Geben Sie im Feld Name des REST-Service-Binding den Namen des
Service-Binding ein. Dieser Name wird auch als Schlüssel bezeichnet. Sie können den Namen
eingeben oder wie folgt vorgehen:
- Klicken Sie auf die Schaltfläche Durchsuchen neben dem Feld
Name des REST-Service-Binding. Das Fenster für die Schnittstellenauswahl
wird angezeigt.
- Wählen Sie den Namen des Schnittstellenabschnitts aus, der als Basis für eine
Variable für Servicezugriff in Ihrem Code dienen soll.
- Klicken Sie auf OK.
Sie geben den Namen des Service-Binding
an, wenn Sie eine Variable für Servicezugriff deklarieren und die Eigenschaft
@BindService für das Feld bindingKey
definieren.
- Geben Sie im Feld baseURI eine Zeichenfolge ein, die die ersten
Qualifikationsmerkmale in der URI kennzeichnet, die für den Zugriff auf den Service verwendet
werden. Der Standardwert für baseURI ist eine leere Zeichenfolge.
- Geben Sie im Feld sessionCookieID den Namen eines Sitzungscookies ein.
Dabei handelt es sich um eine Zeichenfolge, die das Sitzungscookie kennzeichnet. Der Standardwert
ist JSESSIONID. Diese Sitzungs-ID wird immer verwendet, wenn Ihre Anwendung unter
Apache Tomcat ausgeführt wird.
Die Einstellung
sessionCookieID ist nur
in folgenden Fällen von Bedeutung:
- Bei dem Service handelt es sich um einen externen EGL-Typ, der es ermöglicht, ein
aufgerufenes
IBM® i-Programm oder Service-Programm als EGL-REST-RPC-Service
zur Verfügung zu stellen.
- Die Servicelogik ist stateful, d. h. Werte werden von einem Aufruf zum nächsten
weitergeben. Dies
bedeutet, dass der Requester und der Service an einem aus mehreren Schritten bestehenden
Datenaustausch teilnehmen können.
Der Wert in diesem Feld überschreibt die
Einstellung für die Builddeskriptoroption defaultSessionCookieID.
Hintergrundinformationen
hierzu finden Sie im Abschnitt 'Auf Programme unter
IBM i
als Web-Services zugreifen: Übersicht'.
- Klicken Sie auf Fertigstellen. Die Registerkarte
Konfiguration von Service-Bindings ist erneut verfügbar. Von nun an
können
Sie das zuvor definierte Service-Binding bei Bedarf aktualisieren:
- Öffnen Sie die Registerkarte Konfiguration von Service-Bindings.
- Wählen Sie das Binding aus.
- Bearbeiten Sie die angezeigten Informationen.
Die Registerkarte enthält das
Kontrollkästchen
enableGenerate. Dieses Kontrollkästchen dient dem
folgenden Zweck:
- Bei Requestern mit COBOL-Generierung gibt diese Option an, ob die Web-Service-Zugriffsschicht
bei der Generierung des Implementierungsdeskriptors generiert werden soll. Sie müssen die
Web-Service-Zugriffsschicht mindestens ein Mal generieren, damit EGL den Code erstellt, der für den
Zugriff auf den Service benötigt wird. Wenn Sie die Web-Service-Zugriffsschicht generiert haben,
ist eine erneute Generierung nur erforderlich, wenn Sie die Informationen im Service-Binding
ändern. Das Generieren der Web-Service-Zugriffsschicht kann sehr zeitaufwendig sein.
Wenn Sie Zeit sparen möchten, empfiehlt es sich deshalb möglicherweise,
dieses Kontrollkästchen zu inaktivieren.
- Bei Requestern, die in Java™ generiert werden, gibt diese
Option an, ob Bindinginformationen zu der Bindingdatei in der generierten Ausgabe hinzugefügt
werden sollen. Diese Angabe ist erforderlich. Sie müssen diese Option deshalb für Requester, die in
Java generiert werden, auswählen.