Chamada de AEM Forms usando a API Java invoking-aem-forms-using-the-javaapi

Exemplos e exemplos neste documento são somente para AEM Forms no ambiente JEE.

O AEM Forms pode ser chamado usando a API Java do AEM Forms. Ao usar a API Java do AEM Forms, você pode usar a API de chamada ou as bibliotecas de cliente Java. As bibliotecas de cliente Java estão disponíveis para serviços como o serviço Rights Management. Essas APIs altamente tipificadas permitem desenvolver aplicativos Java que chamam o AEM Forms.

A API de Invocação são classes que estão no pacote com.adobe.idp.dsc. Usando essas classes, você pode enviar uma solicitação de chamada diretamente para um serviço e lidar com uma resposta de chamada retornada. Use a API de Invocação para chamar processos de vida curta ou longa criados com o Workbench.

A maneira recomendada de chamar um serviço programaticamente é usar uma biblioteca de cliente Java que corresponda ao serviço, em vez da API de chamada. Por exemplo, para chamar o Serviço de criptografia, use a biblioteca do cliente do Serviço de criptografia. Para executar uma operação do Serviço de criptografia, chame um método que pertença ao objeto cliente do Serviço de criptografia. Você pode criptografar um documento PDF com uma senha invocando o método encryptPDFUsingPassword do objeto EncryptionServiceClient.

A API Java é compatível com os seguintes recursos:

Inclusão de arquivos da biblioteca Java do AEM Forms

Chamar processos de longa vida centrados no ser humano

Chamar o AEM Forms usando serviços da Web

Definindo propriedades de conexão

Passagem de dados para serviços da AEM Forms usando a API do Java

Chamar um serviço usando uma biblioteca cliente Java

Chamar um processo de vida curta usando a API de chamada

Criar uma aplicação Web Java que invoca um processo de longa vida centrado no ser humano

Inclusão de arquivos da biblioteca Java do AEM Forms including-aem-forms-java-library-files

Para chamar programaticamente um serviço AEM Forms usando a API Java, inclua os arquivos de biblioteca necessários (arquivos JAR) no classpath do projeto Java. Os arquivos JAR incluídos no classpath do aplicativo cliente dependem de vários fatores:

Arquivos JAR específicos do serviço service-specific-jar-files

A tabela a seguir lista os arquivos JAR necessários para chamar os serviços do AEM Forms.

Modo de conexão e arquivos JAR da aplicação J2EE connection-mode-and-j2ee-application-jar-files

A tabela a seguir lista os arquivos JAR que dependem do modo de conexão e do servidor da aplicação J2EE no qual o AEM Forms é disponibilizado.

Chamar cenários invoking-scenarios

A tabela a seguir especifica cenários de chamada e lista os arquivos JAR necessários para chamar o AEM Forms com êxito.

Atualizando arquivos JAR upgrading-jar-files

Se você estiver atualizando do LiveCycle para o AEM Forms, é recomendável incluir os arquivos JAR do AEM Forms no caminho de classe do projeto Java. Por exemplo, se estiver usando serviços como o serviço Rights Management, você encontrará um problema de compatibilidade se não incluir arquivos JAR do AEM Forms no caminho da classe.

Supondo que você esteja atualizando para o AEM Forms. Para usar um aplicativo Java que chama o serviço Rights Management, inclua as versões AEM Forms dos seguintes arquivos JAR:

Consulte também

Chamada de AEM Forms usando a API Java

Definindo propriedades de conexão

Passagem de dados para serviços da AEM Forms usando a API do Java

Chamar um serviço usando uma biblioteca cliente Java

Definindo propriedades de conexão setting-connection-properties

Você define propriedades de conexão para chamar o AEM Forms ao usar a API Java. Ao definir as propriedades de conexão, especifique se os serviços devem ser chamados remota ou localmente e também especifique o modo de conexão e os valores de autenticação. Os valores de autenticação serão necessários se a segurança do serviço estiver habilitada. No entanto, se a segurança do serviço estiver desativada, não será necessário especificar valores de autenticação.

O modo de conexão pode ser SOAP ou EJB. O modo EJB usa o protocolo RMI/IIOP e o desempenho do modo EJB é melhor do que o desempenho do modo SOAP. O modo SOAP é usado para eliminar uma dependência do servidor de aplicativos J2EE ou quando um firewall é localizado entre o AEM Forms e o aplicativo cliente. O modo SOAP usa o protocolo https como transporte subjacente e pode se comunicar entre limites de firewall. Se nem uma dependência do servidor de aplicações J2EE nem um firewall for um problema, é recomendável usar o modo EJB.

