Show Menu
화제×

Java API를 사용하여 AEM Forms 호출

AEM Forms Java API를 사용하여 AEM Forms을 호출할 수 있습니다. AEM Forms Java API를 사용하는 경우 호출 API 또는 Java 클라이언트 라이브러리를 사용할 수 있습니다. Java 클라이언트 라이브러리는 Rights Management 서비스와 같은 서비스에 사용할 수 있습니다. 강력한 형식의 API를 사용하면 AEM Forms을 호출하는 Java 애플리케이션을 개발할 수 있습니다.
Invocation API는 패키지에 있는 com.adobe.idp.dsc 클래스입니다. 이 클래스를 사용하면 호출 요청을 서비스로 직접 보내고 반환된 호출 응답을 처리할 수 있습니다. 호출 API를 사용하여 Workbench를 사용하여 생성된 단기 또는 긴 수명 프로세스를 호출할 수 있습니다.
프로그래밍 방식으로 서비스를 호출하는 데 권장되는 방법은 호출 API가 아닌 서비스에 해당하는 Java 클라이언트 라이브러리를 사용하는 것입니다. 예를 들어 암호화 서비스를 호출하려면 암호화 서비스 클라이언트 라이브러리를 사용합니다. 암호화 서비스 작업을 수행하려면 암호화 서비스 클라이언트 개체에 속하는 메서드를 호출합니다. 오브젝트의 방법을 호출하여 암호로 PDF 문서를 암호화할 수 EncryptionServiceClient encryptPDFUsingPassword 있습니다.
Java API는 다음 기능을 지원합니다.
  • 원격 호출을 위한 RMI 전송 프로토콜
  • 로컬 호출을 위한 VM 전송
  • 원격 호출을 위한 SOAP
  • 사용자 이름 및 암호와 같은 다른 인증
  • 동기 및 비동기 호출 요청
Adobe 개발자 웹 사이트
Adobe 개발자 웹 사이트에는 Java API를 사용한 AEM Forms 서비스 호출에 대해 설명하는 다음 문서가 포함되어 있습니다.
참고 항목

AEM Forms Java 라이브러리 파일 포함

Java API를 사용하여 프로그래밍 방식으로 AEM Forms 서비스를 호출하려면 Java 프로젝트의 클래스 경로에 필수 라이브러리 파일(JAR 파일)을 포함합니다. 클라이언트 응용 프로그램의 클래스 경로에 포함하는 JAR 파일은 다음과 같은 여러 요인에 따라 달라집니다.
  • 호출할 AEM Forms 서비스입니다. 클라이언트 응용 프로그램은 하나 이상의 서비스를 호출할 수 있습니다.
  • AEM Forms 서비스를 호출할 모드. EJB 또는 SOAP 모드를 사용할 수 있습니다. 연결 속성 설정을 참조하십시오 .
(턴키만) EJB용 서버 IP를 지정하는 명령으로 AEM Forms 서버 standalone.bat -b <Server IP> -c lc_turnkey.xml 를 시작합니다.
  • AEM Forms이 배포된 J2EE 응용 프로그램 서버.

서비스별 JAR 파일

다음 표에는 AEM Forms 서비스를 호출하는 데 필요한 JAR 파일이 나와 있습니다.
파일
설명
위치
adobe-livecycle-client.jar
Java 클라이언트 응용 프로그램의 클래스 경로에 항상 포함되어야 합니다.
< install directory >/sdk/client-libs/common
adobe-usermanager-client.jar
Java 클라이언트 응용 프로그램의 클래스 경로에 항상 포함되어야 합니다.
< install directory >/sdk/client-libs/common
adobe-utilities.jar
Java 클라이언트 응용 프로그램의 클래스 경로에 항상 포함되어야 합니다.
< install directory >/sdk//client-libs/<app server>
adobe-applicationmanager-client-sdk.jar
Application Manager 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-assembler-client.jar
어셈블러 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-backup-restore-client-sdk.jar
백업 및 복원 서비스 API를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-barcodedforms-client.jar
바코드된 양식 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-convertpdf-client.jar
PDF 변환 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-distiller-client.jar
Distiller 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-docconverter-client.jar
DocConverter 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-contentservices-client.jar
Document Management 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-encryption-client.jar
암호화 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-forms-client.jar
Forms 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-formdataintegration-client.jar
양식 데이터 통합 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-generatepdf-client.jar
PDF 생성 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-generate3dpdf-client.jar
3D PDF 생성 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-jobmanager-client-sdk.jar
작업 관리자 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-output-client.jar
출력 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-pdfutility-client.jar
PDF 유틸리티 또는 XMP 유틸리티 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-reader-extensions-client.jar
Acrobat Reader DC 확장 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-repository-client.jar
commons-codec-1.3.jar
저장소 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
< install directory >/sdk/client-libs\thirdparty
  • adobe-rightsmanagement-client.jar
  • namespace.jar
  • jaxb-api.jar
  • jaxb-impl.jar
  • jaxb-libs.jar
  • jaxb-xjc.jar
  • relaxngDatatype.jar
  • xsdlib.jar
Rights Management 서비스를 호출하는 데 필요합니다.
AEM Forms이 JBoss에 배포된 경우 이러한 파일을 모두 포함합니다.
< install directory >/sdk/client-libs/common
JBoss 특정 lib 디렉토리
adobe-signatures-client.jar
서명 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-taskmanager-client-sdk.jar
작업 관리자 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common
adobe-truststore-client.jar
Trust Store 서비스를 호출하는 데 필요합니다.
< install directory >/sdk/client-libs/common

연결 모드 및 J2EE 응용 프로그램 JAR 파일

다음 표에는 연결 모드에 따라 달라지는 JAR 파일과 AEM Forms이 배포된 J2EE 응용 프로그램 서버가 나열됩니다.
파일
설명
위치
  • activation.jar
  • axis.jar
  • commons-codec-1.3.jar
  • commons-collections-3.1.jar
  • commons-discovery.jar
  • commons-logging.jar
  • dom3-xml-apis-2.5.0.jar
  • jaxen-1.1-beta-9.jar
  • jaxrpc.jar
  • log4j.jar
  • mail.jar
  • saaj.jar
  • wsdl4j.jar
  • xalan.jar
  • xbean.jar
  • xercesImpl.jar
  • commons-httpclient-3.1.jar
