PDNameTreeNode

PDNameTreeNodeは、Apache PDFBox PDModel APIのJavaクラスで、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文書全体で使用される特殊なデータ構造で、効率的な検索が可能なキー・バリューマッピングを保存します。特に、名前付き遷移先、埋め込みファイル、JavaScriptアクション、その他の名前付きリソースに使用されます。この高レベルAPIクラスにより、開発者はPDF文書内の名前ツリー階層をプログラムで読み取り、変更、およびナビゲートできます。

PDNameTreeNodeは、PDFの名前ツリー構造へのJavaインターフェースを提供する実装クラスです。名前ツリーは、階層的なツリー形式で整理されたキー・バリューペアの順序付きコレクションです。単純なキー・バリュー検索を使用する辞書とは異なり、名前ツリーは、中間ノードとリーフノードを持つバランスツリー構造を使用することで、大量のエントリを効率的に処理するように特別に設計されています。このクラスは、基礎となるPDFオブジェクト表現を抽象化し、開発者が低レベルのCOS（Carousel Object Structure）レイヤーを直接操作することなく名前ツリーと対話できるようにします。PDNameTreeNodeは、名前による値の検索、エントリの反復処理、ツリー構造の整合性を維持しながら名前・値ペアの追加または削除などの操作をサポートします。

PDF文書を扱う開発者にとって、PDNameTreeNodeは名前付きリソースに依存する機能を扱う際に不可欠です。一般的な使用例には、埋め込みファイル添付ファイルへのアクセス（EmbeddedFiles名前ツリーに保存）、ナビゲーション用の名前付き遷移先の操作（Dests名前ツリーに保存）、文書レベルのJavaScriptの処理（JavaScript名前ツリーに保存）などがあります。PDNameTreeNodeを理解し正しく使用することで、アプリケーションが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 ) 。

PDNameTreeNodeは、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辞書および配列オブジェクトのラッパーとして動作します。このクラスは、中間ノード（「Kids」配列を介して子ノードへの参照を含む）とリーフノード（「Names」配列に実際の名前・値ペアを含む）の両方を走査するメソッドを提供します。値を取得する際、クラスはソート済みの名前キーに対してバイナリサーチを実行し、各サブツリーに含まれる名前の範囲を定義する「Limits」エントリに基づいてツリー階層を下っていきます。開発者は通常、PDNameTreeNodeを直接インスタンス化しません。代わりに、getCatalog().getNames().getEmbeddedFiles()などの文書カタログメソッドを通じて名前ツリーにアクセスし、適切なルートノードを取得します。このクラスは、変更が加えられた際に適切なソート順とツリーのバランスを維持する複雑さを処理し、PDF仕様要件への準拠を保証します。

• PDDocumentNameDictionary – PDF文書のカタログ内のすべての名前ツリーへのアクセスを提供するコンテナクラス
• PDEmbeddedFilesNameTreeNode – 埋め込みファイル添付ファイルを処理するためのPDNameTreeNodeの特殊化されたサブクラス
• PDPageTree – PDF文書内のページを整理するために使用される類似のツリー構造
• COSDictionary – PDNameTreeNodeがラップする低レベルのCarousel Object Structureクラス
• Named Destination – 名前ツリーを使用して名前で参照できるPDF文書内のターゲット位置