Tạo html từ docx và hiển thị các thay đổi được theo dõi trong Java
Trong hướng dẫn này, bạn sẽ học cách generate html from docx trong khi vẫn giữ nguyên mọi phiên bản được theo dõi xuất hiện trong tệp Word nguồn. Cho dù bạn đang xây dựng một cổng thông tin xem xét hợp đồng, một hệ thống quản lý vụ kiện pháp lý, hoặc giao diện chỉnh sửa cộng tác, việc hiển thị các thay đổi được theo dõi dưới dạng HTML cho phép người dùng thấy chính xác những gì đã được thêm, xóa hoặc bình luận—mà không cần cài đặt Microsoft Word. Bài hướng dẫn sẽ đưa bạn qua cấu hình Maven, cấp phép, và toàn bộ mã Java cần thiết để xuất ra các trang HTML sạch sẽ, dễ điều hướng.
Hiển thị các thay đổi được theo dõi trong tài liệu Word với GroupDocs.Viewer cho Java
Câu trả lời nhanh
- “render word tracked changes” có nghĩa là gì? Nó chuyển đổi đánh dấu phiên bản của tệp Word thành một biểu diễn HTML trực quan với các phần nổi bật cho các chèn, xóa và bình luận.
- Thư viện nào xử lý việc này? GroupDocs.Viewer for Java provides a single API to render HTML, PDF, or images and to include tracked‑change markup.
- Tôi có cần giấy phép không? Bản dùng thử miễn phí hoạt động cho việc đánh giá; giấy phép đầy đủ loại bỏ mọi hạn chế của bản dùng thử và cho phép render với khối lượng lớn.
- Phiên bản Java nào được yêu cầu? Java 8 hoặc mới hơn được hỗ trợ; thư viện tương thích với Java 11, 17 và các bản phát hành LTS sau này.
- Tôi có thể tắt việc render các thay đổi được theo dõi không? Có—đặt
setRenderTrackedChanges(false)trên view options để tạo tài liệu sạch sẽ mà không có các đánh dấu phiên bản.
Render word tracked changes là gì?
Rendering word tracked changes có nghĩa là lấy dữ liệu phiên bản được lưu trong tệp .docx (các chèn, xóa, bình luận, v.v.) và tạo ra một định dạng có thể xem được—thường là HTML—nơi các thay đổi này được làm nổi bật trực quan. Điều này cho phép người dùng cuối thấy chính xác những gì đã được sửa đổi mà không cần mở Microsoft Word.
Tại sao nên sử dụng GroupDocs.Viewer để xem các phiên bản tài liệu Word?
GroupDocs.Viewer for Java trừu tượng hoá việc xử lý OpenXML mức thấp và cung cấp cho bạn một lời gọi API duy nhất để tạo HTML, PDF hoặc hình ảnh. Nó hỗ trợ hơn 120 định dạng và có thể render tài liệu lên tới 2 GB mà không cần tải toàn bộ tệp vào bộ nhớ, giúp cải thiện thời gian phản hồi và giảm tải máy chủ. Thư viện cũng giữ nguyên kiểu dáng, tài nguyên nhúng và thông tin theo dõi thay đổi ngay từ đầu.
Yêu cầu trước
- GroupDocs.Viewer for Java library version 25.2 or later.
- Maven để quản lý phụ thuộc.
- Môi trường phát triển Java (IDE, JDK 8+).
- Khóa giấy phép đánh giá hoặc sản xuất (bản dùng thử miễn phí có sẵn).
Cài đặt GroupDocs.Viewer cho Java
Cấu hình Maven
Thêm kho lưu trữ GroupDocs và phụ thuộc vào pom.xml của bạn:
<repositories>
<repository>
<id>repository.groupdocs.com</id>
<name>GroupDocs Repository</name>
<url>https://releases.groupdocs.com/viewer/java/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-viewer</artifactId>
<version>25.2</version>
</dependency>
</dependencies>
Nhận giấy phép
Bắt đầu với bản dùng thử miễn phí hoặc yêu cầu giấy phép đánh giá tạm thời. Khi bạn đã sẵn sàng cho môi trường sản xuất, mua giấy phép đầy đủ để mở khóa tất cả tính năng và loại bỏ mọi watermark bản dùng thử.
Khởi tạo cơ bản
Lớp Viewer tải một tài liệu và cung cấp khả năng render. Lớp ViewOptions cho phép bạn tùy chỉnh cách tài liệu được render, bao gồm việc hiển thị các thay đổi được theo dõi hay không.
Cách tạo html từ docx và hiển thị các thay đổi được theo dõi
Tải tệp DOCX của bạn bằng lớp Viewer, cấu hình ViewOptions để bật render các thay đổi được theo dõi, và gọi render để tạo ra một loạt các trang HTML. Toàn bộ quá trình chỉ cần vài dòng mã và tự động xử lý hình ảnh nhúng, bảng và bố cục phức tạp.
Bước 1: xác định đường dẫn thư mục đầu ra
Tạo một thư mục để lưu các trang HTML đã render.
Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("RenderTrackedChanges");
Bước 2: chỉ định định dạng để lưu mỗi trang
Đặt mẫu đặt tên cho mỗi tệp HTML được tạo.
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
Bước 3: cấu hình tùy chọn xem
Bật tài nguyên nhúng và bật render các thay đổi được theo dõi.
ViewOptions cho phép bạn tinh chỉnh quy trình render; lớp này cung cấp các thuộc tính như setRenderTrackedChanges và setRenderEmbeddedResources. Mặc định, các hình ảnh nhúng được lưu cùng với các tệp HTML, đảm bảo một chế độ xem web đầy đủ chức năng.
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getWordProcessingOptions().setRenderTrackedChanges(true);
Bước 4: tạo một thể hiện viewer và render
Lớp Viewer là thành phần cốt lõi của GroupDocs.Viewer, tải tài liệu và render nó sang định dạng mong muốn.
try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SAMPLE_DOCX_WITH_TRACKED_CHANGES"))) {
viewer.view(viewOptions);
}
Cách render các thay đổi trong tài liệu Word – các vấn đề thường gặp
Nếu bạn bỏ qua các bước quan trọng, đầu ra có thể thiếu các phiên bản hoặc không tải được tài nguyên. Các vấn đề thường gặp nhất là đường dẫn tệp không đúng, định dạng tài liệu không được hỗ trợ và thiếu giấy phép. Đảm bảo bạn chỉ đến các thư mục tồn tại, sử dụng các tệp .docx/.doc được hỗ trợ, và cung cấp khóa giấy phép hợp lệ trước khi gọi render.
- Incorrect file paths – Kiểm tra lại rằng
YOUR_OUTPUT_DIRECTORYvàYOUR_DOCUMENT_DIRECTORYtrỏ tới các thư mục tồn tại. - Unsupported document format – Đảm bảo tệp là
.docxhoặc.docmà GroupDocs.Viewer hỗ trợ. - Missing license – Nếu không có giấy phép hợp lệ, thư viện có thể giới hạn khả năng render hoặc nhúng watermark bản dùng thử.
Ứng dụng thực tiễn
- Document review systems – Hiển thị cho người xem chính xác những gì đã được thêm hoặc xóa, với các đánh dấu nổi bật nội tuyến.
- Legal case management – Làm nổi bật các sửa đổi trong hợp đồng hoặc bản kiện để dễ dàng theo dõi kiểm toán.
- Academic collaboration – Trực quan hoá đóng góp của nhiều tác giả trong một giao diện HTML duy nhất, có khả năng tìm kiếm.
Các cân nhắc về hiệu năng
- Xử lý một số lượng tài liệu giới hạn đồng thời để giữ mức sử dụng bộ nhớ thấp.
- Sử dụng cấu trúc thư mục hiệu quả để giảm tải I/O.
- Giữ thư viện luôn cập nhật; các phiên bản mới hơn chứa các tối ưu hoá hiệu năng cho phép render tài liệu 500 trang trong vòng dưới 5 giây trên máy chủ tiêu chuẩn.
Kết luận
Bạn hiện đã có một phương pháp hoàn chỉnh, sẵn sàng cho sản xuất để generate html from docx và render word tracked changes bằng cách sử dụng GroupDocs.Viewer cho Java. Tích hợp các bước này vào ứng dụng của bạn, và bạn sẽ cung cấp cho người dùng một trải nghiệm xem xét tài liệu mạnh mẽ, tương tác, hoạt động trên mọi trình duyệt và thiết bị mà không cần Microsoft Office.
Câu hỏi thường gặp
Q: Yêu cầu phiên bản Java tối thiểu là gì?
A: Khuyến nghị sử dụng Java 8 hoặc mới hơn; thư viện cũng tương thích với Java 11, 17 và các bản LTS mới hơn.
Q: Tôi có thể render tài liệu mà không có các thay đổi được theo dõi không?
A: Có, đặt setRenderTrackedChanges(false) trong ViewOptions để tạo HTML sạch sẽ mà không có các đánh dấu phiên bản.
Q: Làm thế nào để xử lý tài liệu lớn một cách hiệu quả?
A: Chia các tệp lớn thành các phần, sử dụng tùy chọn phân trang, và luôn cập nhật thư viện—Phiên bản 25.2 xử lý tài liệu 500 trang trong dưới 5 giây trên phần cứng tiêu chuẩn.
Q: Các tùy chọn cấp phép cho GroupDocs.Viewer là gì?
A: Bắt đầu với bản dùng thử miễn phí, nhận giấy phép đánh giá tạm thời, hoặc mua giấy phép thương mại đầy đủ để loại bỏ mọi hạn chế và cung cấp hỗ trợ ưu tiên.
Q: Có hỗ trợ nếu tôi gặp vấn đề không?
A: Có, bạn có thể nhận trợ giúp qua diễn đàn GroupDocs, tài liệu chính thức, và các ticket hỗ trợ trực tiếp cho khách hàng có giấy phép.
Cập nhật lần cuối: 2026-09-25
Kiểm tra với: GroupDocs.Viewer for Java 25.2
Tác giả: GroupDocs
