GroupDocs redaction Javaでファイル名にサフィックスを追加する方法
この groupdocs redaction java tutorial では、GroupDocs.Redaction を使用してドキュメントを赤字化する際に、出力ファイル名にサフィックスを自動的に付加する方法を学びます。サフィックスを追加することで手動でのリネームが不要になり、未加工ファイルが漏洩するリスクが減少し、命名規則に依存する CI/CD パイプラインにもスムーズに組み込めます。本ガイドでは、Maven の設定、ストリーミングによるドキュメント読み込み、アノテーションの削除、保存オプションの設定までを、簡潔で本番環境向けのコードとともに解説します。
クイック回答
- 「ファイル名にサフィックスを追加する」機能は何ですか?
サフィックスオプションを有効にすると、SDK は出力ファイルの拡張子の前に、デフォルトでは「_redacted」という事前定義された文字列をベース名に自動的に付加します。これにより、どのファイルが処理されたかが即座に判別でき、元のコンテンツが誤って配布されるリスクを防ぎ、命名パターンに依存する下流の自動化も簡素化されます。 - ストリームからドキュメントをロードできますか?
はい—GroupDocs.Redaction は任意のInputStreamからのロードをサポートしており、クラウドストレージやインメモリ処理に最適です。 - この機能にライセンスは必要ですか?
無料トライアルで基本的な赤字化は利用可能です。サフィックス処理を含むすべての高度なオプションを使用するには、一時ライセンスまたはフルライセンスが必要です。 - 対応フォーマットは何ですか?
ライブラリは DOCX、PDF、PPTX、XLSX など多数の形式を扱えます。 - PDF 出力にラスタライズは必須ですか?
ラスタライズはオプションです。文書をフラット化して追加のセキュリティが必要な場合に有効にしてください。
「ファイル名にサフィックスを追加する」機能は何ですか?
サフィックスオプションを有効にすると、SDK は出力ファイルの拡張子の前に、デフォルトでは「_redacted」という事前定義された文字列をベース名に自動的に付加します。これにより、どのファイルが処理されたかが即座に判別でき、元のコンテンツが誤って配布されるリスクを防ぎ、命名パターンに依存する下流の自動化も簡素化されます。
このタスクに GroupDocs.Redaction を使用する理由
GroupDocs.Redaction は、高性能な Java API を提供し、赤字化アクションと自動サフィックス追加、ストリーミングサポート、バッチ処理といった柔軟なファイル操作オプションを組み合わせます。50 以上の入力・出力フォーマットに対応し、メモリ全体にファイルを読み込むことなく数百ページの文書を処理できるため、メモリ使用量が低く高速に実行できます。
前提条件
- Java Development Kit (JDK): バージョン 8 以上。
- GroupDocs.Redaction Library: 赤字化タスク用のコアライブラリ。
- IDE: IntelliJ IDEA、Eclipse、または任意の Java 対応エディタ。
- Maven: 依存関係管理用。
知識の前提条件
Java I/O と基本的なオブジェクト指向概念に慣れていると、例示がより理解しやすくなります。
Java 用 GroupDocs.Redaction の設定
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 から最新バージョンを直接ダウンロードしてください。
ライセンス取得
- Free trial: 制限なしで基本機能にアクセスできます。
- Temporary license: 高度な機能を試すための一時ライセンスを取得してください。
- Purchase: 長期利用の場合はフルライセンスの購入を検討してください。
基本的な初期化と設定
必要なインポートを追加してプロジェクトを初期化します:
import com.groupdocs.redaction.Redactor;
この設定が完了すれば、ドキュメント赤字化機能の実装に進めます。
実装ガイド
機能 1: ストリームからドキュメントをロード
概要: InputStream にドキュメントをロードして処理する方法を学びます。
InputStream はバイトストリームを表す Java I/O クラスで、ファイルやネットワーク接続、その他のソースからデータをメモリ全体に読み込むことなく読み取れます。
手順 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();
}
}
- Why:
InputStreamを使用すると、クラウドバケット、データベース、インメモリバッファなど様々な場所に保存されたドキュメントをディスクに書き出すことなく扱えます。このアプローチは、マイクロサービスアーキテクチャで load document from stream が必要な場合に不可欠です。
機能 2: アノテーション削除赤字化の適用
概要: DeleteAnnotationRedaction を使用してドキュメントからアノテーションを削除します。
DeleteAnnotationRedaction は、コメント、ハイライト、ノートなどのすべてのアノテーションを文書から除去する赤字化操作です。
手順 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());
}
- Why: この手順により、機密性の高いコメントやハイライト、隠しノートなどのアノテーションが文書から除去され、プライバシーとコンプライアンスが向上します。
機能 3: オプション付きでドキュメントを保存
概要: ラスタライズや add suffix filename java などの特定オプションを指定して、処理済みドキュメントを保存する方法を学びます。
SaveOptions は、赤字化された文書の書き出し方法(フォーマット、ラスタライズ、命名規則など)を制御する設定をカプセル化します。
手順 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());
}
}
- Why: 保存オプションをカスタマイズすることで、出力フォーマットや命名規則を柔軟に設定できます。
setAddSuffix(true)を有効にすると adds suffix to filename となり、ファイルが赤字化されたことが明確になります。
ドキュメント保存時に suffix filename java を追加する方法
Redactor クラスはドキュメントをロードし、赤字化操作を適用するコアコンポーネントです。SaveOptions は赤字化された文書の保存方法(フォーマット、ラスタライズ、命名規則)を定義します。Redactor インスタンスを作成し、必要な赤字化を適用した後、setAddSuffix(true) を設定した SaveOptions オブジェクトを構成します。redactor.save(outputPath, options) を呼び出すだけで、SDK が自動的に「_redacted」(または設定されたサフィックス)をファイル名に付加するため、手動でリネームする必要はありません。
GroupDocs Maven 依存関係の概要
groupdocs maven dependency は、単一の <dependency> エントリで Redaction SDK 全体をプロジェクトに組み込みます。トランジティブ依存関係を自動処理し、ライブラリを常に最新に保ち、ビルド自動化を簡素化します。pom.xml に依存関係を宣言するだけで、手動で JAR を管理する手間が省け、最新のセキュリティパッチとの互換性も確保できます。
サフィックスを追加することの重要性
サフィックスを付加することで、ファイルが処理済みであることが視覚的に即座に確認でき、監査証跡や自動化ワークフロー、規制遵守において重要です。スクリプトが赤字化ファイルを簡単にフィルタリングでき、元のコンテンツが誤って配布されるリスクを防ぎ、多くの業界標準が求める「サニタイズ済み」ラベル付与要件を満たします。
実用的な適用例
- Legal document redaction: クライアント共有前に契約書を安全に保護。
- Medical record handling: 患者識別子を保護しつつ臨床データを保持。
- Financial reporting: 外部監査時に機密数値を非公開に。
- CRM integration: サードパーティツールへのエクスポート前に顧客データを自動的に赤字化。
- Collaboration tools: 共有ドラフトが隠しコメントやメタデータを露出しないように保証。
パフォーマンスに関する考慮事項
パフォーマンス最適化
- ストリーミング(
load document from stream)を使用して、ファイル全体をメモリに読み込むことを回避。 Redactorインスタンスは速やかにクローズしてリソースを解放。
リソース使用ガイドライン
- バッチ実行中は CPU とメモリを監視。
- ファイルサイズが小さい場合は、インメモリ保存に
ByteArrayOutputStreamを優先。
Java メモリ管理のベストプラクティス
- 同一タイプの複数ファイルを処理する際は
Redactorオブジェクトを再利用。 try‑with‑resourcesブロック内でclose()を呼び出し、リークを防止。
よくある問題と解決策
| Issue | Cause | Fix |
|---|---|---|
| Suffix not appearing | setAddSuffix(false) または呼び出し忘れ | save() 前に options.setAddSuffix(true) が設定されていることを確認してください。 |
| OutOfMemoryError on large DOCX | ファイル全体をメモリにロード | InputStream ローディングに切り替えてください(Feature 1 参照)。 |
| Annotations still visible | 保存前に赤字化が適用されていない | save() 前に redactor.apply(new DeleteAnnotationRedaction()) を呼び出してください。 |
| PDF rasterization not applied | setRasterizeToPDF(false) または設定省略 | フラット化 PDF が必要な場合は options.setRasterizeToPDF(true) を設定してください。 |
よくある質問
Q: GroupDocs.Redaction で PDF 文書を赤字化できますか?
A: はい、ライブラリは PDF、DOCX、PPTX、XLSX など多数の形式をサポートしています。
Q: 大容量ファイルを扱う最適な方法は何ですか?
A: ストリーミング(load document from stream)を使用し、リソースを速やかにクローズしてメモリ使用量を低く保ちます。
Q: サフィックステキストをカスタマイズできますか?
A: API はデフォルトのサフィックス(例: “_redacted”)を自動的に付加します。カスタムサフィックスが必要な場合は、保存後に出力ファイルをリネームしてください。
Q: GroupDocs.Redaction の一時ライセンスはどう取得しますか?
A: Temporary License page にアクセスし、手順に従って取得してください。
Q: 問題が発生した場合、どこでサポートを受けられますか?
A: GroupDocs Support Forum に参加して専門家の支援を受けてください。
リソース
- Documentation: 詳細ガイドは GroupDocs Documentation で確認できます。
- API reference: 包括的な API 詳細は GroupDocs API Reference をご覧ください。
- Download: 最新バージョンは GroupDocs Downloads から取得できます。
- GitHub repository: ソースコードの閲覧や貢献は GroupDocs GitHub で行えます。
最終更新日: 2026-11-02
テスト環境: GroupDocs.Redaction 24.9 for Java
作者: GroupDocs