JavaでGroupDocs.Redactionを使用してドキュメントを赤字化しながらファイル名にサフィックスを追加する方法

機密データの赤字化は戦いの半分にすぎません—保存されたファイルが処理済みであることを明確に示す必要があります。groupdocs maven 依存関係を使用すればこれが簡単になります。数行のコードで出力ファイル名にサフィックスを追加できます。このガイドでは、GroupDocs.Redaction for Java を使用して赤字化ドキュメントを保存する際にファイル名にサフィックスを追加する方法と、ロード、アノテーション、保存の手順を学びます。法的契約書、医療記録、財務レポートの保護に関わらず、これらの手順でワークフローを安全かつ監査可能に保てます。

クイック回答

「ファイル名にサフィックスを追加する」とは何ですか？
出力ファイル名にカスタムサフィックス（例: “_redacted”）を付加し、処理済みファイルをすぐに識別できるようにします。
ストリームからドキュメントをロードできますか？
はい—GroupDocs.Redaction は任意の InputStream からのロードをサポートしており、クラウドストレージやインメモリ処理に最適です。
この機能にライセンスは必要ですか？
無料トライアルで基本的な赤字化は可能です。臨時またはフルライセンスを取得すると、サフィックス処理を含むすべての高度なオプションが利用可能になります。
対応フォーマットは何ですか？
ライブラリは DOCX、PDF、PPTX、XLSX など多数を取り扱えます。
PDF 出力にラスタライズは必須ですか？
ラスタライズはオプションです。文書をフラット化して追加のセキュリティが必要な場合に有効にしてください。

ファイル名にサフィックスを追加するとは？

サフィックスを付加することは、ファイルが赤字化されたことを示すシンプルな命名規則です。元の未加工バージョンが誤って共有されるのを防ぎ、パイプラインが処理状態を自動的に追跡できるようになります。

このタスクに GroupDocs.Redaction を使う理由

GroupDocs.Redaction は、ファイル名にサフィックスを追加するようなファイル処理オプションと赤字化アクションを数行のコードで組み合わせられる流暢な Java API を提供します。開発時間を短縮し、手動ミスのリスクを低減します。

前提条件

Java Development Kit (JDK)： バージョン 8 以上。
GroupDocs.Redaction ライブラリ： 赤字化タスク用のコアライブラリ。
IDE： IntelliJ IDEA、Eclipse、または任意の Java 対応エディタ。
Maven： 依存関係管理用。

知識の前提条件

Java の I/O と基本的なオブジェクト指向概念に慣れていると、サンプルがより理解しやすくなります。

GroupDocs.Redaction for Java の設定方法

Maven 設定

pom.xml に以下の設定を追加して、Maven 経由で GroupDocs ライブラリにアクセスできるようにします。

<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 から最新バージョンを直接ダウンロードしてください。

ライセンス取得

無料トライアル： 制限なしで基本機能にアクセス。
臨時ライセンス： 高度な機能を試すための一時ライセンスを取得。
購入： 長期利用の場合はフルライセンスの購入を検討してください。

基本的な初期化と設定

必要なインポートを追加してプロジェクトを初期化します。

import com.groupdocs.redaction.Redactor;

この設定が完了すれば、ドキュメント赤字化機能の実装に進めます。

実装ガイド

機能 1: ストリームからドキュメントをロード

概要： InputStream を使用してドキュメントをロードする方法を学びます。

手順実装

Step 1.1: InputStream の作成

import java.io.FileInputStream;
import java.io.InputStream;

try (InputStream stream = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    final Redactor redactor = new Redactor(stream);
    try {
        // Document is now loaded and ready for further processing
    } finally {
        redactor.close();
    }
}

理由： InputStream を使用すると、さまざまな形式で保存されたドキュメントをシームレスに扱えるため、クラウドやマイクロサービス環境で ストリームからドキュメントをロード する際に必須です。

機能 2: アノテーション削除赤字化の適用

概要： DeleteAnnotationRedaction を使ってドキュメントからアノテーションを削除します。

手順実装

Step 2.1: DeleteAnnotationRedaction の適用

import com.groupdocs.redaction.redactions.DeleteAnnotationRedaction;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply the DeleteAnnotationRedaction to remove annotations from the document
    redactor.apply(new DeleteAnnotationRedaction());
}

理由： 敏感なアノテーションを除去し、文書のプライバシーを強化します。

機能 3: オプション付きでドキュメントを保存

概要： ラスタライズや ファイル名にサフィックスを追加 などのオプションを指定して、処理済みドキュメントを保存する方法を学びます。

手順実装

Step 3.1: SaveOptions の設定

