GroupDocs.Redaction Javaでテキストを赤字処理する方法

最新のアプリケーションでは、ワークフローを高速かつコンプライアンス遵守に保ちながら、ドキュメント内のテキストを赤字処理する方法は、開発者、監査人、コンプライアンス担当者にとって頻繁な課題です。このチュートリアルでは、GroupDocs.Redaction for Java を使用して正確なフレーズを検索し、セキュアなオーバーレイで置き換え、最終的に結果をラスタライズされた PDF/A‑1a ドキュメントとしてエクスポートする手順を解説します—アーカイブや法的配布に最適です。

簡単な回答

  • Redactionの主要クラスは何ですか？ Redactor
  • フレーズをカラーオーバーレイで置き換えることはできますか？ はい、ExactPhraseRedaction と ReplacementOptions を使用します。
  • ラスタライズされた PDF を生成するにはどうすればよいですか？ SaveOptions.getRasterization().setEnabled(true) でラスタライズを有効にします。
  • 例で使用されている PDF コンプライアンスレベルはどれですか？ PdfComplianceLevel.PdfA1a。
  • 本番環境で使用するにはライセンスが必要ですか？ 本番展開には有効な GroupDocs.Redaction ライセンスが必要です。

Javaで「テキストを赤字処理する方法」とは何ですか？

Redaction は、機密コンテンツをファイルから永続的に削除または隠蔽し、後で復元や閲覧ができないようにすることです。GroupDocs.Redaction を使用すると、正確なフレーズ（例：社会保障番号や機密プロジェクトコード）をプログラムで検索し、赤いオーバーレイ、黒いボックス、または任意のカスタムビジュアル要素に置き換えて、元のデータが復元不可能であることを保証します。

なぜ GroupDocs.Redaction for Java を使用するのか？

GroupDocs.Redaction は 30 以上の入力および出力フォーマット（PDF、DOCX、PPTX、XLSX、HTML、画像タイプ）をサポートし、ファイル全体をメモリに読み込むことなく数百ページのドキュメントを処理できます。正確なフレーズマッチングアルゴリズムは、一般的なキーワード検索と比較して偽陽性を 95 %以上削減し、組み込みのラスタライズエンジンにより、長期保存に適した完全に画像ベースの PDF/A‑1a ファイルを生成できます。

前提条件

開始する前に、以下が揃っていることを確認してください：

  • GroupDocs.Redaction for Java（v24.9 以上）。
  • Java Development Kit (JDK) 8+。
  • IntelliJ IDEA、Eclipse、NetBeans などの IDE。
  • 依存関係管理のための Maven。

必要なライブラリと依存関係

  • GroupDocs.Redaction for Java – リポジトリと依存関係を pom.xml に追加します（Maven 設定セクション参照）。
  • オプション: 好みのロギングフレームワーク（SLF4J、Log4j など）。

知識の前提条件

  • 基本的な Java 構文とファイル I/O。
  • Maven の pom.xml 構造に関する知識。

GroupDocs.Redaction for Java の設定

Maven 設定

pom.xml ファイルに GroupDocs リポジトリと groupdocs-redaction 依存関係を追加します：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/redaction/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-redaction</artifactId>
      <version>24.9</version>
   </dependency>
</dependencies>

直接ダウンロード

あるいは、最新バージョンを直接 GroupDocs.Redaction for Java releases からダウンロードできます。

ライセンス取得

  • 無料トライアル – ライセンスキーなしで API を試せます。
  • 一時ライセンス – 長期評価に使用できます。
  • フルライセンス – 本番環境で必要です。

基本的な初期化と設定

Redactor クラスはすべての赤字処理操作のエントリーポイントです。ドキュメントを読み込み、赤字ルールを適用し、結果を保存します。

import com.groupdocs.redaction.Redactor;

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");

テキストを赤字処理する方法 – 正確なフレーズの例

Redactor はドキュメントを読み込み、赤字ルールを適用する主要クラスです。ExactPhraseRedaction は特定の文字列にマッチするルールを定義します。この例では、ファイルを読み込み、ExactPhraseRedaction ルールを作成し、単一のステップで赤字処理を実行する方法を示します。開発者にとって簡潔なワークフローを提供し、元のコンテンツが永続的に隠蔽されることを保証します。

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.ReplacementOptions;
import com.groupdocs.redaction.redactions.ExactPhraseRedaction;