SOAP 모드를 사용하여 AEM Forms을 호출하면 이러한 JAR 파일을 포함합니다.
< install directory >/sdk/client-libs/thirdparty
jboss-client.jar
AEM Forms이 JBoss Application Server에 배포된 경우 이 JAR 파일을 포함합니다.
jboss-client.jar 및 참조된 항들이 함께 있지 않으면 classloader에서 필수 클래스를 찾을 수 없습니다.
JBoss 클라이언트 lib 디렉토리
클라이언트 응용 프로그램을 동일한 J2EE 응용 프로그램 서버에 배포하는 경우 이 파일을 포함할 필요가 없습니다.
wlclient.jar
AEM Forms이 BEA WebLogic Server®에 배포되는 경우 이 JAR 파일을 포함시킵니다.
WebLogic-specific lib 디렉토리
클라이언트 응용 프로그램을 동일한 J2EE 응용 프로그램 서버에 배포하는 경우 이 파일을 포함할 필요가 없습니다.
  • com.ibm.ws.admin.client_6.1.0.jar
  • com.ibm.ws.webservices.thinclient_6.1.0.jar
  • AEM Forms이 WebSphere 응용 프로그램 서버에 배포되는 경우 이러한 JAR 파일을 포함합니다.
  • (웹 서비스 호출에는 com.ibm.ws.webservices.thinclient_6.1.0.jar 필요)
WebSphere-specific lib 디렉토리( [WAS_HOME] /runtimes)
클라이언트 응용 프로그램을 동일한 J2EE 응용 프로그램 서버에 배포하는 경우 이러한 파일을 포함할 필요가 없습니다.

시나리오 호출

다음 표에서는 호출 시나리오를 지정하고 AEM Forms을 성공적으로 호출하는 데 필요한 JAR 파일을 나열합니다.
서비스
호출 모드
J2EE 응용 프로그램 서버
필수 JAR 파일
양식 서비스
EJB
JBoss
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • jboss-client.jar
  • adobe-forms-client.jar
  • commons-httpclient-3.1.jar
양식 서비스
Acrobat Reader DC 익스텐션 서비스
서명 서비스
EJB
JBoss
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • jboss-client.jar
  • commons-httpclient-3.1.jar
  • adobe-forms-client.jar
  • adobe-reader-extensions-client.jar
  • adobe-signatures-client.jar
양식 서비스
SOAP
WebLogic
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • wlclient.jar
  • activation.jar
  • axis.jar
  • commons-codec-1.3.jar
  • commons-collections-3.1.jar
  • commons-discovery.jar
  • commons-logging.jar
  • dom3-xml-apis-2.5.0.jar
  • jai_imageio.jar
  • jaxen-1.1-beta-9.jar
  • jaxrpc.jar
  • log4j.jar
  • mail.jar
  • saaj.jar
  • wsdl4j.jar
  • xalan.jar
  • xbean.jar
  • xercesImpl.jar
  • adobe-forms-client.jar
양식 서비스
Acrobat Reader DC 익스텐션 서비스
서명 서비스
SOAP
WebLogic
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • wlclient.jar
  • activation.jar
  • axis.jar
  • commons-codec-1.3.jar
  • commons-collections-3.1.jar
  • commons-discovery.jar
  • commons-logging.jar
  • dom3-xml-apis-2.5.0.jar
  • jai_imageio.jar
  • jaxen-1.1-beta-9.jar
  • jaxrpc.jar
  • log4j.jar
  • mail.jar
  • saaj.jar
  • wsdl4j.jar
  • xalan.jar
  • xbean.jar
  • xercesImpl.jar
  • adobe-forms-client.jar
  • adobe-reader-extensions-client.jar
  • adobe-signatures-client.jar

JAR 파일 업그레이드

LiveCycle에서 AEM Forms으로 업그레이드하는 경우 Java 프로젝트의 클래스 경로에 AEM Forms JAR 파일을 포함하는 것이 좋습니다. 예를 들어 Rights Management 서비스와 같은 서비스를 사용하는 경우 클래스 경로에 AEM Forms JAR 파일을 포함하지 않으면 호환성 문제가 발생합니다.
AEM Forms으로 업그레이드하는 경우 Rights Management 서비스를 호출하는 Java 응용 프로그램을 사용하려면 다음 JAR 파일의 AEM Forms 버전을 포함합니다.
  • adobe-rightsmanagement-client.jar
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
참고 항목

연결 속성 설정

