Serviceaufruf

private SystemGateway systemGateway = SystemGatewayFactory.getSystemGateway("Foo");

• <RQ, RS> RS executeService(String serviceName, RQ serviceInput, Class<? erweitert ServiceGateway<RQ, RS>> gatewayClass) löst ServiceExecutionException aus
  Dies ist eine generische Methode, die mit den Typparametern RQ & RS arbeitet. Die Bedeutung von RQ & RS ist identisch mit der zuvor erwähnten. Diese Methode hilft bei der Ausführung eines bereits deklarierten Dienstes. Die invocationDemo-Methode in der CustomServiceClient-Klasse demonstriert die Verwendung dieser Methode. Sie akzeptiert die folgenden Argumente:

  • Zeichenkette serviceName

    Dies muss der Name des Service sein, der ausgeführt werden soll. Der Name des Dienstes muss genau mit der entsprechenden Deklaration in der Dienstdeklarationsdatei übereinstimmen.

  • RQ serviceInput

    Dies ist eine Eingabe für den Service, der ausgeführt wird. Der Typparameter des Typs RQ stellt den Typ der Eingabe dar, die für den aufgerufenen Service erforderlich ist

  • Class<? extends ServiceGateway<RQ, RS>> gatewayClass

    Er muss mit dem Rückgabewert der getServiceInterface-Methode in der entsprechenden Service-Implementierung übereinstimmen. Er hilft Content Integration Framework bei der Ermittlung der richtigen Eingabe für den Service, der ausgeführt wird, und gibt die gewünschte Ausgabe zurück. Die Parameter RQ und RS, die für das gatewayClass-Argument verwendet werden, stellen den Typ der Eingabe dar, die für den Serviceaufruf und den Antworttyp bereitgestellt wird, der vom Service beim Abschluss zurückgegeben wurde.

  Bei erfolgreichem Abschluss gibt diese Methode das Objekt des Typs zurück, das durch den Typparameter RS dargestellt wird. Daher regelt das dritte Argument für die executeService-Methode, gatewayClass, den Typ der Eingabe, der in den Service fließt, und den Wertentyp, den der Service zurückgibt.

• <T> HttpResponse<T> executeService(HttpRequest request, Class<T> expectedResponse) throws ServiceExecutionException
  Dabei handelt es sich außerdem um eine generische Methode, bei der der Typparameter T den Typ der Antwort darstellt, die vom entfernten HTTP-Aufruf erwartet wird. Es hilft Ihnen dabei, eine schreibübergreifende HTTP auf das Zielsystem zu erstellen, ohne einen expliziten Service dafür in der Dienstdeklarations-Datei zu deklarieren. Die adHocInvocationDemo-Methode in der CustomServiceClient-Klasse demonstriert die Verwendung dieser Methode. Es werden die folgenden aufgelisteten Argumente akzeptiert:

  • HttpRequest-Anforderung

    Dies muss ein Objekt der com.hcl.unica.system.model.request.HttpRequest-Klasse sein. HttpRequest stellt eine Builderschnittstelle für das Konstruieren des Objekts mit den erforderlichen Details bereit. Dieses Objekt enthält im Wesentlichen die Details, die für die Erstellung einer HTTP erforderlich sind, wie z. B. absolute URL, HTTP-Anforderungsmethode, HTTP- Anforderungsheader & HTTP-Anforderungstext oder HTTP-Anforderungsnutzdaten

  • Klasse<T> expectedResponse

    Hier muss der Antworttyp angegeben werden, der von der fernen URL erwartet wird. Es können auch die Typen Jackson und JAXB eingesetzt werden. Die Deserialisierung von JSON/XML wird in diesem Fall automatisch erfolgen.

  Nach erfolgreichem Abschluss gibt diese Methode das Objekt com.hcl.unica.system.model.response.HttpResponse zurück, wobei das Antwortobjekt aus dem fernen Aufruf gekapselt wird. Der Antworttyp, der von HttpResponse eingekapselt wird, ist mit dem expectedResponse-Argument für die executeService-Methode identisch. Das HttpResponse-Objekt ermöglicht den Zugriff auf die HTTP- Antwortstatuscode, Antwortheader und Antwortcookies , zusätzlich zu den Antwortnutzdaten.