PDActionURI

PDActionURIは、Apache PDFBox PDModel APIのクラスで、PDFドキュメント内のURI（Uniform Resource Identifier）アクションを表現します。 ( 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ドキュメントはウェブページ、メールアドレス、その他のネットワークアクセス可能なコンテンツなどの外部リソースにリンクできます。PDActionURIは、開発者がPDFファイル内のこれらのURIベースのナビゲーションアクションをプログラム的に読み取り、操作するためのメソッドを提供します。

PDActionURIは、Apache PDFBoxのPDModelパッケージ内の高レベルJavaクラスで、PDF仕様におけるURIアクションタイプをカプセル化します。PDF仕様の用語では、URIアクションはUniform Resource Identifierを解決し、PDFドキュメントがドキュメント境界を超えて外部コンテンツを参照できるようにします。このクラスは基底クラスであるPDActionクラスを拡張し、URI文字列および関連パラメータを処理するための特定の機能を提供します。

GoToアクション（同一ドキュメント内をナビゲート）やLaunchアクション（アプリケーションを実行）などの他のアクションタイプとは異なり、URIアクションはウェブプロトコルとネットワークリソースを特に扱います。PDActionURIクラスは、基礎となるPDFディクショナリ構造を抽象化し、URI文字列とIsMap（サーバーサイドイメージマップ用）などのオプションパラメータのゲッターおよびセッターメソッドを提供します。

PDFの操作および生成を行う開発者にとって、PDActionURIは外部リソースに接続するインタラクティブなドキュメントを作成するために不可欠です。この機能は、 ( 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にプログラム的にウェブリンクを追加すること、既存のURIアクションを変更して古いURLを更新すること、リンク注釈が関連するURIアクションを適切に参照していることを確認することなどがあります。このクラスがなければ、開発者は基礎となるPDFディクショナリ構造を手動で解析および構築する必要があり、複雑さとエラーの可能性が大幅に増加します。

PDActionURIは、ドキュメント構造内の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 ) によると、URIアクションディクショナリには、アクションタイプ（/URI）とアクセスするリソースを指定するURI文字列が含まれます。

既存のPDFを読み取る際、開発者は対応するCOSDictionaryオブジェクト（低レベル表現）を渡すことでPDActionURIをインスタンス化します。このクラスは、URI文字列を取得するgetURI()や、それを変更するsetURI(String uri)などのメソッドを提供します。URI文字列は通常、標準的なウェブプロトコル（http://、https://、mailto:、ftp://など）に従います。

PDActionURIオブジェクトは、リンク注釈（PDAnnotationLink）と一般的に関連付けられており、注釈をクリックするとURIアクションがトリガーされます。開発者は、getAction()メソッドを使用して注釈からアクションを取得し、アクションタイプがURIの場合はPDActionURIにキャストできます。新しいURIアクションを作成する際、開発者はPDActionURIを直接インスタンス化し、目的のURI文字列を設定して、適切な注釈またはインタラクティブ要素に関連付けます。

このクラスは、JavaのStringオブジェクトとPDFテキスト文字列エンコーディング要件との間の変換を処理し、国際的なURIや特殊文字の適切な文字エンコーディングを保証します。

• PDAction – URI、GoTo、Launchアクションを含むすべてのPDFアクションタイプの基底クラス
• PDAnnotationLink – PDActionURIなどのアクションに関連付けられたクリック可能な領域を作成するPDF注釈タイプ
• PDModel – PDFドキュメント構造操作のためのクラスを含む、Apache PDFBoxの高レベルAPIパッケージ
• COSDictionary – PDModelクラスの基礎となるPDFディクショナリオブジェクトを表す低レベルPDFBoxクラス
• Tagged PDF – ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) で説明されているように、適切なリンク識別を含むアクセシビリティ機能を強化する構造情報を持つPDFドキュメント