Java API를 사용할 때 AEM Forms을 호출하도록 연결 속성을 설정합니다. 연결 속성을 설정할 때는 서비스를 원격으로 호출할지 로컬로 호출할지 여부를 지정하고 연결 모드 및 인증 값도 지정합니다. 서비스 보안이 활성화된 경우 인증 값이 필요합니다. 그러나 서비스 보안이 비활성화된 경우 인증 값을 지정할 필요가 없습니다.
연결 모드는 SOAP 또는 EJB 모드일 수 있습니다. EJB 모드는 RMI/IOP 프로토콜을 사용하고 EJB 모드 성능이 SOAP 모드 성능보다 우수합니다. SOAP 모드는 J2EE 응용 프로그램 서버 종속성을 제거하거나 방화벽이 AEM Forms과 클라이언트 응용 프로그램 사이에 있는 경우에 사용됩니다. SOAP 모드는 https 프로토콜을 기본 전송으로 사용하며 방화벽 경계를 넘어 통신할 수 있습니다. J2EE 응용 프로그램 서버 종속성 또는 방화벽이 모두 문제가 되는 경우 EJB 모드를 사용하는 것이 좋습니다.
AEM Forms 서비스를 성공적으로 호출하려면 다음 연결 속성을 설정합니다.
  • DSC_DEFAULT_EJB_ENDPOINT: EJB 연결 모드를 사용하는 경우 이 값은 AEM Forms이 배포된 J2EE 응용 프로그램 서버의 URL을 나타냅니다. AEM Forms을 원격으로 불러오려면 AEM Forms이 배포된 J2EE 응용 프로그램 서버 이름을 지정합니다. 클라이언트 응용 프로그램이 동일한 J2EE 응용 프로그램 서버에 있는 경우 지정할 수 있습니다 localhost . 배포된 J2EE 응용 프로그램 서버 AEM Forms에 따라 다음 값 중 하나를 지정합니다.
    • JBoss: https://<ServerName>:8080 (default port)
    • WebSphere: iiop://<ServerName>:2809 (default port)
    • WebLogic: t3://<ServerName>:7001 (default port)
  • DSC_DEFAULT_SOAP_ENDPOINT : SOAP 연결 모드를 사용 중인 경우 이 값은 호출 요청이 전송되는 끝점을 나타냅니다. AEM Forms을 원격으로 불러오려면 AEM Forms이 배포된 J2EE 응용 프로그램 서버 이름을 지정합니다. 클라이언트 응용 프로그램이 동일한 J2EE 응용 프로그램 서버에 있는 경우 localhost (예: http://localhost:8080 .)
    • 포트 값 8080 은 J2EE 응용 프로그램이 JBoss일 경우에 적용됩니다. J2EE 응용 프로그램 서버가 IBM® WebSphere®인 경우 포트를 사용하십시오 9080 . 마찬가지로 J2EE 응용 프로그램 서버가 WebLogic이면 포트를 사용하십시오 7001 . 이 값은 기본 포트 값입니다. 포트 값을 변경하는 경우 해당 포트 번호를 사용하십시오.)
  • DSC_TRANSPORT_PROTOCOL : EJB 연결 모드를 사용 중인 경우 이 값 ServiceClientFactoryProperties.DSC_EJB_PROTOCOL 에 대해 지정합니다. SOAP 연결 모드를 사용하는 경우 을 지정합니다 ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL .
  • DSC_SERVER_TYPE : AEM Forms이 배포되는 J2EE 응용 프로그램 서버를 지정합니다. 유효한 값은 JBoss , WebSphere , WebLogic 입니다.
    • 이 연결 속성을 로 설정하면 값 WebSphere java.naming.factory.initial 로 설정됩니다 com.ibm.ws.naming.util.WsnInitCtxFactory .
    • 이 연결 속성을 로 설정하면 값 WebLogic java.naming.factory.initial 로 설정됩니다 weblogic.jndi.WLInitialContextFactory .
    • 마찬가지로 이 연결 속성을 로 설정하면 값 JBoss java.naming.factory.initial 로 설정됩니다 org.jnp.interfaces.NamingContextFactory .
    • 기본값을 사용하지 않으려는 경우 java.naming.factory.initial 속성을 요구 사항을 충족하는 값으로 설정할 수 있습니다.
    문자열을 사용하여 DSC_SERVER_TYPE 연결 속성을 설정하는 대신 클래스의 정적 멤버를 사용할 수 ServiceClientFactoryProperties 있습니다. 다음 값을 사용할 수 있습니다. ServiceClientFactoryProperties.DSC_WEBSPHERE_SERVER_TYPE , ServiceClientFactoryProperties.DSC_WEBLOGIC_SERVER_TYPE 또는 ServiceClientFactoryProperties.DSC_JBOSS_SERVER_TYPE .
  • DSC_CREDENTIAL_USERNAME: AEM Forms 사용자 이름을 지정합니다. 사용자가 AEM Forms 서비스를 성공적으로 호출하려면 서비스 사용자 역할이 필요합니다. 사용자는 서비스 호출 권한을 포함하는 다른 역할을 가질 수도 있습니다. 그렇지 않으면 서비스를 호출하려고 하면 예외가 발생합니다. 서비스 보안이 비활성화된 경우 이 연결 속성을 지정할 필요가 없습니다.
  • DSC_CREDENTIAL_PASSWORD: 해당 암호 값을 지정합니다. 서비스 보안이 비활성화된 경우 이 연결 속성을 지정할 필요가 없습니다.
  • DSC_REQUEST_TIMEOUT: SOAP 요청에 대한 기본 요청 시간 초과 제한은 12,0000밀리초(20분)입니다. 한 번 요청하면 작업을 완료하는 데 시간이 더 걸릴 수 있습니다. 예를 들어, 큰 레코드 집합을 검색하는 SOAP 요청은 더 긴 시간 제한 제한이 필요할 수 있습니다. SOAP 요청 ServiceClientFactoryProperties.DSC_REQUEST_TIMEOUT 에 대한 요청 호출 시간 초과 제한을 늘리는 데 이 변수를 사용할 수 있습니다.
    참고 : SOAP 기반 호출만 DSC_REQUEST_TIMEOUT 속성을 지원합니다.
연결 속성을 설정하려면 다음 작업을 수행하십시오.
  1. 생성자를 사용하여 java.util.Properties 개체를 만듭니다.
  2. 연결 DSC_DEFAULT_EJB_ENDPOINT 속성을 설정하려면 java.util.Properties 개체의 setProperty 메서드를 호출하고 다음 값을 전달합니다.
    • 열거형 ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT
    • AEM Forms을 호스팅하는 J2EE 응용 프로그램 서버의 URL을 지정하는 문자열 값
    SOAP 연결 모드를 사용하는 경우 열거형 값 대신 ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT 열거형 값을 ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT 지정합니다.
  3. 연결 DSC_TRANSPORT_PROTOCOL 속성을 설정하려면 java.util.Properties 개체의 setProperty 메서드를 호출하고 다음 값을 전달합니다.
    • 열거형 ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL
    • 열거형 ServiceClientFactoryProperties.DSC_EJB_PROTOCOL
    SOAP 연결 모드를 사용하는 경우 열거형 값 대신 ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL 열거형 값을 ServiceClientFactoryProperties.DSC_EJB_PROTOCOL 지정합니다.
  4. 연결 DSC_SERVER_TYPE 속성을 설정하려면 java.util.Properties 개체의 setProperty 메서드를 호출하고 다음 값을 전달합니다.
    • 열거형 ServiceClientFactoryProperties.DSC_SERVER_TYPE
    • AEM Forms을 호스팅하는 J2EE 응용 프로그램 서버를 지정하는 문자열 값(예: AEM Forms이 JBoss에 배포된 경우 지정 JBoss ).
      1. 연결 DSC_CREDENTIAL_USERNAME 속성을 설정하려면 java.util.Properties 개체의 setProperty 메서드를 호출하고 다음 값을 전달합니다.
    • 열거형 ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME
    • AEM Forms을 호출하는 데 필요한 사용자 이름을 지정하는 문자열 값
      1. 연결 DSC_CREDENTIAL_PASSWORD 속성을 설정하려면 java.util.Properties 개체의 setProperty 메서드를 호출하고 다음 값을 전달합니다.
    • 열거형 ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD
    • 해당 암호 값을 지정하는 문자열 값
