PDJavascriptNameTreeNode

PDJavascriptNameTreeNodeは、Apache PDFBoxライブラリのクラスで、PDF文書内のJavaScript名前ツリーへのプログラマティックなアクセスを提供します。JavaScript名前ツリーは、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 ) で定義されている構造で、階層的な命名システムを使用してJavaScriptアクションとスクリプトを整理します。このクラスにより、開発者はPDFBoxの高レベルPDModel APIを通じて、PDF文書に埋め込まれたJavaScriptコードの読み取り、変更、管理が可能になります。

PDJavascriptNameTreeNodeは、 ( 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 ) で定義されているJavaScript名前ツリー構造を扱うApache PDFBox内の特化した実装です。名前ツリーは、文字列キーをPDFオブジェクトにマッピングするPDFファイル内の効率的なデータ構造で、特にアルファベット順の並び替えと高速検索が重要な大規模コレクション向けに設計されています。このクラスは、辞書ベースの直接的なアプローチとは異なり、JavaScriptエントリの数が増加しても効率的にスケールするツリーベースの構造を提供します。このクラスはPDFBoxの基本名前ツリーノード機能を拡張し、特にJavaScriptアクションオブジェクトを扱うことで、開発者が文書内のすべてのJavaScriptコードを列挙したり、名前で特定のスクリプトを取得したり、文書カタログに新しいJavaScriptエントリを追加したりできるようにします。

インタラクティブなPDF文書を扱う開発者にとって、PDJavascriptNameTreeNodeは文書レベルのJavaScript機能を管理するために不可欠です。PDF文書には、フォーム検証、自動計算、カスタムユーザーインタラクション、文書自動化のためのJavaScriptを含めることができます。このクラスは、低レベルのPDF構造を手動で解析することなく、これらのスクリプトをプログラマティックに扱うために必要な抽象化を提供します。このクラスの理解と使用は、セキュリティ上の懸念を監査する（潜在的に悪意のあるスクリプトを分析する）、文書操作中にフォーム機能を維持する、または生成されたPDFにプログラマティックにインタラクティブな動作を追加する必要があるPDF処理ワークフローを構築する際に特に重要です。JavaScript名前ツリーを適切に処理しないと、開発者は文書のインタラクティビティを失ったり、文書を変更する際に破損したPDF構造を作成したりするリスクがあります。

PDJavascriptNameTreeNodeは、PDF文書カタログの/Names辞書内の/JavaScriptエントリに格納されている名前ツリー構造を操作します。このクラスは、ツリー構造を走査するメソッドを提供します。ツリー構造には、中間ノード（子ノードを指す/Kids配列を持つ）とリーフノード（実際の名前-値ペアを含む/Names配列を持つ）の両方を含めることができます。JavaScriptエントリにアクセスする際、このクラスは名前ツリーに固有のバイナリサーチ最適化を処理します。エントリはアルファベット順にソートされ、各サブツリー内の名前の範囲を定義する/Limits配列を含めることができます。開発者は通常、文書カタログの名前辞書を通じてこの構造にアクセスし、次にPDJavascriptNameTreeNodeを使用してエントリを反復処理したり、名前で特定のJavaScriptアクションを取得したり、新しいJavaScriptコードを追加したりします。このクラスは、基礎となるCOSDictionaryオブジェクト（PDFBoxの低レベル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 ) で要求される適切なソートと境界制限を維持することを保証します。

• PDNameTreeNode – PDFBox内のすべての名前ツリー実装の基底クラスで、汎用名前ツリー機能を提供します
• PDDocumentCatalog – JavaScript名前ツリーが格納される名前辞書を含む、PDF文書のルートオブジェクトです
• PDActionJavaScript – 名前ツリーエントリによって参照される実際のスクリプトコードを含むJavaScriptアクションオブジェクトを表します
• COSDictionary – すべての高レベルPDModel構造の基礎となるPDF辞書オブジェクトを表すPDFBoxの低レベルクラスです
• PDDocumentNameDictionary – JavaScript、埋め込みファイル、リンク先を含む、PDF文書内のすべての名前ツリーのコンテナクラスです