FDFPage

FDFPageは、Apache PDFBoxにおいて、Forms Data Format（FDF）ファイル内のページを表すクラスです。FDFファイルは、メインのPDF文書とは別に、フォームフィールドデータやアノテーションを交換するために使用されます。FDFは ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されている軽量フォーマットで、PDF全体のコンテンツではなく、フォームデータ、アノテーション、またはページの変更情報のみを含みます。このクラスにより、開発者はフォームデータやアノテーションのインポート・エクスポート時に、ページレベルのFDF操作をプログラムで処理できるようになります。

FDFPageは、Apache PDFBoxライブラリ内のJavaクラスで、FDF文書内のページをオブジェクトとして表現します。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で規定されているテキスト、グラフィックス、レイアウト情報を含む完全なページコンテンツを持つ標準的なPDFページとは異なり、FDFページは主にアノテーションデータ、フォームフィールドの値、およびPDF文書内の対応するページに関連するページレベルの属性を参照します。FDFPageクラスには通常、FDFデータがターゲットPDFのどのページに適用されるかを示すメタデータと、そのページに固有のアノテーションやフォームフィールドの変更情報が含まれます。このクラスは、コンテンツストリームを持つ完全なページを表すPDFBoxのPDPageクラスとは異なり、実際のPDFページとマージされるか、PDFページから抽出される、ページ固有のフォームおよびアノテーションデータのコンテナとして機能します。

PDFフォームやアノテーションを扱う開発者にとって、FDFPageは、PDF文書全体を転送することなくフォームデータ交換ワークフローを実装するために不可欠です。これは、ユーザーがオンラインでPDFフォームに入力するWebアプリケーションにおいて特に重要となります。大きなPDFファイルをアップロード・ダウンロードする代わりに、変更されたフォームの値とアノテーションのみを含む軽量なFDFデータを交換できます。このアプローチにより、帯域幅の使用量が大幅に削減され、文書ワークフローのパフォーマンスが向上します。さらに、FDFPageを使用することで、開発者はPDFコンテンツとは別にアノテーションデータをプログラムで管理できます。これは、複数のユーザーが追加したアノテーションを個別にマージまたは管理する必要がある共同レビュープロセスなどのシナリオで有用です。FDFPageの理解は、フォームデータのインポート/エクスポート機能、アノテーション管理システム、または文書テンプレートからフォームデータを分離する必要があるワークフローを実装する開発者にとって不可欠です。

FDFPageクラスは、ターゲットPDF文書内の特定のページに対応する参照とデータ構造を維持することで機能します。PDFBoxを使用してFDFファイルが作成または解析される際、各FDFPageオブジェクトには、ページインデックスまたは識別子、そのページに関連するアノテーション、場合によってはページレベルの属性などの情報が格納されます。このクラスは、これらのページ固有の要素にプログラムでアクセスし、操作するためのメソッドを提供します。FDFデータをPDFにインポートする際、FDFPageオブジェクトは対応するPDFページと照合され、それらに含まれるアノテーションやフォームフィールド値がPDF文書構造にマージされます。逆に、PDFからFDFフォーマットへフォームデータをエクスポートする際、PDFBoxライブラリはページ固有のアノテーションとフォームデータを整理するためにFDFPageオブジェクトを作成します。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているFDFフォーマット自体は、PDF構文のサブセットを使用しているため、PDFBoxのようなPDFライブラリが解析および生成することは比較的容易です。開発者は通常、FDFPageインスタンスを直接構築するのではなく、FDF文書操作のための高レベルなPDFBox APIを通じてFDFPageオブジェクトとやり取りします。これにより、ライブラリがFDFページとPDFページのマッチングや基盤となるデータ構造の管理の複雑さを処理します。

• FDFDocument – 1つ以上のFDFPageオブジェクトを含み、フォームデータ交換を管理する完全なFDFファイルを表すApache PDFBoxクラス
• PDPage – 軽量なFDFページ表現とは異なる、完全なコンテンツを持つPDF文書内のページを表す標準的なApache PDFBoxクラス
• PDAcroForm – PDF文書内のインタラクティブフォームを扱うApache PDFBoxクラスで、FDFフォーマットを使用してデータをインポート・エクスポートできる
• PDAnnotation – FDFフォーマットで保存でき、FDFPageオブジェクトに関連付けられるPDFアノテーションのためのApache PDFBoxクラス
• Forms Data Format（FDF） – PDF文書とは別にフォームフィールドデータとアノテーションを交換するためのISO標準化されたファイルフォーマット