วิธีบันทึก PDF โดยไม่มี annotation ใน Java ด้วย GroupDocs
หากคุณต้องการ save PDF without annotations ขณะยังสามารถเพิ่มบันทึกการขีดเส้นใต้แบบร่วมมือได้ คุณมาถูกที่แล้ว นักพัฒนา Java จำนวนมากประสบปัญหาในการเก็บรุ่นเอกสารที่สะอาดสำหรับการแจกจ่ายขั้นสุดท้าย โดยเฉพาะเมื่อไฟล์เดียวกันถูกใช้สำหรับการตรวจทานหลายรอบ ในบทแนะนำนี้คุณจะได้เรียนรู้วิธีสร้าง PDF ที่สะอาด จัดการหน่วยความจำอย่างมีประสิทธิภาพ และใช้ underline annotation พร้อมคอมเมนต์ด้วย GroupDocs.Annotation เมื่อจบคุณจะเข้าใจกระบวนการทั้งหมด — ตั้งแต่การโหลด PDF จนถึงการสร้างสำเนาสุดท้ายที่ไม่มีลายน้ำ — พร้อมเคล็ดลับการปฏิบัติที่ดีที่สุดสำหรับการสร้าง java document review system ที่แข็งแรง
คำตอบเร็ว
- ฉันจะเพิ่ม underline annotation อย่างไร? Use
UnderlineAnnotationwithannotator.add()then save the document. - ฉันจะบันทึก PDF โดยไม่มี annotations อย่างไร? Load the annotated file, set
AnnotationType.NONEinSaveOptions, and save a new copy. - ต้องใช้ไลบรารีอะไรบ้าง? GroupDocs.Annotation v25.2 (or newer) and its Maven repository.
- ต้องใช้ไลเซนส์สำหรับการผลิตหรือไม่? Yes—apply a valid GroupDocs license to avoid watermarks.
- ฉันสามารถประมวลผลหลายเอกสารได้อย่างมีประสิทธิภาพหรือไม่? Wrap each
Annotatorin a try‑with‑resources block and dispose after each file.
ฉันจะบันทึก PDF โดยไม่มี annotations ใน Java อย่างไร?
โหลด PDF ต้นฉบับด้วย Annotator ตั้งค่า SaveOptions เพื่อไม่รวมประเภท annotation ทั้งหมด และเรียก save() เพื่อเขียนสำเนาที่สะอาด การดำเนินการนี้ไม่แก้ไขไฟล์ต้นฉบับ ดังนั้นคุณจะมีทั้งเวอร์ชันที่มี annotation สำหรับผู้ตรวจทานและเวอร์ชันที่บริสุทธิ์สำหรับการแจกจ่าย กระบวนการใช้การสตรีมมิ่งอยู่เบื้องหลัง หมายความว่าเอกสารทั้งหมดจะไม่ถูกโหลดเต็มที่ในหน่วยความจำ — สิ่งสำคัญสำหรับ PDF ขนาดใหญ่
save PDF without annotations คืออะไร?
save pdf without annotations หมายถึงการส่งออกเอกสาร PDF โดยลบวัตถุ annotation ทั้งหมดออก (เช่น ไฮไลท์, คอมเมนต์, สแตมป์, underline ฯลฯ) ไฟล์ที่ได้จะมีเฉพาะเนื้อหาและเลย์เอาต์เดิม ทำให้เหมาะสำหรับการยื่นเอกสารทางกฎหมาย, การเผยแพร่สาธารณะ, หรือการจัดเก็บในคลังเอกสาร
ทำไมต้องสร้างไฟล์ PDF ที่สะอาดใน java document review system?
เวอร์ชันที่สะอาดจะลบเครื่องหมายของผู้ตรวจทาน, คอมเมนต์, และไฮไลท์ออก ทำให้คุณได้เอกสารที่เรียบหรูพร้อมสำหรับลูกค้า, หน่วยงานกำกับดูแล, หรือการเผยแพร่สาธารณะ นอกจากนี้ยังลดขนาดไฟล์โดยเฉลี่ยได้ถึง 30 % และป้องกันการเปิดเผยบันทึกภายในโดยบังเอิญ — สิ่งสำคัญสำหรับกระบวนการทางกฎหมายและการปฏิบัติตามข้อกำหนด GroupDocs.Annotation สามารถลบวัตถุ annotation ทั้งหมดในหนึ่งขั้นตอน รองรับ PDF ขนาดถึง 500 MB โดยไม่ต้องโหลดไฟล์ทั้งหมดเข้าสู่หน่วยความจำ
ข้อกำหนดเบื้องต้นและการตั้งค่าสภาพแวดล้อม
ข้อกำหนดก่อนเริ่มต้น
- Java Development Kit (JDK) 8 หรือสูงกว่า (แนะนำ JDK 11+)
- Maven 3.6+ หรือ Gradle 6.0+ สำหรับการจัดการ dependencies
- IDE เช่น IntelliJ IDEA, Eclipse หรือ VS Code พร้อมส่วนขยาย Java
- RAM อย่างน้อย 2 GB (การประมวลผลเอกสารอาจใช้หน่วยความจำมาก)
ความรู้เบื้องต้นที่ต้องมี
คุณควรคุ้นเคยกับแนวคิดพื้นฐานของ Java — การสร้างอ็อบเจ็กต์, การเรียกเมธอด, และ dependencies ของ Maven ประสบการณ์กับไลบรารีของบุคคลที่สามจะช่วยเร่งการนำไปใช้
เอกสารสำหรับการทดสอบ
เตรียม PDF ตัวอย่างหลายไฟล์ไว้พร้อม PDF ที่เป็นข้อความทำงานได้ดีที่สุด; ภาพสแกนอาจต้องใช้ OCR ก่อนทำ annotation
การตั้งค่า Maven: นำ GroupDocs เข้าสู่โปรเจกต์ของคุณ
เพิ่ม dependency ต่อไปนี้ในไฟล์ pom.xml ของคุณ ขั้นตอนนี้ทำให้หลายนักพัฒนาติดขัดในครั้งแรก เนื่องจาก group ID และ artifact ID ต้องตรงกันอย่างแม่นยำ
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>25.2</version>
</dependency>
Important: Version 25.2 เป็นรุ่นเสถียรล่าสุด ณ เวลาที่เขียน ตรวจสอบ repository ของ GroupDocs อย่างสม่ำเสมอเพื่อดูเวอร์ชันใหม่ที่มีการแก้บั๊กและปรับปรุงประสิทธิภาพ
การตั้งค่าไลเซนส์ (ห้ามข้ามขั้นตอนนี้)
For development/testing – ดาวน์โหลดเวอร์ชันทดลองฟรีจากเว็บไซต์ GroupDocs เวอร์ชันทดลองมีฟีเจอร์ทั้งหมดแต่จะเพิ่มลายน้ำให้กับเอกสารที่ประมวลผล
For production – ซื้อไลเซนส์และนำไปใช้ในระหว่างการเริ่มต้นแอปพลิเคชัน หากไม่มีไลเซนส์ที่ถูกต้อง การสร้างสำหรับการผลิตจะถูกจำกัดและมีลายน้ำ
คู่มือการทำงาน: การเพิ่ม underline annotations
ทำความเข้าใจ workflow ของ annotation
ก่อนที่เราจะลงลึกในโค้ด มาดู workflow สี่ขั้นตอนที่เกิดขึ้นเมื่อคุณ annotate PDF in Java:
- Document loading –
Annotatorอ่านไฟล์เข้าสู่หน่วยความจำ. - Annotation creation – กำหนดคุณสมบัติเช่น ตำแหน่ง, สไตล์, และคอมเมนต์.
- Annotation application – ไลบรารีแทรก annotation เข้าไปในโครงสร้างของ PDF.
- Document saving – บันทึกไฟล์ที่แก้ไขไว้, สามารถเลือกเก็บไฟล์ต้นฉบับไว้ได้.
กระบวนการนี้ไม่ทำลายไฟล์ต้นฉบับ; ไฟล์ต้นฉบับจะไม่ถูกเปลี่ยนแปลงหากไม่ได้เขียนทับ
ขั้นตอนที่ 1: เริ่มต้น annotator และโหลดเอกสารของคุณ
Annotator เป็นจุดเข้าหลักใน GroupDocs.Annotation สำหรับการโหลดและแก้ไขเอกสาร PDF มันทำหน้าที่เป็น abstraction ของการจัดการไฟล์, การจัดการสตรีม, และการจัดสรรทรัพยากร native
<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>
Pro tip: ใช้เส้นทางแบบ absolute ระหว่างการพัฒนาเพื่อหลีกเลี่ยงข้อผิดพลาด “file not found”. ในการผลิต ควรพิจารณาโหลดทรัพยากรจาก classpath หรือ bucket ของคลาวด์
ขั้นตอนที่ 2: สร้างคอมเมนต์และการตอบกลับ (ส่วนของการทำงานร่วมกัน)
อ็อบเจ็กต์ Comment แสดงการสนทนาที่เป็นเธรดที่แนบกับ annotation แต่ละคอมเมนต์สามารถมีผู้เขียน, timestamp, และการตอบกลับเพิ่มเติม ทำให้สามารถสนทนาครบวงจรรอบ markup เฉพาะ
import com.groupdocs.annotation.Annotator;
// Load the document you want to annotate
Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input.pdf");
Real‑world use: ผู้ตรวจทานสามารถอภิปรายข้อกำหนดเฉพาะโดยเพิ่มการตอบกลับแบบเธรด ทำให้การสนทนาถูกผูกกับ annotation นั้นอย่างแม่นยำ
ขั้นตอนที่ 3: กำหนดพิกัดของ annotation (ทำให้ตำแหน่งถูกต้อง)
Point กำหนดพิกัดเดียวในพื้นที่ PDF (วัดเป็น points, 72 points = 1 นิ้ว) ต้องใช้สี่จุดสำหรับ underline: สองจุดสำหรับเส้นเริ่มต้นและสองจุดสำหรับเส้นสิ้นสุด
import com.groupdocs.annotation.models.Reply;
import java.util.Calendar;
import java.util.ArrayList;
import java.util.List;
Reply reply1 = new Reply();
reply1.setComment("First comment");
reply1.setRepliedOn(Calendar.getInstance().getTime());
Reply reply2 = new Reply();
reply2.setComment("Second comment");
reply2.setRepliedOn(Calendar.getInstance().getTime());
List<Reply> replies = new ArrayList<>();
replies.add(reply1);
replies.add(reply2);
Coordinate system:
- จุด 1 และ 2 กำหนดขอบบนของ underline.
- จุด 3 และ 4 กำหนดขอบล่าง.
- ความแตกต่างของ Y (730 vs 650) ควบคุมความหนา
ขั้นตอนที่ 4: สร้างและกำหนดค่า underline annotation
UnderlineAnnotation คือคลาสที่เป็น concrete แทน markup ของ underline มันสืบทอดจากคลาสฐาน Annotation และเพิ่มคุณสมบัติที่เฉพาะเจาะจงสำหรับ underline เช่น ความหนาของเส้นและสไตล์
import com.groupdocs.annotation.models.Point;
Point point1 = new Point(80, 730);
Point point2 = new Point(240, 730);
Point point3 = new Point(80, 650);
Point point4 = new Point(240, 650);
List<Point> points = new ArrayList<>();
points.add(point1);
points.add(point2);
points.add(point3);
points.add(point4);
Color & opacity tips:
FontColorใช้ ARGB;65535(0x00FFFF) ให้สีเหลืองสด.- สำหรับสีแดงใช้
16711680(0xFF0000); สำหรับสีน้ำเงินใช้255(0x0000FF). - ค่า opacity ระหว่าง 0.5 และ 0.8 ให้การอ่านที่ดีโดยไม่บดบังข้อความ
ขั้นตอนที่ 5: บันทึกเอกสารที่มี annotation ของคุณ
SaveOptions ให้คุณควบคุมรูปแบบเอาต์พุต, ว่าจะฝัง annotation หรือไม่, และวิธีจัดการ metadata การตั้งค่า AnnotationType.NONE บอกไลบรารีให้ลบวัตถุ annotation ทั้งหมด ซึ่งเป็นกุญแจสำคัญสำหรับ save PDF without annotations
import com.groupdocs.annotation.models.annotationmodels.UnderlineAnnotation;
UnderlineAnnotation underline = new UnderlineAnnotation();
underline.setCreatedOn(Calendar.getInstance().getTime());
underline.setFontColor(65535); // Yellow in ARGB format
underline.setMessage("This is an underline annotation");
underline.setOpacity(0.7f);
underline.setPageNumber(0);
underline.setPoints(points);
underline.setReplies(replies);
annotator.add(underline);
Memory management: การเรียก dispose() ปล่อยทรัพยากร native และป้องกันการรั่วไหลของหน่วยความจำ — สิ่งสำคัญเมื่อประมวลผลไฟล์หลายไฟล์เป็นชุด
การลบ annotation: สร้างเวอร์ชันเอกสารที่สะอาด
บางครั้งคุณต้องการเวอร์ชันของ PDF โดยไม่มี annotation ใดๆ — เช่น เมื่อส่งมอบสัญญาที่ได้รับการอนุมัติขั้นสุดท้าย GroupDocs ทำให้เรื่องนี้ง่าย
ทำความเข้าใจตัวเลือกการลบ annotation
คุณสามารถ:
- ลบ ทั้งหมด ของ annotation (เป็นที่นิยมที่สุด)
- ลบประเภทเฉพาะ (เช่น เฉพาะ highlights)
- ลบ annotation ตามผู้เขียนหรือหน้า
ขั้นตอนการลบ annotation ทีละขั้นตอน
Step 1: โหลดเอกสารที่เคยมี annotation
Annotator ทำหน้าที่เป็น loader อีกครั้ง; มันจะอ่านไฟล์ที่ยังมีวัตถุ annotation อยู่
String outputPath = "YOUR_OUTPUT_DIRECTORY/output.pdf";
annotator.save(outputPath);
annotator.dispose();
Step 2: กำหนดค่า save options สำหรับผลลัพธ์ที่สะอาด
SaveOptions มี fluent API เพื่อระบุว่าไม่ควรเขียนประเภท annotation ใดลงในไฟล์ผลลัพธ์
Annotator annotator = new Annotator(outputPath);
Step 3: บันทึกเวอร์ชันที่สะอาด
การเรียก save() พร้อมตัวเลือกที่กำหนด จะเขียน PDF ที่มีเฉพาะเนื้อหาเดิม
import com.groupdocs.annotation.options.export.AnnotationType;
import com.groupdocs.annotation.options.export.SaveOptions;
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.NONE);
ผลลัพธ์คือไฟล์ clean PDF ที่ไม่มีวัตถุ annotation เหมาะสำหรับการแจกจ่ายขั้นสุดท้าย
ปัญหาทั่วไปและวิธีแก้
ปัญหา 1: ข้อผิดพลาด “Document not found”
ตรวจสอบให้แน่ใจว่าเส้นทางไฟล์ถูกต้องและแอปพลิเคชันมีสิทธิ์อ่าน ใช้ Path.of() กับเส้นทาง absolute เพื่อลดความคลุมเครือส่วนใหญ่
String noneAnnotationPath = Paths.get(outputPath).resolveSibling("none-annotation.pdf").toString();
annotator.save(noneAnnotationPath, saveOptions);
annotator.dispose();
ปัญหา 2: Annotation ปรากฏในตำแหน่งผิด
จุดกำเนิดของพิกัด PDF อยู่ที่มุมล่างซ้าย ตรวจสอบว่าค่า Y ของคุณเพิ่มขึ้นไปด้านบนและคำนึงถึงการหมุนของหน้า
File inputFile = new File("path/to/your/document.pdf");
if (!inputFile.exists()) {
throw new IllegalArgumentException("Document not found: " + inputFile.getAbsolutePath());
}
if (!inputFile.canRead()) {
throw new IllegalArgumentException("Cannot read document: " + inputFile.getAbsolutePath());
}
Annotator annotator = new Annotator(inputFile.getAbsolutePath());
ปัญหา 3: ปัญหาหน่วยความจำกับเอกสารขนาดใหญ่
GroupDocs.Annotation สตรีมเนื้อหาและไม่โหลดไฟล์ทั้งหมดเข้าสู่ heap memory อย่างไรก็ตาม คุณยังต้องเรียก dispose() และพิจารณาเพิ่ม heap ของ JVM (-Xmx) สำหรับไฟล์ที่ใหญ่กว่า 200 MB
// Test with a simple rectangle in the top‑left corner
Point point1 = new Point(10, 10); // Top‑left
Point point2 = new Point(100, 10); // Top‑right
Point point3 = new Point(10, 30); // Bottom‑left
Point point4 = new Point(100, 30); // Bottom‑right
ปัญหา 4: ปัญหาไลเซนส์ในการผลิต
หากไฟล์ไลเซนส์หายหรือเส้นทางไม่ถูกต้อง ไลบรารีจะกลับไปใช้โหมดทดลองและเพิ่มลายน้ำในทุกหน้า วางไฟล์ไลเซนส์ในตำแหน่งที่อยู่บน classpath และโหลดมันตั้งแต่ต้นใน lifecycle ของแอปพลิเคชัน
// Increase JVM heap size when launching the app, e.g., -Xmx2g
try (Annotator annotator = new Annotator("document.pdf")) {
// Annotation logic here
annotator.save("output.pdf");
}
แนวทางปฏิบัติที่ดีที่สุดสำหรับประสิทธิภาพในแอปพลิเคชันการผลิต
กลยุทธ์การจัดการหน่วยความจำ
GroupDocs.Annotation ประมวลผล PDF แบบสตรีมมิ่ง ทำให้สามารถจัดการไฟล์ขนาดถึง 500 MB โดยไม่ต้องโหลดเอกสารทั้งหมดเข้าสู่หน่วยความจำ อย่างไรก็ตาม ให้ปฏิบัติตามแนวทางต่อไปนี้:
try {
License license = new License();
license.setLicense("path/to/your/license.lic");
System.out.println("License loaded successfully");
} catch (Exception e) {
System.err.println("License loading failed: " + e.getMessage());
// Handle the error appropriately
}
try (Annotator annotator = new Annotator("input.pdf")) {
// Your annotation logic
annotator.save("output.pdf");
} // Annotator is automatically disposed here
พิจารณาเรื่องการทำงานหลายเธรด
GroupDocs.Annotation ไม่ปลอดภัยต่อการทำงานหลายเธรด โดยค่าเริ่มต้น หากแอปพลิเคชันของคุณประมวลผลเอกสารพร้อมกัน:
- Never share อินสแตนซ์
Annotatorข้ามเธรด. - Synchronize การเข้าถึงไฟล์หรือใช้กลไกล็อก.
- พิจารณา pool ของอ็อบเจ็กต์
Annotatorหากต้องการ throughput สูง.
กลยุทธ์การแคช
- แคชเทมเพลต annotation ที่ใช้บ่อย.
- ใช้
Pointcollection ซ้ำสำหรับชุดพิกัดทั่วไป. - เก็บ template PDF ในหน่วยความจำหากคุณทำ annotation ซ้ำบนเอกสารฐานเดียวกัน
แนวทางปฏิบัติการจัดการหน่วยความจำ PDF ใน Java
การใช้หน่วยความจำอย่างมีประสิทธิภาพเป็นสิ่งสำคัญเมื่อจัดการ PDF ขนาดใหญ่หรือประมวลผลหลายไฟล์เป็นชุด ต่อไปนี้คือคำแนะนำเชิงปฏิบัติบางประการ:
- Use try‑with‑resources สำหรับทุก
Annotatorเพื่อรับประกันการทำลาย. - Increase the JVM heap (
-Xmx) เฉพาะเมื่อจำเป็น; ตรวจสอบการใช้ด้วยเครื่องมือ profiling. - Process documents sequentially หากเป็นไปได้, ปล่อยหน่วยความจำหลังจากแต่ละไฟล์.
- Avoid loading the same PDF multiple times; ใช้สตรีมเดียวกันซ้ำหากต้องการอ่านหลายครั้ง.
การนำแนวทางเหล่านี้ไปใช้ช่วยให้แอปพลิเคชันตอบสนองได้ดีและป้องกันการพังจาก out‑of‑memory ในช่วงงาน annotation หนัก
การใช้งานจริงและกรณีตัวอย่าง
ระบบตรวจทานเอกสาร
- Legal review: ขีดเส้นใต้ข้อสัญญาและเพิ่มคอมเมนต์เกี่ยวกับความเสี่ยง.
- Compliance audits: ไฮไลท์ส่วนที่มีปัญหาในงบการเงิน.
- Academic peer review: อาจารย์ขีดเส้นใต้ข้อความที่ต้องการชี้แจง.
แพลตฟอร์มการศึกษา
- Student annotation tools: ให้ผู้เรียนขีดเส้นใต้แนวคิดสำคัญใน e‑books.
- Teacher feedback: ให้คอมเมนต์ในบรรทัดโดยตรงบนงานที่ส่ง
กระบวนการประกันคุณภาพ
- Technical documentation review: วิศวกรขีดเส้นใต้ส่วนที่ต้องอัปเดต.
- Standard operating procedures: เจ้าหน้าที่ความปลอดภัยไฮไลท์ขั้นตอนสำคัญ.
ระบบจัดการเนื้อหา
- Editorial workflow: บรรณาธิการขีดเส้นใต้ข้อความที่ต้องตรวจสอบความถูกต้อง.
- Version control: ติดตามประวัติ annotation ข้ามการปรับปรุงเอกสาร
เคล็ดลับขั้นสูงสำหรับการใช้งานระดับมืออาชีพ
สไตล์ annotation แบบกำหนดเอง
คุณสามารถขยายลักษณะการแสดงผลของ underline โดยกำหนดรูปแบบ dash, line caps, และระดับ opacity เอง ซึ่งมีประโยชน์เมื่อคุณต้องแยกบทบาทของผู้ตรวจทาน (เช่น legal กับ engineering)
List<String> documentPaths = Arrays.asList("doc1.pdf", "doc2.pdf", "doc3.pdf");
for (String docPath : documentPaths) {
try (Annotator annotator = new Annotator(docPath)) {
// Process one document at a time
annotator.add(createAnnotation());
annotator.save(getOutputPath(docPath));
}
// Memory is freed after each iteration
}
Metadata ของ annotation สำหรับการติดตาม
ทุก annotation สามารถบรรจุพจนานุกรม metadata ที่กำหนดโดยผู้ใช้ เก็บ ID, timestamp, หรือสถานะ workflow เพื่อเชื่อมต่อกับระบบติดตามภายนอก
UnderlineAnnotation underline = new UnderlineAnnotation();
underline.setFontColor(16711680); // Red for urgent items
underline.setOpacity(0.5f); // Subtle highlighting
underline.setFontSize(12); // Consistent sizing
underline.setMessage("URGENT REVIEW REQUIRED");
การบูรณาการกับระบบจัดการผู้ใช้
แมป property author ของ Comment ไปยัง ID ผู้ใช้ในแอปของคุณ ทำให้สามารถกำหนดสไตล์ตามบทบาทและสร้าง audit‑trail
underline.setCreatedBy("john.doe@company.com");
underline.setCreatedOn(Calendar.getInstance().getTime());
underline.setMessage("Legal review required - Contract clause 4.2");
การแก้ไขปัญหาในสภาพแวดล้อมการผลิต
การตรวจสอบประสิทธิภาพ
ตรวจสอบเมตริกเหล่านี้ในสภาพการผลิต:
- Heap usage – ตรวจสอบว่าได้เรียก
dispose()แล้ว. - Processing time per document – บันทึก timestamp ก่อนและหลัง
annotator.save(). - Error rate – เก็บ exception และจัดประเภท
ปัญหาที่พบบ่อยในการผลิต
- File locking – ตรวจสอบว่าไฟล์ที่อัปโหลดถูกปิดก่อนทำ annotation.
- Concurrent edits – ใช้ optimistic locking หรือเช็คเวอร์ชัน.
- Large files (> 50 MB) – เพิ่ม timeout ของ JVM และพิจารณาใช้ streaming API
แนวทางปฏิบัติการจัดการข้อผิดพลาด
ห่อทุกการเรียก annotation ด้วย try‑catch, บันทึก stack trace ทั้งหมด, และ re‑throw AnnotationException ที่กำหนดเองพร้อมข้อความที่เป็นมิตรกับผู้ใช้ รูปแบบนี้ทำให้การดีบักง่ายขึ้นและให้ข้อเสนอแนะที่ชัดเจนต่อผู้ใช้ API
// Assume you have a method that returns the current authenticated user
String currentUser = getCurrentUser();
String userRole = getUserRole(currentUser);
// Apply role‑based styling
UnderlineAnnotation underline = new UnderlineAnnotation();
underline.setCreatedBy(currentUser);
underline.setFontColor(getRoleColor(userRole));
underline.setMessage(String.format("[%s] %s", userRole.toUpperCase(), commentText));
คำถามที่พบบ่อย
Q: ฉันจะ annotate ส่วนข้อความหลายส่วนในหนึ่งการดำเนินการได้อย่างไร?
A: สร้างหลายอ็อบเจ็กต์ UnderlineAnnotation ด้วยพิกัดต่างๆ แล้วเพิ่มทีละอันโดยใช้ annotator.add()
Q: ฉันสามารถ annotate รูปภาพภายในเอกสาร PDF ได้หรือไม่?
A: ได้ ใช้ระบบพิกัดเดียวกันและตรวจสอบว่าจุดอยู่ภายในขอบเขตของรูปภาพ
Q: GroupDocs.Annotation รองรับรูปแบบไฟล์อะไรบ้างนอกจาก PDF?
A: Word (DOC/DOCX), Excel (XLS/XLSX), PowerPoint (PPT/PPTX) และรูปภาพเช่น JPEG, PNG, TIFF.
Q: ฉันจะจัดการกับเอกสารขนาดใหญ่มากโดยไม่เกิด out‑of‑memory ได้อย่างไร?
A: ประมวลผลเอกสารทีละไฟล์, เพิ่ม heap ของ JVM (-Xmx), และทำการ dispose อินสแตนซ์ Annotator ทันที
Q: สามารถดึง annotation ที่มีอยู่จากเอกสารได้หรือไม่?
A: ได้ ใช้ annotator.get() เพื่อดึง annotation ทั้งหมด แล้วกรองตามประเภท, ผู้เขียน, หรือหน้า ตามต้องการ
อัปเดตล่าสุด: 2026-10-16
ทดสอบกับ: GroupDocs.Annotation 25.2
ผู้เขียน: GroupDocs
try (Annotator annotator = new Annotator(documentPath)) {
UnderlineAnnotation annotation = createAnnotation();
annotator.add(annotation);
annotator.save(outputPath);
} catch (Exception e) {
logger.error("Annotation failed for document: " + documentPath, e);
// Implement appropriate error recovery
throw new DocumentProcessingException("Failed to annotate document", e);
}