JBoss에 대한 EJB 연결 모드 설정
다음 Java 코드 예제에서는 연결 속성을 설정하여 JBoss에 배치된 AEM Forms을 호출하고 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");

WebLogic에 대한 EJB 연결 모드 설정
다음 Java 코드 예제에서는 연결 속성을 설정하여 WebLogic에 배포된 AEM Forms을 호출하고 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");

WebSphere에 대한 EJB 연결 모드 설정
다음 Java 코드 예제에서는 연결 속성을 설정하여 WebSphere에 배치된 AEM Forms을 호출하고 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");

SOAP 연결 모드 설정
다음 Java 코드 예제에서는 SOAP 모드에서 연결 속성을 설정하여 JBoss에 배포된 AEM Forms을 호출합니다.
 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");

SOAP 연결 모드를 선택하는 경우 클라이언트 응용 프로그램의 클래스 경로에 추가 JAR 파일을 포함해야 합니다.
서비스 보안이 비활성화된 경우 연결 속성 설정
다음 Java 코드 예제에서는 JBoss Application Server에 배포된 AEM Forms을 호출하는 데 필요한 연결 속성을 설정하고 서비스 보안을 사용하지 않도록 설정합니다.
 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");

AEM Forms을 사용한 프로그래밍과 연관된 모든 Java 빠른 시작은 EJB 및 SOAP 연결 설정을 모두 보여줍니다.
사용자 지정 요청 제한 시간 제한이 있는 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");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_REQUEST_TIMEOUT, "1800000"); // Request timeout limit 30 Minutes

Context 개체를 사용하여 AEM Forms 호출
개체를 사용하여 인증된 사용자와 AEM Forms 서비스를 호출할 수 있습니다(개체가 인증된 사용자를 com.adobe.idp.Context com.adobe.idp.Context 나타냅니다). 개체를 사용할 때는 com.adobe.idp.Context 속성이나 속성을 설정할 필요가 DSC_CREDENTIAL_USERNAME 없습니다 DSC_CREDENTIAL_PASSWORD . 객체 com.adobe.idp.Context 의 방법을 사용하여 사용자를 인증할 때 AuthenticationManagerServiceClient 객체를 가져올 수 authenticate 있습니다.
authenticate 메서드는 인증 결과가 포함된 AuthResult 개체를 반환합니다. 생성자를 호출하여 com.adobe.idp.Context 객체를 만들 수 있습니다. 그런 다음 다음 com.adobe.idp.Context 개체의 initPrincipal 메서드를 호출하고 다음 코드와 같이 AuthResult 개체를 전달합니다.
 Context myCtx = new Context();
 myCtx.initPrincipal(authResult);

또는 DSC_CREDENTIAL_USERNAME 속성을 설정하는 대신 DSC_CREDENTIAL_PASSWORD 개체의 메서드를 ServiceClientFactory 호출하여 setContext 개체를 전달할 수 있습니다 com.adobe.idp.Context . AEM Forms 사용자를 사용하여 서비스를 호출할 때 AEM Forms 서비스를 호출하는 데 필요한 역할 Services User 이 있는지 확인합니다.
다음 코드 예제에서는 개체를 만드는 데 사용되는 연결 설정 내에서 com.adobe.idp.Context 개체를 사용하는 방법을 보여 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);

사용자 인증에 대한 자세한 내용은 사용자 인증을 참조하십시오 .

시나리오 호출

다음 호출 시나리오에 대해서는 이 섹션에서 설명합니다.
  • 자체 JVM(Java Virtual Machine)에서 실행되는 클라이언트 애플리케이션이 독립 실행형 AEM Forms 인스턴스를 호출합니다.
  • 자체 JVM에서 실행되는 클라이언트 응용 프로그램은 클러스터된 AEM Forms 인스턴스를 호출합니다.

독립 실행형 AEM Forms 인스턴스를 호출하는 클라이언트 응용 프로그램

다음 다이어그램은 자체 JVM에서 실행되고 독립 실행형 AEM Forms 인스턴스를 호출하는 클라이언트 응용 프로그램을 보여줍니다.
이 시나리오에서는 클라이언트 애플리케이션이 자체 JVM에서 실행되고 AEM Forms 서비스를 호출합니다.
이 시나리오는 모든 빠른 시작을 기반으로 하는 호출 시나리오입니다.

클러스터된 AEM Forms 인스턴스를 호출하는 클라이언트 응용 프로그램

