제출된 Forms 처리 handling-submitted-forms

프로젝트 파일 포함

Java 프로젝트의 클래스 경로에 adobe-forms-client.jar과 같은 클라이언트 JAR 파일을 포함합니다.

Forms 클라이언트 API 개체 만들기

• 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
• 생성자를 사용하고 ServiceClientFactory 개체를 전달하여 FormsServiceClient 개체를 만듭니다.

양식 데이터 검색

• Java 서블릿에 게시된 양식 데이터를 검색하려면 생성자를 사용하고 생성자 내에서 javax.servlet.http.HttpServletResponse 개체의 getInputStream 메서드를 호출하여 com.adobe.idp.Document 개체를 만듭니다.
• 해당 생성자를 사용하여 RenderOptionsSpec 개체를 만듭니다. RenderOptionsSpec 개체의 setLocale 메서드를 호출하고 로케일 값을 지정하는 문자열 값을 전달하여 로케일 값을 설정하십시오.

• FormsServiceClient 개체의 processFormSubmission 메서드를 호출하고 다음 값을 전달하십시오.

  • 양식 데이터를 포함하는 com.adobe.idp.Document 개체입니다.
  • 모든 관련 HTTP 헤더를 포함하는 환경 변수를 지정하는 문자열 값입니다. 처리할 콘텐츠 유형을 지정합니다. XML 데이터를 처리하려면 이 매개 변수에 대해 CONTENT_TYPE=text/xml 문자열 값을 지정하십시오. PDF 데이터를 처리하려면 이 매개 변수에 대해 CONTENT_TYPE=application/pdf 문자열 값을 지정하십시오.
  • HTTP_USER_AGENT 헤더 값을 지정하는 문자열 값(예: ). Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322). 이 매개 변수 값은 선택 사항입니다.
  • 런타임 옵션을 저장하는 RenderOptionsSpec 개체입니다.

  processFormSubmission 메서드가 양식 제출 결과를 포함하는 FormsResult 개체를 반환합니다.

• FormsResult 개체의 getAction 메서드를 호출하여 Forms 서비스가 양식 데이터 처리를 완료했는지 여부를 확인합니다. 이 메서드가 값 0을(를) 반환하면 데이터를 처리할 준비가 되었습니다.

양식 제출에 첨부 파일이 포함되어 있는지 확인

• FormsResult 개체의 getAttachments 메서드를 호출합니다. 이 메서드는 양식과 함께 제출한 파일이 포함된 java.util.List 개체를 반환합니다.
• java.util.List 개체를 반복하여 첨부 파일이 있는지 확인합니다. 첨부 파일이 있는 경우 각 요소는 com.adobe.idp.Document 인스턴스입니다. com.adobe.idp.Document 개체의 copyToFile 메서드를 호출하고 java.io.File 개체를 전달하여 첨부 파일을 저장할 수 있습니다.

제출된 데이터 처리

• 데이터 콘텐츠 형식이 application/vnd.adobe.xdp+xml 또는 text/xml인 경우 응용 프로그램 논리를 만들어 XML 데이터 값을 검색합니다.

  • FormsResult 개체의 getOutputContent 메서드를 호출하여 com.adobe.idp.Document 개체를 만듭니다.
  • java.io.DataInputStream 생성자를 호출하고 com.adobe.idp.Document 개체를 전달하여 java.io.InputStream 개체를 만듭니다.
  • 정적 org.w3c.dom.DocumentBuilderFactory 개체의 newInstance 메서드를 호출하여 org.w3c.dom.DocumentBuilderFactory 개체를 만듭니다.
  • org.w3c.dom.DocumentBuilderFactory 개체의 newDocumentBuilder 메서드를 호출하여 org.w3c.dom.DocumentBuilder 개체를 만듭니다.
  • org.w3c.dom.DocumentBuilder 개체의 parse 메서드를 호출하고 java.io.InputStream 개체를 전달하여 org.w3c.dom.Document 개체를 만듭니다.
  • XML 문서 내에서 각 노드의 값을 검색합니다. 이 작업을 수행하는 한 가지 방법은 두 개의 매개 변수(org.w3c.dom.Document 개체 및 값을 검색할 노드의 이름)를 허용하는 사용자 지정 메서드를 만드는 것입니다. 이 메서드는 노드의 값을 나타내는 문자열 값을 반환합니다. 이 프로세스를 따르는 코드 예제에서는 이 사용자 지정 메서드를 getNodeText이라고 합니다. 이 메서드의 본문이 표시됩니다.

