PDSimpleFileSpecification

PDSimpleFileSpecificationは、Apache PDFBox PDModel APIの高レベルJavaクラスで、PDF文書内の単純なファイル仕様を表します。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 ) で定義されているように、外部ファイルまたは埋め込みファイルストリームへの参照を定義します。このクラスは、開発者がファイル名と場所によってファイルを識別するファイル仕様辞書を読み取り、作成、変更するためのプログラマティックなインターフェースを提供します。

PDSimpleFileSpecificationは、ファイル仕様のための基礎となるPDF辞書構造を抽象化する、Apache PDFBoxのオブジェクト指向ラッパー層の一部です。低レベルのCOSDictionary表現とは異なり、このクラスは単純なファイル仕様を扱うために特別に調整された型安全なメソッドと便利な関数を提供します。単純なファイル仕様は文字列を使用してファイルを識別しますが、これは複数のプラットフォーム固有のファイルパス、埋め込みファイルストリーム、追加のメタデータを含めることができる完全なファイル仕様辞書とは対照的です。このクラスは通常、PDF構造内の/F（ファイル仕様文字列）エントリを処理し、ファイルパスを取得および設定するメソッドを提供することで、開発者がPDF辞書エントリを直接操作することなくファイル参照を扱えるようにします。

外部ファイルを参照したりファイル添付を含むPDF文書を扱う開発者にとって、PDSimpleFileSpecificationはこれらの参照をプログラム的に管理するプロセスを簡素化します。これは特に、補助資料のための適切なファイル添付処理が要求される可能性がある ( 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を作成する際に重要です。このクラスは、直感的なgetterおよびsetterメソッドを提供することで低レベルのPDF操作の複雑さを軽減し、不正なファイル仕様につながる可能性のあるエラーを防止します。このクラスを理解することは、PDFポートフォリオ、添付ファイル管理、またはPDF文書に外部リソースをリンクするワークフローなどの機能を実装する開発者にとって不可欠です。

PDSimpleFileSpecificationは、 ( 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オブジェクトをラップします。インスタンス化されると、このクラスはファイルパスを設定するsetFile(String)やそれを取得するgetFile()などのメソッドを提供します。内部的には、これらのメソッドは基礎となる辞書の/Fキーから読み取り、書き込みを行います。このクラスはJavaのStringオブジェクトとPDF文字列オブジェクト（COSString）間の変換を処理し、エンコーディングに関する考慮事項を自動的に管理します。開発者は、新しいCOSDictionaryでクラスをインスタンス化するか、ファイルパス文字列を受け入れる便利なコンストラクタを使用することで、新しい単純なファイル仕様を作成できます。その後、オブジェクトはリンク注釈、ファイル添付注釈、または文書レベルのファイル仕様などのさまざまなPDF構造に関連付けることができます。PDFが保存されると、PDFBoxはPDF仕様で要求される適切な構文とエンコーディングでファイル仕様辞書をシリアル化します。

• PDFileSpecification – 単純なファイル仕様タイプと複雑なファイル仕様タイプの両方を含む、PDFBoxにおけるファイル仕様の抽象親クラス
• PDComplexFileSpecification – プラットフォーム固有のパス、埋め込みファイルストリーム、追加のメタデータをサポートする、より機能豊富なファイル仕様クラス
• PDEmbeddedFile – PDF内の埋め込みファイルストリームを表し、添付ファイルのためのファイル仕様によって参照されることが多い
• COSDictionary – PDSimpleFileSpecificationがラップする低レベルのCarousel Object System（COS）辞書クラス
• PDAnnotationFileAttachment – ファイル仕様を使用してPDF文書内の特定の場所にファイルを添付する注釈タイプ