Java: แปลงหน้าเว็บเป็น DOCX ด้วย GroupDocs.Editor

คำตอบสั้น

• อะไรหมายถึง “convert webpage to docx”? มันแปลงมาร์กอัป HTML และทรัพยากรของมันเป็นไฟล์ Word (DOCX/DOCM) ที่สามารถแก้ไขได้.
• ไลบรารีที่ทำการแปลงคืออะไร? GroupDocs.Editor for Java.
• ฉันต้องการไลเซนส์หรือไม่? การทดลองใช้ฟรีทำงานสำหรับการทดสอบ; จำเป็นต้องมีไลเซนส์แบบชำระเงินสำหรับการใช้งานจริง.
• ต้องการเวอร์ชัน Java ใด? Java 8 หรือสูงกว่า.
• ฉันสามารถเก็บ CSS และรูปภาพได้หรือไม่? ได้ – ตัวแก้ไขจะเก็บสไตล์ชีตและรูปภาพที่เชื่อมโยงไว้ในระหว่างการแปลง.

“convert webpage to docx” คืออะไร

โหลดแหล่งที่มาของ HTML, รวม CSS หรือรูปภาพที่อ้างอิงไว้, แล้วสร้างเอกสารประมวลผลคำที่สะท้อนเลย์เอาต์เดิม การแปลงจะคงหัวเรื่อง, ตาราง, รายการ, และสไตล์ไว้, ผลลัพธ์เป็นไฟล์ที่สามารถเปิดและแก้ไขใน Microsoft Word หรือโปรแกรมแก้ไขที่เข้ากันได้โดยไม่ต้องทำการจัดรูปแบบหรือสร้างใหม่ด้วยตนเอง.

ทำไมต้องใช้ GroupDocs.Editor สำหรับ Java

GroupDocs.Editor ให้ API ระดับสูงที่แปลง HTML เป็น DOCX ภายในเวลาน้อยกว่า 2 วินาทีสำหรับไฟล์ขนาดสูงสุด 150 MB, รองรับกว่า 30 องค์ประกอบ HTML, และฝัง CSS กับรูปภาพโดยอัตโนมัติ มันทำงานข้ามแพลตฟอร์ม, ไม่ต้องพึ่งพาไลบรารีเนทีฟ, และรับประกันความแม่นยำของเลย์เอาต์ใน Word, LibreOffice, และ Google Docs.

ข้อกำหนดเบื้องต้น

ไลบรารีที่จำเป็น, เวอร์ชัน, และการพึ่งพา

• Apache Commons IO – ทำให้การทำงานกับไฟล์ I/O ง่ายขึ้น.
• GroupDocs.Editor – เวอร์ชัน 25.3 (หรือรุ่นเสถียรล่าสุด).

ความต้องการการตั้งค่าสภาพแวดล้อม

• JDK 8 หรือใหม่กว่า ติดตั้งแล้ว.
• IDE เช่น IntelliJ IDEA หรือ Eclipse.

ความรู้เบื้องต้นที่จำเป็น

• พื้นฐาน Java และโครงสร้างโปรเจกต์ Maven.
• ความคุ้นเคยกับไฟล์ HTML และโครงสร้างโฟลเดอร์ของมัน.

การตั้งค่า GroupDocs.Editor สำหรับ Java

การตั้งค่า Maven

เพิ่มรีโพซิทอรีของ GroupDocs และ dependency ลงในไฟล์ 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>

ดาวน์โหลดโดยตรง

Alternatively, you can download the latest version from การปล่อย GroupDocs.Editor สำหรับ Java.

ขั้นตอนการรับไลเซนส์

• Free Trial: เริ่มต้นด้วยการทดลองเพื่อสำรวจ API.
• Temporary License: ใช้คีย์ที่มีเวลาจำกัดสำหรับการประเมินที่ต่อเนื่อง.
• Purchase: รับไลเซนส์เชิงพาณิชย์สำหรับการใช้งานในสภาพแวดล้อมการผลิต.

คู่มือการใช้งาน

ด้านล่างเป็นขั้นตอนการทำงานแบบทีละขั้นตอน แต่ละบล็อกโค้ดจะไม่เปลี่ยนแปลงจากบทแนะนำต้นฉบับ; คำอธิบายโดยรอบได้ถูกขยายเพื่อความชัดเจน.

ฟีเจอร์ 1 – การอ่านเนื้อหา HTML จากไฟล์

ทำไมเรื่องนี้สำคัญ: เพื่อแปลงหน้าเว็บคุณต้องมี HTML ดิบเป็น String ก่อน การใช้ Apache Commons IO ทำให้เป็นบรรทัดเดียว.

1.1 นำเข้าไลบรารีที่จำเป็น

import java.io.File;
import org.apache.commons.io.FileUtils;

