Java-Service aufrufen

Um einen Java™-Dienst aufzurufen, können Sie eine Java-Klasse ermitteln und einen externen Dienst erzeugen. Sie können dann den externen Service in einem Service-Flow zum Aufrufen des Java-Service verwenden.

Vorbereitende Schritte

Fügen Sie vor der Erstellung des externen Service die JAR-Datei hinzu, die die benötigten Klassen enthält, wie im Abschnitt Verwaltete Dateien hinzufügenbeschrieben. Informationen zum Umfang der hochgeladenen JAR-Dateien finden Sie unter Externe Dateien verwalten.

Wenn die benötigten JAR-Dateien in einem Toolkit enthalten sind, können Sie eine Abhängigkeit zu diesem Toolkit hinzufügen, um auf diese Dateien zuzugreifen. Siehe Ändern von Toolkit-Abhängigkeiten.

Wichtig: Das Transaktionsverhalten für die Java-Integration des externen Service ist nicht garantiert und daher nicht definiert.

Informationen zu dieser Task

Um einen Java-Service im Designer zu verwenden, müssen Sie zuerst die Java-Klasse erkennen und anschließend einen externen Service daraus generieren. Der externe Service enthält Operationen mit Eingaben und Ausgaben, welche auf den Methoden in der erkannten Java-Klasse basieren. Wenn Sie einen Service erkennen und bereits ein entsprechender externer Service im Designer vorhanden ist, können Sie entweder den vorhandenen Service überschreiben oder einen neuen erstellen.

Führen Sie die nachfolgend aufgeführten Schritte aus, um eine Java-Klasse zu erkennen und einen externen Service zu erstellen.

  1. Erstellen Sie einen externen Service auf eine der folgenden Weisen.
    • Klicken Sie neben Services in der Bibliotheksnavigation auf das Pluszeichen (+). Wählen Sie Externer Service aus. Wählen Sie auf der Seite Neuer externer Service die Option Java-, REST- oder Web-Service aus.
    • Wählen Sie im Editor Service-Flow eine Task Service aus. Klicken Sie auf der Registerkarte Implementierung für den Service auf New. Wählen Sie auf der Seite Neuer externer Service die Option Vorhandenen Service erkennen aus.
  2. Wählen Sie die Option Java-Service über Serverdatei als Methode zur Erkennung eines Service aus.
  3. Klicken Sie neben Verwaltete Dateiauf Auswählen und wählen Sie die gewünschte Datei aus.
  4. Wählen Sie neben Java-Klasse die gewünschte Klasse aus der Dropdown-Liste aus. Klicken Sie auf Fertigstellen.
  5. Es wird ein externer Service mit einer Java-Bindung erstellt. Die Operationen und ihre Eingaben und Ausgaben basieren auf den Methoden in der erkannten Java-Klasse. Im Abschnitt Details wird der Servicename angezeigt. Sie können auch eine Dokumentation hinzufügen. Der erkannte Namensbereich wird angezeigt. Wenn Sie Binding auswählen, wird der Bindungstyp Java angezeigt. Klicken Sie auf einen Parameter und wählen Sie Bindung aus, damit der native Typ des Parameters angezeigt wird.
    Hinweis Ob eine Operation erfolgreich von einem Service-Flow aufgerufen werden kann, hängt von der Verknüpfung der Klasse, der Methode, den Parametertypen und dem Ergebnistyp der Methode ab:
    • Die Java-Klasse muss 'public' sein.
    • Die Methode muss 'public' sein.
    • Entweder muss die Methode 'static' sein oder die Java-Klasse muss einen öffentlichen Konstruktor ohne Argumente haben.
    • Alle Parametertypen sowie der Ergebnistyp (wenn nicht 'void') müssen eine der folgenden sein:
      Java-Typ Typ des Operationsparameters
      byte, Byte Integer
      short, Short Integer
      int, Integer Integer
      long, Long Decimal
      float, Float Decimal
      double, Double Decimal
      boolean, Boolean Boolean
      char, Character String
      String String
      java.util.Calendar Date
      org.jdom.Element XMLElement
      org.jdom.Document XMLDocument
      java.util.Map Map
Tipp: Da in kompilierten Klassen überprüfte Java-Methodensignaturen keine Informationen zu den Parameternamen enthalten, werden für sie generische Namen und Zahlen generiert, z. B. Parameter 1 (Zeichenfolge), Parameter 2 (Ganzzahl). Sie können BeanInfo-Klassen hinzufügen, die zusätzliche Informationen zu den Klassen und den zugehörigen Methoden zur Verfügung stellen.

Ergebnisse

Nachdem Ihr externer Service erstellt wurde, können Sie ihn als Implementierung eines Service in einem Service-Flow auswählen. Wählen Sie aus der Dropdown-Liste für Operationen die Operation aus, die Sie verwenden möchten, und ordnen Sie die Ein- und Ausgaben auf der Registerkarte Datenzuordnung zu. Siehe Service-Flow erstellen.

Wenn die Operation einen Parametertyp hat, der Map, XMLElementoder XMLDocumentist, verwenden Sie die JavaScript -API, um das Argument zu erstellen oder den Rückgabewert zu zerlegen.