PDURIDictionary

PDURIDictionaryは、Apache PDFBox PDModel APIのクラスで、PDF文書構造内のURI辞書を表現します。URI辞書は、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 ) で定義された特殊なオブジェクトであり、Webリンクや外部参照のためのURI（Uniform Resource Identifier）情報を格納します。このクラスは、PDFビューアがWebリンクや外部リソース参照を処理する方法を制御するURI辞書エントリを読み取り、操作するための高レベルなJavaインターフェースを提供します。

PDURIDictionaryは、PDF文書内の相対URIを解決するための基準URIを定義するPDF URI辞書オブジェクトをカプセル化したJavaラッパークラスです。 ( 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文書構造において、URI辞書は文書カタログ内で指定することができ、文書内のすべての相対URIが参照点として使用する基準URIを確立します。これは単純な文字列ベースのURI格納とは異なり、URI辞書はPDF仕様の要件に準拠した特定のキー・バリューペアを持つ構造化オブジェクトです。PDURIDictionaryクラスは、低レベルなCOS（Carousel Object Structure）層の操作を抽象化し、開発者がPDFオブジェクト構文を直接操作するのではなく、標準的なJavaメソッドを使用してURI設定を扱えるようにします。

PDFBoxを使用する開発者にとって、PDURIDictionaryはPDF文書内のWebリンクを管理する必要があるアプリケーションを構築する際に不可欠です。これは、 ( 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を作成する際に特に重要です。適切なリンク構造とURI解決は、支援技術のパフォーマンスに影響を与えるためです。PDURIDictionaryを理解することで、開発者は文書の基準URIをプログラムで設定でき、PDFが異なるコンテキストや場所で表示される際に相対リンクが正しく解決されることを保証できます。この機能は、エンタープライズコンテンツ管理システム、文書生成ワークフロー、アクセシビリティ修復ツールなど、文書のライフサイクル全体を通じて有効な外部参照を維持する必要があるシステムにとって重要です。

PDURIDictionaryは、PDFBoxのPDModelレイヤーの一部として動作し、基盤となるCOS辞書オブジェクトにアクセスするためのgetterおよびsetterメソッドを提供します。開発者がPDURIDictionaryをインスタンス化または取得すると、 ( 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 ) で指定されているURI辞書エントリを含むCOSDictionaryをラップします。URI辞書の主要なエントリはBaseキーで、基準URIを表す文字列が含まれています。開発者はgetBase()のようなメソッドを使用して現在の基準URI文字列を取得したり、setBase(String)で新しい基準URIを定義したりできます。このクラスは、JavaのStringオブジェクトと仕様で要求されるPDF ASCII文字列フォーマット間の変換を処理します。PDF文書が保存されると、PDFBoxはPDURIDictionaryを適切なCOS構造にシリアライズし、PDF構文規則への準拠を保証します。この抽象化レイヤーは、PDFオブジェクトのフォーマットや辞書構造の技術的詳細を隠蔽することで、URI管理の複雑さを大幅に軽減します。

• COSDictionary – PDURIDictionaryがラップするPDF辞書オブジェクトを表す低レベルなPDFBoxクラス
• PDDocument – URI辞書を含むことができるPDF文書全体を表すPDFBoxのメインクラス
• PDDocumentCatalog – 文書全体の基準URI設定のためにURI辞書を参照する可能性がある文書カタログクラス
• PDAnnotation – 相対リンク解決のために基準URIを利用するURIアクションを含む可能性があるアノテーションオブジェクト
• PDAction – URI操作をトリガーし、URI辞書設定に依存する可能性があるアクションオブジェクト