1.2 ระบุเส้นทางไฟล์

แทนที่ YOUR_DOCUMENT_DIRECTORY ด้วยโฟลเดอร์ที่เก็บไฟล์ HTML ต้นฉบับของคุณ.

String htmlFilePath = "YOUR_DOCUMENT_DIRECTORY/sample_html_body.html";

1.3 อ่านเนื้อหาเป็น String

เมธอด FileUtils.readFileToString จะอ่านไฟล์โดยใช้การเข้ารหัส UTF‑8, คงอักขระทั้งหมดไว้.

String content = FileUtils.readFileToString(new File(htmlFilePath), "utf-8");
// Note: This method reads the HTML content as a UTF-8 encoded string, ensuring accurate representation of characters.

ฟีเจอร์ 2 – การเริ่มต้น EditableDocument จากเนื้อหา HTML

ทำไมเรื่องนี้สำคัญ: EditableDocument เป็นอ็อบเจกต์หลักที่รวมมาร์กอัปกับทรัพยากร (CSS, รูปภาพ) เพื่อให้ตัวแก้ไขทำงานกับเอกสารที่สมบูรณ์.

คลาส EditableDocument แทนเอกสาร HTML เดียวพร้อมกับทรัพยากรที่เชื่อมโยง, ทำให้การแปลงเป็นรูปแบบอื่นเป็นไปอย่างราบรื่น.

2.1 นำเข้าไลบรารี GroupDocs

import com.groupdocs.editor.EditableDocument;

2.2 ระบุเส้นทางโฟลเดอร์ทรัพยากร

โฟลเดอร์ควรมีไฟล์ CSS, รูปภาพ, หรือทรัพยากรอื่น ๆ ที่ HTML อ้างอิง.

String resourceFolderPath = "YOUR_DOCUMENT_DIRECTORY/sample_html_body_resources";

2.3 เริ่มต้น EditableDocument

การเรียกนี้จะผสานมาร์กอัป HTML กับโฟลเดอร์ทรัพยากร, สร้างเอกสารที่แก้ไขได้ในหน่วยความจำ.

EditableDocument inputDoc = EditableDocument.fromMarkupAndResourceFolder(content, resourceFolderPath);
// This method combines the HTML markup with its linked resources to form a complete editable document.

ฟีเจอร์ 3 – การตรวจสอบทรัพยากรของเอกสาร

ทำไมเรื่องนี้สำคัญ: การรู้จำนวนสไตล์ชีตหรือรูปภาพที่มีอยู่ช่วยให้คุณตัดสินใจว่าต้องทำการประมวลผลเพิ่มเติม (เช่น การเพิ่มประสิทธิภาพรูปภาพ) หรือไม่.

3.1 นับสไตล์ชีตและรูปภาพ

int stylesheetCount = inputDoc.getCss().size();
int imageCount = inputDoc.getImages().size();
// These methods provide insights into how many stylesheets or images are linked within your HTML content.

ฟีเจอร์ 4 – การบันทึก EditableDocument เป็น HTML

ทำไมเรื่องนี้สำคัญ: บางครั้งคุณอาจต้องการเก็บเวอร์ชัน HTML หลังจากแก้ไข, หรือคุณต้องการตรวจสอบว่าทรัพยากรถูกบรรจุอย่างถูกต้อง.

4.1 นำเข้าไลบรารีตัวเลือกการบันทึก

import com.groupdocs.editor.Editor;

4.2 ระบุเส้นทางเอาต์พุตสำหรับ HTML

String outputHtmlFilePath = "YOUR_OUTPUT_DIRECTORY/_output.html";

4.3 บันทึกเอกสารเป็น HTML

เมธอด save จะเขียนเอกสารที่แก้ไขแล้วกลับไปยังดิสก์, คงโครงสร้างไว้.

inputDoc.save(outputHtmlFilePath);
// This saves all changes made in memory back into a new HTML document, maintaining its editable format and resources.

ฟีเจอร์ 5 – การบันทึก EditableDocument เป็นเอกสารประมวลผลคำ (DOCX/DOCM)

ทำไมเรื่องนี้สำคัญ: การแปลงเป็น DOCX/DOCM จะให้ไฟล์ Word ที่สามารถแก้ไขได้เต็มรูปแบบและสามารถเปิดใน Microsoft Word, LibreOffice, หรือโปรแกรมแก้ไขที่เข้ากันได้.

enum WordProcessingFormats กำหนดรูปแบบ Word ที่ต้องการสร้าง (DOCX หรือ DOCM) อย่างชัดเจน.

5.1 นำเข้าไลบรารีตัวเลือกการบันทึก

import com.groupdocs.editor.options.WordProcessingSaveOptions;
import com.groupdocs.editor.formats.WordProcessingFormats;

