PDPropBuild

PDPropBuildは、Apache PDFBoxライブラリのPDModel APIに含まれるJavaクラスで、PDF文書内のプロパティビルド辞書を表現および操作します。これらの辞書は、PDFコンテンツの作成または変更に使用されたソフトウェア、ハードウェア、オペレーティングシステム環境に関する情報を格納します（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 ) で定義）。PDPropBuildは、PDFオブジェクトに関連付けられたビルドプロパティの読み取りと書き込みへのプログラマティックなアクセスを開発者に提供し、PDFワークフロー内でのバージョン追跡とアプリケーション識別を可能にします。

PDPropBuildは、Apache PDFBoxにおけるPDF「prop_build」辞書構造をカプセル化した高レベルラッパークラスです。この辞書タイプは、特に署名辞書やその他のメタデータ構造など、さまざまなPDFコンテキストで使用され、特定のPDF要素を作成または処理したソフトウェアアプリケーションを文書化します。このクラスは、アプリケーション名、バージョン情報、オペレーティングシステムの詳細、リビジョン番号などのビルドプロパティにアクセスするためのgetterおよびsetterメソッドを提供します。COS（Carousel Object System）オブジェクトを直接操作する低レベルのPDFBoxクラスとは異なり、PDPropBuildは基盤となる辞書操作を抽象化し、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 ) で定義された標準キーに対応する型安全なJavaメソッドを提供します。

PDF生成、検証、またはデジタル署名を扱う開発者にとって、PDPropBuildはPDFコンテンツを作成または変更したソフトウェア環境の適切な文書化を可能にします。このメタデータは、規制コンプライアンスシナリオ、アクセシビリティワークフロー、および作成ツールチェーンの追跡が不可欠な長期文書保存において特に重要です。PDF/UA準拠文書 ( 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構造を生成したソフトウェアバージョンを識別するのに役立ちます。さらに、デジタル署名実装において、prop_build辞書は署名アプリケーションに関する重要なフォレンジック情報を提供し、文書の真正性検証および署名検証の問題のトラブルシューティングをサポートします。

PDPropBuildは、prop_build辞書仕様に準拠したキーと値のペアを含むCOSDictionaryオブジェクトをラップすることで動作します。開発者は、ビルド情報を書き込むために新しいインスタンスを作成するか、署名辞書などの既存のPDF構造から抽出することでPDPropBuildをインスタンス化します。このクラスは、アプリケーション名用のsetName()、リビジョン情報用のsetREx()、オペレーティングシステム識別子用のsetOS()、タイムスタンプ用のsetDate()などのメソッドを提供します。既存のPDFを読み取る際、PDPropBuildは基盤となる辞書からこれらの値を取得し、適切なJava型に変換します。このクラスは、PDFデータ型（名前、文字列、日付）とJavaオブジェクト間の変換を処理し、PDF標準に従った適切なエンコードとデコードを保証します。PDPropBuildインスタンスを通じて設定されたビルドプロパティは、文書が保存される際にPDF構造にシリアライズされ、メタデータの完全性に関するPDF仕様の要件への準拠を維持します。

• PDModel – PDPropBuildが属するApache PDFBoxの高レベルAPIレイヤーで、PDF構造へのオブジェクト指向アクセスを提供
• COSDictionary – PDPropBuildがラップするPDF辞書オブジェクトを表す低レベルPDFBoxクラス
• PDSignature – デジタル署名作成環境を文書化するためのprop_build辞書を一般的に含む関連PDModelクラス
• PDF Metadata – ビルドプロパティを他の記述データと共に含む一般的な文書レベル情報
• Tagged PDF – 構造マークアップを持つPDF文書 ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) で、ビルドプロパティはアクセシビリティ機能の作成に使用されたツールの識別に役立つ