Operator（Operator (PDFBox)）
Apache PDFBoxにおけるOperatorは、解析されたコンテンツストリームから抽出された単一のPDFオペレータートークンを表します。
Apache PDFBoxにおけるOperatorは、解析されたコンテンツストリームから抽出された単一の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 ) で定義されているように、テキストの配置、グラフィックの描画、色設定など、ページコンテンツのレンダリング方法を定義するオペレーターとそのオペランドのシーケンスが含まれます。PDFBoxはこれらのコンテンツストリームを解析し、各オペレーターを個別のOperatorオブジェクトとして公開することで、開発者が検査および操作できるようにします。
PDFBoxのOperatorクラスは、コンテンツストリーム内に存在する単一のPDFオペレーターをカプセル化するJavaオブジェクトです。PDFオペレーターは、レンダリングエンジンにページ上のコンテンツの表示方法を指示する記号的なコマンド（テキスト表示用のTj、線描画用のl、RGB描画色設定用のRGなど）です。各Operatorオブジェクトはオペレーターの名前を格納し、プログラムでアクセスするためのメソッドを提供します。
オペランド（オペレーターのパラメーターまたは引数）とは異なり、Operatorはコマンド自体のみを表します。PDFBoxの解析モデルでは、オペレーターとそれに関連するオペランドは通常一緒に処理されますが、別々のオブジェクトとして表現されます。Operatorクラスは、PDPageContentStreamのようなPDFBoxの上位レベルクラスとは異なります。PDPageContentStreamはコンテンツストリームを作成するためのビルダースタイルのAPIを提供しますが、Operatorオブジェクトは既存のPDFコンテンツを読み取り、分析する際に使用されます。
Operatorの理解は、既存のPDFコンテンツを低レベルで分析、抽出、または変更する必要がある開発者にとって不可欠です。コンテンツストリームの操作（正確な位置情報を持つテキストの抽出、グラフィックコマンドの分析、カスタムコンテンツフィルターの実装など）を行う場合、開発者はPDFBoxのコンテンツストリームパーサーから返されるOperatorオブジェクトを直接操作する必要があります。
この粒度の細かいアクセスにより、特定の描画操作の識別、 ( 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処理タスクが可能になります。Operatorを理解しなければ、開発者はPDFBoxの上位レベルAPIに制限され、高度なPDF操作シナリオに対して十分な制御を提供できない可能性があります。
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 ) で定義されている特定の名前でオペレータートークンを識別し、検出された各トークンに対してOperatorオブジェクトを作成します。
開発者は通常、コンテンツストリームを処理し、各オペレーターに対してコールバックメソッドを呼び出すPDFBoxのPDFStreamEngineまたはPDFGraphicsStreamEngineクラスを通じてOperatorと対話します。基本的なワークフローには以下が含まれます：
- 解析: コンテンツストリームパーサーがオペレータートークンを識別し、対応するOperatorオブジェクトを作成します
- 処理: 各Operatorは、そのオペランドとともに登録されたプロセッサーメソッドに渡されます
- 処理: 開発者はオペレーター名を調べ、関連するオペランドにアクセスし、適切なアクションを実行できます
例えば、パーサーがコンテンツストリーム内でバイトBT（
(
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
)
でテキストオブジェクトの開始を示す）を検出すると、“BT"という名前のOperatorオブジェクトを作成します。開発者はその後、テキストブロックの初期化を処理するカスタムロジックを実装できます。
Operatorクラスは、オペレーターの記号名を取得するためのgetName()などのメソッドを提供し、開発者がコンテンツストリームに現れるオペレーターに基づいて条件付きロジックを実装できるようにします。
- Content Stream – PDFページコンテンツのレンダリング方法を定義する命令のシーケンス
- PDFStreamEngine – コンテンツストリームを解析および処理し、Operatorオブジェクトを作成するPDFBoxクラス
- Operand – コンテンツストリーム内でPDFオペレーターに付随するパラメーターまたは引数
- PDPageContentStream – 高レベルAPIを使用して新しいコンテンツストリームを作成するためのPDFBoxクラス
- Graphics State – 後続の操作の表示方法に影響を与える、PDFオペレーターによって維持されるレンダリングコンテキスト
- (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.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