ตัวอย่างการทำงานเต็มรูปแบบเพื่อรวมหลายเอกสาร Word ใน Java

ตัวอย่างนี้แสดงวิธีการรวมหลายเอกสาร Word ใน Java โดยใช้ Merger API.

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());
        }
    }
}

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลักของฟังก์ชัน ก่อนนำไปใช้ในโครงการของคุณ ให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาที่จำเป็นทั้งหมดได้ติดตั้งอย่างถูกต้อง และทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อ ทีมสนับสนุน เพื่อขอความช่วยเหลือ

ผสานไฟล์ Word ผ่าน REST API ด้วย cURL

หากคุณต้องการใช้วิธี 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 อย่างเป็นทางการ.

ทำความเข้าใจกระบวนการรวมเอกสาร Word ใน Java

ด้านล่างเป็นการแยกขั้นตอนอย่างละเอียดของโค้ดที่แสดงไว้ก่อนหน้า.

1. สร้าง ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") สร้างการเชื่อมต่อกับบริการคลาวด์ของ GroupDocs.

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

2. สร้างอินสแตนซ์ MergerApi - new MergerApi(apiClient) ให้การเข้าถึง endpoint ที่เกี่ยวกับการรวม.

MergerApi mergerApi = new MergerApi(apiClient);

3. เตรียมรายการไฟล์ต้นทาง - แต่ละอ็อบเจ็กต์ FileInfo ชี้ไปยังไฟล์ DOCX ที่เก็บไว้ในคลาวด์ รายการนี้จะถูกส่งให้กับ MergeOptions.

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

4. กำหนดค่า MergeOptions - ตั้งค่าที่อยู่ของไฟล์ผลลัพธ์ที่ต้องการและแนบรายการไฟล์ต้นทาง.

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

5. ดำเนินการรวม - 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 ล่าสุดและซอร์สโค้ดจาก download page.
คุณจะต้องมี Java 8 หรือสูงกว่าและการเชื่อมต่ออินเทอร์เน็ตสำหรับการเรียกใช้คลาวด์.
สร้างบัญชี GroupDocs, รับ Client ID และ Client Secret ของคุณและเก็บให้ปลอดภัย.

สรุป

การรวมไฟล์ DOCX ด้วยโปรแกรมเมชันตอนนี้ง่ายขึ้นด้วย GroupDocs.Merger Cloud SDK for Java. ตัวอย่างโค้ดและสคริปต์ cURL แสดงสองวิธีที่ยืดหยุ่นในการรวมเอกสาร Word หลายไฟล์ใน Java ไม่ว่าคุณจะชอบใช้ไลบรารีเนทีฟหรือเรียก REST โดยตรง อย่าลืมกำหนดค่าข้อมูลประจำตัวของคุณ, จัดการไฟล์ขนาดใหญ่โดยการสตรีมเมื่อต้องการ, และทดสอบการทำงานของการรวมด้วยเอกสารตัวอย่าง สำหรับการใช้งานในสภาพแวดล้อมการผลิตคุณจะต้องมีใบอนุญาตแบบชำระเงิน; รายละเอียดราคาอยู่ในหน้าผลิตภัณฑ์และคุณสามารถขอใบอนุญาตชั่วคราวเพื่อการประเมินจาก หน้าลิขสิทธิ์ชั่วคราว.

FAQs

• ฉันจะรวมเอกสาร Word หลายไฟล์ใน Java โดยไม่ต้องเขียนโค้ดจัดการไฟล์แบบกำหนดเองได้อย่างไร?
  ใช้ GroupDocs.Merger Cloud SDK for Java. SDK จะทำหน้าที่แยกการดำเนินการระดับต่ำทั้งหมดและทำให้คุณสามารถรวมไฟล์ DOCX ได้ด้วยการเรียก API เพียงไม่กี่ครั้ง.

• เป็นไปได้หรือไม่ที่จะรวมเอกสารที่จัดเก็บในโฟลเดอร์คลาวด์ต่าง ๆ?
  ใช่. ให้ระบุเส้นทางไฟล์คลาวด์เต็มในอ็อบเจกต์ FileInfo แล้วการดำเนินการรวมจะดึงไฟล์แต่ละไฟล์จากตำแหน่งของมันก่อนที่จะรวมเข้าด้วยกัน.

• ฉันควรทำอย่างไรหากการรวมล้มเหลวด้วย ApiException?
  ตรวจสอบข้อความข้อยกเว้นเพื่อดูรายละเอียดเช่นไฟล์ที่หายไปหรือปัญหาการอนุญาต ตรวจสอบให้แน่ใจว่าเส้นทางไฟล์ถูกต้องและบัญชีของคุณมีสิทธิ์อ่าน/เขียนเข้าถึงที่เก็บข้อมูล ปรึกษา เอกสารอย่างเป็นทางการ สำหรับรหัสข้อผิดพลาด

• ฉันต้องการใบอนุญาตแยกต่างหากสำหรับแต่ละสภาพแวดล้อม (การพัฒนา, สเตจ, การผลิต) หรือไม่?
  ใบอนุญาตเดียวครอบคลุมทุกสภาพแวดล้อม แต่คุณต้องปฏิบัติตามขีดจำกัดการใช้งานที่กำหนดในข้อตกลงใบอนุญาตของคุณ สำหรับการทดสอบคุณสามารถใช้ใบอนุญาตชั่วคราวที่ลิงก์ด้านบน

อ่านเพิ่มเติม

• ปกป้องไฟล์ ZIP ด้วยซอฟต์แวร์การป้องกันรหัสผ่าน
• ปกป้อง Excel ด้วยบริการการป้องกันรหัสผ่าน
• รวมเอกสาร Word ใน C#