• 데이터 콘텐츠 형식이 application/pdf인 경우 응용 프로그램 논리를 만들어 제출된 PDF 데이터를 PDF 파일로 저장합니다.

  • FormsResult 개체의 getOutputContent 메서드를 호출하여 com.adobe.idp.Document 개체를 만듭니다.
  • 공용 생성자를 사용하여 java.io.File 개체를 만듭니다. PDF을 파일 이름 확장명으로 지정해야 합니다.
  • com.adobe.idp.Document 개체의 copyToFile 메서드를 호출하고 java.io.File 개체를 전달하여 PDF 파일을 채웁니다.

프로젝트 파일 포함

• Forms 서비스 WSDL을 사용하는 Java 프록시 클래스를 만듭니다.
• 클래스 경로에 Java 프록시 클래스를 포함합니다.

Forms 클라이언트 API 개체 만들기

FormsService 개체를 만들고 인증 값을 설정하십시오.

양식 데이터 검색

• Java 서블릿에 게시된 양식 데이터를 검색하려면 생성자를 사용하여 BLOB 개체를 만듭니다.

• javax.servlet.http.HttpServletResponse 개체의 getInputStream 메서드를 호출하여 java.io.InputStream 개체를 만듭니다.

• 생성자를 사용하고 java.io.InputStream 개체의 길이를 전달하여 java.io.ByteArrayOutputStream 개체를 만듭니다.

• java.io.InputStream 개체의 내용을 java.io.ByteArrayOutputStream 개체에 복사합니다.

• java.io.ByteArrayOutputStream 개체의 toByteArray 메서드를 호출하여 바이트 배열을 만듭니다.

• 해당 setBinaryData 메서드를 호출하고 바이트 배열을 인수로 전달하여 BLOB 개체를 채웁니다.

• 해당 생성자를 사용하여 RenderOptionsSpec 개체를 만듭니다. RenderOptionsSpec 개체의 setLocale 메서드를 호출하고 로케일 값을 지정하는 문자열 값을 전달하여 로케일 값을 설정하십시오.

• FormsService 개체의 processFormSubmission 메서드를 호출하고 다음 값을 전달하십시오.

  • 양식 데이터를 포함하는 BLOB 개체입니다.
  • 모든 관련 HTTP 헤더를 포함하는 환경 변수를 지정하는 문자열 값입니다. 처리할 콘텐츠 유형을 지정합니다. XML 데이터를 처리하려면 이 매개 변수에 대해 CONTENT_TYPE=text/xml 문자열 값을 지정하십시오. PDF 데이터를 처리하려면 이 매개 변수에 대해 CONTENT_TYPE=application/pdf 문자열 값을 지정하십시오.
  • HTTP_USER_AGENT 헤더 값을 지정하는 문자열 값입니다(예: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)).
  • 런타임 옵션을 저장하는 RenderOptionsSpec 개체입니다.
  • 메서드로 채워진 빈 BLOBHolder 개체입니다.
  • 메서드로 채워진 빈 javax.xml.rpc.holders.StringHolder 개체입니다.
  • 메서드로 채워진 빈 BLOBHolder 개체입니다.
  • 메서드로 채워진 빈 BLOBHolder 개체입니다.
  • 메서드로 채워진 빈 javax.xml.rpc.holders.ShortHolder 개체입니다.
  • 메서드로 채워진 빈 MyArrayOf_xsd_anyTypeHolder 개체입니다. 이 매개 변수는 양식과 함께 제출되는 첨부 파일을 저장하는 데 사용됩니다.
  • 전송된 양식으로 메서드에 의해 채워지는 빈 FormsResultHolder 개체입니다.

  processFormSubmission 메서드는 양식 제출 결과로 FormsResultHolder 매개 변수를 채웁니다.

