REST-Binding zum Implementierungsdeskriptor hinzufügen

Ein REST-Service-Binding liefert die Angaben, die für den Zugriff auf einen REST- oder EGL REST-RPC-Service erforderlich sind.

  1. Ö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.
  2. Klicken Sie auf Service-Bindings. Die Registerkarte Konfiguration von Service-Bindings wird angezeigt.
  3. Klicken Sie auf Hinzufügen. Die Seite Service-Binding hinzufügen wird angezeigt.
  4. Klicken Sie auf REST-Service-Binding und danach auf Weiter. Die Seite REST-Service-Binding hinzufügen wird angezeigt.
  5. 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:
    1. Klicken Sie auf die Schaltfläche Durchsuchen neben dem Feld Name des REST-Service-Binding. Das Fenster für die Schnittstellenauswahl wird angezeigt.
    2. Wählen Sie den Namen des Schnittstellenabschnitts aus, der als Basis für eine Variable für Servicezugriff in Ihrem Code dienen soll.
    3. 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.

  6. 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.
  7. 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'.

  8. 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:
    1. Öffnen Sie die Registerkarte Konfiguration von Service-Bindings.
    2. Wählen Sie das Binding aus.
    3. 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.

Feedback