วิธีบันทึก PDF ที่มีการทำหมายเหตุด้วย GroupDocs.Annotation สำหรับ Java

ในบทแนะนำนี้คุณจะได้ค้นพบ วิธีบันทึก PDF ที่มีการทำหมายเหตุ อย่างโปรแกรมโดยใช้ GroupDocs.Annotation สำหรับ Java ไม่ว่าคุณจะต้องการไฮไลท์ข้อกฎหมาย, เพิ่มความคิดเห็นการตรวจสอบ, หรือฝังรูปทรงในแบบแปลนวิศวกรรม ขั้นตอนต่อไปนี้จะพาคุณผ่านทุกขั้นตอน—from การตั้งค่า Maven ไปจนถึงการเพิ่มหมายเหตุเป็นชุดและการบันทึกไฟล์ขั้นสุดท้าย. เมื่อเสร็จสิ้นคุณจะสามารถรวมความสามารถการทำหมายเหตุ PDF ที่แข็งแกร่งเข้าไปในแอปพลิเคชัน Java ใดก็ได้.

คำตอบสั้น

  • วัตถุประสงค์หลักของ GroupDocs.Annotation คืออะไร?
    เพื่อสร้าง, แก้ไข, และ บันทึก PDF ที่มีการทำหมายเหตุ อย่างโปรแกรมในแอปพลิเคชัน Java.
  • ฉันต้องการ Maven artifact ใด?
    com.groupdocs:groupdocs-annotation (ดูส่วน การพึ่งพา Maven).
  • ฉันสามารถเพิ่มหมายเหตุมากกว่าหนึ่งรายการพร้อมกันได้หรือไม่?
    ใช่ – คุณสามารถ เพิ่มหลายหมายเหตุ ในการดำเนินการเดียว, ซึ่งช่วยลดภาระ I/O.
  • ฉันจะเริ่มต้น annotator อย่างไร?
    ใช้รูปแบบ initialize annotator ที่แสดงในบทแนะนำ; มันโหลด PDF และเตรียม API สำหรับงานทำหมายเหตุ.
  • เคล็ดลับแนวทางปฏิบัติที่สำคัญคืออะไร?
    ปฏิบัติตามรายการตรวจสอบ annotation best practices สำหรับการจัดการหน่วยความจำ, การประมวลผลเป็นชุด, และขนาดไฟล์ที่เหมาะสม.

“วิธีทำหมายเหตุ PDF” คืออะไร?

GroupDocs.Annotation เป็นไลบรารี Java ที่ให้คุณฝังโน้ตภาพ—ไฮไลท์, ความคิดเห็น, รูปทรง, และตราประทับ—โดยตรงลงในไฟล์ PDF. ไลบรารีนี้ทำให้การจัดการ PDF ระดับล่างเป็นเรื่องง่ายเพื่อให้คุณโฟกัสที่ตรรกะธุรกิจแทนการทำงานกับ PDF ภายใน. มันรองรับประเภทหมายเหตุหลากหลาย, มี Streaming APIs สำหรับเอกสารขนาดใหญ่, และรวมเข้ากับโครงการ Java ที่มีอยู่ได้อย่างง่ายดาย, ทำให้เป็นโซลูชันที่หลากหลายสำหรับกระบวนการทำงานที่ใช้ PDF ใด ๆ.

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

