GroupDocs.Editor for Java を使用した DOCX の編集とリソース抽出方法
はじめに
プログラムで docx から画像を抽出 しながら埋め込み資産も取得したい場合は、ここが適切な場所です。このチュートリアルでは GroupDocs.Editor for Java を使って Word 文書を編集し、画像・フォント・スタイルシートを抽出し、さらに複数ファイルのバッチ処理を行う方法を解説します。コンテンツ管理ポータル、デジタル資産パイプライン、カスタムレポートエンジンの構築に役立ち、時間を節約しコードをすっきりさせられます。
クイック回答
- docx を編集するには?
Editor.edit()とWordProcessingEditOptionsを使用します。 - docx から画像を抽出するには?
document.getImages()を呼び出し、各IImageResourceを保存します。 - docx からフォントを抽出できるか? はい —
document.getFonts()を使用し、FontResourceBaseオブジェクトを保存します。 - バッチ処理はサポートされているか? ファイルのリストをループで処理すれば、GroupDocs.Editor が各ファイルを独立して処理します。
- ライセンスは必要か? 本番環境で使用する場合は、一時ライセンスまたはトライアルライセンスが必要です。
なぜ docx から画像を抽出するのか?
画像を抽出すると、Word ファイルに埋め込まれたビジュアル資産に直接アクセスできます。Web ギャラリー用に画像を再利用したり、デジタル資産管理システムへ移行したり、文書コンテンツとは別にアーカイブしたりする際に特に有用です。
GroupDocs.Editor で「docx を編集する」とは?
GroupDocs.Editor は Office Open XML 形式の複雑さを抽象化したハイレベル API を提供します。.docx ファイルを Editor インスタンスにロードすることで、文書の内容と埋め込みリソースに対するフルリード/ライトアクセスが可能になります。
なぜ Java アプリケーションで Word 文書を GroupDocs.Editor で編集するのか?
- Office のインストール不要 — 任意のサーバーサイド環境で動作します。
- 豊富なリソース抽出 — 数行のコードで画像、フォント、CSS スタイルシートを取得できます。
- スケーラブルなバッチ処理 — メモリリークなしで多数のファイルを一括処理できます。
- クロスプラットフォーム — JDK 8+ と任意の Maven ベースプロジェクトで利用可能です。
前提条件
- Java Development Kit (JDK) 8 以上
- Maven(依存関係管理用)
- Java プロジェクト構成に関する基本的な知識
GroupDocs.Editor for Java のセットアップ
Maven 設定
pom.xml にリポジトリと依存関係を追加します。
<repositories>
<repository>
<id>repository.groupdocs.com</id>
<name>GroupDocs Repository</name>
<url>https://releases.groupdocs.com/editor/java/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-editor</artifactId>
<version>25.3</version>
</dependency>
</dependencies>
直接ダウンロード
Maven を使用したくない場合は、GroupDocs releases から最新バージョンの GroupDocs.Editor for Java をダウンロードしてください。
ライセンス取得
GroupDocs.Editor の使用を開始するには、無料トライアルまたは一時ライセンスを取得します。GroupDocs のウェブサイト で一時ライセンスをリクエストできます。提供された手順に従ってコードにライセンスを適用してください。
基本的な初期化と設定
ライブラリを追加したら、Word ファイルを指す Editor インスタンスを作成します。
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new WordProcessingLoadOptions());
これで edit word document java スタイルの編集が可能になります。
実装ガイド
実装は機能ごとに分割し、各セクションで GroupDocs.Editor for Java の特定の機能に焦点を当てます。
GroupDocs.Editor for Java で DOCX を編集する方法
概要
文書のロードと編集は最初のステップです。この機能により、ユーザーはアプリケーション内でコンテンツを直接閲覧・変更できます。
手順 1: Editor オブジェクトを作成
// Initialize the Editor with the path to your Word file.
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new WordProcessingLoadOptions());
手順 2: 文書を編集
edit() メソッドを使用して、操作可能な EditableDocument を取得します。
EditableDocument document = editor.edit(new WordProcessingEditOptions());
DOCX から画像を抽出する方法
概要
画像抽出は、テキストとは別にビジュアルを再利用またはアーカイブしたい場合に不可欠です。
手順 1: 画像を取得
// Get the list of image resources in the document.
List<IImageResource> images = document.getImages();
画像をフォルダーに保存
概要
抽出後は、必要な場所に画像を保存できます。
手順 2: 抽出した画像を保存
String outputFolder = "YOUR_OUTPUT_DIRECTORY";
for (IImageResource oneImage : images) {
// Save each image with its original name and extension.
oneImage.save(outputFolder + oneImage.getFilenameWithExtension());
}
DOCX からフォントを抽出する方法
概要
ブランド向けに埋め込まれたフォントを抽出すれば、プラットフォーム間で視覚的一貫性を保てます。
手順 1: フォントを取得
// Obtain a list of font resources within the document.
List<FontResourceBase> fonts = document.getFonts();
フォントをフォルダーに保存
概要
抽出したフォントをデザインツールや他の文書で後から利用できるように永続化します。
手順 2: 抽出したフォントを保存
for (FontResourceBase oneFont : fonts) {
// Store each font resource with its original name and extension.
oneFont.save(outputFolder + oneFont.getFilenameWithExtension());
}
DOCX からスタイルシートを抽出する方法
概要
スタイルシート(CSS)は視覚レイアウトを定義します。これを抽出すれば、Web や他の文書形式でスタイルを再利用できます。
手順 1: スタイルシートを取得
// Access the list of CSS text resources in the document.
List<CssText> stylesheets = document.getCss();
スタイルシートをフォルダーに保存
概要
CSS ファイルを保存すれば、Word 以外でも文書のスタイリングを完全にコントロールできます。
手順 2: 抽出したスタイルシートを保存
for (CssText oneStylesheet : stylesheets) {
// Preserve each stylesheet with its original name and extension.
oneStylesheet.save(outputFolder + oneStylesheet.getFilenameWithExtension());
}
実用例
- デジタル資産管理 — 画像を集中リポジトリに抽出。
- ブランド一貫性 — フォントを抽出して、すべての社内文書で統一されたブランディングを保証。
- カスタム文書テンプレート — 抽出したスタイルシートを再利用し、レポート自動生成用の一貫したテンプレートを構築。
- Word 文書のバッチ処理 —
.docxファイルが格納されたフォルダーをループし、同一の編集・抽出ワークフローを各ファイルに適用。
パフォーマンス上の考慮点
GroupDocs.Editor を使用する際は、以下のポイントに留意してください。
- リソース管理 — 各文書処理後に
editor.close()を呼び出すか、JVM のガベージコレクタにリソース解放を任せます。 - バッチ処理 — ファイルを順次処理するかスレッドプールを利用しますが、メモリ使用量を監視してください。
- ロードオプションの調整 — 大容量文書向けに
WordProcessingLoadOptions(不要機能の無効化など)を調整します。
よくある質問
Q: GroupDocs.Editor はすべての Java バージョンに対応していますか?
A: はい、JDK 8 以降で動作します。
Q: パスワード保護された文書を編集できますか?
A: 可能です。WordProcessingLoadOptions でパスワードを指定してください。
Q: リソース抽出はワークフローにどんなメリットがありますか?
A: 資産を一元管理でき、ブランド更新が簡素化され、さまざまなプラットフォームで再利用可能になります。
Q: バッチ処理のパフォーマンスへの影響は?
A: 適切なリソースクリーンアップと最適なロードオプションを設定すれば、数十ファイルでもメモリ使用量を低く抑えられます。
Q: GroupDocs.Editor はクラウドストレージと統合できますか?
A: はい、AWS S3、Azure Blob、Google Cloud Storage から直接ストリームでファイルを Editor に渡すことができます。
リソース
このガイドに従えば、docx を編集 し、GroupDocs.Editor for Java を使用してすべての関連リソースを抽出するための確固たる基盤が手に入ります。スペルチェック、変更履歴の追跡、カスタム HTML 変換など、追加の API 機能を試してソリューションをさらに拡張してください。
最終更新日: 2026-03-22
テスト環境: GroupDocs.Editor 25.3 for Java
作成者: GroupDocs