Javaで複数のWordドキュメントを結合する完全な動作例

この例では、Merger API を使用して Java で複数の Word ドキュメントを結合する方法を示します。

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

// Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

// Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + e.getMessage());
        }
    }
}

注: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値が実際の環境に合わせて更新されていることを確認し、必要な依存関係がすべて正しくインストールされているか検証し、開発環境で十分にテストしてください。問題が発生した場合は、公式ドキュメントをご参照いただくか、サポートチームへお問い合わせください。

cURL を使用した REST API で Word ファイルをマージする

純粋な REST アプローチを好む場合、同じマージ操作を cURL 呼び出しで実行できます。以下の手順では、アクセストークンの取得、ソースファイルのアップロード、マージのリクエスト、結果のダウンロード方法を示します。

認証してアクセストークンを取得する:

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

各 DOCX ファイルをクラウドストレージにアップロードします（YOUR_ACCESS_TOKEN を前の手順のトークンに置き換えてください）:

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

input2.docx と input3.docx のアップロードコマンドを繰り返してください。

マージリクエストを作成する:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "outputPath":"merged_output.docx",
           "fileInfos":[
               {"filePath":"input1.docx"},
               {"filePath":"input2.docx"},
               {"filePath":"input3.docx"}
           ]
         }'

結合されたドキュメントをダウンロード:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/merged_output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.docx

リクエスト パラメータの詳細については、公式 API ドキュメントをご覧ください。

JavaでWord文書を結合するプロセスの理解

以下は、前述のコードのステップバイステップの内訳です。

1. Create an ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") は GroupDocs クラウドサービスへの接続を確立します。

   ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
   

2. Instantiate MergerApi - new MergerApi(apiClient) はマージ関連エンドポイントへのアクセスを提供します。

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Prepare source file list - 各 FileInfo オブジェクトはクラウドに保存された DOCX ファイルを指します。リストは MergeOptions に渡されます。

   List<FileInfo> sourceFiles = new ArrayList<>();
   sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
   

4. Configure MergeOptions - 出力パスを設定し、ソースファイルのリストを添付します。

   MergeOptions mergeOptions = new MergeOptions();
   mergeOptions.setOutputPath("merged_output.docx");
   mergeOptions.setFileInfos(sourceFiles);
   

5. Execute merge - mergerApi.merge(mergeOptions) はリクエストを送信し、マージされたドキュメントの FileInfo を返します。

   FileInfo result = mergerApi.merge(mergeOptions);
   

利用可能なプロパティの完全なリストについては、API リファレンスをご参照ください。

GroupDocs.Merger Cloud SDK の前提条件とセットアップ

コードを実行する前に、プロジェクトに Maven 依存関係を追加し、有効な GroupDocs アカウントがあることを確認してください。

SDK を pom.xml に追加します:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

最新の JAR とソースはダウンロードページからダウンロードしてください。
また、Java 8 以上とクラウド呼び出しのためのインターネット接続が必要です。
GroupDocs アカウントを作成し、Client ID と Client Secret を取得して、安全に保管してください。

結論

プログラムで DOCX ファイルをマージすることは、GroupDocs.Merger Cloud SDK for Java を使用すれば今や簡単です。サンプルコードと cURL スニペットは、ネイティブライブラリを使用するか直接 REST 呼び出しを行うかにかかわらず、Java で複数の Word ドキュメントを結合する 2 つの柔軟な方法を示しています。認証情報の設定や、必要に応じてストリーミングで大きなファイルを処理すること、代表的なドキュメントでマージ操作をテストすることを忘れないでください。実稼働環境では有料ライセンスが必要です。価格情報は製品ページにあり、一時ライセンスページ から評価用の一時ライセンスをリクエストできます。

よくある質問

• Javaでカスタムのファイル処理コードを書かずに複数のWordドキュメントを結合するにはどうすればよいですか？
  Use the GroupDocs.Merger Cloud SDK for Java. The SDK abstracts all low‑level operations and lets you merge DOCX files with a few API calls.

• 異なるクラウドフォルダーに保存されているドキュメントを結合することは可能ですか？
  はい。FileInfo オブジェクトに完全なクラウドファイルパスを指定してください。マージ操作は各ファイルをその場所から取得し、結合します。

• マージが ApiException で失敗した場合はどうすればよいですか？
  例外メッセージを確認し、ファイルが見つからない、権限の問題などの詳細を確認してください。ファイルパスが正しいこと、アカウントがストレージへの読み取り/書き込み権限を持っていることを確認します。エラーコードについては、公式ドキュメント を参照してください。

• 各環境（開発、ステージング、本番）ごとに別々のライセンスが必要ですか？
  1つのライセンスで全ての環境をカバーできますが、ライセンス契約で定められた使用制限を遵守する必要があります。テスト用には上記の一時ライセンスを使用できます。

読み続ける

• パスワード保護ソフトウェアを使用してZIPファイルにパスワードを設定する
• パスワード保護サービスを使用してExcelにパスワードを設定する
• C#でWord文書を結合する

Node.JS で複数の Word ドキュメントを結合する - 完全なコード例

この例では、GroupDocs.Merger Cloud SDK for Node.js を使用して、3 つの DOCX ファイルを単一のドキュメントに結合する方法を示します。

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

