Invocation de service

La classe CustomServiceClient obtient une référence à l'objet SystemGateway pour le système représenté par un identificateur Foo en appelant la méthode SystemGatewayFactory.getSystemGateway avec Foo comme argument. La méthode SystemGatewayFactory.getSystemGateway fournit donc un descripteur à n’importe quel système cible en spécifiant son systemId. Une fois que le descripteur est obtenu en tant qu'objet SystemGateway, il peut être utilisé pour appeler un service sur le système cible respectif. Voici le fragment de code correspondant de la classe CustomServiceClient :

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

• <RQ, RS> RS executeService(String serviceName, RQ serviceInput, Class<? extends ServiceGateway<RQ, RS>> gatewayClass) throws ServiceExecutionException
  Il s’agit d’une méthode générique qui fonctionne avec les paramètres de type RQ et RS. La signification de RQ et RS est la même que celle mentionnée précédemment. Cette méthode permet d'exécuter un service déjà déclaré. La méthode invocationDemo dans la classe CustomServiceClient illustre l’utilisation de cette méthode. Elle accepte les arguments suivants :

  • String serviceName

    Il doit s’agir du nom du service à exécuter. Le nom du service doit correspondre exactement à la déclaration correspondante dans le fichier de déclaration de service.

  • RQ serviceInput

    Il s’agit d’une entrée pour le service en cours d’exécution. Le paramètre de type RQ représente le type d’entrée requis pour le service appelé.

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

    Il doit être identique à la valeur de retour de la méthode getServiceInterface dans l'implémentation de service correspondante. Il permet à Content Integration Framework d’identifier l’entrée correcte pour le service en cours d’exécution et renvoie la sortie du type souhaité. Les paramètres de type RQ et RS utilisés pour l’argument gatewayClass représentent le type d’entrée fourni lors de l’appel de service et le type de réponse renvoyé par le service à la fin, respectivement.

  En cas de réussite, cette méthode renvoie l’objet de type représenté par le paramètre de type RS. Par conséquent, le troisième argument de la méthode executeService, gatewayClass , régit le type d’entrée qui entre dans le service et le type de valeur renvoyé par le service.

• <T> HttpResponse<T> executeService(HttpRequest request, Class<T> expectedResponse) throws ServiceExecutionException
  Il s’agit également d’une méthode générique, dans laquelle le paramètre de type T représente le type de réponse attendu par l’appel HTTP distant. Il permet d'effectuer un appel HTTP ad hoc sur le système cible sans déclarer de service explicite pour ce dernier dans le fichier de déclaration de service. La méthode adHocInvocationDemo de la classe CustomServiceClient illustre l’utilisation de cette méthode. Elle accepte les arguments répertoriés suivants :

  • Requête HTTPRequest

    Il doit s’agir d’un objet de la classe com.hcl.unica.system.model.request.HttpRequest. HttpRequest fournit une interface de générateur pour la construction de l’objet avec les détails requis. Cet objet encapsule essentiellement les détails requis pour effectuer un appel HTTP, tels que l’URL absolue, la méthode de requête HTTP, les en-têtes de requête HTTP et le corps de requête HTTP ou la charge de requête HTTP.

  • Class<T> expectedResponse

    Cela doit indiquer le type de réponse attendu par l'URL distante. Les types Jackson et JAXB peuvent également être utilisés. La désérialisation de JSON/XML se produira automatiquement dans ce cas.

  En cas de réussite, cette méthode renvoie l’objet com.hcl.unica.system.model.response.HttpResponse, en encapsulant l’objet de réponse à partir de l’appel distant. Le type de réponse encapsulé par HttpResponse sera le même que celui de l'argument expectedResponse de la méthode executeService. L'objet HttpResponse donne accès au code de statut de réponse HTTP, aux en-têtes de réponse et aux cookies de réponse, en plus de la charge de réponse.