다음 다이어그램은 자체 JVM에서 실행되는 클라이언트 응용 프로그램과 클러스터에 있는 AEM Forms 인스턴스 불러오기를 보여줍니다.
이 시나리오는 독립 실행형 AEM Forms 인스턴스를 호출하는 클라이언트 응용 프로그램과 유사합니다. 그러나 공급자 URL은 다릅니다. 클라이언트 응용 프로그램이 특정 J2EE 응용 프로그램 서버에 연결하려는 경우 응용 프로그램은 특정 J2EE 응용 프로그램 서버를 참조하도록 URL을 변경해야 합니다.
응용 프로그램 서버가 중지되면 클라이언트 응용 프로그램과 AEM Forms 간의 연결이 종료되므로 특정 J2EE 응용 프로그램 서버를 참조하는 것은 권장되지 않습니다. 공급자 URL은 특정 J2EE 응용 프로그램 서버 대신 셀 수준 JNDI 관리자를 참조하는 것이 좋습니다.
SOAP 연결 모드를 사용하는 클라이언트 응용 프로그램은 클러스터에 대해 HTTP 부하 균형 조정기 포트를 사용할 수 있습니다. EJB 연결 모드를 사용하는 클라이언트 응용 프로그램은 특정 J2EE 응용 프로그램 서버의 EJB 포트에 연결할 수 있습니다. 이 작업은 클러스터 노드 간의 로드 밸런싱을 처리합니다.
WebSphere
다음 예제는 WebSphere에 배포된 AEM Forms에 연결하는 데 사용되는 jndi.properties 파일의 내용을 보여줍니다.
 java.naming.factory.initial=com.ibm.websphere.naming.
 WsnInitialContextFactory
 java.naming.provider.url=corbaloc::appserver1:9810,:appserver2:9810

WebLogic
다음 예는 WebLogic에 배포된 AEM Forms에 연결하는 데 사용되는 jndi.properties 파일의 내용을 보여줍니다.
 java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory
 java.naming.provider.url=t3://appserver1:8001, appserver2:8001

JBoss
다음 예는 JBoss에 배포된 AEM Forms에 연결하는 데 사용되는 jndi.properties 파일의 내용을 보여줍니다.
 java.naming.factory.initial= org.jnp.interfaces.NamingContextFactory
 java.naming.provider.url= jnp://appserver1:1099, appserver2:1099,
 appserver3:1099

J2EE 응용 프로그램 서버 이름과 포트 번호를 확인하려면 관리자에게 문의하십시오.
참고 항목

Java API를 사용하여 AEM Forms 서비스에 데이터 전달

AEM Forms 서비스 작업은 일반적으로 PDF 문서를 소비하거나 생성합니다. 서비스를 호출할 때 PDF 문서(또는 XML 데이터와 같은 기타 문서 유형)를 서비스에 전달해야 하는 경우가 있습니다. 마찬가지로 서비스에서 반환되는 PDF 문서를 처리해야 하는 경우도 있습니다. AEM Forms 서비스에 데이터를 전달할 수 있는 Java 클래스는 입니다 com.adobe.idp.Document .
AEM Forms 서비스는 PDF 문서를 java.io.InputStream 개체나 바이트 배열과 같은 다른 데이터 유형으로 허용하지 않습니다. 또한 개체를 사용하여 XML 데이터와 같은 다른 데이터 형식을 서비스로 전달할 수도 있습니다. com.adobe.idp.Document
개체는 Java serializable 형식이므로 RMI 호출을 통해 전달할 수 있습니다. com.adobe.idp.Document 받는 쪽의 위치는 동일한 호스트, 동일한 클래스 로더), 로컬(동일한 호스트, 다른 클래스 로더) 또는 원격(다른 호스트)으로 열 수 있습니다. 문서 컨텐츠 전달은 각 사례에 맞게 최적화되어 있습니다. 예를 들어, 발신자와 수신자가 동일한 호스트에 있는 경우 해당 컨텐츠는 로컬 파일 시스템을 통해 전달됩니다. (경우에 따라 문서를 메모리에 전달할 수 있습니다.)
개체 com.adobe.idp.Document 크기에 따라 데이터는 개체 내에서 com.adobe.idp.Document 전달되거나 서버의 파일 시스템에 저장됩니다. 객체가 점유하는 모든 임시 스토리지 자원 com.adobe.idp.Document 은 폐기 시 자동으로 com.adobe.idp.Document 제거됩니다. 문서 개체 처리를 참조하십시오 .
경우에 따라 서비스에 객체를 전달하려면 먼저 com.adobe.idp.Document 객체의 컨텐츠 유형을 알아야 합니다. 예를 들어 작업에 특정 컨텐츠 유형(예: application/pdf 콘텐트 유형)이 필요한 경우 컨텐츠 유형을 결정하는 것이 좋습니다. 자세한 내용은 문서의 컨텐츠 유형 결정을 참조하십시오 .
com.adobe.idp.Document 개체는 제공된 데이터를 사용하여 콘텐트 유형을 확인합니다. 제공된 데이터에서 컨텐츠 유형을 검색할 수 없는 경우(예: 데이터가 바이트 배열로 제공되었을 때) 컨텐츠 유형을 설정합니다. 컨텐츠 유형을 설정하려면 com.adobe.idp.Document 개체의 메서드를 setContentType 호출합니다. (문서 의 컨텐츠 유형 결정 참조 )
동일한 파일 시스템에 부수적 파일이 있는 경우 보다 신속하게 com.adobe.idp.Document 객체를 만들 수 있습니다. 원격 파일 시스템에 부수적 파일이 있는 경우 복사 작업을 수행해야 하므로 성능이 저하됩니다.
응용 프로그램에는 com.adobe.idp.Document org.w3c.dom.Document 데이터 유형이 모두 포함될 수 있습니다. 그러나 org.w3c.dom.Document 데이터 유형의 자격을 완전히 갖추었는지 확인하십시오. 객체를 개체로 변환하는 방법에 대한 자세한 내용은 org.w3c.dom.Document com.adobe.idp.Document 빠른 시작(EJB 모드)을 참조하십시오. Java API를 사용하여 양식에 플로우 가능한 레이아웃을 채울 수 있습니다 .
개체를 사용하는 동안 WebLogic에서 메모리 누수를 방지하려면 문서 정보를 2048바이트 이하의 청크 단위로 읽으십시오. com.adobe.idp.Document 예를 들어 다음 코드는 2048바이트 단위로 문서 정보를 읽습니다.
        // 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();

참고 항목

문서 만들기