Para chamar um serviço AEM Forms com êxito, defina as seguintes propriedades de conexão:

Para definir propriedades de conexão, execute as seguintes tarefas:

Definindo o modo de conexão EJB para JBoss

O exemplo de código Java a seguir define propriedades de conexão para chamar o AEM Forms implantado em JBoss e usando o modo de conexão EJB.

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "https://<hostname>:8080");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DOCUMENT_HTTP_ENDPOINT,"https://<hostname>:8080");

Definindo o modo de conexão EJB para WebLogic

O exemplo de código Java a seguir define propriedades de conexão para chamar o AEM Forms implantado no WebLogic e usando o modo de conexão EJB.

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "t3://localhost:7001");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "WebLogic");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");

Definindo o modo de conexão EJB para WebSphere

O exemplo de código Java a seguir define propriedades de conexão para chamar o AEM Forms implantado no WebSphere e usando o modo de conexão EJB.

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "iiop://localhost:2809");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "WebSphere");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");

Definindo o modo de conexão SOAP

O exemplo de código Java a seguir define propriedades de conexão no modo SOAP para chamar o AEM Forms implantado no JBoss.

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "http://localhost:8080");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");

Definindo propriedades de conexão quando a segurança do serviço estiver desabilitada

O exemplo de código Java a seguir define as propriedades de conexão necessárias para chamar o AEM Forms implantado no JBoss Application Server e quando a segurança do serviço está desativada.

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://localhost:1099");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");

Definindo o modo de conexão SOAP com o tempo limite de solicitação personalizada

 Properties ConnectionProps = new Properties();
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "http://localhost:8080");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
 ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_REQUEST_TIMEOUT, "1800000"); // Request timeout limit 30 Minutes

Usando um objeto Context para invocar o AEM Forms

Você pode usar um objeto com.adobe.idp.Context para invocar um serviço AEM Forms com um usuário autenticado (o objeto com.adobe.idp.Context representa um usuário autenticado). Ao usar um objeto com.adobe.idp.Context, não é necessário definir as propriedades DSC_CREDENTIAL_USERNAME ou DSC_CREDENTIAL_PASSWORD. Você pode obter um objeto com.adobe.idp.Context ao autenticar usuários usando o método authenticate do objeto AuthenticationManagerServiceClient.

O método authenticate retorna um objeto AuthResult que contém os resultados da autenticação. Você pode criar um objeto com.adobe.idp.Context chamando seu construtor. Em seguida, chame o método initPrincipal do objeto com.adobe.idp.Context e passe o objeto AuthResult, como mostrado no código a seguir:

 Context myCtx = new Context();
 myCtx.initPrincipal(authResult);

Em vez de definir as propriedades DSC_CREDENTIAL_USERNAME ou DSC_CREDENTIAL_PASSWORD, você pode invocar o método setContext do objeto ServiceClientFactory e passar o objeto com.adobe.idp.Context. Ao usar um usuário de formulários AEM para invocar um serviço, verifique se ele tem a função chamada Services User que é necessária para invocar um serviço do AEM Forms.

O código a seguir mostra como usar um objeto com.adobe.idp.Context nas configurações de conexão usadas para criar um objeto EncryptionServiceClient.

 //Authenticate a user and use the Context object within connection settings
 // Authenticate the user
 String username = "wblue";
 String password = "password";
 AuthResult authResult = authClient.authenticate(username, password.getBytes());

 //Set a Content object that represents the authenticated user
 //Use the Context object to invoke the Encryption service
 Context myCtx = new Context();
 myCtx.initPrincipal(authResult);

 //Set connection settings
 Properties connectionProps = new Properties();
 connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://<server>:1099");
 connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL, ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
 connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, ServiceClientFactoryProperties.DSC_JBOSS_SERVER_TYPE);
 connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DOCUMENT_HTTP_ENDPOINT,"jnp://<server>:1099");


 //Create a ServiceClientFactory object
 ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps);
 myFactory.setContext(myCtx);

 //Create an EncryptionServiceClient object
 EncryptionServiceClient encryptClient  = new EncryptionServiceClient(myFactory);

Chamar cenários invoking_scenarios-1

Os cenários de chamada a seguir são discutidos nesta seção:

Aplicativo cliente que invoca uma instância autônoma do AEM Forms client-application-invoking-a-stand-alone-aem-forms-instance

O diagrama a seguir mostra uma aplicação cliente sendo executada em sua própria JVM e chamando uma instância independente do AEM Forms.

Nesse cenário, um aplicativo cliente é executado em sua própria JVM e chama os serviços da AEM Forms.

Aplicativo cliente que invoca instâncias AEM Forms clusterizadas client-application-invoking-clustered-aem-forms-instances

O diagrama a seguir mostra uma aplicação cliente sendo executada em sua própria JVM e chamando instâncias do AEM Forms em um cluster.

Esse cenário é semelhante a um aplicativo cliente que chama uma instância AEM Forms independente. No entanto, o URL do provedor é diferente. Se um aplicativo cliente quiser se conectar a um servidor de aplicativos J2EE específico, o aplicativo deverá alterar o URL para fazer referência ao servidor de aplicativos J2EE específico.

Não é recomendável fazer referência a um servidor de aplicativos J2EE específico porque a conexão entre o aplicativo cliente e o AEM Forms será encerrada se o servidor de aplicativos for interrompido. Recomenda-se que o URL do provedor faça referência a um gerenciador JNDI no nível da célula, em vez de um servidor de aplicativos J2EE específico.

Os aplicativos clientes que usam o modo de conexão SOAP podem usar a porta do balanceador de carga HTTP para o cluster. As aplicações clientes que usam o modo de conexão EJB podem se conectar à porta EJB de um servidor de aplicações J2EE específico. Esta ação lida com o Balanceamento de Carga entre nós de cluster.

WebSphere

O exemplo a seguir mostra o conteúdo de um arquivo jndi.properties usado para se conectar ao AEM Forms que é implantado no WebSphere.

 java.naming.factory.initial=com.ibm.websphere.naming.
 WsnInitialContextFactory
 java.naming.provider.url=corbaloc::appserver1:9810,:appserver2:9810

WebLogic

O exemplo a seguir mostra o conteúdo de um arquivo jndi.properties usado para se conectar a AEM Forms que é implantado no WebLogic.

 java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory
 java.naming.provider.url=t3://appserver1:8001, appserver2:8001

JBoss

O exemplo a seguir mostra o conteúdo de um arquivo jndi.properties usado para se conectar a AEM Forms que é implantado no JBoss.

 java.naming.factory.initial= org.jnp.interfaces.NamingContextFactory
 java.naming.provider.url= jnp://appserver1:1099, appserver2:1099,
 appserver3:1099

Consulte também

Inclusão de arquivos biblioteca Java AEM Forms

Passar dados para serviços AEM Forms usando a API Java

Invocando um serviço usando um biblioteca do cliente Java

Passar dados para serviços AEM Forms usando a API Java passing-data-to-aem-forms-services-using-the-java-api

As operações de serviço da AEM Forms normalmente consomem ou produzem documentos PDF. Quando você chama um serviço, às vezes é necessário passar um documento PDF (ou outros tipos de documento, como dados XML) para o serviço. Da mesma forma, às vezes é necessário manipular um documento PDF que é retornado do serviço. A classe Java que permite que você passe dados de e para serviços AEM Forms é com.adobe.idp.Document.

Os serviços AEM Forms não aceitam um documento PDF como outros tipos de dados, como um objeto java.io.InputStream ou uma matriz de bytes. Um objeto com.adobe.idp.Document também pode ser usado para passar outros tipos de dados, como dados XML, para serviços.

Um objeto com.adobe.idp.Document é um tipo serializável Java, portanto, pode ser passado por uma chamada RMI. O lado receptor pode ser colocado (mesmo host, mesmo carregador de classe), local (mesmo host, carregador de classe diferente) ou remoto (host diferente). A transmissão do conteúdo do documento é otimizada para cada caso. Por exemplo, se o remetente e o destinatário estiverem localizados no mesmo host, o conteúdo será transmitido por um sistema de arquivos local. (Em alguns casos, os documentos podem ser transmitidos na memória.)

Dependendo do tamanho do objeto com.adobe.idp.Document, os dados são transportados dentro do objeto com.adobe.idp.Document ou armazenados no sistema de arquivos do servidor. Quaisquer recursos de armazenamento temporário ocupados pelo objeto com.adobe.idp.Document são removidos automaticamente após o descarte de com.adobe.idp.Document. (Consulte Descartando objetos Document.)