• FormsResult 개체의 getAction 메서드를 호출하여 Forms 서비스가 양식 데이터 처리를 완료했는지 여부를 확인합니다. 이 메서드가 값 0을(를) 반환하면 양식 데이터를 처리할 준비가 되었습니다. FormsResultHolder 개체의 value 데이터 멤버의 값을 가져와서 FormsResult 개체를 가져올 수 있습니다.

양식 제출에 첨부 파일이 포함되어 있는지 확인

MyArrayOf_xsd_anyTypeHolder 개체의 value 데이터 멤버 값을 가져옵니다(MyArrayOf_xsd_anyTypeHolder 개체가 processFormSubmission 메서드에 전달됨). 이 데이터 멤버는 Objects 배열을 반환합니다. Object 배열 내의 각 요소는 양식과 함께 제출된 파일에 해당하는 Object입니다. 배열 내의 각 요소를 가져와서 BLOB 개체로 캐스팅할 수 있습니다.

제출된 데이터 처리

• 데이터 콘텐츠 형식이 application/vnd.adobe.xdp+xml 또는 text/xml인 경우 응용 프로그램 논리를 만들어 XML 데이터 값을 검색합니다.

  • FormsResult 개체의 getOutputContent 메서드를 호출하여 BLOB 개체를 만듭니다.
  • BLOB 개체의 getBinaryData 메서드를 호출하여 바이트 배열을 만듭니다.
  • java.io.ByteArrayInputStream 생성자를 호출하고 바이트 배열을 전달하여 java.io.InputStream 개체를 만듭니다.
  • 정적 org.w3c.dom.DocumentBuilderFactory 개체의 newInstance 메서드를 호출하여 org.w3c.dom.DocumentBuilderFactory 개체를 만듭니다.
  • org.w3c.dom.DocumentBuilderFactory 개체의 newDocumentBuilder 메서드를 호출하여 org.w3c.dom.DocumentBuilder 개체를 만듭니다.
  • org.w3c.dom.DocumentBuilder 개체의 parse 메서드를 호출하고 java.io.InputStream 개체를 전달하여 org.w3c.dom.Document 개체를 만듭니다.
  • XML 문서 내에서 각 노드의 값을 검색합니다. 이 작업을 수행하는 한 가지 방법은 두 개의 매개 변수(org.w3c.dom.Document 개체 및 값을 검색할 노드의 이름)를 허용하는 사용자 지정 메서드를 만드는 것입니다. 이 메서드는 노드의 값을 나타내는 문자열 값을 반환합니다. 이 프로세스를 따르는 코드 예제에서는 이 사용자 지정 메서드를 getNodeText이라고 합니다. 이 메서드의 본문이 표시됩니다.

• 데이터 콘텐츠 형식이 application/pdf인 경우 응용 프로그램 논리를 만들어 제출된 PDF 데이터를 PDF 파일로 저장합니다.

  • FormsResult 개체의 getOutputContent 메서드를 호출하여 BLOB 개체를 만듭니다.
  • BLOB 개체의 getBinaryData 메서드를 호출하여 바이트 배열을 만듭니다.
  • 공용 생성자를 사용하여 java.io.File 개체를 만듭니다. PDF을 파일 이름 확장명으로 지정해야 합니다.
  • 생성자를 사용하고 java.io.File 개체를 전달하여 java.io.FileOutputStream 개체를 만듭니다.
  • java.io.FileOutputStream 개체의 write 메서드를 호출하고 바이트 배열을 전달하여 PDF 파일을 채웁니다.