PDF 문서(또는 기타 문서 유형)를 입력 값으로 필요로 하는 서비스 작업을 호출하기 전에 com.adobe.idp.Document 객체를 만듭니다. 이 com.adobe.idp.Document 클래스는 다음과 같은 컨텐츠 유형에서 문서를 만들 수 있는 생성자를 제공합니다.
  • 바이트 배열
  • 기존 com.adobe.idp.Document 개체
  • 개체 java.io.File
  • 개체 java.io.InputStream
  • 개체 java.net.URL

바이트 배열을 기반으로 문서 만들기

다음 코드 예제에서는 바이트 배열을 기반으로 하는 com.adobe.idp.Document 개체를 만듭니다.
바이트 배열을 기반으로 하는 Document 객체 만들기
 Document myPDFDocument = new Document(myByteArray);

다른 문서를 기반으로 문서 만들기

다음 코드 예제에서는 다른 개체를 기반으로 하는 com.adobe.idp.Document 개체를 com.adobe.idp.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);

파일을 기반으로 문서 만들기

다음 코드 예제에서는 map.pdf라는 PDF 파일을 기반으로 한 개체를 com.adobe.idp.Document 만듭니다 **. 이 파일은 C 하드 드라이브 루트에 있습니다. 이 생성자는 파일 이름 확장자를 사용하여 개체의 MIME 콘텐츠 형식을 com.adobe.idp.Document 설정하려고 합니다.
객체를 com.adobe.idp.Document 수락하는 생성자도 java.io.File 부울 매개 변수를 수락합니다. 이 매개 변수를 로 설정하면 true 개체가 com.adobe.idp.Document 파일을 삭제합니다. 이 작업은 파일을 생성자에게 전달한 후 파일을 제거할 필요가 없음을 com.adobe.idp.Document 의미합니다.
이 매개 변수를 설정하여 이 파일의 소유권을 유지함을 false 의미합니다. 이 매개 변수를 보다 효율적으로 true 설정합니다. 이유는 개체가 파일을 복사하지 않고 로컬 관리 영역으로 바로 이동할 수 있기 때문입니다(더 느림). com.adobe.idp.Document
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);

InputStream 개체를 기반으로 문서 만들기

다음 Java 코드 예제에서는 개체를 기반으로 하는 com.adobe.idp.Document 개체를 java.io.InputStream 만듭니다.
InputStream 개체를 기반으로 문서 만들기
 //Create a Document object based on an InputStream object
 InputStream is = new FileInputStream("C:\\Map.pdf");
 Document myPDFDocument = new Document(is);

URL에서 액세스할 수 있는 컨텐츠를 기반으로 문서 만들기

다음 Java 코드 예제에서는 map.pdf라는 PDF 파일을 기반으로 한 개체를 com.adobe.idp.Document 만듭니다 **. 이 파일은 실행 중인 웹 응용 프로그램 WebApp 에 있습니다 localhost . 이 생성자는 URL 프로토콜과 함께 반환되는 콘텐츠 형식을 사용하여 com.adobe.idp.Document 개체의 MIME 콘텐츠 형식을 설정하려고 합니다.
다음 예와 같이 객체에 제공된 URL은 com.adobe.idp.Document 원래 com.adobe.idp.Document 개체가 생성된 쪽에서 항상 읽혀집니다.
     Document doc = new Document(new java.net.URL("file:c:/temp/input.pdf"));

c:/temp/input.pdf 파일은 서버 컴퓨터가 아닌 클라이언트 컴퓨터에 있어야 합니다. 클라이언트 컴퓨터는 URL을 읽는 곳이고 개체가 만들어진 com.adobe.idp.Document 곳입니다.
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);

참고 항목

반환된 문서 처리

출력 값으로 PDF 문서(또는 XML 데이터와 같은 기타 데이터 유형)를 반환하는 서비스 작업에서는 com.adobe.idp.Document 객체를 반환합니다. 객체를 받은 후 com.adobe.idp.Document 다음 형식으로 변환할 수 있습니다.
  • 개체 java.io.File
  • 개체 java.io.InputStream
  • 바이트 배열
다음 코드 행은 객체를 com.adobe.idp.Document 개체로 java.io.InputStream 변환합니다. 객체를 myPDFDocument 나타낸다고 com.adobe.idp.Document 가정합니다.
     java.io.InputStream resultStream = myDocument.getInputStream();

마찬가지로 다음 작업을 수행하여 로컬 파일 com.adobe.idp.Document 에 대한 내용을 복사할 수 있습니다.
  1. 개체를 java.io.File 만듭니다.
  2. 개체의 com.adobe.idp.Document 메서드를 호출하고 copyToFile java.io.File 개체를 전달합니다.
다음 코드 예제에서는 com.adobe.idp.Document 개체의 내용을 AnotherMap.pdf라는 파일 로 복사합니다 .
문서 개체의 내용을 파일에 복사
 File outFile = new File("C:\\AnotherMap.pdf");
 myDocument.copyToFile (outFile);

참고 항목

문서의 컨텐츠 유형 결정

개체의 메서드를 호출하여 개체의 MIME 형식 com.adobe.idp.Document com.adobe.idp.Document getContentType 결정합니다. 이 메서드는 com.adobe.idp.Document 개체의 컨텐트 유형을 지정하는 문자열 값을 반환합니다. 다음 표에서는 AEM Forms이 반환하는 다양한 컨텐츠 유형을 설명합니다.
MIME 유형
설명
application/pdf
PDF 문서
application/vnd.adobe.xdp+xml
XDP(XML Data Packaging) - XFA(XML Forms Architecture) 양식을 내보내는 데 사용됩니다.
text/xml
책갈피, 첨부 파일 또는 기타 XML 문서
application/vnd.fdf
Acrobat 양식을 내보내는 데 사용되는 FDF(Forms Data Format)
application/vnd.adobe.xfdf
Acrobat 양식을 내보내는 데 사용되는 XFDF(XML Forms Data Format)
application/rdf+xml
풍부한 데이터 포맷 및 XML
application/octet-stream
일반 데이터 형식
NULL
지정되지 않은 MIME 형식
다음 코드 예제에서는 com.adobe.idp.Document 개체의 컨텐트 유형을 결정합니다.
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);

