วิธีการแสดงผลหน้าโดยใช้ GroupDocs.Viewer สำหรับ Java

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

พร้อมที่จะยกระดับแอปพลิเคชันของคุณหรือยัง? เริ่มต้นด้วยการตรวจสอบการตั้งค่าของคุณให้ถูกต้องกันเลย

คำตอบสั้น ๆ

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

แสดงหน้าที่เลือกจากเอกสารด้วย GroupDocs.Viewer สำหรับ Java

สิ่งที่คุณจะได้เรียนรู้

  • การตั้งค่า GroupDocs.Viewer ในสภาพแวดล้อม Java ของคุณ
  • การแสดงผลหน้าที่เฉพาะของเอกสารโดยใช้ Viewer API
  • การกำหนดค่า HTML view options เพื่อการแสดงผลที่เหมาะสมที่สุด
  • กรณีการใช้งานจริงและสถานการณ์การบูรณาการ

การแสดงผลหน้าที่เลือกคืออะไร?

การแสดงผลหน้าที่เลือกหมายถึงการสกัดเฉพาะหน้าที่คุณระบุจากเอกสารต้นฉบับ (DOCX, PDF, PPT ฯลฯ) แล้วแปลงเป็นรูปแบบที่สามารถแสดงในเว็บเบราว์เซอร์ วิธีนี้ช่วยลดแบนด์วิธ เร่งความเร็วการโหลดหน้า และปรับปรุงประสบการณ์ผู้ใช้โดยแสดงเฉพาะเนื้อหาที่เกี่ยวข้องเท่านั้น

ทำไมต้องสร้าง HTML จากเอกสาร?

การสร้าง HTML จากเอกสารทำให้คุณได้รูปแบบที่มีน้ำหนักเบาและเป็นอิสระต่อแพลตฟอร์ม ซึ่งทำงานได้บนทุกเบราว์เซอร์โดยไม่ต้องพึ่งตัวอ่านหรือปลั๊กอินภายนอก การฝังทรัพยากรโดยตรงลงในไฟล์ HTML (รูปภาพ, ฟอนต์, CSS) ทำให้การปรับใช้ง่ายขึ้นและขจัดปัญหา cross‑origin

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

ตรวจสอบให้แน่ใจว่าการตั้งค่าการพัฒนาของคุณตรงตามข้อกำหนดต่อไปนี้:

  1. ไลบรารีที่ต้องการ – เพิ่ม GroupDocs.Viewer สำหรับ Java (เวอร์ชัน 25.2 หรือใหม่กว่า) ในโปรเจกต์ของคุณ
  2. สภาพแวดล้อม – JDK 8 หรือสูงกว่า; IDE เช่น IntelliJ IDEA หรือ Eclipse
  3. ความรู้พื้นฐาน – การเขียนโปรแกรม 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) อยู่ในโฟลเดอร์แอปพลิเคชันหรือระบุเส้นทางอย่างโปรแกรมเมติก

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

การแสดงผลหน้าที่เลือกมีประโยชน์ในหลายสถานการณ์:

  1. เอกสารทางกฎหมาย – แสดงเฉพาะข้อที่เกี่ยวข้องของสัญญา
  2. แพลตฟอร์มการศึกษา – ให้ผู้เรียนดูตัวอย่างบทที่ต้องการโดยไม่ต้องดาวน์โหลดตำราทั้งเล่ม
  3. รายงานธุรกิจ – นำเสนอสรุปที่กระชับให้ผู้มีส่วนได้ส่วนเสียโดยแสดงเฉพาะส่วนสำคัญของรายงาน

พิจารณาด้านประสิทธิภาพ

  • การจัดการหน่วยความจำ – ใช้ try‑with‑resources (ตามตัวอย่าง) เพื่อปล่อยทรัพยากร Viewer อย่างรวดเร็ว
  • แคช – เก็บ HTML ที่แสดงผลแล้วในแคช (เช่น Redis หรือในหน่วยความจำ) สำหรับหน้าที่เข้าถึงบ่อย
  • การลดขนาดทรัพยากร – แม้ว่าการฝังทรัพยากรจะเพิ่มขนาดไฟล์เล็กน้อย แต่คุณอาจบีบอัดผลลัพธ์ HTML หากแบนด์วิธเป็นข้อกังวล

ปัญหาที่พบบ่อยและวิธีแก้

ปัญหาวิธีแก้
ไม่พบไฟล์ตรวจสอบเส้นทางแบบ absolute/relative อีกครั้งและยืนยันว่าไฟล์มีอยู่
หน่วยความจำไม่พอสำหรับเอกสารขนาดใหญ่แสดงผลเฉพาะหน้าที่ต้องการ หรือเพิ่มขนาด heap ของ JVM (-Xmx)
รูปภาพหายใน HTMLยืนยันว่าได้ใช้ forEmbeddedResources; หากไม่ใช้ รูปภาพจะถูกบันทึกแยกไฟล์
ข้อผิดพลาดเรื่องลิขสิทธิ์วางไฟล์ GroupDocs.Viewer.lic ที่โฟลเดอร์รากของแอปพลิเคชันหรือระบุเส้นทางโดยโปรแกรมเมติก

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

  1. GroupDocs.Viewer สำหรับ Java คืออะไร?
    ไลบรารีที่ช่วยให้คุณสามารถแสดงผลเอกสารกว่า 90 รูปแบบ (PDF, DOCX, PPT ฯลฯ) โดยตรงในแอปพลิเคชัน Java

  2. ฉันสามารถแสดงผลหน้าของ PDF ด้วยวิธีนี้ได้หรือไม่?
    ได้ – Viewer API รองรับ PDF รวมถึงรูปแบบอื่น ๆ อีกมากมาย

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

  4. ประโยชน์ของการฝังทรัพยากรในไฟล์ HTML คืออะไร?
    ทำให้แต่ละหน้าเป็นไฟล์อิสระที่มีทุกอย่างรวมอยู่ในไฟล์เดียว ทำให้การปรับใช้ง่ายและไม่ต้องโหลดทรัพยากรภายนอก

  5. ฉันจะหาเอกสารเพิ่มเติมเกี่ยวกับ GroupDocs.Viewer สำหรับ Java ได้จากที่ไหน?

แหล่งข้อมูล


อัปเดตล่าสุด: 2026-01-15
ทดสอบกับ: GroupDocs.Viewer 25.2
ผู้เขียน: GroupDocs