AEM Forms peut être appelé à l’aide de l’API Java d’AEM Forms. Lorsque vous utilisez l’API Java d’AEM Forms, vous pouvez utiliser l’API d’appel ou les bibliothèques client Java. Des bibliothèques client Java sont disponibles pour des services tels que le service Rights Management. Ces API fortement typées vous permettent de développer des applications Java qui appellent AEM Forms.
Les API d’appel sont des classes situées dans le package com.adobe.idp.dsc
. À l’aide de ces classes, vous pouvez envoyer une demande d’appel directement à un service et traiter une réponse d’appel retournée. Utilisez l’API d’appel pour appeler les processus à durée de vie courte ou longue créés à l’aide de Workbench.
La méthode recommandée pour appeler un service par programmation consiste à utiliser une bibliothèque client Java correspondant au service, par opposition à l’API d’appel. Par exemple, pour appeler le service Encryption, utilisez la bibliothèque client du service Encryption. Pour effectuer une opération de service Encryption, appelez une méthode appartenant à l’objet client du service Encryption. Vous pouvez chiffrer un document PDF avec un mot de passe en appelant la méthode de l’objet EncryptionServiceClient
encryptPDFUsingPassword
.
L’API Java prend en charge les fonctionnalités suivantes :
Site Web d’Adobe Developer
Le site Web d’Adobe Developer contient les articles suivants traitant de l’appel des services AEM Forms à l’aide de l’API Java :
Utilisation des servlets Java pour appeler les processus AEM Forms
Appel de l’API AEM Forms Distiller de Java
Voir également
Inclusion des fichiers de bibliothèque Java AEM Forms
Appel de processus pour des intervenants humains de longue durée
Appel d’AEM Forms utilisant des services Web
Réglage des propriétés de la connexion
Transmission de données vers les services AEM Forms à l’aide de l’API Java
Appel d’un service à l’aide d’une bibliothèque client Java
Appel d’un processus de courte durée en utilisant l’API d’appel
Pour appeler un service AEM Forms par programmation à l’aide de l’API Java, incluez les fichiers de bibliothèque requis (fichiers JAR) dans le chemin d’accès aux classes de votre projet Java. Les fichiers JAR que vous incluez dans le chemin d’accès aux classes de votre application client dépendent de plusieurs facteurs :
(Clé en main uniquement) Début le serveur AEM Forms avec la commande standalone.bat -b <Server IP> -c lc_turnkey.xml
pour spécifier une adresse IP de serveur pour EJB.
Le tableau suivant énumère les fichiers JAR qui sont nécessaires pour appeler les services AEM Forms.
File |
Description |
Emplacement |
---|---|---|
adobe-livecycle-client.jar |
Doit toujours être inclus dans le chemin d’accès aux classes d’une application client Java. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-usermanager-client.jar |
Doit toujours être inclus dans le chemin d’accès aux classes d’une application client Java. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-utilities.jar |
Doit toujours être inclus dans le chemin d’accès aux classes d’une application client Java. |
<répertoire d’installation>/sdk//client-libs/<app server> |
adobe-applicationmanager-client-sdk.jar |
Requis pour appeler le service Application Manager. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-assembler-client.jar |
Requis pour appeler le service Assembler. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-backup-restore-client-sdk.jar |
Requis pour appeler l’API du service Backup and Restore. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-barcodedforms-client.jar |
Requis pour appeler le service Barcoded Forms. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-convertpdf-client.jar |
Requis pour appeler le service Convert PDF. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-distiller-client.jar |
Requis pour appeler le service Distiller. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-docconverter-client.jar |
Requis pour appeler le service DocConverter. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-contentservices-client.jar |
Requis pour appeler le service Document Management. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-encryption-client.jar |
Requis pour appeler le service Encryption. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-forms-client.jar |
Requis pour appeler le service Forms. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-formdataintegration-client.jar |
Requis pour appeler le service Form Data Integration. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-generatepdf-client.jar |
Requis pour appeler le service Generate PDF. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-generate3dpdf-client.jar |
Requis pour appeler le service Generate 3D PDF. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-jobmanager-client-sdk.jar |
Requis pour appeler le service Job Manager. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-output-client.jar |
Requis pour appeler le service Output. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-pdfutility-client.jar |
Requis pour appeler le service PDF Utilities ou XMP Utilities. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-reader-extensions-client.jar |
Requis pour appeler le service d’extensions Acrobat Reader DC. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-repository-client.jar commons-codec-1.3.jar |
Requis pour appeler le service Repository. |
<répertoire d’installation>/sdk/client-libs/common <répertoire d’installation>/sdk/client-libs\thirdparty |
|
Requis pour appeler le service Rights Management. Si AEM Forms est déployé sur JBoss, incluez tous ces fichiers. |
<répertoire d’installation>/sdk/client-libs/common Répertoire lib spécifique à JBoss |
adobe-signatures-client.jar |
Requis pour appeler le service Signature. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-taskmanager-client-sdk.jar |
Requis pour appeler le service Task Manager. |
<répertoire d’installation>/sdk/client-libs/common |
adobe-truststore-client.jar |
Requis pour appeler le service Trust Store. |
<répertoire d’installation>/sdk/client-libs/common |
Le tableau suivant répertorie les fichiers JAR qui dépendent du mode de connexion et du serveur d’applications J2EE sur lequel AEM Forms est déployé.
Fichier |
Description |
Emplacement |
---|---|---|
|
Si AEM Forms est appelé à l’aide du mode SOAP, incluez ces fichiers JAR. |
<répertoire d’installation>/sdk/client-libs/thirdparty |
jboss-client.jar |
Si AEM Forms est déployé sur le serveur d’applications JBoss, incluez ce fichier JAR. Les classes requises ne seront pas trouvées par le chargeur de classe si jboss-client.jar et les jars référencés ne sont pas colocalisés. |
Répertoire lib du client JBoss Si vous déployez votre application client sur le même serveur d’applications J2EE, vous n’avez pas besoin d’inclure ce fichier. |
wlclient.jar |
Si AEM Forms est déployé sur BEA WebLogic Server®, incluez ce fichier JAR. |
Répertoire lib spécifique à WebLogic Si vous déployez votre application client sur le même serveur d’applications J2EE, vous n’avez pas besoin d’inclure ce fichier. |
|
|
Répertoire lib spécifique à WebSphere ([WAS_HOME]/runtimes) Si vous déployez votre application client sur le même serveur d’applications J2EE, vous n’avez pas besoin d’inclure ces fichiers. |
Le tableau suivant spécifie les scénarios d’appel et répertorie les fichiers JAR requis pour appeler correctement AEM Forms.
Services |
Mode d’appel |
Serveur d’applications J2EE |
Fichiers JAR requis |
---|---|---|---|
Service Forms |
EJB |
JBoss |
|
Service Forms Service d’extensions Acrobat Reader DC Service Signature |
EJB |
JBoss |
|
Service Forms |
méthode d’objet |
WebLo gic |
|
Service Forms Service d’extensions Acrobat Reader DC Service Signature |
SOAP |
WebLo gic |
|
Si vous effectuez une mise à niveau de LiveCycle vers AEM Forms, il est recommandé d’inclure les fichiers JAR d’AEM Forms dans le chemin d’accès aux classes de votre projet Java. Par exemple, si vous utilisez des services tels que le service Rights Management, vous rencontrerez un problème de compatibilité si vous n’incluez pas les fichiers JAR d’AEM Forms dans votre chemin d’accès aux classes.
Supposant que vous procédez à la mise à niveau vers AEM Forms. Pour utiliser une application Java qui appelle le service Rights Management, incluez les versions AEM Forms des fichiers JAR suivants :
Voir également
Appel d’AEM Forms en utilisant l’API Java
Réglage des propriétés de la connexion
Transmission de données vers les services AEM Forms à l’aide de l’API Java
Appel d’un service à l’aide d’une bibliothèque client Java
Vous définissez les propriétés de connexion pour appeler AEM Forms lors de l’utilisation de l’API Java. Lors de la définition des propriétés de connexion, indiquez si vous souhaitez appeler des services à distance ou localement, ainsi que le mode de connexion et les valeurs d’authentification. Les valeurs d’authentification sont requises si la sécurité des services est activée. Toutefois, si la sécurité du service est désactivée, il n’est pas nécessaire de spécifier des valeurs d’authentification.
Le mode de connexion peut être le mode SOAP ou EJB. Le mode EJB utilise le protocole RMI/IIOP et les performances du mode EJB sont supérieures à celles du mode SOAP. Le mode SOAP est utilisé pour éliminer une dépendance du serveur d’applications J2EE ou lorsqu’un pare-feu se trouve entre AEM Forms et l’application client. Le mode SOAP utilise le protocole https comme moyen de transport sous-jacent et peut communiquer au-delà des limites du pare-feu. Si ni une dépendance de serveur d’applications J2EE ni un pare-feu ne pose problème, il est recommandé d’utiliser le mode EJB.
Pour appeler un service AEM Forms, définissez les propriétés de connexion suivantes :
DSC_DEFAULT_EJB_ENDPOINT : si vous utilisez le mode de connexion EJB, cette valeur représente l’URL du serveur d’applications J2EE sur laquelle AEM Forms est déployé. Pour appeler à distance AEM Forms, spécifiez le nom du serveur d’applications J2EE sur lequel AEM Forms est déployé. Si votre application client est située sur le même serveur d’applications J2EE, vous pouvez spécifier localhost
. Selon le serveur d’application J2EE sur lequel AEM Forms est déployé, spécifiez l’une des valeurs suivantes :
https://<ServerName>:8080 (default port)
iiop://<ServerName>:2809 (default port)
t3://<ServerName>:7001 (default port)
DSC_DEFAULT_SOAP_ENDPOINT : si vous utilisez le mode de connexion SOAP, cette valeur représente le point de fin auquel une demande d’appel est envoyée. Pour appeler à distance AEM Forms, spécifiez le nom du serveur d’applications J2EE sur lequel AEM Forms est déployé. Si votre application client est située sur le même serveur d’applications J2EE, vous pouvez spécifier localhost
(par exemple : http://localhost:8080
.)
8080
est applicable si l’application J2EE est JBoss. Si le serveur d’applications J2EE est IBM® WebSphere®, utilisez le port 9080
. Si le serveur d’applications J2EE est WebLogic, utilisez le port 7001
. (Ces valeurs sont les valeurs de port par défaut. Si vous modifiez la valeur du port, utilisez le numéro de port applicable.)DSC_TRANSPORT_PROTOCOL : si vous utilisez le mode de connexion EJB, spécifiez ServiceClientFactoryProperties.DSC_EJB_PROTOCOL
pour cette valeur. Si vous utilisez le mode de connexion SOAP, spécifiez ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL
.
DSC_SERVER_TYPE : spécifiez le serveur d’applications J2EE sur lequel AEM Forms est déployé. Les valeurs valides sont JBoss
, WebSphere
, WebLogic
.
WebSphere
, la valeur java.naming.factory.initial
est définie sur com.ibm.ws.naming.util.WsnInitCtxFactory
.WebLogic
, la valeur java.naming.factory.initial
est définie sur weblogic.jndi.WLInitialContextFactory
.JBoss
, la valeur java.naming.factory.initial
est définie sur org.jnp.interfaces.NamingContextFactory
.java.naming.factory.initial
sur une valeur répondant à vos exigences si vous ne souhaitez pas utiliser les valeurs par défaut.Au lieu d'utiliser une chaîne pour définir la propriété de connexion DSC_SERVER_TYPE
, vous pouvez utiliser un membre statique de la classe ServiceClientFactoryProperties
. Les valeurs suivantes peuvent être utilisées : ServiceClientFactoryProperties.DSC_WEBSPHERE_SERVER_TYPE
, ServiceClientFactoryProperties.DSC_WEBLOGIC_SERVER_TYPE
ou ServiceClientFactoryProperties.DSC_JBOSS_SERVER_TYPE
.
DSC_CREDENTIAL_USERNAME : spécifie le nom d’utilisateur d’AEM Forms. Pour qu’un utilisateur puisse appeler un service AEM Forms, il lui faut le rôle Services User. Un utilisateur peut également avoir un autre rôle incluant l’autorisation d’appel de services. Sinon, une exception est levée lorsqu’il tente d’appeler un service. Si la sécurité du service est désactivée, il n’est pas nécessaire de spécifier cette propriété de connexion.
DSC_CREDENTIAL_PASSWORD : indique la valeur de mot de passe correspondant. Si la sécurité du service est désactivée, il n’est pas nécessaire de spécifier cette propriété de connexion.
DSC_REQUEST_TIMEOUT : la limite du délai d’attente de requête par défaut pour la demande SOAP est 1 200 000 millisecondes (20 minutes). Parfois, une demande peut prendre plus de temps pour réaliser l’opération. Par exemple, une demande SOAP qui récupère un grand ensemble d’enregistrements peut nécessiter un délai d’expiration plus long. Vous pouvez utiliser le ServiceClientFactoryProperties.DSC_REQUEST_TIMEOUT
pour augmenter la limite de délai d’appel de demande pour les requêtes SOAP.
Seuls les appels SOAP prennent en charge la propriété DSC_REQUEST_TIMEOUT.
Pour définir les propriétés de connexion, effectuez les tâches suivantes :
Créez un objet java.util.Properties
en utilisant son constructeur.
Pour définir la propriété de connexion DSC_DEFAULT_EJB_ENDPOINT
, appelez la méthode java.util.Properties
de l'objet setProperty
et transmettez les valeurs suivantes :
ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT
Si vous utilisez le mode de connexion SOAP, spécifiez la valeur de énumération ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT
au lieu de la valeur de énumération ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT
.
Pour définir la propriété de connexion DSC_TRANSPORT_PROTOCOL
, appelez la méthode java.util.Properties
de l'objet setProperty
et transmettez les valeurs suivantes :
ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL
ServiceClientFactoryProperties.DSC_EJB_PROTOCOL
Si vous utilisez le mode de connexion SOAP, spécifiez la valeur de énumération ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL
au lieu de la valeur de énumération ServiceClientFactoryProperties.DSC_EJB_PROTOCOL
.
Pour définir la propriété de connexion DSC_SERVER_TYPE
, appelez la méthode java.util.Properties
de l'objet setProperty
et transmettez les valeurs suivantes :
Valeur de la énumération ServiceClientFactoryProperties.DSC_SERVER_TYPE
Valeur string qui spécifie le serveur d’application J2EE hébergeant AEM Forms (par exemple, si AEM Forms est déployé sur , spécifiezJBoss
JBoss).
DSC_CREDENTIAL_USERNAME
, appelez la méthode java.util.Properties
de l'objet setProperty
et transmettez les valeurs suivantes :Valeur de la énumération ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME
Valeur string qui spécifie le nom d’utilisateur requis pour appeler AEM Forms
DSC_CREDENTIAL_PASSWORD
, appelez la méthode java.util.Properties
de l'objet setProperty
et transmettez les valeurs suivantes :Valeur de la énumération ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD
Valeur string qui spécifie la valeur du mot de passe correspondant
Définition du mode de connexion EJB pour JBoss
L’exemple de code Java suivant définit les propriétés de connexion pour appeler AEM Forms déployé sur JBoss et utilisant le mode de connexion 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");
Réglage du mode de connexion EJB pour WebLogic
L’exemple de code Java suivant définit les propriétés de connexion pour appeler AEM Forms déployé sur WebLogic et utilisant le mode de connexion 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");
Réglage du mode de connexion EJB pour WebSphere
L’exemple de code Java suivant définit les propriétés de connexion pour appeler AEM Forms déployé sur WebSphere et utilisant le mode de connexion 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");
Réglage du mode de connexion SOAP
L’exemple de code Java suivant définit les propriétés de connexion pour appeler AEM Forms déployé sur JBoss et utilisant le mode de connexion SOAP.
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");
Si vous sélectionnez le mode de connexion SOAP, assurez-vous d’inclure des fichiers JAR supplémentaires dans le chemin d’accès aux classes de votre application client.
Définition des propriétés de connexion lorsque la sécurité des services est désactivée
L’exemple de code Java suivant définit les propriétés de connexion requises pour appeler AEM Forms déployé sur le serveur d’applications JBoss et lorsque la sécurité du service est désactivée.
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");
Tous les outils de démarrage rapide Java associés à la programmation avec AEM Forms affichent les paramètres de connexion EJB et SOAP.
Réglage du mode de connexion SOAP avec limite de délai d’attente de demande personnalisée
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
Utilisation d’un objet de contexte pour appeler AEM Forms
Vous pouvez utiliser un objet com.adobe.idp.Context
pour appeler un service AEM Forms avec un utilisateur authentifié (l’objet du com.adobe.idp.Context
représente un utilisateur authentifié). Lors de l'utilisation d'un objet com.adobe.idp.Context
, il n'est pas nécessaire de définir les propriétés DSC_CREDENTIAL_USERNAME
ou DSC_CREDENTIAL_PASSWORD
. Vous pouvez obtenir un objet com.adobe.idp.Context
lors de l’authentification d’utilisateurs à l’aide de la méthode AuthenticationManagerServiceClient
de l’objet authenticate
.
La méthode authenticate
renvoie un objet AuthResult
contenant les résultats de l'authentification. Vous pouvez créer un objet com.adobe.idp.Context
en appelant son constructeur. Ensuite, appelez la méthode com.adobe.idp.Context
de l’objet initPrincipal
et transmettez l’objet AuthResult
, comme indiqué dans le code suivant :
Context myCtx = new Context();
myCtx.initPrincipal(authResult);
Au lieu de définir les propriétés DSC_CREDENTIAL_USERNAME
ou DSC_CREDENTIAL_PASSWORD
, vous pouvez appeler la méthode ServiceClientFactory
de l'objet setContext
et transmettre l'objet com.adobe.idp.Context
. Lorsque vous utilisez un utilisateur d’AEM Forms pour appeler un service, assurez-vous qu’il possède le rôle Services User
requis pour appeler un service AEM Forms.
L’exemple de code suivant montre comment utiliser un objet com.adobe.idp.Context
dans les paramètres de connexion qui sont utilisés pour créer un objet 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);
Pour plus d’informations sur l’authentification d’un utilisateur, voir Authentification des utilisateurs .
Les scénarios d’appel suivants sont abordés dans cette section :
Le diagramme suivant illustre une application client exécutée sur sa propre machine virtuelle et appelant une instance AEM Forms autonome.
Dans ce scénario, une application client s’exécute sur sa propre JVM et appelle les services AEM Forms.
Ce scénario est le scénario d’appel sur lequel toutes les mises en route sont basées.
Le diagramme suivant montre une application client s’exécutant dans sa propre JVM et invoquant des instances de AEM Forms situées dans un cluster.
Ce scénario est similaire à celui d’une application client invoquant une instance autonome d’AEM Forms. Cependant, l’URL du fournisseur est différente. Si une application client souhaite se connecter à un serveur d’applications J2EE spécifique, l’application doit changer l’URL pour référencer le serveur d’applications J2EE spécifique.
Le référencement d’un serveur d’applications J2EE spécifique n’est pas recommandé car la connexion entre l’application client et AEM Forms est interrompue si le serveur d’applications s’arrête. Il est recommandé que l’URL du fournisseur fasse référence à un gestionnaire JNDI de niveau cellulaire, au lieu d’un serveur d’applications J2EE spécifique.
Les applications client qui utilisent le mode de connexion SOAP peuvent utiliser le port d’équilibrage de charge HTTP pour le cluster. Les applications client qui utilisent le mode de connexion EJB peuvent se connecter au port EJB d’un serveur d’applications J2EE spécifique. Cette action gère l’équilibrage de charge entre les nœuds du cluster.
**WebSphere **
L’exemple suivant montre le contenu d’un fichier jndi.properties utilisé pour se connecter à AEM Forms déployé sur WebSphere.
java.naming.factory.initial=com.ibm.websphere.naming.
WsnInitialContextFactory
java.naming.provider.url=corbaloc::appserver1:9810,:appserver2:9810
WebLo gic
L’exemple suivant montre le contenu d’un fichier jndi.properties utilisé pour se connecter à AEM Forms déployé sur WebLogic.
java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory
java.naming.provider.url=t3://appserver1:8001, appserver2:8001
**JBoss **
L’exemple suivant montre le contenu d’un fichier jndi.properties utilisé pour se connecter à AEM Forms déployé sur JBoss.
java.naming.factory.initial= org.jnp.interfaces.NamingContextFactory
java.naming.provider.url= jnp://appserver1:1099, appserver2:1099,
appserver3:1099
Consultez votre administrateur pour déterminer le nom du serveur d’applications J2EE et le numéro de port.
Voir également
Inclusion des fichiers de bibliothèque Java AEM Forms
Transmission de données vers les services AEM Forms à l’aide de l’API Java
Appel d’un service à l’aide d’une bibliothèque client Java
Les opérations de service AEM Forms consomment ou produisent généralement des documents PDF. Lorsque vous invoquez un service, il est parfois nécessaire de lui transmettre un document PDF (ou d’autres types de documents tels que des données XML). De même, il est parfois nécessaire de gérer un document PDF renvoyé par le service. La classe Java qui vous permet de transmettre des données depuis et vers les services AEM Forms est com.adobe.idp.Document
.
Les services AEM Forms n’acceptent aucun autre type de données qu’un document PDF, comme un objet java.io.InputStream
ou un tableau d’octets. Un objet com.adobe.idp.Document
peut également être utilisé pour transmettre d’autres types de données aux services, comme des données XML.
Un objet com.adobe.idp.Document
est un type sérialisable Java, donc il peut être passé sur un appel RMI. Le côté récepteur peut être co-localisé (même hôte, même chargeur de classe), local (même hôte, chargeur de classe différent) ou distant (hôte différent). La transmission du contenu du document est optimisée pour chaque cas. Par exemple, si l’expéditeur et le destinataire se trouvent sur le même hôte, le contenu est transmis via un système de fichiers local. (Dans certains cas, les documents peuvent être passés en mémoire.)
En fonction de la taille de l’objet de com.adobe.idp.Document
, les données sont transmises au sein de l’objet com.adobe.idp.Document
ou stockées sur le système de fichiers du serveur. Toutes les ressources de stockage temporaires occupées par l’objet du com.adobe.idp.Document
sont automatiquement supprimées lors de l’élimination de com.adobe.idp.Document
. (Voir Élimination d’objets de document)
Parfois, il est nécessaire de connaître le type de contenu d’un objet com.adobe.idp.Document
avant de pouvoir le transmettre à un service. Par exemple, si une opération nécessite un type de contenu spécifique, comme application/pdf
, il est recommandé de déterminer le type de contenu. (Voir Détermination du type de contenu d’un document.)
L’objet com.adobe.idp.Document
tente de déterminer le type de contenu en utilisant les données fournies. Si le type de contenu ne peut pas être extrait des données fournies (par exemple, lorsque les données ont été fournies sous forme de tableau d’octets), définissez le type de contenu. Pour définir le type de contenu, appelez la méthode com.adobe.idp.Document
de l’objet setContentType
. (Voir Détermination du type de contenu d’un document)
Si les fichiers de documentation et ressources résident sur le même système de fichiers, cela crée un objet com.adobe.idp.Document
plus rapide. Si les fichiers de documentation et ressources résident sur des systèmes de fichiers distants, une opération de copie doit avoir lieu, ce qui affecte les performances.
Une application peut contenir à la fois les types de données com.adobe.idp.Document
et org.w3c.dom.Document
. Toutefois, assurez-vous que vous remplissez les conditions requises pour le type de données org.w3c.dom.Document
. Pour plus d’informations sur la conversion d’un objet org.w3c.dom.Document
à un objet com.adobe.idp.Document
, voir le didacticiel de mise en route (mode EJB) : Préremplissage des formulaires avec les mises en page souples à l’aide de l’API Java.
Pour éviter une fuite de mémoire dans WebLogic en utilisant l’objet com.adobe.idp.Document
, lisez les informations de documents en blocs de 2 048 octets maximum. Par exemple, le code suivant lit les informations du document en blocs de 2 048 octets :
// 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();
Voir également
Appel d’AEM Forms en utilisant l’API Java
Réglage des propriétés de la connexion
Créez un objet com.adobe.idp.Document
avant d’appeler une opération de service ayant besoin d’un document PDF (ou d’autres types de documents) comme une valeur d’entrée. La classe com.adobe.idp.Document
fournit des constructeurs qui vous permettent de créer un document à partir des types de contenu suivants :
com.adobe.idp.Document
existantjava.io.File
java.io.InputStream
java.net.URL
L’exemple de code suivant crée un objet com.adobe.idp.Document
basé sur un tableau d’octets.
Création d’un objet Document basé sur un tableau d’octets
Document myPDFDocument = new Document(myByteArray);
L’exemple de code suivant crée un objet com.adobe.idp.Document
basé sur un autre objet com.adobe.idp.Document
.
Création d’un objet Document basé sur un autre document
//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);
L’exemple de code suivant crée un objet com.adobe.idp.Document
basé sur un fichier PDF nommé map.pdf. Ce fichier se trouve dans la racine du disque dur C. Ce constructeur tente de définir le type de contenu MIME de l’objet com.adobe.idp.Document
en utilisant l’extension de nom de fichier.
Le constructeur com.adobe.idp.Document
qui accepte l’objet java.io.File
accepte également un paramètre Boolean. En définissant ce paramètre sur true
, l’objet com.adobe.idp.Document
supprime le fichier. Cette action signifie que vous n’avez pas besoin de supprimer le fichier après l’avoir passé au constructeur com.adobe.idp.Document
.
Définir ce paramètre sur false
signifie que vous conservez la propriété de ce fichier. Définir ce paramètre sur true
est plus efficace. La raison est que l’objet com.adobe.idp.Document
peut déplacer le fichier directement sur la zone gérée locale au lieu de le copier (ce qui est plus lent).
Création d’un objet Document basé sur un fichier 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);
L’exemple de code Java suivant crée un objet com.adobe.idp.Document
basé sur un objet java.io.InputStream
.
Création d’un document à partir d’un objet InputStream
//Create a Document object based on an InputStream object
InputStream is = new FileInputStream("C:\\Map.pdf");
Document myPDFDocument = new Document(is);
L’exemple de code Java suivant crée un objet com.adobe.idp.Document
basé sur un fichier PDF nommé map.pdf. Ce fichier se trouve dans une application Web nommée WebApp
qui s’exécute sur localhost
. Ce constructeur tente de définir le type de contenu MIME de l’objet com.adobe.idp.Document
en utilisant le type de contenu retourné avec le protocole URL.
L’URL fournie à l’objet com.adobe.idp.Document
est toujours lue du côté où l’objet com.adobe.idp.Document
original est créé, comme indiqué dans cet exemple :
Document doc = new Document(new java.net.URL("file:c:/temp/input.pdf"));
Le fichier c:/temp/input.pdf doit se trouver sur l’ordinateur client (et non sur l’ordinateur serveur). L’ordinateur client est l’emplacement de lecture de l’URL et de création de l’objet com.adobe.idp.Document
.
Création d’un document basé sur un contenu accessible à partir d’une 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);
Voir également
Appel d’AEM Forms en utilisant l’API Java
Réglage des propriétés de la connexion
Les opérations de service retournant un document PDF (ou d’autres types de données telles que les données XML) comme valeur de sortie retournent l’objet com.adobe.idp.Document
. Après avoir reçu un objet com.adobe.idp.Document
, vous pouvez le convertir aux formats suivants :
java.io.File
java.io.InputStream
La ligne suivante de code convertit un objet com.adobe.idp.Document
à un objet java.io.InputStream
. Supposons que myPDFDocument
représente un objet com.adobe.idp.Document
:
java.io.InputStream resultStream = myDocument.getInputStream();
De même, vous pouvez copier le contenu d’un fichier com.adobe.idp.Document
dans un fichier local en effectuant les tâches suivantes :
java.io.File
.com.adobe.idp.Document
de l'objet copyToFile
et transmettez l'objet java.io.File
.L’exemple de code suivant copie le contenu d’un objet com.adobe.idp.Document
dans un fichier nommé AnotherMap.pdf.
Copie du contenu d’un objet de document dans un fichier
File outFile = new File("C:\\AnotherMap.pdf");
myDocument.copyToFile (outFile);
Voir également
Appel d’AEM Forms en utilisant l’API Java
Réglage des propriétés de la connexion
Déterminez le type MIME d'un objet com.adobe.idp.Document
en appelant la méthode com.adobe.idp.Document
de l'objet getContentType
. Cette méthode renvoie une valeur string qui spécifie le type de contenu de l’objet com.adobe.idp.Document
. Le tableau suivant décrit les différents types de contenu qu’AEM Forms retourne.
Type MIME |
Description |
---|---|
|
Document PDF |
|
XML Data Packaging (XDP), utilisé pour les formulaires XML Forms Architecture (XFA) exportés |
|
Signets, pièces jointes ou autres documents XML |
|
Format de données de formulaires (FDF), utilisé pour les formulaires Acrobat exportés |
|
Format de données de formulaires XML (XFDF), utilisé pour les formulaires Acrobat exportés |
|
Format de données enrichi et XML |
|
Format de données générique |
|
Type MIME non spécifié |
L’exemple de code suivant détermine le type de contenu d’un objet com.adobe.idp.Document
.
Détermination du type de contenu d’un objet Document
//Determine the content type of the Document object
String ct = myDocument.getContentType();
System.out.println("The content type of the Document object is " +ct);
Voir également
Appel d’AEM Forms en utilisant l’API Java
Réglage des propriétés de la connexion
Lorsque vous n’avez plus besoin d’un objet Document
, il est recommandé de l’éliminer en appelant la méthode dispose
. Chaque objet Document
consomme un descripteur de fichier et jusqu’à 75 Mo d’espace mémoire sur la plate-forme de votre application hôte. Si un objet Document
n’est pas éliminé, le processus de collecte de Java Garage le supprime. Toutefois, si vous l’éliminez avant en utilisant la méthode dispose
, vous pouvez libérer la mémoire occupée par l’objet Document
.
Voir également
Appel d’AEM Forms en utilisant l’API Java
Inclusion des fichiers de bibliothèque Java AEM Forms
Appel d’un service à l’aide d’une bibliothèque client Java
Les opérations du service AEM Forms peuvent être appelées à l’aide de l’API fortement typée du service, appelée bibliothèque client Java. Une bibliothèque client Java est un ensemble de classes concrètes permettant d’accéder aux services déployés dans le conteneur de service. Vous instanciez un objet Java qui représente le service à appeler au lieu de créer l’objet InvocationRequest
en utilisant l’API d’appel. L’API d’appel est utilisée pour appeler des processus, tels que des processus de longue durée, créés dans Workbench. (Voir Appel de processus pour des intervenants humains de longue durée.)
Pour effectuer une opération de service, appelez une méthode appartenant à l’objet Java. Une bibliothèque client Java contient des méthodes qui associent généralement des opérations un-à-un à des opérations de service. Lorsque vous utilisez une bibliothèque client Java, définissez les propriétés de connexion requises. (Voir Réglage des propriétés de la connexion.)
Après avoir défini les propriétés de connexion, créez un objet ServiceClientFactory
utilisé pour instancier un objet Java qui vous permet d’appeler un service. Chaque service qui a une bibliothèque client Java a un objet client correspondant. Par exemple, pour appeler le service Repository, créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
. L’objet ServiceClientFactory
est responsable de la gestion des paramètres de connexion nécessaires pour appeler les services AEM Forms.
Bien que l’obtention d’un objet ServiceClientFactory
soit généralement rapide, des frais généraux sont à prévoir lorsque l’usine est utilisée pour la première fois. Cet objet est optimisé pour la réutilisation et, par conséquent, le cas échéant, utilisez le même objet ServiceClientFactory
lorsque vous créez des objets client Java multiples. En d’autres termes, ne créez pas d’objet ServiceClientFactory
distinct pour chaque objet de bibliothèque client que vous créez.
Un paramètre User Manager contrôle la durée de vie de l’assertion SAML qui se trouve dans l’objet com.adobe.idp.Context
affectant l’objet ServiceClientFactory
. Ce paramètre contrôle toutes les durées de vie du contexte d’authentification dans AEM Forms, y compris tous les appels effectués à l’aide de l’API Java. Par défaut, un objet ServiceCleintFactory
peut être utilisé pendant une période de deux heures.
Pour expliquer comment appeler un service à l’aide de l’API Java, l’opération writeResource
du service Repository est appelée. Cette opération place une nouvelle ressource dans le référentiel.
Vous pouvez appeler le service Repository en utilisant une bibliothèque client Java et en effectuant les étapes suivantes :
Incluez les fichiers JAR du client, tels que adobe-repository-client.jar, dans le chemin d’accès aux classes de votre projet Java. Pour plus d’informations sur l’emplacement de ces fichiers, voir Inclusion des fichiers de bibliothèque Java AEM Forms.
Définir les propriétés de connexion requises pour appeler un service.
Créez un objet ServiceClientFactory
en appelant la méthode statique createInstance
de l'objet ServiceClientFactory
et en transmettant l'objet java.util.Properties
contenant des propriétés de connexion.
Créez un objet ResourceRepositoryClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
. Utilisez l’objet ResourceRepositoryClient
pour appeler les opérations du service Repository.
Créez un objet RepositoryInfomodelFactoryBean
en utilisant son constructeur et transmettez-le comme null
. Cet objet vous permet de créer un objet Resource
qui représente le contenu ajouté au référentiel.
Créez un objet Resource
en appelant la méthode RepositoryInfomodelFactoryBean
de l'objet newImage
et en transmettant les valeurs suivantes :
new Id()
.new Lid()
.Convertissez la valeur de retour en Resource
.
Créez un objet ResourceContent
en appelant la méthode RepositoryInfomodelFactoryBean
de l'objet newImage
et en faisant passer la valeur renvoyée à ResourceContent
. Cet objet représente le contenu ajouté au référentiel.
Créez un objet com.adobe.idp.Document
en transmettant un objet java.io.FileInputStream
qui stocke le fichier XDP à ajouter au référentiel. (Voir Création d’un document basé sur un objet InputStream.)
Ajoutez le contenu de l'objet com.adobe.idp.Document
à l'objet ResourceContent
en appelant la méthode ResourceContent
de l'objet setDataDocument
. Transmettez l'objet com.adobe.idp.Document
.
Définissez le type MIME du fichier XDP à ajouter au référentiel en appelant la méthode ResourceContent
de l’objet setMimeType
et en transmettant application/vnd.adobe.xdp+xml
.
Ajoutez le contenu de l'objet ResourceContent
à l'objet Resource
en appelant la méthode Resource
de l'objet setContent
et en transmettant l'objet ResourceContent
.
Ajoutez une description de la ressource en appelant la méthode Resource
de l’objet setDescription
et en transmettant une valeur string représentant la description de la ressource.
Ajoutez la conception de formulaire au référentiel en appelant la méthode ResourceRepositoryClient
de l’objet writeResource
et en transmettant les valeurs suivantes :
Resource
qui a été crééVoir également
Didacticiel de mise en route (mode EJB) : écriture d’une ressource en utilisant l’API Java
Appel d’AEM Forms en utilisant l’API Java
Inclusion des fichiers de bibliothèque Java AEM Forms
Vous pouvez appeler un processus de courte durée en utilisant l’API d’appel de Java. Lorsque vous appelez un processus de courte durée à l’aide de l’API d’appel, vous transmettez les valeurs de paramètre requises à l’aide d’un objet java.util.HashMap
. Pour chaque paramètre à transmettre à un service, appelez la méthode java.util.HashMap
de l’objet put
et spécifiez la paire nom-valeur requise par le service pour effectuer l’opération spécifiée. Indiquez le nom exact des paramètres appartenant au processus de courte durée.
Pour plus d’informations sur l’appel d’un processus de longue durée, voir Appel de processus pour des intervenants humains de longue durée.
La discussion ici porte sur l’utilisation de l’API d’appel pour appeler le processus de courte durée AEM Forms suivant, nommé MyApplication/EncryptDocument
.
Ce processus n’est pas basé sur un processus AEM Forms existant. Pour suivre l’exemple de code, créez un processus désigné par MyApplication/EncryptDocument
à l’aide de Workbench. (Voir Utilisation de Workbench.)
Lorsque ce processus est appelé, il effectue les actions suivantes :
SetValue
. Le paramètre d’entrée pour ce processus est une variable de processus document
désignée par inDoc
.PasswordEncryptPDF
. Le document PDF chiffré avec un mot de passe est retourné dans une variable de processus nommée outDoc
.Appelez le processus de courte durée MyApplication/EncryptDocument
à l’aide de l’API d’appel Java :
Incluez les fichiers JAR du client, tels que adobe-livecycle-client.jar, dans le chemin d’accès aux classes de votre projet Java. (Voir Inclusion des fichiers de bibliothèque Java AEM Forms.)
Créez un objet ServiceClientFactory
qui contient des propriétés de connexion. (Voir Réglage des propriétés de la connexion.)
Créez un objet ServiceClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
. Un objet ServiceClient
vous permet d’appeler une opération de service. Il gère des tâches telles que la localisation, la répartition et le routage des demandes d’appel.
Créez un objet java.util.HashMap
en utilisant son constructeur.
Appelez la méthode java.util.HashMap
de l’objet put
pour chaque paramètre d’entrée à transmettre au processus de longue durée. Vu que le processus de courte durée MyApplication/EncryptDocument
nécessite un paramètre d’entrée de type Document
, il suffit d’appeler la méthode put
une fois, comme le montre l’exemple suivant.
//Create a Map object to store the parameter value for inDoc
Map params = new HashMap();
InputStream inFile = new FileInputStream("C:\\Adobe\Loan.pdf");
Document inDoc = new Document(inFile);
params.put("inDoc", inDoc);
Créez un objet InvocationRequest
en appelant la méthode ServiceClientFactory
de l'objet createInvocationRequest
et en transmettant les valeurs suivantes :
MyApplication/EncryptDocument
, spécifiez MyApplication/EncryptDocument
.invoke
.java.util.HashMap
qui contient les valeurs de paramètre requises par l’opération de service.true
qui crée une demande synchrone (cette valeur est applicable pour appeler un processus de courte durée).Envoyez la demande d’appel au service en appelant la méthode ServiceClient
de l’objet invoke
et en transmettant l’objet InvocationRequest
. La méthode invoke
renvoie un objet InvocationReponse
.
Un processus de longue durée peut être appelé en transmettant la valeur false
en tant que quatrième paramètre de la méthode createInvocationRequest
. La transmission de la valeur false
crée une requête asynchrone.
Récupérer la valeur de retour de processus en invoquant la méthode InvocationReponse
de l’objet getOutputParameter
et passant à une valeur string qui spécifie le nom du paramètre de sortie. Dans ce cas, spécifiez outDoc
( outDoc
est le nom du paramètre de sortie pour le processus MyApplication/EncryptDocument
). Convertissez la valeur de retour en Document
, comme le montre l’exemple suivant.
InvocationResponse response = myServiceClient.invoke(request);
Document encryptDoc = (Document) response.getOutputParameter("outDoc");
Créez un objet java.io.File
et assurez-vous que l’extension du fichier est .pdf.
Appelez la méthode com.adobe.idp.Document
de l'objet copyToFile
pour copier le contenu de l'objet com.adobe.idp.Document
dans le fichier. Assurez-vous d’utiliser l’objet com.adobe.idp.Document
qui a été retourné par la méthode getOutputParameter
.
Voir également
Didacticiel de mise en route : appel d’un processus de courte durée en utilisant l’API d’appel
Appel de processus pour des intervenants humains de longue durée
Inclusion des fichiers de bibliothèque Java AEM Forms