COSObjectKey

COSObjectKeyは、Apache PDFBoxにおいて、PDFの低レベルなCarousel Object Structure（COS）レイヤー内のオブジェクトを一意に識別するためのクラスです。COSレイヤーは、 ( 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文書構造全体にわたって間接オブジェクトを配置および管理するための参照機構として機能します。

COSObjectKeyは、PDFファイル内の間接オブジェクトを一意に識別する2つの整数値、すなわちオブジェクト番号と世代番号をカプセル化します。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 ) では、間接オブジェクトは「n g obj」という形式でこの番号ペアによって参照されます。ここでnはオブジェクト番号、gは世代番号です。COSObjectKeyクラスは、この識別スキームのJava表現を提供し、PDFBoxがPDFオブジェクトを効率的に追跡、取得、管理できるようにします。実際のPDFオブジェクトの内容を表すCOSObjectクラスやCOSBaseクラスとは異なり、COSObjectKeyは純粋な参照識別子であり、ポインタやハッシュマップのキーに類似しています。