eml to pdf java – GroupDocsでメールをPDFに変換
多くの企業では、メールメッセージを不変のPDFとしてアーカイブすることが、コンプライアンス、法的ディスカバリー、そして簡単な共有のために不可欠です。このチュートリアルでは、GroupDocs.Conversion を使用して Javaで .eml ファイルを PDF に変換する方法 を示し、最終ドキュメントに表示するメールフィールドを完全に制御できるようにします。機密ヘッダーの非表示方法、Maven 依存関係の設定方法、大量バッチのパフォーマンス最適化方法も紹介します。
クイック回答
- メールを PDF に変換するライブラリは何ですか? GroupDocs.Conversion for Java.
- 必要な Maven アーティファクトはどれですか?
com.groupdocs:groupdocs-conversion. - 送信者/受信者の詳細を非表示にできますか? はい —
EmailLoadOptionsを使用して表示を制御します。 - 本番環境でライセンスが必要ですか? トライアル以外の使用には有効な GroupDocs ライセンスが必要です。
- サポートされている Java バージョンは何ですか? Java 8 以上。
メールを PDF に変換するとは何ですか?
メールを PDF に変換することは、.msg、.eml、またはその他のメール形式を静的で携帯可能な PDF ドキュメントに変換することです。このプロセスは元のメッセージレイアウトを保持しつつ、メールアドレス、ヘッダー、CC/BCC フィールド、添付ファイルなどの機密情報を編集(赤字)できるようにします。
なぜ Java 用 GroupDocs.Conversion を使用するのか?
GroupDocs.Conversion は java pdf conversion library を提供し、EML、MSG、PDF、DOCX、HTML など 100 以上の入力および出力フォーマットをサポートします。細かい EmailLoadOptions を提供し、メールのどの部分を PDF に表示するか正確に決定でき、Maven とシームレスに統合されて依存関係管理が容易です。
前提条件
- Java Development Kit (JDK) 8+ がインストールされていること。
- Maven を依存関係管理に使用する(下記の maven dependency groupdocs conversion セクションを参照)。
- Java と Maven プロジェクトの基本的な知識があること。
Java 用 GroupDocs.Conversion の設定
pom.xml に GroupDocs リポジトリとコンバージョン依存関係を追加します。これが必要な groupdocs conversion maven 設定です。
<repositories>
<repository>
<id>repository.groupdocs.com</id>
<name>GroupDocs Repository</name>
<url>https://releases.groupdocs.com/conversion/java/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion</artifactId>
<version>25.2</version>
</dependency>
</dependencies>
ライセンス取得
- Free Trial – すべての機能を無料で試せます。
- Temporary License – 拡張評価のために短期キーをリクエストします。
- Purchase – 本番展開用のフルライセンスを取得します。
高度なオプションで eml を pdf java に変換する方法は?
EmailLoadOptions は変換時にメールのどの部分をレンダリングするかを定義します。.eml ファイルを読み込み、表示するフィールドを設定し、コンバータを呼び出します—すべて数ステップで完了します。この回答では 70 語未満で完全なワークフローを示します。EmailLoadOptions を作成し、PDF 変換設定を行い、convert メソッドを呼び出し、発生する可能性のある例外を処理します。
ステップ 1: Email Load Options の設定
EmailLoadOptions を使用すると、送信者、受信者、ヘッダーなど個々のメールセクションの表示/非表示を切り替えられます。
import com.groupdocs.conversion.options.load.EmailLoadOptions;
EmailLoadOptions loadOptions = new EmailLoadOptions();
loadOptions.setDisplayHeader(false);
loadOptions.setDisplayFromEmailAddress(false);
loadOptions.setDisplayToEmailAddress(false);
loadOptions.setDisplayEmailAddress(false);
loadOptions.setDisplayCcEmailAddress(false);
loadOptions.setDisplayBccEmailAddress(false);
loadOptions.setConvertOwned(false); // Prevent conversion of fields that are owned by the document
ステップ 2: コンバータの初期化
Converter は、提供されたロードオプションと変換オプションを使用して変換を実行するエンジンです。
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG", () -> loadOptions);
ステップ 3: PDF 変換オプションの設定
PdfConvertOptions は、ページサイズや圧縮などの PDF 出力設定を構成します。
PdfConvertOptions options = new PdfConvertOptions();
ステップ 4: 変換の実行
定義した PDF オプションと宛先ファイルパスを指定して convert を呼び出します。このメソッドは成功を示す boolean を返します。
converter.convert("YOUR_OUTPUT_DIRECTORY/ConvertEmailWithAlteringFieldsVisibility.pdf", options);
msg を pdf java に変換する方法(同じオプションを再利用)
EmailLoadOptions は変換時にメールのどの部分をレンダリングするかを定義します。Outlook の .msg ファイルを処理する必要がある場合、同じ EmailLoadOptions と Converter のワークフローが適用されます。ソースファイルパスを .msg ファイルに置き換えるだけです。ロードオプションを調整して特定のヘッダーを非表示または表示にしたり、同じ PdfConvertOptions を再利用してフォーマット間で一貫した出力品質を維持できます。
ステップ 1: Email Load Options の設定(再利用)
import com.groupdocs.conversion.options.load.EmailLoadOptions;
EmailLoadOptions emailLoadOptions = new EmailLoadOptions();
emailLoadOptions.setDisplayHeader(false);
emailLoadOptions.setDisplayFromEmailAddress(false);
emailLoadOptions.setDisplayToEmailAddress(false);
emailLoadOptions.setDisplayEmailAddress(false);
emailLoadOptions.setDisplayCcEmailAddress(false);
emailLoadOptions.setDisplayBccEmailAddress(false);
emailLoadOptions.setConvertOwned(false); // Do not convert owned fields
ステップ 2: Email Load Options を使用したコンバータの初期化
Converter emailConverter = new Converter("EMAIL_FILE_PATH", () -> emailLoadOptions);
実用的な応用例
email to pdf conversion が活躍する実際のシナリオを 3 つ紹介します:
- Legal Documentation – クライアントとメール証拠を共有する前に個人データをマスクします。
- Corporate Archiving – 社内コミュニケーションを標準化された読み取り専用フォーマットで長期保存します。
- Personal Organization – 不要なアドレスを公開せず、重要なメッセージをクリーンな PDF アーカイブとして保存します。
パフォーマンス上の考慮点
- File‑size optimisation – 小さなバッチで処理するか、PDF 圧縮 (
PdfConvertOptions.setCompressionLevel(CompressionLevel.Maximum)) を有効にして、典型的な 10 ページのメールで出力を 2 MB 未満に保ちます。 - Memory management – Java のストリーミング API を使用し、マルチメガバイトの
.msgファイルを変換する際は JVM ヒープ (-Xmx2g) を増やします。 - Version upgrades – 最新の GroupDocs.Conversion リリースは、バージョン 24.x と比較して変換速度を最大 30 % 向上させます。
一般的な問題と解決策
| Issue | Cause | Solution |
|---|---|---|
大きな .msg ファイルでの OutOfMemoryError | ファイル全体がメモリにロードされる | メールコンテンツをストリーム処理するか、JVM ヒープサイズ (-Xmx2g) を増やします。 |
| PDF にメール本文が欠落 | displayHeader が true に設定されているが本文が非表示 | setDisplayHeader(false) がヘッダーのみを非表示にし、本文は表示されたままになることを確認してください。 |
| ライセンスが認識されない | 本番環境でトライアルキーを使用 | 有効な本番用ライセンスファイルまたは文字列に置き換えてください。 |
よくある質問
Q: GroupDocs.Conversion for Java とは何ですか?
A: 100 以上のファイル形式間の変換を可能にする Java ライブラリで、メールから PDF への変換も含まれ、高精度で外部依存なしです。
Q: 変換中にメールのプライバシーを確保するには?
A: 変換前に EmailLoadOptions を使用して、送信者、受信者、CC/BCC アドレスなどのフィールドをオフにします。
Q: メール以外のドキュメントも変換できますか?
A: はい、Word、Excel、PowerPoint、画像など多数のフォーマットもサポートしています。
Q: 大きなメールを変換するためのメモリ要件は?
A: ヒープを少なくとも 2 GB (-Xmx2g) 確保し、バッチ処理でメモリ上限内に収めることを検討してください。
Q: GroupDocs.Conversion の詳細情報はどこで見つけられますか?
A: 公式ドキュメント official documentation と API リファレンス API reference をご覧ください。 GroupDocs.Conversion for Java Docs と GroupDocs.Conversion API Reference も参照してください。
最終更新日: 2026-05-21
テスト環境: GroupDocs.Conversion 25.2
作者: GroupDocs