PDDocumentCatalogAdditionalActions

PDDocumentCatalogAdditionalActionsは、Apache PDFBoxライブラリのJavaクラスで、PDFドキュメントカタログの追加アクション（AA）ディクショナリへのプログラマティックなアクセスを提供します。このクラスにより、開発者はドキュメントレベルのトリガーイベントを読み取り、変更することができます。これらのトリガーイベントは、ドキュメントが開かれたとき、閉じられたとき、印刷されたとき、保存されたときなど、特定のドキュメントイベントが発生したときにアクションを実行します。追加アクションは、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 ) で定義されているインタラクティブ機能の一部であり、ドキュメントがユーザーのインタラクションやドキュメントのライフサイクルイベントに動的に応答できるようにします。

PDDocumentCatalogAdditionalActionsは、PDFBoxのPDModel APIにおける高レベルのラッパークラスで、ドキュメントカタログに関連付けられた追加アクション（AA）ディクショナリをカプセル化します。ドキュメントカタログはPDFドキュメントのオブジェクト階層のルートであり、そのAAエントリは、さまざまなドキュメントレベルのイベントに応答して実行されるアクションを指定します。このクラスは、特定のトリガーに対するアクションを取得および設定するための型安全なメソッドを提供します。これには、ドキュメントを開く（WillClose）、ドキュメントを閉じる（WillSave）、印刷前（DidPrint）、印刷後のイベントが含まれます。

ウィジェットレベルのインタラクションに応答するアノテーションの追加アクションやフォームフィールドの追加アクションとは異なり、PDDocumentCatalogAdditionalActionsはドキュメントレベルで動作し、個々のコンポーネントではなくPDF全体に影響を与えます。このクラスは、基礎となるPDFディクショナリ構造を抽象化し、開発者が生のPDF構文を直接操作するのではなく、Javaオブジェクトで作業できるようにします。

PDDocumentCatalogAdditionalActionsを理解して使用することは、自動化された動作を持つインタラクティブな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ドキュメントとの互換性を維持するためにも重要です。開発者は、ドキュメント構造を破壊することなく、これらのアクションを読み取り、保持、または変更する必要があるためです。

PDDocumentCatalogAdditionalActionsは、ドキュメントカタログのAAエントリに対応する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 ) で定義されているAAディクショナリ内の特定のキーに対応する、さまざまなイベントタイプのgetterおよびsetterメソッドを提供します。

主要なメソッドには次のものがあります：

• getWC() および setWC()：ドキュメントを閉じる前に実行される「WC」（Will Close）アクションにアクセス
• getWS() および setWS()：保存前に実行される「WS」（Will Save）アクションにアクセス
• getDS() および setDS()：保存後に実行される「DS」（Did Save）アクションにアクセス
• getWP() および setWP()：印刷前に実行される「WP」（Will Print）アクションにアクセス
• getDP() および setDP()：印刷後に実行される「DP」（Did Print）アクションにアクセス

各setterメソッドは、実行されるアクションを表すPDActionオブジェクト（またはPDActionJavaScriptなどのサブクラス）を受け入れます。取得されると、これらのメソッドは検査または変更可能なPDActionオブジェクトを返します。このクラスは、高レベルのPDActionオブジェクトと低レベルのCOSディクショナリ表現との間の変換を処理し、ドキュメントが保存されるときの適切なシリアライゼーションを保証します。

• PDDocumentCatalog – PDFドキュメントのルートカタログオブジェクトで、メタデータ、ページツリーの参照、ドキュメントレベルの設定を含む
• PDAction – PDFファイル内でユーザーのインタラクションやドキュメントイベントによってトリガーされるアクションを表す基底クラス
• PDActionJavaScript – PDFビューアコンテキスト内でJavaScriptコードを実行するPDActionのサブクラス
• COSDictionary – PDFオブジェクトの生のディクショナリ構造を表すPDFBoxの低レベルクラス
• PDAnnotationAdditionalActions – ドキュメントレベルではなくアノテーションレベルで追加アクションを処理する同様のクラス