GroupDocs.Annotation มีชุดคุณลักษณะที่ครบถ้วนซึ่งทำให้งานทำหมายเหตุ PDF ง่ายขึ้นพร้อมกับประสิทธิภาพและความสามารถในการขยายสูง. ไลบรารีทำงานบนระบบปฏิบัติการใดก็ได้ที่รองรับ Java, จัดการเอกสารขนาดถึง 500 MB โดยไม่ต้องโหลดไฟล์ทั้งหมดเข้าสู่หน่วยความจำ, และมีประเภทหมายเหตุในตัวมากกว่า 15 ประเภท. API ถูกออกแบบมาสำหรับนักพัฒนา, ให้คุณเพิ่ม, แก้ไข, และลบหมายเหตุได้ด้วยไม่กี่บรรทัดโค้ด, พร้อมตัวเลือกการให้ลิขสิทธิ์ที่แข็งแกร่งสำหรับการทดลองและการใช้งานจริง.

  • การสนับสนุนข้ามแพลตฟอร์ม – ทำงานบน Windows, Linux, และ macOS, ครอบคลุม 100 % ของสภาพแวดล้อมที่เข้ากันกับ Java.
  • ประเภทหมายเหตุที่หลากหลาย – มากกว่า 15 ประเภทที่มีมาในตัว, รวมถึงข้อความ, พื้นที่, รูปวงรี, และตราประทับแบบกำหนดเอง.
  • ไม่ต้องใช้โปรแกรมแก้ไข PDF ภายนอก – ทุกการดำเนินการเกิดขึ้นภายในโค้ด Java ของคุณ, ลดการพึ่งพาเครื่องมือของบุคคลที่สาม.
  • ความสามารถในการขยายระดับองค์กร – สามารถประมวลผล PDF ขนาดถึง 500 MB และจัดการเอกสารหลายร้อยหน้าโดยไม่ต้องโหลดไฟล์ทั้งหมดเข้าสู่หน่วยความจำ, ด้วย Streaming APIs.

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

  • Java 8 หรือใหม่กว่า (แนะนำ JDK 11 หรือเวอร์ชันที่ใหม่กว่า).
  • Maven สำหรับการจัดการ dependencies.
  • IDE เช่น IntelliJ IDEA หรือ Eclipse.
  • ความคุ้นเคยพื้นฐานกับ Java collections และการจัดการข้อยกเว้น.

การขึ้นอยู่กับ Maven ของ GroupDocs

เพิ่มรีโพสิตอรีของ GroupDocs และไลบรารี annotation ลงใน pom.xml ของคุณ:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/annotation/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-annotation</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

การรับใบอนุญาต

  1. ทดลองใช้ฟรี – ดาวน์โหลดการทดลองใช้งาน 30 วันเพื่อประเมิน API.
  2. ใบอนุญาตชั่วคราว – ขอคีย์การประเมิน 7 วันเพื่อเข้าถึงฟีเจอร์ทั้งหมด.
  3. ใบอนุญาตการผลิต – ซื้อใบอนุญาตถาวรสำหรับการใช้งานไม่จำกัด.

วิธีเริ่มต้น annotator ใน Java

Annotator เป็นคลาสหลักของ GroupDocs.Annotation ที่โหลด PDF และให้เมธอดสำหรับสร้าง, แก้ไข, และบันทึกหมายเหตุ. การเริ่มต้นอย่างถูกต้องเป็นขั้นตอนแรกสู่กระบวนการทำงานที่เชื่อถือได้, และการใช้ try‑with‑resources จะทำให้ทรัพยากร native ถูกปล่อยอัตโนมัติ. คุณสร้างอินสแตนซ์โดยส่งพาธไฟล์ (และอาจส่งรหัสผ่านสำหรับ PDF ที่ป้องกัน) ไปยังคอนสตรัคเตอร์, หลังจากนั้น annotator จะพร้อมสำหรับการดำเนินการต่อ.

import com.groupdocs.annotation.Annotator;

public class Feature1 {
    public void loadAnnotator(String fileName) {
        try (final Annotator annotator = new Annotator(fileName)) {
            // Ready to use!
        }
    }
}

ฟีเจอร์ 1: การโหลดและเริ่มต้น annotator

ฟีเจอร์นี้แสดงการสร้างอินสแตนซ์ Annotator ด้วยพาธไฟล์, พร้อมหรือไม่ก็ส่งรหัสผ่านสำหรับ PDF ที่ป้องกัน.

import com.groupdocs.annotation.Annotator;

public class Feature1 {
    public void loadAnnotator(String fileName) {
        try (final Annotator annotator = new Annotator(fileName)) {
            // Annotator initialized and ready.
        }
    }
}

วิธีสร้างหมายเหตุ

การสร้างหมายเหตุเกี่ยวข้องกับการสร้างโมเดลหมายเหตุเฉพาะ, ตั้งค่าคุณสมบัติ, และเพิ่มลงในคอลเลกชันของ annotator.

ฟีเจอร์ 2: การสร้าง area annotation