Às vezes, é necessário conhecer o tipo de conteúdo de um objeto com.adobe.idp.Document antes de passá-lo para um serviço. Por exemplo, se uma operação requer um tipo de conteúdo específico, como application/pdf, é recomendável determinar o tipo de conteúdo. (Consulte Determinando o tipo de conteúdo de um documento.)

O objeto com.adobe.idp.Document tenta determinar o tipo de conteúdo usando os dados fornecidos. Se o tipo de conteúdo não puder ser recuperado dos dados fornecidos (por exemplo, quando os dados tiverem sido fornecidos como uma matriz de bytes), defina o tipo de conteúdo. Para definir o tipo de conteúdo, chame o método setContentType do objeto com.adobe.idp.Document. (Consulte Determinando o tipo de conteúdo de um documento)

Se os arquivos auxiliares residirem no mesmo sistema de arquivos, a criação de um objeto com.adobe.idp.Document será mais rápida. Se os arquivos auxiliares residirem em sistemas de arquivos remotos, uma operação de cópia deverá ser feita, o que afeta o desempenho.

Um aplicativo pode conter os tipos de dados com.adobe.idp.Document e org.w3c.dom.Document. No entanto, certifique-se de qualificar totalmente o tipo de dados org.w3c.dom.Document. Para obter informações sobre como converter um objeto org.w3c.dom.Document em um objeto com.adobe.idp.Document, consulte Início Rápido (modo EJB): Pré-preenchendo o Forms com Layouts Fluxáveis usando a API Java.

        // Set up the chunk size to prevent a potential memory leak
        int buffSize = 2048;

        // Determine the total number of bytes to read
        int docLength = (int) inDoc.length();
        byte [] byteDoc = new byte[docLength];

        // Set up the reading position
        int pos = 0;

        // Loop through the document information, 2048 bytes at a time
        while (docLength > 0) {
      // Read the next chunk of information
            int toRead = Math.min(buffSize, docLength);
            int bytesRead = inDoc.read(pos, byteDoc, pos, toRead);

            // Handle the exception in case data retrieval failed
            if (bytesRead == -1) {

                inDoc.doneReading();
                inDoc.dispose();
                throw new RuntimeException("Data retrieval failed!");

            }

             // Update the reading position and number of bytes remaining
             pos += bytesRead;
             docLength -= bytesRead;

        }

        // The document information has been successfully read
        inDoc.doneReading();
        inDoc.dispose();

Consulte também

Chamada de AEM Forms usando a API Java

Definindo propriedades de conexão

Criação de documentos creating-documents

Crie um objeto com.adobe.idp.Document antes de invocar uma operação de serviço que requer um documento PDF (ou outros tipos de documento) como um valor de entrada. A classe com.adobe.idp.Document fornece construtores que permitem criar um documento a partir dos seguintes tipos de conteúdo:

Criando um documento baseado em uma matriz de bytes creating-a-document-based-on-a-byte-array

O código de exemplo a seguir cria um objeto com.adobe.idp.Document que é baseado em uma matriz de bytes.

Criando um objeto Document baseado em uma matriz de bytes

 Document myPDFDocument = new Document(myByteArray);

Criando um documento baseado em outro documento creating-a-document-based-on-another-document

O código de exemplo a seguir cria um objeto com.adobe.idp.Document que é baseado em outro objeto com.adobe.idp.Document.

Criando um objeto Documento baseado em outro documento

 //Create a Document object based on a byte array
 InputStream is = new FileInputStream("C:\\Map.pdf");
 int len = is.available();
 byte [] myByteArray = new byte[len];
 int i = 0;
 while (i < len) {
       i += is.read(myByteArray, i, len);
 }
 Document myPDFDocument = new Document(myByteArray);

 //Create another Document object
 Document anotherDocument = new Document(myPDFDocument);

Criação de um documento baseado em um arquivo creating-a-document-based-on-a-file

O código de exemplo a seguir cria um objeto com.adobe.idp.Document que é baseado em um arquivo PDF chamado map.pdf. Esse arquivo está na raiz do disco rígido C. Este construtor tenta definir o tipo de conteúdo MIME do objeto com.adobe.idp.Document usando a extensão de nome de arquivo.