참고 항목

문서 객체 처리

더 이상 개체가 필요하지 않은 경우 해당 Document 메서드를 호출하여 개체를 처리하는 것이 dispose 좋습니다. 각 Document 개체는 애플리케이션 호스트 플랫폼에서 파일 설명자와 최대 75MB의 RAM 공간을 사용합니다. 객체가 처리되지 않으면 Java Garage 수집 프로세스에서 Document 객체를 삭제합니다. 그러나 이 방법을 사용하면 dispose 해당 개체를 더 빨리 폐기하여 Document 개체가 차지하는 메모리를 자유화할 수 있습니다.
참고 항목

Java 클라이언트 라이브러리를 사용하여 서비스 호출

AEM Forms 서비스 작업은 Java 클라이언트 라이브러리라고 하는 서비스의 강력한 형식의 API를 사용하여 호출할 수 있습니다. Java 클라이언트 라이브러리는 서비스 컨테이너에 배포된 서비스에 대한 액세스를 제공하는 구체적인 클래스 세트입니다. 호출 API를 사용하여 개체를 만드는 대신 호출할 서비스를 나타내는 Java 개체를 InvocationRequest 인스턴스화합니다. 호출 API는 Workbench에서 생성된 긴 프로세스 등의 프로세스를 호출하는 데 사용됩니다. 인간 중심의 오랜 프로세스 호출을 참조하십시오 .
서비스 작업을 수행하려면 Java 개체에 속하는 메서드를 호출합니다. Java 클라이언트 라이브러리에는 일반적으로 서비스 작업과 일대일 매핑을 하는 메서드가 포함되어 있습니다. Java 클라이언트 라이브러리를 사용할 때는 필수 연결 속성을 설정합니다. 연결 속성 설정을 참조하십시오 .
연결 속성을 설정한 후 서비스를 호출할 수 있는 Java 개체를 인스턴스화하는 데 사용되는 ServiceClientFactory 개체를 만듭니다. Java 클라이언트 라이브러리가 있는 각 서비스에는 해당 클라이언트 개체가 있습니다. 예를 들어 Repository service를 호출하려면 생성자를 사용하여 객체를 ResourceRepositoryClient 생성하고 객체를 ServiceClientFactory 전달합니다. 개체 ServiceClientFactory 는 AEM Forms 서비스를 호출하는 데 필요한 연결 설정을 유지 관리합니다.
비록 ServiceClientFactory 일반적으로 빨리 얻기는 하지만, 공장을 처음 사용할 때 일부 오버헤드가 수반된다. 이 개체는 재사용을 위해 최적화되어 있으므로 가능하면 여러 Java 클라이언트 개체를 만들 때 동일한 ServiceClientFactory 개체를 사용하십시오. 즉, 사용자가 만드는 각 클라이언트 라이브러리 개체에 대해 별도의 ServiceClientFactory 개체를 만들지 마십시오.
객체에 영향을 주는 객체 내에 있는 SAML 어설션의 수명을 제어하는 사용자 관리자 설정이 com.adobe.idp.Context ServiceClientFactory 있습니다. 이 설정은 Java API를 사용하여 수행한 모든 호출을 포함하여 AEM Forms 전체의 모든 인증 컨텍스트 라이프타임을 제어합니다. 기본적으로 개체를 사용할 수 있는 기간은 2시간입니다. ServiceCleintFactory
Java API를 사용하여 서비스를 호출하는 방법을 설명하는 경우, 저장소 서비스의 작업이 writeResource 호출됩니다. 이 작업을 수행하면 새 리소스가 저장소에 배치됩니다.
Java 클라이언트 라이브러리를 사용하고 다음 단계를 수행하여 저장소 서비스를 호출할 수 있습니다.
  1. Java 프로젝트의 클래스 경로에 adobe-repository-client.jar와 같은 클라이언트 JAR 파일을 포함합니다. 이러한 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함을 참조하십시오 .
  2. 서비스를 호출하는 데 필요한 연결 속성을 설정합니다.
  3. 개체의 정적 ServiceClientFactory 메서드를 호출하고 연결 속성이 포함된 ServiceClientFactory createInstance java.util.Properties 개체를 전달하여 개체를 만듭니다.
  4. 생성자를 사용하여 개체를 ResourceRepositoryClient 만들고 개체를 ServiceClientFactory 전달합니다. 개체를 사용하여 저장소 서비스 작업을 ResourceRepositoryClient 호출합니다.
  5. 생성자를 사용하여 RepositoryInfomodelFactoryBean 개체를 만들고 전달합니다 null . 이 객체를 사용하면 저장소에 추가되는 컨텐츠를 나타내는 Resource 객체를 만들 수 있습니다.
  6. 개체의 메서드를 호출하고 다음 값을 전달하여 Resource 개체를 RepositoryInfomodelFactoryBean newImage 만듭니다.
    • 지정하는 고유한 ID 값 new Id() .
    • 지정하는 고유한 UUID 값 new Lid() .
    • 리소스의 이름입니다. XDP 파일의 파일 이름을 지정할 수 있습니다.
    반환 값을 다음으로 캐스팅합니다 Resource .
  7. 개체 ResourceContent 의 메서드를 호출하고 RepositoryInfomodelFactoryBean 반환 값을 다음으로 캐스팅하여 개체를 만듭니다 newImage ResourceContent . 이 개체는 저장소에 추가되는 컨텐츠를 나타냅니다.
  8. 저장소에 추가할 XDP 파일을 저장하는 com.adobe.idp.Document java.io.FileInputStream 객체를 전달하여 객체를 만듭니다. (InputStream 개체를 기반으로 문서 만들기를 참조하십시오 .)
  9. 개체의 메서드를 호출하여 개체 com.adobe.idp.Document ResourceContent 내용을 ResourceContent 개체에 setDataDocument 추가합니다. 개체를 com.adobe.idp.Document 전달합니다.
  10. 객체의 메서드를 호출하고 전달하여 저장소에 추가할 XDP 파일의 MIME 유형을 ResourceContent 설정합니다 setMimeType application/vnd.adobe.xdp+xml .
  11. 개체 's 메서드 ResourceContent 를 호출하고 개체를 전달하여 개체 Resource 의 내용을 개체에 Resource setContent ResourceContent 추가합니다.
  12. 's' Resource 개체 setDescription 메서드를 호출하고 리소스의 설명을 나타내는 문자열 값을 전달하여 리소스에 대한 설명을 추가합니다.
  13. 객체의 메서드를 호출하고 다음 값을 전달하여 ResourceRepositoryClient 양식 디자인을 저장소에 writeResource 추가합니다.
    • 새 리소스를 포함하는 리소스 컬렉션의 경로를 지정하는 문자열 값
    • 만들어진 Resource 개체
