値別に Forms をレンダリング rendering-forms-by-value

プロジェクトファイルを含める

クライアント JAR ファイル（adobe-forms-client.jar など）を Java プロジェクトのクラスパスに含めます。

Forms Client API オブジェクトの作成

• 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
• コンストラクターを使用して ServiceClientFactory オブジェクトを渡し、FormsServiceClient オブジェクトを作成します。

フォームデザインの参照

• コンストラクターを使用して、XDP ファイルの場所を指定する文字列の値を渡すことにより、レンダリングするフォームデザインを表す java.io.FileInputStream オブジェクトを作成します。
• コンストラクターを使用して java.io.FileInputStream オブジェクトを渡すことにり、com.adobe.idp.Document オブジェクトを作成します。

値でフォームをレンダリング

FormsServiceClient オブジェクトの renderPDFForm メソッドを呼び出して、以下の値を渡します。

• 空の文字列の値（通常、このパラメーターにはフォームデザインの名前を指定する文字列の値が必要です）。
• フォームデザインを含む com.adobe.idp.Document オブジェクト。通常、このパラメーター値はフォームにマージするデータ用に予約されています。
• 実行時オプションを保存する PDFFormRenderSpec オブジェクト。これはオプションのパラメーターで、実行時オプションを指定しない場合は、null を指定できます。
• Forms サービスで必要となる URI 値が含まれる URLSpec オブジェクト。
• 添付ファイルを保存する java.util.HashMap オブジェクト。これはオプションのパラメーターで、フォームにファイルを添付しない場合に null を指定できます。

renderPDFForm メソッドは、クライアント web ブラウザーに書き込むことができるフォームデータストリームを含む FormsResult オブジェクトを返します。

フォームデータストリームをクライアント web ブラウザーに書き込む

• FormsResult オブジェクトの getOutputContent メソッドを呼び出して、com.adobe.idp.Document オブジェクトを作成します。
• getContentType メソッドを呼び出して、com.adobe.idp.Document オブジェクトのコンテンツタイプを取得します。
• javax.servlet.http.HttpServletResponse オブジェクトの setContentType メソッドを呼び出してコンテンツタイプを設定し、com.adobe.idp.Document オブジェクトのコンテンツタイプを渡します。
• javax.servlet.http.HttpServletResponse オブジェクトの getOutputStream メソッドを呼び出して、javax.servlet.ServletOutputStream オブジェクトを作成します。このオブジェクトは、フォームデータストリームをクライアント web ブラウザーに書き込むために使用されます。
• com.adobe.idp.Document オブジェクトの getInputStream メソッドを呼び出すことによって、java.io.InputStream オブジェクトを作成します。
• バイト配列を作成し、InputStream オブジェクトのサイズを割り当てます。InputStream オブジェクトの available メソッドを呼び出して、InputStream オブジェクトのサイズを取得します。
• InputStream オブジェクトの read メソッドを呼び出して、バイト配列を引数として渡すことにより、バイト配列にフォームデータストリームを格納します。
• javax.servlet.ServletOutputStream オブジェクトの write メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに送信します。バイト配列を write メソッドに渡します。

プロジェクトファイルを含める

• Forms Service WSDL を使用する Java プロキシクラスを作成します。
• Java プロキシクラスをクラスパスに含めます。

Forms Client API オブジェクトの作成

FormsService オブジェクトを作成し、認証情報を設定します。

フォームデザインの参照

• コンストラクターを使用して java.io.FileInputStream オブジェクトを作成します。XDP ファイルの場所を指定する文字列の値を渡します。
• コンストラクターを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、パスワードで暗号化された PDF ドキュメントを保存するために使用されます。
• java.io.FileInputStream オブジェクトのコンテンツを格納するバイト配列を作成します。available メソッドを使用して java.io.FileInputStream オブジェクトのサイズを取得することにより、バイト配列のサイズを指定できます。
• java.io.FileInputStream オブジェクトの read メソッドを呼び出してバイト配列を渡すことにより、バイト配列にストリームデータを格納します。
• setBinaryData メソッドを呼び出してバイト配列を渡すことにより、BLOB オブジェクトに入力します。

値でフォームをレンダリング

FormsService オブジェクトの renderPDFForm メソッドを呼び出して、以下の値を渡します。

• 空の文字列の値（通常、このパラメーターにはフォームデザインの名前を指定する文字列の値が必要です）。
• フォームデザインを含む BLOB オブジェクト。通常、このパラメーター値はフォームにマージするデータ用に予約されています。
• 実行時オプションを保存する PDFFormRenderSpec オブジェクト。これはオプションのパラメーターで、実行時オプションを指定しない場合は、null を指定できます。
• Forms サービスで必要となる URI 値が含まれる URLSpec オブジェクト。
• 添付ファイルを保存する java.util.HashMap オブジェクト。これはオプションのパラメーターで、 フォームにファイルを添付しない場合に、nullを指定します。
• メソッドによって設定される空の com.adobe.idp.services.holders.BLOBHolder オブジェクト。これは、レンダリングされた PDF フォームを保存するために使用されます。
• メソッドによって設定される空の javax.xml.rpc.holders.LongHolder オブジェクト。（この引数は、フォームのページ数を保存します）。
• メソッドによって設定される空の javax.xml.rpc.holders.StringHolder オブジェクト。（この引数はロケール値を格納します。）
• この操作の結果を格納する 空の com.adobe.idp.services.holders.FormsResultHolder オブジェクト。

renderPDFForm メソッドは、最後の引数値として渡される com.adobe.idp.services.holders.FormsResultHolder オブジェクトに、クライアント web ブラウザーに書き込む必要のあるフォームデータストリームを入力します。

フォームデータストリームをクライアント web ブラウザーに書き込む

• com.adobe.idp.services.holders.FormsResultHolder オブジェクトの value データメンバーの値を取得して、FormResult オブジェクトを作成します。
• FormsResult オブジェクトの getOutputContent メソッドを呼び出して、フォームデータを含む BLOB オブジェクトを作成します。
• getContentType メソッドを呼び出して、BLOB オブジェクトのコンテンツタイプを取得します。
• javax.servlet.http.HttpServletResponse オブジェクトの setContentType メソッドを呼び出してコンテンツタイプを設定し、BLOB オブジェクトのコンテンツタイプを渡します。
• javax.servlet.http.HttpServletResponse オブジェクトの getOutputStream メソッドを呼び出して、クライアントの web ブラウザーにフォームデータストリームを書き込むために使用する javax.servlet.ServletOutputStream オブジェクトを作成します。
• BLOB オブジェクトの getBinaryData メソッドを呼び出し、バイト配列を作成して入力します。このタスクは、FormsResult オブジェクトのコンテンツをバイト配列に割り当てます。
• javax.servlet.http.HttpServletResponse オブジェクトの write メソッドを呼び出して、フォームデータストリームをクライアント web ブラウザーに送信します。バイト配列を write メソッドに渡します。