รวมหลายเอกสาร Word ใน Node.JS - ตัวอย่างโค้ดเต็ม

ตัวอย่างนี้แสดงวิธีการรวมไฟล์ DOCX สามไฟล์เป็นเอกสารเดียวโดยใช้ GroupDocs.Merger Cloud SDK for Node.js.

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, เป็นต้น) ให้ตรงกับตำแหน่งไฟล์จริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาที่จำเป็นทั้งหมดได้ติดตั้งอย่างถูกต้อง และทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อทีมสนับสนุนที่ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

การรวมเอกสาร Word ผ่าน REST API ด้วย cURL

หากคุณต้องการใช้วิธี 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

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ payload ของคำขอและตัวเลือก ดูที่ เอกสาร API อย่างเป็นทางการ.

วิธีการทำงานของการรวมหลายเอกสาร Word ใน Node.JS

SDK สรุปกระบวนการผสานเป็นขั้นตอนเชิงตรรกะไม่กี่ขั้นตอน:

1. การสร้างการกำหนดค่า - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) สร้างบริบทการตรวจสอบสิทธิ์ ดูอ้างอิงคลาสใน API Reference.

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

2. API Instance - new GroupDocsMergerCloud.MergeApi(config) ให้การเข้าถึงการดำเนินการรวม.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Document Entries - แต่ละไฟล์ต้นทางจะถูกห่อหุ้มใน DocumentEntry ที่มี FileInfo พร้อมเส้นทางไฟล์.

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

4. Merge Request - 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. กำหนดค่า Credentials - แทนที่ YOUR_CLIENT_ID และ YOUR_CLIENT_SECRET ในโค้ดด้วยค่าจากบัญชี GroupDocs Cloud ของคุณ.

4. สร้างโฟลเดอร์โปรเจกต์ - วางไฟล์ DOCX ต้นฉบับในโฟลเดอร์ย่อย documents/ ตามที่แสดงในตัวอย่าง.

เมื่อทำตามขั้นตอนเหล่านี้เสร็จแล้ว คุณพร้อมที่จะเรียกใช้สคริปต์การรวมหรือเรียกใช้ REST endpoints

สรุป

การรวมหลายเอกสาร Word ใน Node.JS กลายเป็นเรื่องง่ายด้วย GroupDocs.Merger Cloud SDK for Node.js. SDK จัดการการอัปโหลดไฟล์, โลจิกการรวม, และการสร้างผลลัพธ์, ทำให้คุณสามารถมุ่งเน้นที่ตรรกะธุรกิจแทนการจัดการไฟล์ระดับต่ำ. อย่าลืมรับใบอนุญาตที่เหมาะสมสำหรับการใช้งานในสภาพแวดล้อมการผลิต; คุณสามารถเริ่มต้นด้วย ใบอนุญาตชั่วคราว และอัปเกรดเป็นการสมัครสมาชิกเต็มรูปแบบเมื่อความต้องการของคุณเพิ่มขึ้น. เริ่มรวมไฟล์วันนี้และทำให้กระบวนการทำงานเอกสารของคุณเป็นระเบียบมากขึ้น.

คำถามที่พบบ่อย

• ฉันจะรวมเอกสาร Word หลายไฟล์ใน Node.JS โดยใช้ SDK ได้อย่างไร?
  ใช้คลาส MergeApi เพื่อสร้าง MergeDocumentsRequest ที่ระบุไฟล์ DOCX แต่ละไฟล์เป็น DocumentEntry. SDK จะทำการรวมไฟล์เหล่านั้นตามลำดับที่ระบุและบันทึกผลลัพธ์ไปยังเส้นทางเอาต์พุตที่กำหนด.

• สามารถรวมไฟล์ PDF เข้าด้วยกันได้ด้วย SDK เดียวกันหรือไม่?
  ใช่, Merger SDK รองรับ PDF, DOCX, ODT, และหลายรูปแบบอื่น ๆ เพียงเปลี่ยนส่วนขยายของไฟล์ในอาร์เรย์ inputFiles แล้ว SDK จะจัดการการแปลงโดยอัตโนมัติ ดูที่ เอกสารอย่างเป็นทางการ สำหรับรายละเอียดรูปแบบ.

• จำนวนเอกสารที่ฉันสามารถรวมในคำขอเดียวได้มีขีดจำกัดเท่าใด?
  บริการคลาวด์กำหนดขีดจำกัดตามขนาดแทนที่จะเป็นจำนวนที่แน่นอน ตราบใดที่ขนาดรวมยังอยู่ในโควต้าของบัญชีของคุณ คุณสามารถรวมไฟล์ได้หลายสิบไฟล์ สำหรับชุดข้อมูลขนาดใหญ่มาก ให้พิจารณาอัปโหลดไฟล์ไปยังที่เก็บข้อมูลของ GroupDocs ก่อนและอ้างอิงโดยใช้ ID

• ฉันต้องกังวลเรื่องการให้สิทธิ์สำหรับการพัฒนาเทียบกับการผลิตหรือไม่?
  การพัฒนาและการทดสอบสามารถใช้ใบอนุญาตชั่วคราวที่ได้รับจาก หน้าลิขสิทธิ์ชั่วคราว ได้ สำหรับการใช้งานในสภาพแวดล้อมการผลิต ให้ซื้อใบอนุญาตเต็มเพื่อเปิดใช้งานการรวมไม่จำกัดและการสนับสนุนระดับแรก.

อ่านเพิ่มเติม

• ป้องกันไฟล์ ZIP ด้วยซอฟต์แวร์การป้องกันด้วยรหัสผ่าน
• ป้องกันไฟล์ Excel ด้วยบริการการป้องกันด้วยรหัสผ่าน
• รวมเอกสาร Word ใน C#