import java.io.ByteArrayOutputStream;
import com.groupdocs.redaction.options.SaveOptions;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply necessary redactions before saving
    redactor.apply(new DeleteAnnotationRedaction());
    try (ByteArrayOutputStream bA = new ByteArrayOutputStream()) {
        SaveOptions options = new SaveOptions();
        options.setRasterizeToPDF(true);  // Option to rasterize document to PDF format
        options.setAddSuffix(true);      // Option to add a suffix to the saved file name
        redactor.save(bA, options.getRasterization());
    }
}

理由： 保存オプションをカスタマイズすることで、出力形式や命名規則を柔軟に制御できます。setAddSuffix(true) を有効にすると ファイル名にサフィックスが追加 され、赤字化されたことが一目で分かります。

groupdocs maven 依存関係の概要

groupdocs maven 依存関係 は、単一の <dependency> エントリで Redaction SDK 全体をプロジェクトに組み込みます。トランジティブ依存関係を自動処理し、ライブラリを常に最新に保ち、ビルド自動化を簡素化します。pom.xml に依存関係を宣言するだけで、手動で JAR を管理する手間が省け、最新のセキュリティパッチとの互換性も確保できます。

サフィックス追加が重要な理由

監査性： チームは即座に配布可能なファイルかどうかを判別できます。
自動化： スクリプトはサフィックスでファイルをフィルタリングでき、元のドキュメントが誤って処理されるのを防止します。
コンプライアンス： 多くの規制で、サニタイズされた文書に明確なラベル付けが求められます。

実用的な活用例

法的文書の赤字化： クライアント共有前に契約書を安全に保護。
医療記録の取り扱い： 患者識別子を保護。
財務報告書： 機密数値を非公開に。
CRM 連携： エクスポート前に顧客データを自動的に赤字化。
コラボレーションツール： 共有ドラフトが隠しコメントを露出しないように保証。

パフォーマンス考慮事項

パフォーマンス最適化

ストリーミング（load document from stream）を使用して、ファイル全体をメモリに読み込むのを回避。
Redactor インスタンスは速やかにクローズしてリソースを解放。

リソース使用ガイドライン

バッチ実行時は CPU とメモリを監視。
ファイルサイズが小さい場合は、インメモリ保存に ByteArrayOutputStream を使用するのが望ましい。

Java メモリ管理のベストプラクティス

同種のファイルを複数処理する際は Redactor オブジェクトを再利用。
try‑with‑resources ブロックで close() を呼び出し、リークを防止。

よくある問題と解決策

問題	原因	対策
サフィックスが表示されない	`setAddSuffix(false)` もしくは呼び出し忘れ	`save()` 前に `options.setAddSuffix(true)` を設定してください。
大きな DOCX で OutOfMemoryError	ファイル全体をメモリにロードしている	`InputStream` ロードに切り替えてください（機能 1 を参照）。
アノテーションが残っている	保存前に赤字化が適用されていない	`redactor.apply(new DeleteAnnotationRedaction())` を `save()` 前に呼び出してください。
PDF ラスタライズが適用されない	`setRasterizeToPDF(false)` もしくは未設定	フラット化された PDF が必要な場合は `options.setRasterizeToPDF(true)` を設定してください。

FAQ（よくある質問）

Q: GroupDocs.Redaction で PDF 文書を赤字化できますか？
A: はい、ライブラリは PDF、DOCX、PPTX、XLSX など多数のフォーマットをサポートしています。

Q: 大容量ファイルを扱う最適な方法は何ですか？
A: ストリーミング（load document from stream）を使用し、リソースを速やかにクローズしてメモリ使用量を抑えてください。

Q: サフィックスのテキストをカスタマイズできますか？
A: API はデフォルトで “_redacted” などのサフィックスを自動付加します。カスタムサフィックスが必要な場合は、保存後に出力ファイルをリネームしてください。

Q: GroupDocs.Redaction の臨時ライセンスはどう取得しますか？
A: 臨時ライセンスページにアクセスし、手順に従って取得してください。

Q: 問題が発生した場合、どこでサポートを受けられますか？
A: 専門家が回答する GroupDocs Support Forum で質問できます。

リソース

ドキュメント： 詳細ガイドは GroupDocs Documentation をご覧ください。
API リファレンス： 完全な API 詳細は GroupDocs API Reference にあります。
ダウンロード： 最新バージョンは GroupDocs Downloads から取得できます。
GitHub リポジトリ： ソースコードの閲覧や貢献は GroupDocs GitHub で行えます。

最終更新日： 2026-02-16
テスト環境： GroupDocs.Redaction 24.9 for Java
作成者： GroupDocs