AreaAnnotation แทนพื้นที่ไฮไลท์สี่เหลี่ยมบนหน้า PDF. มันมีประโยชน์สำหรับการทำเครื่องหมายส่วนของข้อความหรือรูปภาพที่ต้องการความสนใจ.

import com.groupdocs.annotation.models.Rectangle;
import com.groupdocs.annotation.models.annotationmodels.AreaAnnotation;

public class Feature2 {
    public AreaAnnotation createAreaAnnotation() {
        AreaAnnotation area = new AreaAnnotation();
        area.setBox(new Rectangle(100, 100, 100, 100));
        area.setBackgroundColor(65535);
        area.setPageNumber(1);

        return area;
    }
}

ฟีเจอร์ 3: การสร้าง ellipse annotation

EllipseAnnotation กำหนดรูปวงรีหรือวงกลมที่สามารถวางบนหน้าเพื่อเน้นโลโก้, แผนภาพ, หรือองค์ประกอบภาพอื่น ๆ.

import com.groupdocs.annotation.models.Rectangle;
import com.groupdocs.annotation.models.annotationmodels.EllipseAnnotation;

public class Feature3 {
    public EllipseAnnotation createEllipseAnnotation() {
        EllipseAnnotation ellipse = new EllipseAnnotation();
        ellipse.setBox(new Rectangle(100, 100, 100, 100));
        ellipse.setBackgroundColor(123456);
        ellipse.setPageNumber(2);

        return ellipse;
    }
}

วิธีเพิ่มหลายหมายเหตุ

เมธอด addAnnotations อนุญาตให้คุณเพิ่มคอลเลกชันของอ็อบเจ็กต์หมายเหตุไปยังเอกสารในคำเรียกเดียว, ซึ่งช่วยเพิ่มประสิทธิภาพโดยลดการเขียนไฟล์และการใช้หน่วยความจำ. การทำหมายเหตุเป็นชุดช่วยลดการดำเนินการ I/O และทำให้การใช้ heap ของ JVM ต่ำ, โดยเฉพาะเมื่อทำงานกับ PDF ขนาดใหญ่.

import com.groupdocs.annotation.Annotator;
import java.util.ArrayList;
import java.util.List;
import com.groupdocs.annotation.models.AnnotationBase;
import com.groupdocs.annotation.models.annotationmodels.AreaAnnotation;
import com.groupdocs.annotation.models.annotationmodels.EllipseAnnotation;

public class Feature4 {
    public void addAnnotations(Annotator annotator) {
        AreaAnnotation area = new AreaAnnotation();
        area.setBox(new Rectangle(100, 100, 100, 100));
        area.setBackgroundColor(65535);
        area.setPageNumber(1);

        EllipseAnnotation ellipse = new EllipseAnnotation();
        ellipse.setBox(new Rectangle(100, 100, 100, 100));
        ellipse.setBackgroundColor(123456);
        ellipse.setPageNumber(2);

        List<AnnotationBase> annotations = new ArrayList<>();
        annotations.add(area);
        annotations.add(ellipse);

        annotator.add(annotations);
    }
}

วิธีบันทึก PDF ที่มีการทำหมายเหตุ

SaveOptions ให้คุณระบุประเภทหมายเหตุและการตั้งค่าเอาต์พุตที่ต้องการเมื่อบันทึก PDF. โหลด PDF ของคุณ, เพิ่มหมายเหตุที่ต้องการ, แล้วเรียกเมธอด save พร้อมอ็อบเจ็กต์ SaveOptions ที่ระบุประเภทหมายเหตุที่ต้องการบันทึก. การดำเนินการขั้นเดียวนี้จะเขียนการเปลี่ยนแปลงกลับไปยังดิสก์พร้อมคงโครงสร้างเอกสารเดิมไว้.

public class Feature5 {
    public String getOutputPath(String fileName) {
        return "YOUR_OUTPUT_DIRECTORY" + "/filtered_output.pdf";
    public void saveAnnotatedDocument(Annotator annotator, String outputPath) {
        SaveOptions saveOptions = new SaveOptions();
        saveOptions.setAnnotationTypes(AnnotationType.ELLIPSE);

        annotator.save(outputPath, saveOptions);
    }
}

แนวทางปฏิบัติที่ดีที่สุดสำหรับการทำหมายเหตุใน Java

