วิธีการแสดงผลหน้าโดยใช้ GroupDocs.Viewer สำหรับ Java
การแสดงเฉพาะส่วนของเอกสารในแอปพลิเคชันเว็บของคุณอาจเป็นเรื่องท้าทาย ในบทแนะนำนี้คุณจะได้เรียนรู้ วิธีการแสดงผลหน้า อย่างมีประสิทธิภาพ โดยแปลงเป็นไฟล์ HTML ที่เป็นอิสระและสามารถฝังลงใน UI ของคุณได้โดยตรง ไม่ว่าคุณจะต้องการแสดงส่วนของสัญญา หรือบทเดียวของตำราเรียน ขั้นตอนต่อไปนี้จะพาคุณผ่านกระบวนการทั้งหมดโดยใช้ GroupDocs.Viewer สำหรับ Java
พร้อมที่จะยกระดับแอปพลิเคชันของคุณหรือยัง? เริ่มต้นด้วยการตรวจสอบการตั้งค่าของคุณให้ถูกต้องกันเลย
คำตอบสั้น ๆ
- “การแสดงผลหน้า” หมายถึงอะไร? การแปลงหน้าที่เลือกจากเอกสารให้เป็นรูปแบบที่สามารถดูได้ เช่น HTML
- รูปแบบที่สร้างขึ้นคืออะไร? HTML พร้อมทรัพยากรฝังในตัว (รูปภาพ, CSS, ฟอนต์)
- ต้องใช้ลิขสิทธิ์หรือไม่? เวอร์ชันทดลองใช้ได้สำหรับการประเมิน; ต้องมีลิขสิทธิ์เต็มสำหรับการใช้งานจริง
- สามารถเลือกหน้าที่ไม่ต่อเนื่องได้หรือไม่? ได้ – ระบุหมายเลขหน้าที่ต้องการได้ตามต้องการ
- แนะนำให้ใช้แคชหรือไม่? แน่นอน การแคช HTML ที่แสดงผลแล้วช่วยลดเวลาโหลดสำหรับหน้าที่เข้าถึงบ่อย

