Word to PDF java: GroupDocsで保護されたWordファイルを変換
この包括的なチュートリアルでは、GroupDocs.Conversion を使用した word to pdf java 変換の方法を学びます。パスワードで保護された Word ドキュメントの開封、特定のページ範囲の選択、DPI の調整、ページの回転、サイズのカスタマイズなどを順に解説し、生成される PDF が正確な要件に合致するようにします。
クイック回答
- どのライブラリが変換を処理しますか? GroupDocs.Conversion for Java.
- パスワードで保護された Word ファイルを変換できますか? Yes – provide the password via
WordProcessingLoadOptions. - 変換を特定のページに限定するにはどうすればよいですか? Use
setPageNumber()andsetPagesCount()onPdfConvertOptions. - DPI は設定可能ですか? Absolutely; call
options.setDpi(yourValue). - GroupDocs を追加するのに Maven が必要ですか? Yes – include the Maven repository and dependency (see the Maven groupdocs dependency section).
word to pdf java 変換とは?
Word to pdf java 変換は、Microsoft Word ドキュメントを Java コードで PDF ファイルに変換するプロセスです。GroupDocs.Conversion は複雑なレンダリングロジックを抽象化し、セキュリティ処理や出力品質といったビジネスルールに集中できるようにします。
Java で word pdf 変換タスクに GroupDocs を使用する理由
GroupDocs.Conversion は 50 以上の入力および出力フォーマット をサポートし、数百ページに及ぶドキュメントをメモリに全体を読み込むことなく処理し、純粋な Java 上で動作します(ネイティブバイナリは不要)。これにより、安定性と速度が重要な高スループットサーバ環境に最適です。また、既存の Java アプリケーションへの統合も容易です。
前提条件
- JDK 8 以上がインストールされ、設定されていること。
- 基本的な Java 開発経験。
- GroupDocs.Conversion ライセンスへのアクセス(無料トライアル利用可能)。
必要なライブラリと依存関係
GroupDocs.Conversion を使用するには、Maven リポジトリと依存関係を pom.xml に含めます:
<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>
ライセンス取得
GroupDocs.Conversion は機能テスト用の無料トライアル版を提供しています。長期利用の場合は、GroupDocs Purchase から一時ライセンスまたはフルライセンスの取得をご検討ください。
Java 用 GroupDocs.Conversion の設定
Maven 設定
上記の Maven スニペットは、必要なすべての JAR が自動的にダウンロードされることを保証します。
基本的な初期化
Converter クラスは、ドキュメントの読み込みと変換を統括するエントリーポイントです。
Converter インスタンスを作成し、保護されたドキュメントを読み込みます:
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Set password for protected documents if necessary:
loadOptions.setPassword("your_password_here");
Converter converter = new Converter("path_to_your_document.docx", () -> loadOptions);
loadOptions オブジェクトは、convert password protected word シナリオを処理する場所です。
実装ガイド
以下では、堅牢な java convert word pdf ワークフローに必要となる各機能を詳しく解説します。
パスワード保護されたドキュメントを PDF に変換
Definition: WordProcessingLoadOptions は、暗号化されたファイルのパスワードを含む、Word ドキュメントの読み込みオプションを指定します。
Definition: PdfConvertOptions は、ページ範囲、DPI、回転、サイズなどの PDF 出力設定を定義します。
直接の回答: Word ファイルを new Converter("input.docx", new WordProcessingLoadOptions("password")) で読み込み、続いて converter.convert(new PdfConvertOptions(), "output.pdf") を呼び出します – ライブラリがドキュメントのロックを解除し、単一ステップで PDF を生成します。
ステップバイステップ実装
- パスワードでロードオプションを初期化 – 正しいパスワードを指定します。
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("12345"); // Replace with your actual password.
- コンバータを設定して変換 – PDF オプションを定義し、実行します。
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertedDocument.pdf";
PdfConvertOptions options = new PdfConvertOptions();
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleProtectedDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);
説明: loadOptions オブジェクトはドキュメントのロックを解除し、PdfConvertOptions は必要に応じて出力を調整できるようにします。
PDF 変換でページを指定
直接の回答: PdfConvertOptions.setPageNumber(startPage) と setPagesCount(pageCount) を使用して、GroupDocs にレンダリングするページを指示し、通常通り変換を実行します。
ステップバイステップ実装
- ページ範囲を設定 – コンバータにレンダリングするページ範囲を指示します。
PdfConvertOptions options = new PdfConvertOptions();
options.setPageNumber(2); // Start from page 2.
options.setPagesCount(1); // Convert only one page.
- 変換プロセス – 同じ
Converterインスタンスを再利用します。
String convertedFile = "YOUR_OUTPUT_DIRECTORY/SelectedPagesPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);
説明: setPageNumber() は最初のページを定義し、setPagesCount() は処理するページ数を制限します。
PDF 変換でページを回転
直接の回答: 変換前に PdfConvertOptions.setRotate(Rotation.On90)(または他の enum 値)を呼び出すと、すべての出力ページが指定した角度で回転します。
ステップバイステップ実装
- 回転オプションを設定 – 回転用の enum を選択します。
import com.groupdocs.conversion.options.convert.Rotation;
PdfConvertOptions options = new PdfConvertOptions();
options.setRotate(Rotation.On180); // Rotate pages 180 degrees.
- 変換を実行 – 前と同様のパターンで変換を実行します。
String convertedFile = "YOUR_OUTPUT_DIRECTORY/RotatedPagesPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);
説明: 回転は横向きスキャンの修正や特定のレイアウト要件を満たすのに役立ちます。
PDF 変換で DPI を設定
直接の回答: convert を呼び出す前に PdfConvertOptions.setDpi(300)(任意の整数)で画像解像度を調整します。DPI を上げると、より鮮明な画像になりますが、ファイルサイズが大きくなります。
ステップバイステップ実装
- DPI 設定を構成
PdfConvertOptions options = new PdfConvertOptions();
options.setDpi(300); // Set DPI to 300 for high resolution.
- カスタム DPI で変換を実行
String convertedFile = "YOUR_OUTPUT_DIRECTORY/HighResolutionPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);
説明: 高い DPI は視覚的忠実度を向上させますが、ファイルサイズが増加します—対象媒体に応じて選択してください。
PDF 変換で幅と高さを設定
直接の回答: PdfConvertOptions.setWidth(1240) と setHeight(1754) を使用して明示的なピクセル寸法を定義し、出力 PDF を特定のページサイズに合わせます。
ステップバイステップ実装
- 寸法を定義
PdfConvertOptions options = new PdfConvertOptions();
options.setWidth(1024); // Set width to 1024 pixels.
options.setHeight(768); // Set height to 768 pixels.
- カスタムサイズで変換
String convertedFile = "YOUR_OUTPUT_DIRECTORY/SizedPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);
説明: カスタム寸法は、特定の画面サイズや印刷フォーマットに合わせた PDF を生成する際に便利です。
GroupDocs を使用した Word から PDF への Java 変換方法
new Converter("doc.docx", new WordProcessingLoadOptions("pwd")) で保護された Word ファイルを読み込み、必要な PdfConvertOptions(ページ、DPI、回転、サイズ)を設定し、converter.convert(options, "output.pdf") を呼び出します。このワンラインパターンは復号、レンダリング、ファイル書き込みを処理し、外部ツールなしで本番環境向けの PDF を提供します。Java 8 以降をサポートする任意のプラットフォームで動作します。
よくある問題と解決策
| 問題 | 考えられる原因 | 対策 |
|---|---|---|
IncorrectPasswordException | 提供されたパスワードが間違っています | パスワード文字列を再確認し、余分な空白を取り除いてください。 |
FileNotFoundException | 無効なファイルパス | 絶対パスを使用するか、作業ディレクトリを確認してください。 |
| 出力 PDF がぼやけている | DPI が低すぎる | options.setDpi() で DPI を上げてください。 |
| ページが逆さまに表示される | 回転が設定されていない、または誤って設定されている | options.setRotate(Rotation.On180)(または他の enum)を使用してください。 |
| 変換されたファイルが予想より大きい | 高 DPI と大きな寸法 | DPI を下げるか、幅/高さを調整してサイズと品質のバランスを取ってください。 |
よくある質問
Q: パスワードと読み取り専用保護の両方が設定された Word ドキュメントを変換できますか?
A: はい。WordProcessingLoadOptions.setPassword() で開くパスワードを指定してください。読み取り専用フラグは変換時に無視されます。
Q: GroupDocs.Conversion は .doc(レガシー)ファイルと .docx の両方をサポートしていますか?
A: もちろんです。ライブラリは両方のフォーマットを透過的に処理します。
Q: java convert word pdf のパフォーマンスは大きなファイルでどのようにスケールしますか?
A: GroupDocs はデータをストリーミングし、各変換後にリソースを解放します。非常に大きなファイルの場合は、JVM ヒープサイズを増やし、完了後に Converter.dispose() を呼び出してください。
Q: バッチで複数のドキュメントを変換することは可能ですか?
A: はい。ファイルパスをループし、各々に新しい Converter を作成し、適切に同じ PdfConvertOptions を再利用してください。
Q: 開発ビルドに商用ライセンスは必要ですか?
A: 評価には無料トライアルで十分ですが、本番環境での展開には有効な GroupDocs.Conversion ライセンスが必要です。
最終更新日: 2026-10-10
テスト環境: GroupDocs.Conversion 25.2 for Java
作者: GroupDocs