PDDestinationOrAction

PDDestinationOrActionは、Apache PDFBoxの高レベルPDModel APIにおけるユーティリティクラスであり、PDF文書内の宛先（destination）またはアクション（action）のいずれかを扱うための統一されたインターフェースを提供します。 ( 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のナビゲーション機構として機能し、宛先は文書内の目標位置を指定し、アクションは実行される動作を定義します。このクラスは、いずれかのタイプが有効なコンテキストにおいて、これらの関連性はあるものの異なるPDFオブジェクトをポリモーフィックに扱うことで、その取り扱いを簡素化します。

PDDestinationOrActionは、Apache 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 ) で規定されているPDF仕様では、宛先はPDF文書の特定のビュー（特定のページとズーム設定など）を記述し、アクションは実行される操作（URIへのナビゲーションやアプリケーションの起動など）を記述します。このクラスが存在する理由は、リンク注釈、アウトライン項目、フォームフィールドアクションなどのいくつかのPDF構造が、宛先またはアクションのいずれかを相互に参照できるためです。開発者が型をチェックし、それぞれのケースを個別に処理することを要求するのではなく、PDDestinationOrActionはこの複雑さを抽象化する一貫性のあるプログラミングインターフェースを提供します。このクラスは、PDDestinationまたはPDActionオブジェクトのいずれかを保持できる親型として機能し、APIメソッドが単一のパラメータまたは戻り値を通じていずれかの型を受け入れたり返したりすることを可能にします。

インタラクティブなPDF機能を扱う開発者にとって、PDDestinationOrActionはナビゲーションおよびインタラクティビティ要素を処理する際にコードを大幅に簡素化します。リンク注釈、ブックマーク、フォームアクションを処理する際、開発者は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文書でナビゲーションの破損やインタラクションの失敗につながる可能性があります。

Apache PDFBoxでPDDestinationOrActionを使用する際、開発者は通常、PDFオブジェクトからナビゲーション関連のプロパティを取得するメソッドの戻り値の型として遭遇します。例えば、リンク注釈の宛先またはアクションを読み取る場合、APIは開発者に事前にどちらの型が存在するかを知ることを強制するのではなく、PDDestinationOrActionオブジェクトを返します。このクラスは、オブジェクト内に含まれる実際の型を判断し、特定のPDDestinationまたはPDActionインスタンスを取得するためのメソッドを提供します。内部的には、このクラスは基礎となるPDF辞書構造を調べて、オブジェクトが宛先（通常は配列または名前付き宛先）を表すのか、アクション（TypeエントリがActionの辞書）を表すのかを判断します。開発者は、instanceofチェックまたは型固有のgetterメソッドを使用して、具体的なオブジェクトを抽出し、その特定のプロパティを操作できます。PDF構造を作成する際、開発者はPDDestinationOrActionパラメータを受け入れるメソッドにPDDestinationまたはPDActionオブジェクトのいずれかを渡すことができ、ライブラリが ( 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構造を正しくエンコードすることを可能にします。この設計パターンは、クラス階層を通じて型安全性を維持しながら、可能な限り最も汎用的な型を受け入れるという原則に従っています。

• PDDestination – PDF文書内の特定のビューまたは位置を表すPDFBoxクラスで、ページ参照と表示パラメータを含みます
• PDAction – ユーザーインタラクションまたは文書イベントに応答して実行されるアクションを表すPDFBoxクラス
• PDAnnotation – PDF注釈の基底クラスで、その多くはインタラクティブな動作のための宛先またはアクションを含むことができます
• PDOutlineItem – ブックマークエントリを表すクラスで、クリックされたときに宛先を指すか、アクションをトリガーすることができます
• PDPageDestination – オプションのビュー設定とともにPDF文書内の特定のページを参照する、特定の型の宛先