การรวมไฟล์ Word ด้วยโปรแกรมเป็นความต้องการที่พบบ่อยเมื่อสร้างแอปพลิเคชันที่เน้นเอกสาร โดยเฉพาะสำหรับการสร้างรายงานหรือการรวมสัญญา GroupDocs.Merger Cloud SDK for Java ให้ไลบรารีแบบคลาวด์ที่ง่ายซึ่งช่วยให้คุณรวมไฟล์ DOCX โดยไม่ต้องจัดการกับการจัดการไฟล์ระดับต่ำ ในคู่มือนี้คุณจะได้เรียนรู้วิธีการรวมเอกสาร Word หลายไฟล์ใน Java ดูตัวอย่างโค้ดเต็มสำรวจการเรียกใช้ cURL ที่เทียบเท่า และเข้าใจการตั้งค่าที่จำเป็น เมื่อเสร็จสิ้นคุณจะพร้อมผสานการรวมเอกสารเข้าสู่โครงการ Java ของคุณเอง
ตัวอย่างการทำงานเต็มรูปแบบเพื่อรวมหลายเอกสาร 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
ด้านล่างเป็นการแยกขั้นตอนอย่างละเอียดของโค้ดที่แสดงไว้ก่อนหน้า.
- สร้าง ApiClient -
new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")สร้างการเชื่อมต่อกับบริการคลาวด์ของ GroupDocs.
ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
- สร้างอินสแตนซ์ MergerApi -
new MergerApi(apiClient)ให้การเข้าถึง endpoint ที่เกี่ยวกับการรวม.
MergerApi mergerApi = new MergerApi(apiClient);
- เตรียมรายการไฟล์ต้นทาง - แต่ละอ็อบเจ็กต์
FileInfoชี้ไปยังไฟล์ DOCX ที่เก็บไว้ในคลาวด์ รายการนี้จะถูกส่งให้กับMergeOptions.
List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
- กำหนดค่า MergeOptions - ตั้งค่าที่อยู่ของไฟล์ผลลัพธ์ที่ต้องการและแนบรายการไฟล์ต้นทาง.
MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setOutputPath("merged_output.docx");
mergeOptions.setFileInfos(sourceFiles);
- ดำเนินการรวม -
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?
ตรวจสอบข้อความข้อยกเว้นเพื่อดูรายละเอียดเช่นไฟล์ที่หายไปหรือปัญหาการอนุญาต ตรวจสอบให้แน่ใจว่าเส้นทางไฟล์ถูกต้องและบัญชีของคุณมีสิทธิ์อ่าน/เขียนเข้าถึงที่เก็บข้อมูล ปรึกษา เอกสารอย่างเป็นทางการ สำหรับรหัสข้อผิดพลาดฉันต้องการใบอนุญาตแยกต่างหากสำหรับแต่ละสภาพแวดล้อม (การพัฒนา, สเตจ, การผลิต) หรือไม่?
ใบอนุญาตเดียวครอบคลุมทุกสภาพแวดล้อม แต่คุณต้องปฏิบัติตามขีดจำกัดการใช้งานที่กำหนดในข้อตกลงใบอนุญาตของคุณ สำหรับการทดสอบคุณสามารถใช้ใบอนุญาตชั่วคราวที่ลิงก์ด้านบน
