Adapter bieten bestimmte Funktionen, die sich im X4 Designer in der Properties-Sicht über die Eigenschaft Operation auswählen lassen. Jeder Listeneintrag dieses Auswahlmenüs entspricht einer Operation-Methode im Adapter.
Ein Adapter benötigt mindestens eine Operation. Verfügt der Adapter nur über eine einzige Operation, so wird diese im Prozess-Designer automatisch ausgewählt.
Methoden zu Operationen zuordnen
-
Für jede Operation die Annotation
@AdapterOperationfür die Deklaration an einepublic-Methode in der Adapter-Klasse angeben. -
Parameter definieren.
-
Jede Methode kann optional einen Parameter definieren. Dieser entspricht dem Adapter-Input.
-
Der Rückgabetyp der Methode kann
X4Documentoder eine JAXB-konforme Java-Bean sein. Ist der Rückgabetypvoid, wird der Input als Output betrachtet. -
Um Java-Beans benutzen zu können, muss der Input XML und konform zur Java-Bean-Definition sein. Andernfalls wird die Adapter-Ausführung mit dem Status
-1abgebrochen.
Das Grundgerüst einer Operation-Methode ist nun fertig.
-
Metadaten für Adapter-Operation definieren
Um Metadaten für Adapter-Operationen zu definieren, wird die Annotation @AdapterOperation verwendet:
|
Feld |
Beschreibung |
|---|---|
|
|
Gibt den Namen der Operation an und kann frei gewählt werden. Er muss jedoch eindeutig pro Adapter sein. |