Contêiner de serviço service-container

Permite que os serviços da AEM Forms sejam chamados usando métodos diferentes. Você pode configurar um serviço definindo endpoints para que ele possa ser chamado usando todos os métodos: Remoting, a API do Java, serviços da Web e REST. (Consulte Gerenciando Pontos De Extremidade Programaticamente.)

Converte uma mensagem em um formato normalizado chamado solicitação de invocação. Uma solicitação de invocação é enviada de um aplicativo cliente (ou outro serviço) para um serviço no contêiner de serviço. Uma solicitação de chamada contém informações como o nome do serviço a ser chamado e os valores de dados necessários para executar a operação. Muitos serviços exigem um documento para executar uma operação. Portanto, uma solicitação de chamada geralmente contém um documento, que pode ser dados PDF, dados XDP, dados XML e assim por diante.

Encaminha solicitações de invocação para serviços apropriados (o nome do serviço a ser chamado faz parte da solicitação de invocação).

Executa tarefas, como determinar se o chamador tem permissão para invocar a operação de serviço especificada. A solicitação de invocação deve conter um nome de usuário e uma senha válidos para formulários AEM.

Há diferentes maneiras de enviar uma solicitação de invocação para um serviço. Além disso, há diferentes maneiras de enviar valores de entrada necessários para o serviço. Por exemplo, suponha que você use a API Java para chamar um serviço que requer um documento PDF. O método Java correspondente contém um parâmetro que aceita um documento PDF. Nessa situação, o tipo de dados do parâmetro é com.adobe.idp.Document. (Consulte Passando dados para serviços da AEM Forms usando a API Java.)

Se você chamar um serviço usando pastas monitoradas, uma solicitação de invocação será enviada quando você colocar um arquivo em uma pasta monitorada configurada. Se você chamar um serviço usando o email, uma solicitação de invocação será enviada para um serviço quando uma mensagem de email chegar em uma caixa de entrada configurada.

O contêiner de serviço retorna uma resposta de invocação depois que a operação é executada. Uma resposta de chamada contém informações como os resultados da operação. Por exemplo, se a operação modificar um documento PDF, a resposta de chamada conterá o documento PDF modificado. Se a operação não foi bem-sucedida, a resposta de invocação contém uma mensagem de erro.

Uma resposta de invocação pode ser recuperada da mesma forma que uma solicitação de invocação é enviada. Ou seja, se a solicitação de chamada for enviada usando a API Java, uma resposta de chamada poderá ser recuperada usando a API Java. Suponha, por exemplo, que uma operação modifique um documento PDF. Você pode recuperar o documento de PDF modificado obtendo o valor de retorno do método Java que chamou o serviço.

Quando um processo de longa duração é chamado, uma resposta de chamada contém um valor identificador associado à solicitação de chamada. Usando esse valor de identificador, você pode verificar o status do processo posteriormente. Por exemplo, considere o serviço de longa vida do MortgageLoan. Usando o valor do identificador, você pode verificar se o processo foi concluído com êxito. (Consulte Chamar Processos De Longa Vida Centrados No Ser Humano.)

O diagrama a seguir mostra uma aplicação cliente (que usa a API Java) chamando um serviço.

Quando um aplicativo cliente chama um serviço, ocorrem três eventos:

1. Um aplicativo cliente envia uma solicitação de invocação a um serviço.
2. O serviço executa a operação especificada na solicitação de invocação.
3. O contêiner de serviço retorna uma resposta de invocação ao aplicativo cliente.