5.2 ระบุเส้นทางเอาต์พุตสำหรับ DOCX/DOCM

String outputDocmFilePath = "YOUR_OUTPUT_DIRECTORY/_output.docm";

5.3 ตั้งค่าตัวเลือกการบันทึกและรูปแบบ

ที่นี่เราระบุรูปแบบ DOCM (เอกสาร Word ที่เปิดใช้งานมาโคร) อย่างชัดเจน คุณสามารถเปลี่ยนเป็น "docx" เพื่อเป็นเอกสารมาตรฐานได้.

WordProcessingFormats saveFormat = WordProcessingFormats.fromExtension("docm");
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(saveFormat);
// Here, we define the desired output format (DOCM) along with any specific saving options needed for conversion.

Editor เป็นคลาสหลักที่รับ EditableDocument และเขียนออกเป็นรูปแบบ Word ที่เลือก.

5.4 บันทึกเอกสารเป็น DOCM

เราใช้คลาส Editor เพื่อทำการแปลงขั้นสุดท้าย.

Editor editor = new Editor(htmlFilePath);
editor.save(inputDoc, outputDocmFilePath, saveOptions);
// This final step converts and saves your HTML content into a fully functional Word document (DOCM).

การประยุกต์ใช้งานจริง

• Dynamic Report Generation: ดึงตารางจากแดชบอร์ดสด, แปลงเป็น Word, และส่งอีเมลรายงานอัตโนมัติ.
• Content Management Systems: ให้ปุ่ม “Export to Word” สำหรับบทความ, คงสไตล์และรูปภาพ.
• Legal Document Preparation: แปลงกฎระเบียบที่เผยแพร่บนเว็บเป็นสัญญาหรือเอกสารนโยบายที่แก้ไขได้.
• Educational Material Compilation: รวบรวมบันทึกการบรรยายจากหน้า HTML เป็นคู่มือการศึกษาเดียว.
• Business Proposal Creation: แปลงหน้าเว็บการตลาดเป็นข้อเสนอ DOCM ที่เรียบหรูสำหรับลูกค้า.

ข้อควรพิจารณาด้านประสิทธิภาพ

• Optimize Memory Usage: สำหรับไฟล์ HTML ขนาดใหญ่, เพิ่มขนาด heap ของ JVM (-Xmx2g) หรือประมวลผลเอกสารเป็นชิ้นส่วน.
• Load Resources Asynchronously: ในเครื่องมือเว็บ, โหลด CSS และรูปภาพในเธรดพื้นหลังเพื่อให้ UI ตอบสนอง.

ปัญหาทั่วไปและวิธีแก้

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

ถาม: ฉันสามารถแปลง URL สดโดยตรงโดยไม่ต้องบันทึก HTML ก่อนหรือไม่?
ตอบ: ใช่. ดาวน์โหลดเนื้อหาหน้าเว็บด้วย Jsoup หรือ HttpClient, แล้วส่งสตริงนั้นเข้าไปใน EditableDocument.fromMarkupAndResourceFolder.

ถาม: GroupDocs.Editor รองรับการแปลงเป็น DOCX เช่นเดียวกับ DOCM หรือไม่?
ตอบ: แน่นอน. เปลี่ยนส่วนขยายใน WordProcessingFormats.fromExtension("docx") และปรับชื่อไฟล์เอาต์พุต.

ถาม: ถ้า HTML ของฉันอ้างอิง CSS ภายนอกที่โฮสต์บน CDN จะทำอย่างไร?
ตอบ: ดาวน์โหลดไฟล์ CSS เหล่านั้นลงในโฟลเดอร์ทรัพยากรก่อนเริ่มต้น EditableDocument, หรือให้ตัวแก้ไขดึงมาเองหากเปิดใช้งานการเข้าถึงเครือข่าย.

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

ถาม: ฉันสามารถคงฟังก์ชัน JavaScript ไว้ในผลลัพธ์ Word ได้หรือไม่?
ตอบ: ไม่. รูปแบบเอกสารประมวลผลคำไม่รองรับ JavaScript ฝั่งไคลเอนต์; จะคงเฉพาะเนื้อหาคงที่และสไตล์เท่านั้น.

อัปเดตล่าสุด: 2026-07-02
ทดสอบด้วย: GroupDocs.Editor 25.3
ผู้เขียน: GroupDocs

บทแนะนำที่เกี่ยวข้อง

• วิธีแปลง Word เป็น HTML และแก้ไขเอกสาร Word ใน Java ด้วย GroupDocs.Editor
• โหลดเอกสาร Word ใน Java ด้วย GroupDocs.Editor – คู่มือฉบับสมบูรณ์
• แก้ไขเอกสาร Word ใน Java ด้วย GroupDocs.Editor – คู่มือ