참고 항목

호출 API를 사용하여 짧은 기간 프로세스 호출

Java 호출 API를 사용하여 단기 프로세스를 호출할 수 있습니다. 호출 API를 사용하여 짧은 기간 프로세스를 호출하는 경우 개체를 사용하여 필수 매개 변수 값을 java.util.HashMap 전달합니다. 각 매개 변수가 서비스로 전달되도록 하려면 java.util.HashMap 개체의 put 메서드를 호출하고 지정된 작업을 수행하기 위해 서비스에 필요한 이름-값 쌍을 지정합니다. 단기 프로세스에 속하는 매개 변수의 정확한 이름을 지정합니다.
장기 체류 프로세스 호출에 대한 자세한 내용은 인간 중심 장기 체류 프로세스 호출을 참조하십시오 .
여기서 논의되는 내용은 호출 API를 사용하여 이름이 짧은 다음 AEM Forms을 호출하는 것입니다 MyApplication/EncryptDocument .
이 프로세스는 기존 AEM Forms 프로세스를 기반으로 하지 않습니다. 코드 예제를 따라 하려면 Workbench를 MyApplication/EncryptDocument 사용하는 프로세스를 만듭니다. (워크벤치 사용을 참조하십시오 .)
이 프로세스가 호출되면 다음 작업을 수행합니다.
  1. 프로세스로 전달된 보안되지 않은 PDF 문서를 가져옵니다. 이 작업은 작업을 SetValue 기반으로 합니다. 이 프로세스에 대한 입력 매개 변수는 document 프로세스 변수입니다(이름 inDoc ).
  2. 암호로 PDF 문서를 암호화합니다. 이 작업은 작업을 PasswordEncryptPDF 기반으로 합니다. 암호로 암호화된 PDF 문서는 이름이 지정된 프로세스 변수로 반환됩니다 outDoc .

Java 호출 API를 사용하여 MyApplication/EncryptDocument의 단기 프로세스를 호출합니다.

Java 호출 API를 사용하여 MyApplication/EncryptDocument 짧은 기간 프로세스 호출:
  1. Java 프로젝트의 클래스 경로에 adobe-livecycle-client.jar와 같은 클라이언트 JAR 파일을 포함합니다. AEM Forms Java 라이브러리 파일 포함을 참조하십시오 .
  2. 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다. 연결 속성 설정을 참조하십시오 .
  3. 생성자를 사용하여 개체를 ServiceClient 만들고 개체를 ServiceClientFactory 전달합니다. 객체를 사용하면 서비스 작업을 호출할 수 ServiceClient 있습니다. 호출 요청 찾기, 전달 및 라우팅 등의 작업을 처리합니다.
  4. 생성자를 사용하여 java.util.HashMap 개체를 만듭니다.
  5. 각 입력 매개 변수에 대해 java.util.HashMap 개체의 put 메서드를 호출하여 오래 지속되는 프로세스로 전달합니다. 단기 프로세스에 유형 MyApplication/EncryptDocument 의 입력 매개 변수가 하나만 필요하므로 다음 예제와 같이 메서드를 한 번만 호출하면 Document put 됩니다.
     //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);
    
    
  6. 개체의 메서드를 호출하고 다음 값을 전달하여 InvocationRequest 개체를 ServiceClientFactory createInvocationRequest 만듭니다.
    • 호출할 긴 프로세스 이름을 지정하는 문자열 값. 프로세스를 MyApplication/EncryptDocument 호출하려면 을 지정합니다 MyApplication/EncryptDocument .
    • 프로세스 작업 이름을 나타내는 문자열 값입니다. 일반적으로 짧은 기간 프로세스 작업의 이름이 됩니다 invoke .
    • 서비스 작업에 필요한 매개 변수 값이 포함된 java.util.HashMap 개체입니다.
    • 동기식 요청을 생성하는 부울 값 true 을 지정합니다(이 값은 단기 프로세스를 호출하는 데 적용 가능).
  7. 개체의 메서드를 호출하고 개체를 전달하여 ServiceClient 호출 요청을 서비스로 invoke InvocationRequest 보냅니다. 이 invoke 메서드는 InvocationReponse 개체를 반환합니다.
    값을 메서드의 네 번째 매개 변수 false 로 전달하여 긴 프로세스를 호출할 수 createInvocationRequest 있습니다. 값을 전달하면 비동기 요청이 false 만들어집니다.
  8. 객체의 메서드를 호출하고 출력 매개 변수의 이름을 지정하는 문자열 값을 전달하여 InvocationReponse 프로세스의 반환 값 getOutputParameter 을 검색합니다. 이 경우, outDoc (프로세스 outDoc 의 출력 매개 변수의 이름)을 MyApplication/EncryptDocument 지정합니다. 다음 예제와 같이 반환 값 Document 을 다음으로 캐스팅합니다.
     InvocationResponse response = myServiceClient.invoke(request);
     Document encryptDoc = (Document) response.getOutputParameter("outDoc");
    
    
  9. 개체를 만들고 파일 확장자가 .pdf인지 확인합니다. java.io.File
  10. 개체의 com.adobe.idp.Document 메서드를 copyToFile 호출하여 com.adobe.idp.Document 개체의 내용을 파일에 복사합니다. 메서드에서 반환된 com.adobe.idp.Document 개체를 사용해야 getOutputParameter 합니다.
참고 항목