  • ใช้ try‑with‑resources เพื่อปิด Annotator โดยอัตโนมัติและปลดปล่อยทรัพยากร native.
  • เพิ่มหมายเหตุเป็นชุด (ตามที่แสดงในฟีเจอร์ 4) เพื่อลดภาระ I/O.
  • ระบุเฉพาะประเภทหมายเหตุที่ต้องการ ใน SaveOptions เพื่อควบคุมขนาดไฟล์ผลลัพธ์.
  • ปล่อยเอกสารขนาดใหญ่ จากหน่วยความจำหลังการบันทึกเพื่อหลีกเลี่ยงการรั่วไหล; เรียก annotator.dispose() เมื่อเสร็จ.

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

  • การตรวจสอบเอกสารทางกฎหมาย – ไฮไลท์ข้อกำหนด, แนบความคิดเห็น, และติดตามการเปลี่ยนแปลงของผู้ตรวจสอบ.
  • ทรัพยากรการศึกษา – ทำหมายเหตุในตำราเรียนหรือสไลด์การบรรยายเพื่อการศึกษากลุ่มร่วมกัน.
  • คู่มือเทคนิค – ฝังโน้ต, คำเตือน, และเครื่องหมายการแก้ไขโดยตรงบนแบบแปลนวิศวกรรม.

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

  • จำกัดการดำเนินการทำหมายเหตุพร้อมกันบน PDF ขนาดใหญ่กว่า 300 MB เพื่อหลีกเลี่ยงความกดดันของ heap.
  • ใช้ annotation best practices ที่แนะนำเพื่อรักษาการใช้หน่วยความจำต่ำกว่า 200 MB สำหรับงานระดับองค์กรทั่วไป.
  • ทำการ profiling แอปพลิเคชันของคุณด้วย Java Flight Recorder หรือ VisualVM หากพบการเพิ่มขึ้นของความหน่วง.

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

ปัญหาวิธีแก้
OutOfMemoryError เมื่อโหลด PDF ขนาดใหญ่โหลดเอกสารในโหมด streaming (new Annotator(stream)) หรือเพิ่มขนาด heap ของ JVM (-Xmx2g).
หมายเหตุไม่แสดงหลังการบันทึกตรวจสอบว่า SaveOptions มีค่า enum AnnotationType ที่ถูกต้อง.
ข้อผิดพลาดของใบอนุญาตตรวจสอบว่าเส้นทางไฟล์ใบอนุญาตถูกต้องและเวอร์ชันของใบอนุญาตตรงกับเวอร์ชันของไลบรารี.

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

Q: ฉันสามารถเพิ่มความคิดเห็นข้อความนอกเหนือจากรูปทรงได้หรือไม่?
A: ใช่, GroupDocs.Annotation รองรับประเภท TextAnnotation และ CommentAnnotation — สร้างอินสแตนซ์ของโมเดลที่เหมาะสมและเพิ่มลงในคอลเลกชันของ annotator.

Q: สามารถแก้ไขหมายเหตุที่มีอยู่ได้หรือไม่?
A: ได้แน่นอน. ดึงหมายเหตุโดย ID, แก้ไขคุณสมบัติ, และเรียก annotator.update(updatedAnnotation).

Q: ฉันจะลบหมายเหตุที่ไม่ต้องการได้อย่างไร?
A: ใช้ annotator.delete(annotationId) เพื่อลบหมายเหตุเฉพาะหรือ annotator.clear(pageNumber) เพื่อลบหมายเหตุทั้งหมดบนหน้า.

Q: ไลบรารีทำงานกับ PDF ที่มีการป้องกันด้วยรหัสผ่านหรือไม่?
A: ใช่. ให้รหัสผ่านเมื่อสร้างอินสแตนซ์ Annotator: new Annotator(filePath, password).

Q: ต้องการเวอร์ชันของ Java ใด?
A: ไลบรารีเข้ากันได้กับ Java 8 และใหม่กว่า; เราแนะนำให้ใช้รุ่น LTS ล่าสุด (Java 17) เพื่อประสิทธิภาพและความปลอดภัยที่ดีที่สุด.


อัปเดตล่าสุด: 2026-10-11
ทดสอบด้วย: GroupDocs.Annotation 25.2
ผู้เขียน: GroupDocs

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