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

このチュートリアルでは、GroupDocs.Redaction を使用して Java ベースのドキュメントで テキストを赤字処理する方法 を学びます。個人情報のマスク、機密文字列を安全なプレースホルダーに置き換える方法、バッチ処理に適した複数ファイルの処理方法を確認できます。最後には、プライバシーを保護し、GDPR/HIPAA の要件を満たし、既存の Java アプリケーションにスムーズに統合できる本番環境向けソリューションが手に入ります。

クイック回答

  • 使用されているライブラリは何ですか？ GroupDocs.Redaction for Java.
  • 個人情報をマスクできますか？ はい – use exact‑phrase redaction with replacement options.
  • バッチ処理はサポートされていますか？ もちろん、同じ Redactor インスタンスで複数のファイルをループ処理できます。
  • ライセンスは必要ですか？ A free trial works for evaluation; a commercial license is required for production.
  • 必要な Java バージョンはどれですか？ JDK 8 or higher.

「テキストを赤字処理する方法」とは

赤字処理は、文書から機密データを永久に削除または隠蔽します。GroupDocs.Redaction を使用すると、特定の文字列を検索し、安全なプレースホルダーに置き換えて、サニタイズされたファイルを保存できます—すべて手動編集なしで行えます。

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

GroupDocs.Redaction for Java は 50 以上の入力および出力フォーマット（PDF、DOCX、XLSX、PPTX、TXT、RTF など）をサポートし、文書全体をメモリに読み込むことなく数百ページのファイルを処理でき、標準サーバーハードウェア上で高スループットのバッチ操作を実現します。

前提条件

  • Java Development Kit (JDK): バージョン 8 以上。
  • IDE: IntelliJ IDEA、Eclipse、または任意の Java 対応エディタ。
  • Maven: 依存関係管理に使用。
  • Basic Java knowledge: クラス、メソッド、例外処理に慣れていること。

GroupDocs.Redaction for Java の設定

まず、Maven プロジェクトにライブラリを追加します。

Maven の設定

pom.xml ファイルにリポジトリと依存関係を追加します:

<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>

直接ダウンロード

必要に応じて、最新の JAR を GroupDocs.Redaction for Java releases から取得してください。

ライセンス取得

まずは Free Trial で開始し、拡張テスト用に Temporary License をリクエストするか、本番利用のために Commercial License を購入できます。

GroupDocs.Redaction を使用したドキュメントのテキスト赤字処理方法

以下のセクションでは、個人情報をマスクし、機密テキストを置き換えるために必要な手順を詳しく説明します。

手順 1: Redactor の初期化

Redactor はドキュメントを読み込み、赤字処理ルールを適用し、出力を書き込むコアクラスです。

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

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new LoadOptions());

手順 2: exact‑phrase 赤字処理の適用

ExactPhraseRedaction は正確な文字列一致を検索し、ReplacementOptions は一致したテキストの置換方法を定義します。

redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]"));
  • パラメータ:
    • "John Doe" – 赤字処理する正確なテキストです。
    • ReplacementOptions("[personal]") – 元のコンテンツを置き換える文字列で、実質的に 個人情報をマスク します。

手順 3: 赤字処理されたドキュメントの保存

Redactor.save は変更されたドキュメントを新しいファイルに書き込むか、元のファイルを上書きし、元のフォーマットを保持します。

redactor.save();

手順 4: リソースのクリーンアップ

常に Redactor.close() を呼び出してネイティブリソースを解放し、メモリリークを防止してください。

finally {
    redactor.close();
}

カスタムコールバックで個人情報をマスクする方法

カスタムコールバックを使用すると、各赤字処理イベントに応答でき、ロギング、条件付き置換、監査トレイルに便利です。

コールバッククラスの作成

IRedactionCallback は各赤字処理操作の前後に呼び出されるメソッドを定義します。

class RedactionDump implements IRedactionCallback {
    @Override
    public void onRedacted(IRedaction redaction) {
        // Custom processing or logging for each redaction event.
    }
}

Redactor インスタンス化時にコールバックを使用する

RedactorSettings を介してコールバック実装を渡すことで、処理中にエンジンがそれを呼び出すようにします。

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new LoadOptions(), new RedactorSettings(new RedactionDump()));

実用的な活用例

  • Legal contracts: 下書きを共有する前に、クライアント名、SSN、機密条項を自動的に非表示にします。
  • Medical records: 研究パートナーへレコードをエクスポートする際、患者識別子などの 個人情報をマスク します。
  • Corporate communications: 外部配布前に内部プロジェクトコードなどの 機密テキストを置き換え、偶発的な漏洩を防止します。

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

大規模または多数のファイルを処理する際は、以下のポイントに留意してください：

  • Batch processing: ファイルコレクションをループして起動オーバーヘッドを削減します。
  • Memory management: 各ファイル処理後に Redactor を解放し、同時に多数のドキュメントをメモリに保持しないようにします。
  • Profiling: Java プロファイラ（例: VisualVM）を使用して I/O や赤字処理ロジックのボトルネックを特定します。

よくある質問

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

Q: 赤字処理は元に戻せますか？
A: いいえ。赤字処理は元のコンテンツを永久に削除するため、ソースファイルのバックアップを保持してください。

Q: 非常に大きなドキュメントを効率的に処理するにはどうすればよいですか？
A: チャンク単位で処理し、バッチモードを使用し、プロファイリングツールでメモリ使用量を監視してください。

Q: 他にどのようなテキストフォーマットがサポートされていますか？
A: DOCX と PDF に加えて、TXT、RTF、XLSX、PPTX なども赤字処理できます。

Q: 既存のワークフローに GroupDocs.Redaction を統合できますか？
A: もちろんです。API は Web サービス、バックグラウンドジョブ、CI/CD パイプラインから呼び出すことができます。

リソース

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

関連チュートリアル