สิ่งที่คุณจะได้เรียนรู้
- การตั้งค่า GroupDocs.Viewer ในสภาพแวดล้อม Java ของคุณ
- การแสดงผลหน้าที่เฉพาะของเอกสารโดยใช้ Viewer API
- การกำหนดค่า HTML view options เพื่อการแสดงผลที่เหมาะสมที่สุด
- กรณีการใช้งานจริงและสถานการณ์การบูรณาการ
การแสดงผลหน้าที่เลือกคืออะไร?
การแสดงผลหน้าที่เลือกหมายถึงการสกัดเฉพาะหน้าที่คุณระบุจากเอกสารต้นฉบับ (DOCX, PDF, PPT ฯลฯ) แล้วแปลงเป็นรูปแบบที่สามารถแสดงในเว็บเบราว์เซอร์ วิธีนี้ช่วยลดแบนด์วิธ เร่งความเร็วการโหลดหน้า และปรับปรุงประสบการณ์ผู้ใช้โดยแสดงเฉพาะเนื้อหาที่เกี่ยวข้องเท่านั้น
ทำไมต้องสร้าง HTML จากเอกสาร?
การสร้าง HTML จากเอกสารทำให้คุณได้รูปแบบที่มีน้ำหนักเบาและเป็นอิสระต่อแพลตฟอร์ม ซึ่งทำงานได้บนทุกเบราว์เซอร์โดยไม่ต้องพึ่งตัวอ่านหรือปลั๊กอินภายนอก การฝังทรัพยากรโดยตรงลงในไฟล์ HTML (รูปภาพ, ฟอนต์, CSS) ทำให้การปรับใช้ง่ายขึ้นและขจัดปัญหา cross‑origin
ข้อกำหนดเบื้องต้น
ตรวจสอบให้แน่ใจว่าการตั้งค่าการพัฒนาของคุณตรงตามข้อกำหนดต่อไปนี้:
- ไลบรารีที่ต้องการ – เพิ่ม GroupDocs.Viewer สำหรับ Java (เวอร์ชัน 25.2 หรือใหม่กว่า) ในโปรเจกต์ของคุณ
- สภาพแวดล้อม – JDK 8 หรือสูงกว่า; IDE เช่น IntelliJ IDEA หรือ Eclipse
- ความรู้พื้นฐาน – การเขียนโปรแกรม Java เบื้องต้นและการจัดการ dependency ด้วย Maven
การตั้งค่า GroupDocs.Viewer สำหรับ Java
การติดตั้งผ่าน Maven
เพิ่ม repository และ dependency ลงในไฟล์ pom.xml ของคุณ:
<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>
การรับลิขสิทธิ์
- เวอร์ชันทดลองฟรี – ทดลองใช้ทุกฟีเจอร์โดยไม่มีค่าใช้จ่าย
- ลิขสิทธิ์ชั่วคราว – ขยายระยะเวลาการทดสอบหลังจากหมดเวอร์ชันทดลอง
- การซื้อเต็ม – จำเป็นสำหรับการใช้งานในสภาพแวดล้อมการผลิต
การเริ่มต้นและตั้งค่าเบื้องต้น
import com.groupdocs.viewer.Viewer;
public class DocumentViewer {
public static void main(String[] args) {
try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
// Your rendering logic here
}
}
}
คู่มือการดำเนินการ
แสดงผลหน้าที่เฉพาะเป็น HTML พร้อมทรัพยากรฝังในตัว
ขั้นตอน 1: กำหนดเส้นทางการบันทึกผลลัพธ์
import java.nio.file.Path;
import java.nio.file.Paths;
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
- คำอธิบาย:
outputDirectoryคือที่ที่ไฟล์ HTML ที่สร้างจะถูกบันทึกไว้ - การตั้งชื่อ:
page_{0}.htmlจะสร้างไฟล์แยกสำหรับแต่ละหน้าที่แสดงผล
ขั้นตอน 2: ตั้งค่า HTML View Options
import com.groupdocs.viewer.options.HtmlViewOptions;
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
- คำอธิบาย:
forEmbeddedResources()จะบรรจุรูปภาพ, CSS, และฟอนต์ไว้ภายในไฟล์ HTML แต่ละไฟล์ ทำให้ไม่ต้องพึ่งพาไฟล์ภายนอก
ขั้นตอน 3: แสดงผลหน้าที่ต้องการ
try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
viewer.view(viewOptions, 1, 3);
}
- คำอธิบาย: เมธอด
view()รับHtmlViewOptionsและรายการหมายเลขหน้า ในตัวอย่างนี้จะแสดงเฉพาะหน้าแรกและหน้าที่สาม
เคล็ดลับการแก้ปัญหา
- ตรวจสอบให้แน่ใจว่าโฟลเดอร์ผลลัพธ์มีอยู่และแอปพลิเคชันมีสิทธิ์เขียน
- ยืนยันว่าเส้นทางไฟล์เอกสารถูกต้องและไฟล์ไม่ได้เสียหาย
- หากพบข้อผิดพลาดเรื่องลิขสิทธิ์ ให้ตรวจสอบว่าไฟล์ลิขสิทธิ์ที่ถูกต้อง (
GroupDocs.Viewer.lic) อยู่ในโฟลเดอร์แอปพลิเคชันหรือระบุเส้นทางอย่างโปรแกรมเมติก
การประยุกต์ใช้งานจริง
การแสดงผลหน้าที่เลือกมีประโยชน์ในหลายสถานการณ์:
- เอกสารทางกฎหมาย – แสดงเฉพาะข้อที่เกี่ยวข้องของสัญญา
- แพลตฟอร์มการศึกษา – ให้ผู้เรียนดูตัวอย่างบทที่ต้องการโดยไม่ต้องดาวน์โหลดตำราทั้งเล่ม
- รายงานธุรกิจ – นำเสนอสรุปที่กระชับให้ผู้มีส่วนได้ส่วนเสียโดยแสดงเฉพาะส่วนสำคัญของรายงาน
พิจารณาด้านประสิทธิภาพ
- การจัดการหน่วยความจำ – ใช้
try‑with‑resources(ตามตัวอย่าง) เพื่อปล่อยทรัพยากร Viewer อย่างรวดเร็ว - แคช – เก็บ HTML ที่แสดงผลแล้วในแคช (เช่น Redis หรือในหน่วยความจำ) สำหรับหน้าที่เข้าถึงบ่อย
- การลดขนาดทรัพยากร – แม้ว่าการฝังทรัพยากรจะเพิ่มขนาดไฟล์เล็กน้อย แต่คุณอาจบีบอัดผลลัพธ์ HTML หากแบนด์วิธเป็นข้อกังวล
ปัญหาที่พบบ่อยและวิธีแก้
| ปัญหา | วิธีแก้ |
|---|---|
| ไม่พบไฟล์ | ตรวจสอบเส้นทางแบบ absolute/relative อีกครั้งและยืนยันว่าไฟล์มีอยู่ |
| หน่วยความจำไม่พอสำหรับเอกสารขนาดใหญ่ | แสดงผลเฉพาะหน้าที่ต้องการ หรือเพิ่มขนาด heap ของ JVM (-Xmx) |
| รูปภาพหายใน HTML | ยืนยันว่าได้ใช้ forEmbeddedResources; หากไม่ใช้ รูปภาพจะถูกบันทึกแยกไฟล์ |
| ข้อผิดพลาดเรื่องลิขสิทธิ์ | วางไฟล์ GroupDocs.Viewer.lic ที่โฟลเดอร์รากของแอปพลิเคชันหรือระบุเส้นทางโดยโปรแกรมเมติก |
คำถามที่พบบ่อย
GroupDocs.Viewer สำหรับ Java คืออะไร?
ไลบรารีที่ช่วยให้คุณสามารถแสดงผลเอกสารกว่า 90 รูปแบบ (PDF, DOCX, PPT ฯลฯ) โดยตรงในแอปพลิเคชัน Javaฉันสามารถแสดงผลหน้าของ PDF ด้วยวิธีนี้ได้หรือไม่?
ได้ – Viewer API รองรับ PDF รวมถึงรูปแบบอื่น ๆ อีกมากมายฉันจะจัดการกับเอกสารขนาดใหญ่อย่างมีประสิทธิภาพได้อย่างไร?
แสดงผลเฉพาะหน้าที่ต้องการและใช้แคชเพื่อหลีกเลี่ยงการประมวลผลซ้ำประโยชน์ของการฝังทรัพยากรในไฟล์ HTML คืออะไร?
ทำให้แต่ละหน้าเป็นไฟล์อิสระที่มีทุกอย่างรวมอยู่ในไฟล์เดียว ทำให้การปรับใช้ง่ายและไม่ต้องโหลดทรัพยากรภายนอกฉันจะหาเอกสารเพิ่มเติมเกี่ยวกับ GroupDocs.Viewer สำหรับ Java ได้จากที่ไหน?
- เอกสาร: GroupDocs.Viewer Documentation
- อ้างอิง API: API Reference Guide
แหล่งข้อมูล
- เอกสาร: GroupDocs.Viewer Documentation
- อ้างอิง API: API Reference Guide
- ดาวน์โหลด: GroupDocs.Viewer Download Page
- ซื้อ: Buy GroupDocs.Viewer
- ทดลองใช้ฟรี: GroupDocs Free Trial
- ลิขสิทธิ์ชั่วคราว: Get a Temporary License
- สนับสนุน: GroupDocs Support Forum
อัปเดตล่าสุด: 2026-01-15
ทดสอบกับ: GroupDocs.Viewer 25.2
ผู้เขียน: GroupDocs