O construtor com.adobe.idp.Document que aceita um objeto java.io.File também aceita um parâmetro Booleano. Ao definir este parâmetro como true, o objeto com.adobe.idp.Document exclui o arquivo. Esta ação significa que não é necessário remover o arquivo após passá-lo para o construtor com.adobe.idp.Document.

Configurar este parâmetro para false significa que você retém a propriedade deste arquivo. A definição deste parâmetro para true é mais eficiente. O motivo é que o objeto com.adobe.idp.Document pode mover o arquivo diretamente para a área gerenciada local em vez de copiá-lo (que é mais lento).

Criando um objeto Document baseado em um arquivo PDF

 //Create a Document object based on the map.pdf source file
 File mySourceMap = new File("C:\\map.pdf");
 Document myPDFDocument = new Document(mySourceMap,true);

Criando um documento com base em um objeto InputStream creating-a-document-based-on-an-inputstream-object

O código Java a seguir cria um objeto com.adobe.idp.Document que é baseado em um objeto java.io.InputStream.

Criando um documento com base em um objeto InputStream

 //Create a Document object based on an InputStream object
 InputStream is = new FileInputStream("C:\\Map.pdf");
 Document myPDFDocument = new Document(is);

Criar um documento com base no conteúdo acessível de um URL creating-a-document-based-on-content-accessible-from-an-url

O exemplo de código Java a seguir cria um objeto com.adobe.idp.Document que é baseado em um arquivo PDF chamado map.pdf. Este arquivo está localizado em um aplicativo Web chamado WebApp que está em execução em localhost. Este construtor tenta definir o tipo de conteúdo MIME do objeto com.adobe.idp.Document usando o tipo de conteúdo retornado com o protocolo de URL.

A URL fornecida para o objeto com.adobe.idp.Document é sempre lida no lado onde o objeto com.adobe.idp.Document original é criado, conforme mostrado neste exemplo:

     Document doc = new Document(new java.net.URL("file:c:/temp/input.pdf"));

O arquivo c:/temp/input.pdf deve estar localizado no computador cliente (não no computador servidor). O computador cliente é onde o URL é lido e onde o com.adobe.idp.Document objeto foi criado.

Criar um documento baseado em conteúdo acessíveis a partir de uma URL

 //Create a Document object based on a java.net.URL object
 URL myURL = new URL("http", "localhost", 8080,"/WebApp/map.pdf");

 //Create another Document object
 Document myPDFDocument = new Document(myURL);

Consulte também

Chamada de AEM Forms usando a API Java

Definindo propriedades de conexão

Manuseio de documentos retornados handling-returned-documents

Operações de serviço que retornam uma documento PDF (ou outros tipos de dados, como dados XML), à medida que um valor de saída retorna um com.adobe.idp.Document objeto. Depois de receber um com.adobe.idp.Document objeto, é possível converter-lo nos seguintes formatos:

A linha de código a seguir converte um objeto com.adobe.idp.Document em um objeto java.io.InputStream. Suponha que myPDFDocument represente um objeto com.adobe.idp.Document:

     java.io.InputStream resultStream = myDocument.getInputStream();

Da mesma forma, você pode copiar o conteúdo de um com.adobe.idp.Document para um arquivo local executando as seguintes tarefas:

O exemplo de código a seguir copia o conteúdo de um objeto com.adobe.idp.Document para um arquivo chamado AnotherMap.pdf.

Copiando o conteúdo de um objeto de documento para um arquivo

 File outFile = new File("C:\\AnotherMap.pdf");
 myDocument.copyToFile (outFile);

Consulte também

Chamada de AEM Forms usando a API Java

Definindo propriedades de conexão

Determinar o tipo de conteúdo de um documento determining-the-content-type-of-a-document

Determine o tipo MIME de um objeto com.adobe.idp.Document invocando o método getContentType do objeto com.adobe.idp.Document. Este método retorna um valor de cadeia de caracteres que especifica o tipo de conteúdo do objeto com.adobe.idp.Document. A tabela a seguir descreve os diferentes tipos de conteúdo que o AEM Forms retorna.

O código de exemplo a seguir determina o tipo de conteúdo de um objeto com.adobe.idp.Document.

Determinando o tipo de conteúdo de um objeto do Documento

 //Determine the content type of the Document object
 String ct = myDocument.getContentType();
 System.out.println("The content type of the Document object is " +ct);

Consulte também

Chamada de AEM Forms usando a API Java

Definindo propriedades de conexão

Descartando objetos de documento disposing-document-objects