注意: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパス（input1.docx、combined_output.docx など）を実際のファイル位置に合わせて更新し、必要な依存関係がすべて正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント を参照するか、サポートチーム にお問い合わせください。

cURL を使用した REST API での Word ドキュメントのマージ

純粋な REST アプローチを好む場合、同じマージ操作は cURL コマンドで実行できます。以下は、認証、ソースファイルのアップロード、マージの実行、結果のダウンロードを行う簡潔なワークフローです。

1. 認証してアクセストークンを取得

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/authenticate" \
-H "Content-Type: application/json" \
-d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

レスポンスには、後続の呼び出しで使用される access_token が含まれています。

2. ソースファイルをアップロードする

マージしたい各DOCXファイルについてこの手順を繰り返します。

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. マージ操作の実行

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "documents": [
        {"fileInfo": {"filePath": "documents/input1.docx"}},
        {"fileInfo": {"filePath": "documents/input2.docx"}},
        {"fileInfo": {"filePath": "documents/input3.docx"}}
    ],
    "outputPath": "documents/combined_output.docx"
}'

API はマージされたファイルのパスを返します。

4. 結合されたドキュメントのダウンロード

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=documents/combined_output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o combined_output.docx

リクエスト ペイロードとオプションの詳細については、公式 API ドキュメントをご覧ください。

Node.JS で複数の Word ドキュメントをマージする方法

SDKはマージプロセスをいくつかの論理的なステップに抽象化します：

1. 構成作成 - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) は認証コンテキストを構築します。 詳細は API Reference のクラス参照をご覧ください。

   const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
   

2. API インスタンス - new GroupDocsMergerCloud.MergeApi(config) はマージ操作へのアクセスを提供します。

const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

3. ドキュメント エントリ - 各ソースファイルは DocumentEntry でラップされ、その中にファイルパスを持つ FileInfo が含まれます。

   const documentEntries = inputFiles.map(path => {
       return new GroupDocsMergerCloud.Models.DocumentEntry({
           fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
       });
   });
   

4. マージリクエスト - MergeDocumentsRequest はエントリと目的の出力パスをバンドルします。

   const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
       documents: documentEntries,
       outputPath: outputFile
   });
   

5. 実行 - mergeApi.mergeDocuments(mergeRequest) はクラウドサービスにリクエストを送信します。Promise は出力ファイルパスを含む結果オブジェクトで解決されます。

const result = await mergeApi.mergeDocuments(mergeRequest);
console.log(`Merge completed successfully. Output file: ${result.path}`);

これらの手順を組み合わせることで、低レベルのファイルストリームを扱うことなく、複数の Word ドキュメントを効率的に結合できます。

GroupDocs.Merger の環境を準備する

1. SDK をインストールする

npm install groupdocs-merger-cloud

パッケージは公式のダウンロードページから入手できます。

2. Node.js バージョン - Node.js 12 以上が実行されていることを確認してください。

3. 認証情報の構成 - コード内の YOUR_CLIENT_ID と YOUR_CLIENT_SECRET を、GroupDocs Cloud アカウントの値に置き換えてください。

4. プロジェクト フォルダーを作成 - ソース DOCX ファイルを documents/ サブフォルダーに配置し、例に示すように。

これらの手順が完了したら、マージスクリプトを実行するか、REST エンドポイントを呼び出す準備が整います。

結論

Node.JS で複数の Word ドキュメントを結合することは、GroupDocs.Merger Cloud SDK for Node.js を使用すれば簡単になります。SDK はファイルのアップロード、マージロジック、出力生成を処理し、低レベルのファイル操作ではなくビジネスロジックに集中できるようにします。製品版の使用には適切なライセンスを取得することを忘れないでください。まずは一時ライセンスで開始し、ニーズに応じてフルサブスクリプションにアップグレードできます。今日からマージを始め、ドキュメントワークフローを効率化しましょう。

FAQs

• Node.JS の SDK を使用して複数の Word ドキュメントを結合するにはどうすればよいですか？
  MergeApi クラスを使用して、各 DOCX ファイルを DocumentEntry として列挙する MergeDocumentsRequest を作成します。SDK は指定された順序でドキュメントを結合し、結果を指定された出力パスに保存します。

• 同じ SDK で PDF を結合することは可能ですか？
  はい、Merger SDK は PDF、DOCX、ODT、およびその他複数の形式をサポートしています。inputFiles 配列のファイル拡張子を変更するだけで、SDK が自動的に変換を処理します。形式の詳細については、公式ドキュメント を参照してください。

• 単一リクエストでマージできるドキュメント数の上限は何ですか？
  クラウドサービスは厳密な数ではなくサイズ制限を課しています。結合されたサイズがアカウントのクォータ内に収まっている限り、何十ものファイルをマージできます。非常に大規模なバッチの場合は、まずファイルを GroupDocs ストレージにアップロードし、ID で参照することを検討してください。

• 開発と本番でライセンスを気にする必要がありますか？
  開発およびテストでは、一時ライセンスページから取得できる一時ライセンスを使用できます。本番環境へのデプロイでは、無制限のマージと優先サポートを利用できるフルライセンスを購入してください。

さらに読む

• パスワード保護ソフトウェアを使用したZIPファイルのパスワード保護
• パスワード保護サービスを使用したExcelのパスワード保護
• C#でWord文書を結合する