PDComplexFileSpecification

PDComplexFileSpecificationは、Apache PDFBoxのPDModel APIに含まれるクラスで、PDF文書内の複合ファイル仕様構造を表現します。 ( 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内でファイルを参照または埋め込む方法を記述し、複数のプラットフォーム、説明、および関連メタデータのサポートを含みます。この高レベルJavaクラスは、開発者がこれらのファイル仕様辞書をプログラム的に作成、読み取り、および変更するためのメソッドを提供します。

PDComplexFileSpecificationは、Apache PDFBoxライブラリに含まれるJavaクラスで、PDFファイル仕様辞書(Type /Filespec)をカプセル化します。単なる文字列ファイル名で構成される単純なファイル仕様とは異なり、複合ファイル仕様は辞書オブジェクトであり、 ( 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 ) で定義されているプラットフォーム固有のファイルパス、埋め込みファイルストリーム、説明、MIMEタイプ、および関連ファイルパラメータを含むことができます。このクラスはPDFileSpecificationを継承し、すべての標準ファイル仕様辞書エントリに対するgetterおよびsetterメソッドを提供することで、開発者が型安全でオブジェクト指向な方法でファイル添付および外部ファイル参照を扱えるようにします。この抽象化により、開発者は基底のCOS(Carousel Object Structure)辞書オブジェクトを直接操作する必要がなくなります。

PDF添付ファイル、ポートフォリオ、または外部ファイルを参照する文書を扱う開発者にとって、PDComplexFileSpecificationは適切なファイル処理に不可欠です。このクラスは埋め込みファイルへのプログラム的なアクセスを可能にし、 ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) で規定されているアクセシビリティ準拠において特に重要です。関連ファイルは適切に記述される必要があるためです。このクラスは、PDF文書への添付ファイルの追加、埋め込みファイルの抽出、プラットフォーム固有のファイルパス(Windows、Unix、Mac)の設定、ファイルメタデータの管理などの一般的なタスクを簡素化します。この抽象化レイヤーがなければ、開発者は複雑な辞書構造を手動で構築および解析する必要があり、検証に失敗したり相互運用性の問題を引き起こす不正なPDFファイルを作成するリスクが高まります。

PDComplexFileSpecificationは、COSDictionaryオブジェクトのラッパーとして動作し、ファイル仕様エントリへの型付きアクセスを提供します。開発者は、新しい仕様を作成するか、PDF文書から取得した既存の辞書をラップすることでクラスをインスタンス化します。主要なメソッドには、汎用ファイル名を設定するsetFile()、Unicode互換ファイル名を設定するsetFileUnicode()、PDEmbeddedFileオブジェクトを通じて実際のファイルデータを添付するsetEmbeddedFile()などがあります。このクラスは、 ( 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 ) で要求されるクロスプラットフォーム互換性を確保するために、複数のファイル名バリアント(F、UF、DOS、Mac、Unixエントリ)を処理します。PDFが保存されると、PDFBoxはJavaオブジェクトを適切な辞書構造にシリアライズします。また、このクラスはファイルの説明、変更日時、関係インジケーター(AFRelationship)などのオプションエントリもサポートしており、これらはPDF/A-3およびアクセシブルなPDF文書に特に関連します。

• PDEmbeddedFile – ファイル仕様内の実際の埋め込みファイルストリームデータを表すクラス
• PDFileSpecification – 単純および複合ファイル仕様の両方の親クラスおよびインターフェース
• PDDocumentCatalog – Names辞書を通じて文書レベルのファイル添付を管理するコンテナクラス
• PDAnnotationFileAttachment – 添付アイコンを表示するためにファイル仕様を参照する注釈タイプ
• COSDictionary – 基底の辞書オブジェクト構造を表す低レベルPDFBoxクラス