הייתה תקופה שבה נהגנו לדון בתוכן מסמכים ובמשוב בשרשורי דוא"ל ארוכים עם מספר קבצים מצורפים וגרסאות קבצים שונות. כעת אנו יכולים פשוט להשתמש בהערות כדי לסמן את המסמך בהודעות ותשובות ולשלוח אותו. במאמר זה, תלמד כיצד להוסיף הערות תוכנית למסמכי PDF ב-Java עם היישום שלך. בנוסף, נראה כיצד להסיר הערות מקובצי PDF באמצעות אותו Java API.
להלן הנושאים הנידונים בקצרה להלן:
PDF Annotator Java API
כדי להתמודד עם הערות של המסמך והתמונות שלך בתוך יישומי Java שלך, GroupDocs מספקת GroupDocs.Annotation for Java. באמצעות ה-API, אתה יכול להוסיף, להסיר ולחלץ הערות ממסמכי עיבוד תמלילים, גיליונות אלקטרוניים, מצגות, תמונות, הודעות דואר אלקטרוני, שרטוטי Visio, כמה AutoCAD ופורמטים של הדמיה דיגיטלית כמו DICOM. יתר על כן, ה-API מאפשר הוספת הערות לקבצי PDF. ייתכן שתעיין בתיעוד כדי לדעת על הרשימה הארוכה של פורמטים נתמכים של מסמכים להערות.
הורד והגדר
קבל את ספריית ההערות מהורדות או פשוט הוסף את תצורת pom.xml הבאה ביישומי Java מבוססי Maven כדי לנסות את הדוגמאות של מאמר זה כמו גם את הדוגמאות הרבות נוספות הזמינות ב-GitHub. לפרטים, אתה יכול לבקר ב-API Reference.
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>20.2</version>
</dependency>
הוסף הערות ל-PDF ב-Java
בואו נקפוץ במהירות כדי להוסיף כמה מהסוגים השונים של הערות למסמך PDF. מכיוון שישנם סוגים רבים ושונים של הערות, ייתכן שלא נעסוק בכולם במאמר זה. אני רק אזכיר אותם, ואתה יכול למד על כל ביאור בנפרד.
-
הערת שטח / מלבן
-
חֵץ
-
מֶרְחָק
-
אֶלִיפְּסָה
-
שִׂיא
-
קישור
-
נְקוּדָה
-
פוליליין
-
תַחֲלִיף
-
חיתוך משאבים
-
פסילה
-
שדה טקסט
-
עריכת טקסט
-
לָשִׂים דָגֵשׁ
-
סימן מים
בואו נתחיל להוסיף כמה מהם במסמך PDF.
הוסף הערת חץ ל-PDF באמצעות Java
להלן השלבים להוספת הערת חצים למסמך PDF.
- טען את מסמך ה-PDF באמצעות המחלקה Annotator.
- אתחול הערת חץ באמצעות המחלקה ArrowAnnotation.
- הגדר את המיקום והגודל של החץ באמצעות שיטת setBox של ArrowAnnotation.
- הוסף את הערת החץ שנוצרה לאובייקט Annotator.
- שמור את ה-PDF המוער על ידי אספקת הנתיב בשיטת save.
דוגמת הקוד הבאה מראה כיצד להוסיף הערת חץ למסמך PDF באמצעות Java.
// הוסף הערת חץ ל-PDF באמצעות Java
final Annotator annotator = new Annotator("document.pdf");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100)); // (x, y, width, height)
annotator.add(arrow);
annotator.save("path/annotated-with-arrow.pdf");
הוסף הערת מלבן או אזור ל-PDF באמצעות Java
אתה יכול להתאים אישית כל הערה תוך כדי הוספתה למסמך. להלן השלבים להוספת הערת מלבן או אזור למסמך PDF עם מעט יותר התאמות אישיות. זה דומה להוספת הערת חץ אך משתמש במחלקת AreaAnnotation במקום ArrowAnnotation.
- טען את מסמך ה-PDF באמצעות המחלקה Annotator.
- אתחול הערת מלבן באמצעות המחלקה AreaAnnotation.
- הגדר את המיקום והגודל של המלבן באמצעות שיטת setBox של AreaAnnotation.
- הגדר מאפיינים אחרים כמו צבע, רקע, אטימות, סגנון, רוחב עט, או אפילו הודעות וזמן.
- הוסף את הערת המלבן שנוצרה לאובייקט המציין.
- שמור את ה-PDF המוער על ידי מתן הנתיב בשיטת save.
דוגמת הקוד הבאה מראה כיצד להוסיף הערת מלבן/אזור למסמך PDF באמצעות Java.
// הוסף הערת אזור או הערת מלבן ל-PDF באמצעות Java
final Annotator annotator = new Annotator("document.pdf");
AreaAnnotation area = new AreaAnnotation();
area.setBox(new Rectangle(50, 100, 500, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("Annotate documents and images.");
area.setOpacity(0.7);
area.setPenColor(-13076963);
area.setPenStyle(PenStyle.Dash);
area.setPenWidth((byte) 3);
// להוסיף למסמך
annotator.add(area);
annotator.save("path/annotated-with-rectangle.pdf");
הוסף הערת אליפסה או אליפסה ל-PDF באמצעות Java
להלן השלבים להוספת הערה אליפסה או הערת אליפסה למסמך PDF.
- טען את מסמך ה-PDF באמצעות המחלקה Annotator.
- אתחול הערת אליפסה באמצעות המחלקה EllipseAnnotation.
- הגדר את המיקום והגודל של האליפסה באמצעות שיטת setBox של EllipseAnnotation.
- הוסף את הערת האליפסה שנוצרה לאובייקט המציין.
- שמור את ה-PDF המוער על ידי אספקת הנתיב בשיטת save.
דוגמת הקוד הבאה מראה כיצד להוסיף הערת אליפסה או אליפסה למסמך PDF באמצעות Java.
// הוסף הערת אליפסה או אליפסה ב-PDF באמצעות Java
final Annotator annotator = new Annotator("document.pdf");
// ביאור אליפסה או אליפסה
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBox(new Rectangle(275, 505, 300, 80));
// להוסיף למסמך
annotator.add(area);
annotator.save("path/annotated-with-ellipse.pdf");
הכנס הערת מרחק ל-PDF באמצעות Java
אתה יכול גם להוסיף את הערת המרחק כדי להראות את המרחק בין שתי נקודות. להלן השלבים להוספת הערת מרחק למסמך PDF.
- טען את מסמך ה-PDF באמצעות המחלקה Annotator.
- אתחול הערת מרחק באמצעות המחלקה DistanceAnnotation.
- הגדר את הגודל והמיקום של ההערה באמצעות שיטת setBox של DistanceAnnotation.
- הוסף את הערת המרחק שנוצרה לאובייקט Annotator.
- שמור את ה-PDF המוער על ידי מתן הנתיב בשיטת save.
דוגמת הקוד הבאה מראה כיצד להוסיף הערת מרחק למסמך PDF באמצעות Java.
// הערת מרחק באמצעות Java
final Annotator annotator = new Annotator("document.pdf");
// הערת מרחק
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(775, 235, 0, 150));
// להוסיף למסמך
annotator.add(area);
annotator.save("path/annotated-with-distance.pdf");
קוד מלא
לסיכום, הנה קוד ה-Java עם הפלט המציג את כל ההערות וההודעות שנוספו עם תשובות באמצעות קוד ה-Java שהוזכר.
הקוד הבא למטה מוסיף, חץ, מלבן, אליפסה, הערות מרחק, הודעות ותשובות לקובץ PDF.
// הוסף הערות מרובות ל-PDF באמצעות Java
// הוספת הערות חץ, אזור, סגלגל (אליפסה), מרחק ל-PDF עם הודעות ותשובות באמצעות Java
final Annotator annotator = new Annotator(Constants.INPUT);
// הגדרת תשובות
Reply reply1 = new Reply();
reply1.setComment("Please look in to these issues.");
reply1.setRepliedOn(Calendar.getInstance().getTime());
Reply reply2 = new Reply();
reply2.setComment("Change Description");
reply2.setRepliedOn(Calendar.getInstance().getTime());
Reply reply3 = new Reply();
reply2.setComment("On-Premises APIs");
reply2.setRepliedOn(Calendar.getInstance().getTime());
Reply reply4 = new Reply();
reply2.setComment("Add images as well.");
reply2.setRepliedOn(Calendar.getInstance().getTime());
java.util.List<Reply> replies = new ArrayList<Reply>();
replies.add(reply1);
replies.add(reply2);
replies.add(reply3);
replies.add(reply4);
// הערת חץ ================================
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(560, 250, 60, -60));
arrow.setCreatedOn(Calendar.getInstance().getTime());
arrow.setMessage("This image is little upwards.");
arrow.setOpacity(0.7);
arrow.setPenColor(-3407872);
arrow.setPenWidth((byte) 2);
arrow.setReplies(replies.subList(0, 1));
// ביאור אזור ==================================
AreaAnnotation area = new AreaAnnotation();
area.setBox(new Rectangle(50, 100, 500, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("Annotate documents and images.");
area.setOpacity(0.7);
area.setPenColor(-13076963);
area.setPenStyle(PenStyle.Dash);
area.setPenWidth((byte) 3);
area.setReplies(replies.subList(1, 2));
// ביאור אליפסה או אליפסה ========================
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBox(new Rectangle(275, 505, 300, 80));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("Shows all the available Annotation APIs.");
ellipse.setOpacity(0.7);
ellipse.setPenColor(-16034924);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies.subList(2, 3));
// הערת מרחק ==============================
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(775, 235, 0, 150));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is the heading area");
distance.setOpacity(0.7);
distance.setPenColor(-21197);
distance.setPenStyle(PenStyle.Solid);
distance.setPenWidth((byte) 1);
distance.setReplies(replies.subList(3, 4));
// הוספת הערות ================================
annotator.add(arrow);
annotator.add(area);
annotator.add(ellipse);
annotator.add(distance);
// שמירת PDF עם הערות ==============================
annotator.save(outputPath);
annotator.dispose();
הסר הערות מ-PDF ב-Java
השלבים הבאים מראים כיצד להסיר את כל ההערות מקובצי PDF ב-Java.
- טען את מסמך ה-PDF באמצעות המחלקה Annotator.
- אתחול אפשרויות שמירה באמצעות מחלקה SaveOptions.
- הגדר את סוגי ההערות ל-None.
- שמור את קובץ ה-PDF לאחר הסרת כל ההערות, על ידי אספקת הנתיב בשיטת save.
קוד ה-Java הבא מסיר הערות מקובץ PDF.
// הסר את כל ההערות ממסמך ה-PDF באמצעות Java
final Annotator annotator = new Annotator("document.pdf");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
// שמור את ה-PDF ללא עוד הערות בתוכו.
annotator.save("path/annotations-removed.pdf", saveOptions);
annotator.dispose();
סיכום
בקיצור, למדת איך להוסיף הערות ל-PDF בתוך יישומי Java. יתר על כן, ראית כיצד להסיר את כל ההערות מכל קובץ PDF. כעת, אתה אמור להיות בטוח לבנות יישום Java משלך לעורך מסמכים. זה יכול לתמוך בסוגים שונים של הערות באמצעות GroupDocs.Annotation עבור Java.
לפרטים נוספים, אפשרויות ודוגמאות, אתה יכול לבקר במאגר תיעוד ומאגר GitHub. לשאלות נוספות, צור קשר עם התמיכה בפורום.