PDFileSpecification

PDFileSpecificationは、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内で外部ファイルや埋め込みファイルストリームがどのように参照されるかを定義します。このクラスは、ファイル仕様オブジェクトを作成、読み取り、変更するためのメソッドを提供し、開発者がファイル添付や外部ファイル参照をプログラム的に扱えるようにします。

PDFileSpecificationは、 ( 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クラスです。PDFアーキテクチャにおいて、ファイル仕様とは、パスで参照される外部ファイルであれ、PDF自体に含まれる埋め込みファイルストリームであれ、ファイルの位置特定とアクセス方法を記述するデータ構造です。このクラスは、ファイル名、説明、埋め込みファイルストリーム、ファイルシステム識別子などのファイル仕様プロパティを操作するためのオブジェクト指向インターフェースを提供します。PDFプリミティブオブジェクトを直接扱う低レベルのCOS（Carousel Object Structure）クラスとは異なり、PDFileSpecificationはより高い抽象化レベルで動作し、開発者にとって一般的なファイル添付操作を簡素化します。

PDF文書を扱う開発者にとって、PDFileSpecificationは、ファイル添付機能、ポートフォリオ/コレクション機能、または文書アクセシビリティの強化を実装する際に不可欠です。多くのPDFワークフローでは、補助文書、ソースファイル、または代替フォーマット版を添付する必要があります。これは特に ( 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に添付ファイルをプログラム的に追加したり、埋め込みファイルを抽出したり、ファイルメタデータを管理したり、PDFパッケージやポートフォリオを作成したりできるようになります。これは、エンタープライズ文書管理システム、自動文書処理パイプライン、および関連ファイルを単一のPDFコンテナ内にまとめる必要があるアプリケーションで特に有用です。

PDFileSpecificationは、 ( 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仕様に従ってファイル仕様データを含むCOSDictionaryオブジェクトをラップすることで機能します。開発者は通常、シンプルなファイル仕様にはPDFileSpecification.createFS()のようなファクトリメソッドを使用してインスタンスを作成するか、埋め込みファイルストリームを含む複雑なファイル仕様を構築します。このクラスは、ファイル名（プラットフォーム固有のバリアントを含む）、説明文字列、埋め込みファイルストリーム（PDEmbeddedFileオブジェクトで表現）などの主要なプロパティへのアクセサメソッドを提供します。ファイルを埋め込む際、開発者はファイルコンテンツストリームを含むPDEmbeddedFileインスタンスを作成し、圧縮パラメータを設定して、ファイル仕様に関連付けます。その後、ファイル仕様は、文書カタログの名前辞書を通じて文書に添付したり、注釈添付として追加したり、フォームフィールド値に含めたりできます。このクラスは、基盤となるCOS構造の複雑さを処理し、PDF仕様で要求される辞書キーと値の型を自動的に管理します。

• PDEmbeddedFile – PDFファイル仕様内の埋め込みファイルストリームを表現
• PDDocumentCatalog – ファイル添付のコレクションを管理するPDF文書のルートオブジェクト
• PDAnnotationFileAttachment – PDFページにファイル添付アイコンを表示する注釈タイプ
• COSDictionary – PDF辞書オブジェクトを表現する低レベルのCarousel Object Structureクラス
• PDDocumentNameDictionary – 名前をファイル仕様やその他のPDFオブジェクトにマッピングする名前辞書