ラスタライズされた PDF として保存する方法

SaveOptions はドキュメントの保存方法を制御する構成オブジェクトです。ラスタライズ機能を有効にし、PDF/A‑1a コンプライアンスを選択することで、各ページがビットマップとしてレンダリングされた画像のみの PDF を生成でき、アーカイブ基準を満たし、テキスト抽出を防止します。

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");
try {
    RedactorChangeLog result = redactor.apply(new ExactPhraseRedaction(
        "John Doe", new ReplacementOptions(java.awt.Color.RED)));
    
    if (result.getStatus() != RedactionStatus.Failed) {
        // Successfully redacted the text
    }
} finally { 
    redactor.close(); 
}

実用的な応用例

  1. 機密データの赤字処理 – 契約書を共有する前に個人識別子を自動的に非表示にします。
  2. ドキュメントのアーカイブ – 完成したレポートを長期コンプライアンスのためにラスタライズされた PDF/A に変換します。
  3. 大量コンテンツ更新 – 数百ファイルにわたる古い用語を単一スクリプトで置き換えます。

パフォーマンス上の考慮点

  • 各操作後に Redactor を閉じる ことで、ファイルハンドルとメモリを解放します。
  • バッチ処理 – ファイルリストを読み込み、ループで処理し、可能な限り単一の Redactor インスタンスを再利用します。
  • リソースの監視 – 大規模な赤字処理中に CPU とヒープ使用量を監視するために Java プロファイリングツールを使用します。

よくある質問

Q: Maven プロジェクトに GroupDocs.Redaction をインストールするにはどうすればよいですか？
A: Maven Setup セクションに示すように、GroupDocs リポジトリと groupdocs-redaction 依存関係を pom.xml に追加します。

Q: このライブラリで PDF ファイルのテキストを赤字処理できますか？
A: はい、GroupDocs.Redaction は PDF、DOCX、PPTX など多数のフォーマットをサポートしています。

Q: 正確なフレーズが見つからなかった場合はどうなりますか？
A: RedactorChangeLog は Failed ステータスを返します。フレーズのスペルと大文字小文字を確認してください。

Q: 非常に大きなドキュメントを効率的に処理するにはどうすればよいですか？
A: 小さなページ範囲に分割して処理し、必要な箇所だけラスタライズを有効にし、常に Redactor を閉じてリソースを解放します。

Q: 特定のページ範囲でラスタライズされた PDF を保存することは可能ですか？
A: もちろん可能です。options.getRasterization().setPageIndex() と setPageCount() を使用して、ラスタライズしたい正確なページを指定します。

結論

これで、GroupDocs.Redaction Java を使用した テキストの赤字処理 と ラスタライズされた PDF として保存 に関する完全なエンドツーエンドガイドが手に入りました。これらの手順に従うことで、機密情報を保護し、厳格なコンプライアンス基準を満たし、スケールに応じて Java サービスのパフォーマンスを維持できます。

次のステップ

  • API をさらに深く掘り下げるには、公式ドキュメント を参照してください。
  • RegexRedaction や ImageRedaction など、他の赤字タイプを試してみてください。
  • GroupDocs Support Forum でコミュニティに参加し、ヒントやベストプラクティスを共有してください。

最終更新日: 2026-08-20
テスト環境: GroupDocs.Redaction Java 24.9
作者: GroupDocs

import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.options.PdfComplianceLevel;

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");
try {
    SaveOptions options = new SaveOptions();

    // Enable rasterization for converting pages into images.
    options.getRasterization().setEnabled(true);
    
    // Set the starting page and count for rasterization.
    options.getRasterization().setPageIndex(5);
    options.getRasterization().setPageCount(1);

    // Define PDF compliance level.
    options.getRasterization().setCompliance(PdfComplianceLevel.PdfA1a);

    // Append a suffix to avoid filename conflicts.
    options.setAddSuffix(true);

    // Save the document with these configurations.
    redactor.save(options);
} finally { 
    redactor.close(); 
}

関連チュートリアル