Quando você não precisar mais de um objeto Document, é recomendável descartá-lo invocando seu método dispose. Cada objeto Document consome um descritor de arquivo e até 75 MB de espaço RAM na plataforma host do aplicativo. Se um objeto Document não for descartado, o processo de coleta do Java Garage o descartará. Entretanto, ao descartá-la antes usando o método dispose, você poderá liberar a memória ocupada pelo objeto Document.

Consulte também

Chamada de AEM Forms usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Chamar um serviço usando uma biblioteca cliente Java

Chamar um serviço usando uma biblioteca cliente Java invoking-a-service-using-a-java-client-library

As operações de serviço do AEM Forms podem ser chamadas usando uma API altamente tipada do serviço, que é conhecida como uma biblioteca de cliente Java. Uma biblioteca cliente Java é um conjunto de classes concretas que fornecem acesso aos serviços implantados no contêiner de serviço. Você instancia um objeto Java que representa o serviço a ser chamado em vez de criar um objeto InvocationRequest usando a API de chamada. A API de chamada é usada para chamar processos, como processos de longa duração, criados no Workbench. (Consulte Chamar Processos De Longa Vida Centrados No Ser Humano.)

Para executar uma operação de serviço, chame um método que pertence ao objeto Java. Uma biblioteca cliente Java contém métodos que normalmente mapeiam de um para um com operações de serviço. Ao usar uma biblioteca cliente Java, defina as propriedades de conexão necessárias. (Consulte Definindo propriedades de conexão.)

Depois de definir as propriedades de conexão, crie um objeto ServiceClientFactory que seja usado para instanciar um objeto Java que permita chamar um serviço. Cada serviço que tem uma biblioteca cliente Java tem um objeto cliente correspondente. Por exemplo, para invocar o serviço do Repositório, crie um objeto ResourceRepositoryClient usando seu construtor e transmitindo o objeto ServiceClientFactory. O objeto ServiceClientFactory é responsável por manter as configurações de conexão necessárias para chamar os serviços AEM Forms.

Embora a obtenção de um ServiceClientFactory seja tipicamente rápida, alguma sobrecarga é envolvida quando a fábrica é usada pela primeira vez. Esse objeto é otimizado para reutilização e, portanto, quando possível, use o mesmo objeto ServiceClientFactory quando estiver criando vários objetos cliente Java. Ou seja, não crie um objeto ServiceClientFactory separado para cada objeto da biblioteca do cliente que você criar.

Há uma configuração do Gerenciador de Usuários que controla o tempo de vida da declaração SAML que está dentro do objeto com.adobe.idp.Context que afeta o objeto ServiceClientFactory. Essa configuração controla toda a vida útil do contexto de autenticação em todo o AEM Forms, incluindo todas as chamadas executadas usando a API Java. Por padrão, o período em que um objeto ServiceCleintFactory pode ser usado é de duas horas.

Você pode invocar o serviço de repositório usando um biblioteca do cliente Java e executando as seguintes etapas:

Consulte também

Início rápido (modo EJB): Gravação de um recurso usando a API Java

Chamada de AEM Forms usando a API Java

Inclusão de arquivos da biblioteca Java do AEM Forms

Chamar um processo de vida curta usando a API de chamada invoking-a-short-lived-process-using-the-invocation-api

Você pode chamar um processo de curta duração usando a API de chamada Java. Ao invocar um processo de curta duração usando a API de Invocação, você passa os valores de parâmetro necessários usando um objeto java.util.HashMap. Para cada parâmetro a ser transmitido para um serviço, chame o método put do objeto java.util.HashMap e especifique o par nome-valor necessário para que o serviço execute a operação especificada. Especifique o nome exato dos parâmetros que pertencem ao processo de vida curta.

A discussão aqui é sobre o uso da API de Invocação para invocar o seguinte processo de vida curta do AEM Forms chamado MyApplication/EncryptDocument.

Quando esse processo é chamado, ele executa as seguintes ações:

Chame o processo de curta duração MyApplication/EncryptDocument usando a API de invocação Java invoke-the-myapplication-encryptdocument-short-lived-process-using-the-java-invocation-api

Chame o processo de curta duração MyApplication/EncryptDocument usando a API de invocação Java:

Consulte também

Início Rápido: Chamar um processo de vida curta usando a API de Chamada

Chamar processos de longa vida centrados no ser humano

Inclusão de arquivos da biblioteca Java do AEM Forms