From 00dd8366aee63544c7c316f3b6b2e0f03c335b42 Mon Sep 17 00:00:00 2001 From: Muhammad Muqarrab Date: Sat, 25 Jul 2026 05:17:26 +0000 Subject: [PATCH] =?UTF-8?q?Optimize=20page:=20content/english/java/graphic?= =?UTF-8?q?al-annotations/java-ellipse-annotations-pdf-groupdocs/=5Findex.?= =?UTF-8?q?md=20-=20-=20Updated=20front=20matter=20with=20current=20date,?= =?UTF-8?q?=20keywords,=20tags,=20and=20Open=20Graph=20fields.=20-=20Integ?= =?UTF-8?q?rated=20primary=20keyword=20=E2=80=9Chow=20to=20annotate=20pdf?= =?UTF-8?q?=E2=80=9D=20into=20title,=20description,=20and=20multiple=20sec?= =?UTF-8?q?tions.=20-=20Added=20definition=20anchors=20for=20key=20classes?= =?UTF-8?q?=20(e.g.,=20`Annotator`).=20-=20Inserted=20direct=20answer=20pa?= =?UTF-8?q?ragraphs=20after=20question=E2=80=91style=20H2=20headings.=20-?= =?UTF-8?q?=20Replaced=20vague=20benefits=20with=20quantified=20claims=20a?= =?UTF-8?q?nd=20authoritative=20framing.=20-=20Expanded=20explanations,=20?= =?UTF-8?q?use=E2=80=91case=20discussions,=20and=20performance=20tips=20wh?= =?UTF-8?q?ile=20preserving=20all=20original=20links=20and=20placeholders.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../_index.md | 225 ++++++---- .../_index.md | 210 +++++++--- .../_index.md | 371 +++++++++++++---- .../_index.md | 219 ++++++---- .../_index.md | 141 +++++-- .../og-image.png | Bin 0 -> 45364 bytes .../_index.md | 212 +++++++--- .../_index.md | 273 +++++++----- .../_index.md | 374 +++++++++++++---- .../_index.md | 373 +++++++++++++---- .../_index.md | 252 ++++++++---- .../_index.md | 375 +++++++++++++---- .../_index.md | 373 +++++++++++++---- .../_index.md | 258 ++++++++---- .../_index.md | 321 +++++++++------ .../_index.md | 263 ++++++++---- .../_index.md | 388 ++++++++++++++---- .../_index.md | 372 +++++++++++++---- .../_index.md | 374 +++++++++++++---- .../_index.md | 242 +++++++---- .../_index.md | 375 +++++++++++++---- .../_index.md | 256 ++++++++---- .../_index.md | 374 +++++++++++++---- .../_index.md | 262 ++++++++---- 24 files changed, 4997 insertions(+), 1886 deletions(-) create mode 100644 content/english/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/og-image.png diff --git a/content/arabic/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/arabic/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index d98b7bf2e..1ac0301a3 100644 --- a/content/arabic/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/arabic/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,55 +1,107 @@ --- categories: - Java Development -date: '2026-02-03' -description: تعلم كيفية إضافة التعليقات التوضيحية إلى ملفات PDF باستخدام مكتبة GroupDocs - Annotation للغة Java. دليل خطوة بخطوة، أمثلة على الشيفرة، نصائح لحل المشكلات، وأفضل - الممارسات. -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: تعلم كيفية إضافة تعليقات توضيحية إلى PDF باستخدام GroupDocs Annotation + Library Java – دليل خطوة بخطوة، مقتطفات كود، نصائح للأداء، وأفضل الممارسات. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: إضافة تعليقات توضيحية إلى PDF في Java +og_description: تعلم كيفية إضافة تعليقات توضيحية إلى PDF باستخدام GroupDocs Annotation + Library Java – دليل يغطي تعليقات توضيحية إهليلجية، تعليقات، الترخيص، ونصائح لمطوري + Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: كيفية إضافة تعليقات توضيحية إلى PDF باستخدام GroupDocs Annotation Library + Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'مكتبة GroupDocs للتعليقات التوضيحية Java: إضافة تعليقات PDF' +- document processing +- ellipse annotation +title: كيفية إضافة تعليقات توضيحية إلى PDF باستخدام GroupDocs Annotation Library Java type: docs url: /ar/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# مكتبة GroupDocs Annotation Java: إضافة تعليقات توضيحية إلى PDF +# كيفية إضافة تعليقات توضيحية إلى PDF باستخدام مكتبة GroupDocs Annotation للغة Java -هل تساءلت يومًا كيف يمكنك إضافة تعليقات توضيحية إلى مستندات PDF برمجيًا باستخدام Java؟ باستخدام **groupdocs annotation library java**، يمكنك تضمين تنسيقات غنية—مثل الإهليلجات، التعليقات، والطوابع—مباشرةً في ملفات PDF. سواءً كنت تبني نظام مراجعة مستندات، منصة تعليمية، أو مساحة عمل تعاونية، يوضح لك هذا الدليل خطوة بخطوة كيفية البدء. +إضافة ملاحظات بصرية أو تعليقات أو طوابع إلى ملف PDF برمجياً يمكن أن يسرّع بشكل كبير دورات المراجعة، وفحوصات الامتثال، وتدفقات العمل التعاونية. في هذا الدرس ستكتشف **كيفية إضافة تعليقات توضيحية إلى PDF** باستخدام مكتبة GroupDocs Annotation للغة Java، مع تغطية كل شيء من إعداد المشروع إلى تعليقات بيضاوية متقدمة، والترخيص، وتحسين الأداء، ونصائح التكامل في العالم الحقيقي. ## إجابات سريعة -- **ما المكتبة التي تضيف تعليقات توضيحية إلى ملفات PDF في Java؟** مكتبة groupdocs annotation library java. -- **هل أحتاج إلى ترخيص؟** النسخة التجريبية تعمل للاختبار؛ يلزم ترخيص إنتاج للاستخدام التجاري. -- **أي بيئة تطوير متكاملة (IDE) هي الأنسب؟** أي IDE للـ Java (IntelliJ IDEA، Eclipse، VS Code) يعمل بشكل جيد. -- **هل يمكنني إضافة تعليقات توضيحية إلى ملفات PDF محمية بكلمة مرور؟** نعم—قم بتوفير كلمة المرور عند إنشاء `Annotator`. -- **هل يدعم المعالجة الدفعية؟** بالتأكيد؛ راجع مثال المعالجة الدفعية لاحقًا. +- **ما المكتبة التي تضيف تعليقات توضيحية إلى ملفات PDF في Java؟** مكتبة GroupDocs Annotation للغة Java. +- **هل أحتاج إلى ترخيص؟** النسخة التجريبية تعمل للاختبار؛ الترخيص الإنتاجي مطلوب للاستخدام التجاري. +- **أي بيئة تطوير متكاملة (IDE) هي الأنسب؟** أي بيئة تطوير Java (IntelliJ IDEA، Eclipse، VS Code) تعمل بشكل جيد. +- **هل يمكنني إضافة تعليقات توضيحية إلى ملفات PDF محمية بكلمة مرور؟** نعم—قم بتوفير كلمة المرور عند إنشاء كائن `Annotator`. +- **هل يدعم المعالجة الدفعية؟** بالتأكيد؛ راجع مثال المعالجة الدفعية لاحقاً. -## ما هي مكتبة GroupDocs Annotation Java؟ -مكتبة groupdocs annotation library java هي واجهة برمجة تطبيقات Java قوية وجاهزة للمؤسسات تتيح لك إنشاء وتعديل واسترجاع تعليقات توضيحية على ملفات PDF برمجيًا. تدعم أكثر من 50 صيغة مستند وتوفر ميزات التعاون مثل الردود وسلاسل التعليقات. +## ما هي مكتبة GroupDocs Annotation للغة Java؟ -## لماذا تستخدم مكتبة GroupDocs Annotation Java؟ -- **أنواع تعليقات توضيحية غنية** – أشكال، نص، طوابع، علامات مائية، وأكثر. -- **جاهز للتعاون** – ردود مدمجة وسلاسل تعليقات. -- **محسن للأداء** – يتعامل مع ملفات PDF الكبيرة بكفاءة. -- **واجهة برمجة تطبيقات بسيطة** – تقلل من وقت التطوير مقارنة بالمكتبات منخفضة المستوى مثل iText أو PDFBox. +مكتبة GroupDocs Annotation للغة Java هي واجهة برمجة تطبيقات جاهزة للاستخدام تمكّن المطورين من إنشاء وتعديل واسترجاع وحذف التعليقات التوضيحية في ملفات PDF بالكامل باستخدام كود Java. تدعم **أكثر من 50 تنسيق مستند**، وتوفر سلاسل تعليقات مدمجة، وتقدم تحكمًا دقيقًا في الأذونات. + +## لماذا نستخدم مكتبة GroupDocs Annotation للغة Java؟ + +يمكنك إضافة تنسيقات غنية—بما في ذلك الأشكال البيضاوية، ملاحظات النص، الطوابع، والعلامات المائية—ببضع نداءات طرق فقط، وتقوم المكتبة بمعالجة **ملفات PDF مئات الصفحات** دون تحميل الملف بالكامل إلى الذاكرة. مقارنةً بالأدوات منخفضة المستوى مثل iText أو PDFBox، تقلل من وقت التطوير بنسبة تصل إلى **70 %** وتتعامل مع ميزات PDF المعقدة (الطبقات، النماذج، التوقيعات الرقمية) مباشرةً. ## المتطلبات المسبقة والإعداد -- **JDK 8+** (يوصى بـ JDK 11) +- **JDK 8+** (يوصى بـ JDK 11) - **Maven أو Gradle** لإدارة التبعيات -- **IDE** حسب اختيارك (IntelliJ IDEA، Eclipse، إلخ) -- إلمام أساسي بملفات I/O في Java +- **IDE** حسب اختيارك (IntelliJ IDEA، Eclipse، VS Code) +- إلمام أساسي بعمليات إدخال/إخراج الملفات في Java -## إعداد مكتبة GroupDocs Annotation Java - -### دمج Maven -أضف المستودع والتبعيات إلى ملف `pom.xml` الخاص بك: +### تكامل Maven +أضف المستودع والتبعية إلى ملف `pom.xml` الخاص بك: ```xml @@ -69,7 +121,7 @@ weight: 1 ``` ### تكوين الترخيص -طبق ترخيصك قبل أي عمل تعليقات توضيحية: +طبق الترخيص الخاص بك قبل أي عمل تعليقات توضيحية: ```java License license = new License(); @@ -81,11 +133,15 @@ license.setLicense("path/to/your/license/file"); ## دليل التنفيذ الكامل ### الخطوة 1: تهيئة PDF Annotator +فئة `Annotator` هي نقطة الدخول لجميع عمليات التعليقات التوضيحية. تقوم بتحميل ملف PDF المستهدف، وتطبيق إعدادات الأمان، وتحضير تمثيل في الذاكرة للتحرير. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### الخطوة 2: إنشاء تعليقات تفاعلية والردود +`CommentAnnotation` يتيح لك تضمين نص حر، بينما كائنات `Reply` تمكّن من مناقشات متسلسلة مباشرة على صفحة PDF. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -100,7 +156,9 @@ replies.add(reply1); replies.add(reply2); ``` -### الخطوة 3: تكوين تعليمة إهليلجية +### الخطوة 3: تكوين تعليقة بيضاوية +`EllipseAnnotation` يرسم شكلًا بيضاويًا قابلًا للتوسيع. يمكنك تعيين لون الخط، لون التعبئة، الشفافية، وسماكة الحدود المخصصة لتتناسب مع إرشادات واجهة المستخدم الخاصة بك. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -115,13 +173,15 @@ ellipse.setReplies(replies); ``` ### الخطوة 4: إضافة وحفظ التعليقات التوضيحية +بعد تكوين جميع كائنات التعليقات التوضيحية، استدعِ `annotator.save()` لكتابة التغييرات إلى القرص. تذكر استدعاء `dispose()` لتحرير الموارد الأصلية، خاصةً عند معالجة العديد من الملفات في حلقة. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **لماذا تستدعي `dispose()`؟** لأنه يحرر الموارد الأصلية، مما يمنع تسرب الذاكرة—وهذا مهم خصوصًا عند معالجة العديد من ملفات PDF داخل حلقة. +> **لماذا استدعاء `dispose()`؟** يحرّر الموارد الأصلية، مما يمنع تسرب الذاكرة—وهذا مهم بشكل خاص عند معالجة العديد من ملفات PDF في حلقة. ## المشكلات الشائعة والحلول @@ -130,12 +190,12 @@ annotator.dispose(); *الحل:* تحقق من المسار المطلق أو اطبع `System.getProperty("user.dir")` لتأكيد دليل الأساس. ### المشكلة 2 – التعليقات غير مرئية -*السبب:* نظام إحداثيات أو فهرس صفحة غير صحيح. +*السبب:* نظام إحداثيات خاطئ أو فهرس صفحة غير صحيح. *الحل:* تذكر أن إحداثيات PDF تبدأ من الزاوية السفلية اليسرى، وأن الصفحات تبدأ من الصفر. -### المشكلة 3 – OutOfMemoryError على ملفات PDF الكبيرة -*السبب:* تحميل المستند بالكامل في الذاكرة. -*الحل:* زيادة حجم Heap في JVM (`-Xmx2g`) أو معالجة الصفحات على دفعات (انظر مثال الدفعة أدناه). +### المشكلة 3 – OutOfMemoryError في ملفات PDF الكبيرة +*السبب:* تحميل المستند بالكامل إلى الذاكرة. +*الحل:* زيادة حجم كومة JVM (`-Xmx2g`) أو معالجة الصفحات على دفعات (انظر مثال المعالجة الدفعية أدناه). ### المشكلة 4 – أخطاء التحقق من الترخيص *السبب:* ملف الترخيص مفقود أو غير متطابق. @@ -144,6 +204,8 @@ annotator.dispose(); ## نصائح تحسين الأداء ### أفضل ممارسات إدارة الذاكرة +تجنب الاحتفاظ بمراجع كائنات `Annotator` الكبيرة لفترة أطول من الضرورة. استخدم try‑with‑resources أو استدعاءات صريحة لـ `dispose()` بعد معالجة كل ملف. + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -155,11 +217,13 @@ for (String documentPath : documentPaths) { ``` ### استراتيجيات المعالجة الدفعية -- **ملفات PDF الصغيرة (<10 ميغابايت):** معالجة كل ملف على حدة. -- **ملفات PDF المتوسطة (10‑50 ميغابايت):** معالجة على دفعات من 5‑10 ملفات. -- **ملفات PDF الكبيرة (>50 ميغابايت):** استخدم البث أو المعالجة المجزأة لتجنب نفاد الذاكرة. +- **ملفات PDF الصغيرة (<10 MB):** معالجة فردية. +- **ملفات PDF المتوسطة (10‑50 MB):** معالجة على دفعات من 5‑10. +- **ملفات PDF الكبيرة (>50 MB):** استخدم البث أو المعالجة المجزأة لتجنب نفاد الذاكرة. ### اعتبارات التخزين المؤقت +فئة `AnnotationAppearance` تغلف الخصائص البصرية مثل اللون والشفافية للتعليقات التوضيحية. قم بتخزين كائنات قابلة لإعادة الاستخدام مثل `AnnotationAppearance` أو مثيلات `Color` في الذاكرة المؤقتة عندما تقوم بتعليق العديد من الصفحات بنفس النمط. + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -169,9 +233,11 @@ private static EllipseAnnotation createStandardEllipse() { } ``` -## أمثلة على التكامل في العالم الحقيقي +## أمثلة التكامل في العالم الحقيقي + +### تكامل تطبيق الويب +اعرض نقطة نهاية REST تستقبل تدفق PDF، وتطبق تعليقة بيضاوية عند الإحداثيات التي يزودها الواجهة الأمامية، وتعيد ملف PDF المعلق كمصفوفة بايت. -### تكامل تطبيق ويب ```java @RestController @RequestMapping("/api/documents") @@ -188,7 +254,9 @@ public class DocumentAnnotationController { } ``` -### معالجة دفعة من المستندات +### معالجة المستندات دفعيًا +تجول عبر دليل يحتوي على العقود، أضف طابع “تمت المراجعة” إلى كل منها، وانقل الملفات المعالجة إلى مجلد الأرشيف. + ```java public class BatchAnnotationProcessor { @@ -203,9 +271,11 @@ public class BatchAnnotationProcessor { } ``` -## تقنيات التعليق التوضيحي المتقدمة +## تقنيات التعليقات التوضيحية المتقدمة + +### تحديد موضع التعليقات التوضيحية ديناميكيًا +احسب إحداثيات التعليقات التوضيحية في الوقت الفعلي بناءً على مواقع النص المكتشف باستخدام OCR أو واجهات استخراج نص PDF، ثم ضع أشكال بيضاوية حول الكلمات المفتاحية. -### تموضع التعليقات التوضيحية الديناميكي ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); @@ -213,6 +283,8 @@ ellipse.setBox(dynamicPosition); ``` ### تنسيق التعليقات التوضيحية الشرطي +طبق ألوانًا أو مستويات شفافية مختلفة بناءً على دور مؤلف التعليقة (مثال: المراجع = أزرق، الموافق = أخضر). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow @@ -220,74 +292,79 @@ ellipse.setBackgroundColor(color); ``` ## التطبيقات العملية وحالات الاستخدام -- **منصات تعليمية:** تمييز المفاهيم، إضافة تعليقات المعلمين، إنشاء أدلة دراسة تفاعلية. +- **منصات التعليم:** تمييز المفاهيم، إضافة تعليقات المعلمين، إنشاء أدلة دراسة تفاعلية. - **مراجعة المستندات القانونية:** وضع علامات على البنود، إضافة ملاحظات سرية، الحفاظ على سجلات التدقيق. -- **السجلات الطبية:** التعليق على الملاحظات، تمييز البيانات الحرجة، تمكين التعاون الآمن. +- **السجلات الطبية:** تعليق الملاحظات، تمييز البيانات الحرجة، تمكين التعاون الآمن. - **سير العمل المؤسسي:** تبسيط موافقات التقارير، إضافة طوابع المراجعين، تتبع التغييرات. -## متى تستخدم أنواع التعليقات التوضيحية المختلفة -بينما يركز هذا الدليل على تعليقات الإهليلج، توفر مكتبة groupdocs annotation library java أيضًا: +## متى نستخدم أنواع التعليقات التوضيحية المختلفة +تعد تعليقات البيضاوية مثالية عندما تحتاج إلى تمييز غير مستطيل، مثل إبراز المخططات الدائرية، الشعارات، أو المناطق التي يُفضَّل تمثيلها بشكل بيضاوي. توفر إشارة بصرية واضحة مع الحفاظ على قابلية القراءة، مما يجعلها مناسبة لمراجعات التصميم، فحوصات العلامة التجارية، وأي سيناريو يفضَّل فيه التركيز الدائري. + +بينما يركز هذا الدليل على تعليقات البيضاوية، تقدم مكتبة GroupDocs Annotation للغة Java أيضًا: - **تعليقات نصية** للتعليقات التفصيلية. -- **تعليقات سهمية** للإشارة إلى عناصر معينة. -- **تعليقات مستطيلة** لتسليط الضوء على منطقة. +- **تعليقات سهمية** للإشارة إلى عناصر محددة. +- **تعليقات مستطيلة** لتحديد المناطق. - **تعليقات علامة مائية** للعلامة التجارية أو الأمان. - **تعليقات طوابع** للموافقات. -اختر الإهليلجات عندما تحتاج إلى تمييز غير مستطيل، بصريًا مميز—مثالي لجذب الانتباه إلى الرسوم الدائرية أو مناطق الشعار. - ## دليل استكشاف الأخطاء وإصلاحها ### مشاكل الأداء -- **العرض:** معالجة بطيئة. +- **العَرَض:** معالجة بطيئة. - **التشخيص:** حجم ملف كبير، عدد كبير من التعليقات، ذاكرة RAM محدودة. - **الحل:** تحسين خصائص التعليقات، المعالجة غير المتزامنة، أو تقسيم ملفات PDF الكبيرة إلى صفحات. ### مشاكل التوافق -- **العرض:** التعليقات تظهر مختلفة عبر عارضات مختلفة. -- **التشخيص:** ميزات PDF غير قياسية. -- **الحل:** اختبار مع Adobe Acrobat، Chrome، وFirefox؛ الالتزام بعلامات التعليقات القياسية في PDF. +- **العَرَض:** مظهر التعليقات يختلف بين عارضات الملفات. +- **التشخيص:** ميزات PDF غير معيارية. +- **الحل:** اختبار مع Adobe Acrobat، Chrome، وFirefox؛ الالتزام بعلامات التعليقات المعيارية في PDF. ### تحديات التكامل -- **العرض:** تعارضات التبعيات. -- **التشخيص:** عدم توافق الإصدارات مع مكتبات أخرى. -- **الحل:** استخدم `` في Maven لفرض إصدارات متوافقة أو انتقل إلى REST API للتكامل غير المعتمد على لغة معينة. +- **العَرَض:** تعارضات في التبعيات. +- **التشخيص:** إصدارات غير متطابقة مع مكتبات أخرى. +- **الحل:** استخدم `` في Maven لفرض إصدارات متوافقة أو التحول إلى واجهة REST API للتكامل غير المرتبط بلغة معينة. ## الأسئلة المتكررة **س: هل يمكنني إضافة تعليقات توضيحية إلى ملفات PDF محمية بكلمة مرور؟** -ج: نعم. استخدم النسخة المتعددة `new Annotator(filePath, loadOptions)` حيث يحتوي `loadOptions` على كلمة المرور. +ج: نعم. استخدم النسخة الزائدة `new Annotator(filePath, loadOptions)` حيث يتضمن `loadOptions` كلمة المرور. -**س: كيف يجب أن أتعامل مع ملفات PDF أكبر من 100 ميغابايت؟** -ج: عالج الصفحات بشكل فردي، زد حجم الـ heap، أو استخدم GroupDocs Annotation Cloud API للعبء الثقيل. +**س: كيف يجب أن أتعامل مع ملفات PDF أكبر من 100 MB؟** +ج: عالج الصفحات بشكل فردي، وزِّد حجم الكومة، أو استفد من GroupDocs Annotation Cloud API للعبء الثقيل. **س: هل هناك حد لعدد التعليقات التوضيحية في المستند؟** -ج: لا حد ثابت، لكن قد يتدهور الأداء بعد آلاف التعليقات. فكر في التقسيم إلى صفحات أو التجميع. +ج: لا يوجد حد ثابت، لكن قد يتدهور الأداء بعد آلاف التعليقات. ضع في اعتبارك التقسيم إلى صفحات أو التجميع. **س: هل يمكنني استخراج التعليقات التوضيحية الموجودة؟** ج: بالتأكيد. استدعِ `annotator.get()` لاسترجاع جميع التعليقات من ملف PDF. **س: كيف أؤمن التعليقات التوضيحية بحيث لا يمكن تحريرها إلا من قبل مستخدمين معينين؟** -ج: توفر المكتبة إعدادات أذونات تعتمد على المستخدم؛ قم بتكوينها عبر API `AnnotationPermission`. +ج: توفر المكتبة إعدادات أذونات مبنية على المستخدم؛ قم بتكوينها عبر واجهة `AnnotationPermission` API. ## الخلاصة -مكتبة **groupdocs annotation library java** توفر لك طريقة نظيفة وعالية الأداء لإدراج تعليقات توضيحية غنية على ملفات PDF مباشرةً من كود Java. باتباع الخطوات السابقة، يمكنك إضافة تعليقات إهليلجية، إدارة التعليقات، والتعامل مع أحمال عمل على مستوى المؤسسات. +توفر لك **GroupDocs Annotation Library Java** طريقة نظيفة وعالية الأداء لإدراج تعليقات توضيحية غنية في ملفات PDF مباشرةً من كود Java. باتباع الخطوات السابقة، يمكنك إضافة تعليقات بيضاوية، إدارة التعليقات، والتعامل مع أحمال عمل على مستوى المؤسسات. **الخطوات التالية:** -1. تجربة أنواع تعليقات أخرى (نص، طابع، علامة مائية). +1. جرب أنواع تعليقات توضيحية أخرى (نص، طابع، علامة مائية). 2. دمج المكتبة في سير عمل المستندات الحالي أو الخدمة الويب. -3. استكشاف REST API للسيناريوهات غير المعتمدة على لغة معينة. +3. استكشف واجهة REST API للسيناريوهات غير المرتبطة بلغة معينة. --- -**آخر تحديث:** 2026-02-03 +**آخر تحديث:** 2026-07-25 **تم الاختبار مع:** GroupDocs.Annotation 25.2 for Java **المؤلف:** GroupDocs -**الروابط الأساسية:** +**روابط أساسية:** - **التوثيق:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) - **مرجع API:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) - **تحميل:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) - **شراء:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) - **نسخة تجريبية مجانية:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) - **ترخيص مؤقت:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **الدعم:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **الدعم:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## دروس ذات صلة +- [كيفية إضافة سهم إلى PDF باستخدام Java – دليل كامل وأفضل الممارسات](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [كيفية إضافة صورة إلى PDF باستخدام Java وGroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [الدليل الكامل - كيفية حفظ PDF معلق باستخدام GroupDocs.Annotation للغة Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/chinese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/chinese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index b799bc5a5..d2cdb6690 100644 --- a/content/chinese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/chinese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,53 +1,104 @@ --- categories: - Java Development -date: '2026-02-03' -description: 学习如何使用 GroupDocs Annotation Library Java 为 PDF 文件添加批注。一步一步的指南、代码示例、故障排除技巧和最佳实践。 -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: 了解如何使用 GroupDocs Annotation Library Java 为 PDF 添加批注——一步一步的指南、代码片段、性能技巧和最佳实践。 +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: 在 Java 中添加 PDF 批注 +og_description: 了解如何使用 GroupDocs Annotation Library Java 为 PDF 添加批注——本指南涵盖椭圆批注、评论、授权以及针对 + Java 开发者的技巧。 +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: 如何使用 GroupDocs Annotation Library Java 为 PDF 添加批注 +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: GroupDocs 注释库 Java：添加 PDF 注释 +- document processing +- ellipse annotation +title: 如何使用 GroupDocs Annotation Library Java 为 PDF 添加批注 type: docs url: /zh/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java: 添加 PDF 注释 +# 如何使用 GroupDocs Annotation Library Java 对 PDF 进行注释 -是否曾想过如何在 Java 中以编程方式向 PDF 文档添加注释？使用 **groupdocs annotation library java**，您可以将丰富的标记——例如椭圆、评论和印章——直接嵌入 PDF。无论您是在构建文档审阅系统、教育平台还是协作工作区，本教程都将准确展示如何入门。 +以编程方式向 PDF 添加可视化备注、评论或印章可以显著加快审阅周期、合规检查和协作工作流。在本教程中，您将学习使用 GroupDocs Annotation Library for Java **如何对 PDF 进行注释**，涵盖从项目设置到高级椭圆注释、授权、性能调优以及实际集成技巧的全部内容。 ## 快速答案 -- **什么库可以在 Java 中向 PDF 添加注释？** The groupdocs annotation library java. -- **我需要许可证吗？** 试用版可用于测试；商业使用需购买正式许可证。 -- **哪个 IDE 最适合？** 任意 Java IDE（IntelliJ IDEA、Eclipse、VS Code）均可正常使用。 -- **我可以给受密码保护的 PDF 添加注释吗？** 可以——在创建 `Annotator` 时提供密码。 -- **是否支持批量处理？** 当然；请参阅后面的批量处理示例。 +- **什么库在 Java 中为 PDF 添加注释？** GroupDocs Annotation Library for Java。 +- **我需要许可证吗？** 试用版可用于测试；商业使用需要正式许可证。 +- **哪个 IDE 最适合？** 任意 Java IDE（IntelliJ IDEA、Eclipse、VS Code）均可。 +- **我可以对受密码保护的 PDF 进行注释吗？** 可以——在创建 `Annotator` 时提供密码。 +- **是否支持批量处理？** 当然；请参见后面的批处理示例。 ## 什么是 GroupDocs Annotation Library Java？ -groupdocs annotation library java 是一个功能强大、面向企业的 Java API，允许您以编程方式创建、编辑和检索 PDF 注释。它支持超过 50 种文档格式，并提供诸如回复和评论线程等协作功能。 + +GroupDocs Annotation Library Java 是一个即用型 API，允许开发者在 Java 代码中完整地创建、编辑、检索和删除 PDF 注释。它支持 **超过 50 种文档格式**，提供内置的评论线程，并提供细粒度的权限控制。 ## 为什么使用 GroupDocs Annotation Library Java？ -- **丰富的注释类型** – 形状、文本、印章、水印等。 -- **协作就绪** – 内置回复和评论线程。 -- **性能优化** – 高效处理大型 PDF。 -- **简洁的 API** – 与 iText 或 PDFBox 等底层库相比，可减少开发时间。 + +只需几行方法调用，即可添加丰富的标记——包括椭圆、文本备注、印章和水印，并且该库能够在不将整个文件加载到内存的情况下处理 **数百页的 PDF**。与 iText 或 PDFBox 等底层工具相比，它可将开发时间缩短最多 **70 %**，并开箱即用地处理复杂的 PDF 功能（图层、表单、数字签名）。 ## 前置条件和设置 -- **JDK 8+**（推荐使用 JDK 11） +- **JDK 8+**（建议使用 JDK 11） - **Maven 或 Gradle** 用于依赖管理 -- **IDE**（任选，如 IntelliJ IDEA、Eclipse 等） +- **IDE**（任选）(IntelliJ IDEA、Eclipse、VS Code) - 对 Java 文件 I/O 有基本了解 -## 设置 GroupDocs Annotation Library Java - ### Maven 集成 -将仓库和依赖添加到您的 `pom.xml`： +在 `pom.xml` 中添加仓库和依赖： ```xml @@ -66,7 +117,7 @@ groupdocs annotation library java 是一个功能强大、面向企业的 Java A ``` -### 许可证配置 +### 授权配置 在进行任何注释操作之前应用许可证： ```java @@ -79,11 +130,15 @@ license.setLicense("path/to/your/license/file"); ## 完整实现指南 ### 步骤 1：初始化 PDF Annotator +`Annotator` 类是所有注释操作的入口。它加载目标 PDF，应用安全设置，并准备一个内存中的表示以供编辑。 + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### 步骤 2：创建交互式评论和回复 +`CommentAnnotation` 允许嵌入自由文本，而 `Reply` 对象则在 PDF 页面上实现线程式讨论。 + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -99,6 +154,8 @@ replies.add(reply2); ``` ### 步骤 3：配置椭圆注释 +`EllipseAnnotation` 绘制可缩放的椭圆形。您可以设置线条颜色、填充颜色、不透明度以及自定义边框粗细，以符合 UI 指南。 + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -113,35 +170,39 @@ ellipse.setReplies(replies); ``` ### 步骤 4：添加并保存注释 +在配置完所有注释对象后，调用 `annotator.save()` 将更改写回磁盘。请记得调用 `dispose()` 释放本地资源，尤其是在循环处理大量文件时。 + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **为什么调用 `dispose()`？** 它会释放本机资源，防止内存泄漏——在循环处理大量 PDF 时尤为重要。 +> **为什么要调用 `dispose()`？** 它释放本地资源，防止内存泄漏——在循环处理大量 PDF 时尤为重要。 ## 常见问题及解决方案 ### 问题 1 – “未找到文档” *原因：* 文件路径或工作目录不正确。 -*解决方案：* 验证绝对路径或打印 `System.getProperty("user.dir")` 以确认基目录。 +*解决方案：* 验证绝对路径，或打印 `System.getProperty("user.dir")` 以确认基目录。 -### 问题 2 – 注释未显示 +### 问题 2 – 注释不可见 *原因：* 坐标系或页码错误。 -*解决方案：* 请记住 PDF 坐标从左下角开始，页码从零计数。 +*解决方案：* 请记住 PDF 坐标从左下角开始，页码从零开始计数。 ### 问题 3 – 大型 PDF 导致 OutOfMemoryError -*原因：* 整个文档一次性加载到内存。 -*解决方案：* 增加 JVM 堆内存 (`-Xmx2g`) 或批量处理页面（见下方批处理示例）。 +*原因：* 整个文档被加载到内存中。 +*解决方案：* 增加 JVM 堆内存 (`-Xmx2g`) 或分批处理页面（见下方批处理示例）。 ### 问题 4 – 许可证验证错误 -*原因：* 许可证文件缺失或不匹配。 -*解决方案：* 仔细检查文件路径，并确保许可证版本与库版本相匹配。 +*原因：* 缺少或不匹配的许可证文件。 +*解决方案：* 再次检查文件路径，并确保许可证版本与库版本匹配。 ## 性能优化技巧 ### 内存管理最佳实践 +避免长时间持有大型 `Annotator` 实例的引用。处理完每个文件后使用 try‑with‑resources 或显式的 `dispose()` 调用。 + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -153,11 +214,13 @@ for (String documentPath : documentPaths) { ``` ### 批处理策略 -- **小型 PDF（<10 MB）：** 单独处理。 -- **中型 PDF（10‑50 MB）：** 以 5‑10 为一批进行处理。 -- **大型 PDF（>50 MB）：** 使用流式或分块处理，以避免 OOM。 +- **小型 PDF (<10 MB)：** 单独处理。 +- **中型 PDF (10‑50 MB)：** 以 5‑10 为一批处理。 +- **大型 PDF (>50 MB)：** 使用流式或分块处理以避免 OOM。 ### 缓存注意事项 +`AnnotationAppearance` 类封装了注释的视觉属性，如颜色和不透明度。当对许多页面使用相同样式进行注释时，请缓存可复用的对象，如 `AnnotationAppearance` 或 `Color` 实例。 + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -170,6 +233,8 @@ private static EllipseAnnotation createStandardEllipse() { ## 实际集成示例 ### Web 应用集成 +提供一个 REST 接口，接受 PDF 流，在前端提供的坐标处添加椭圆注释，并将带注释的 PDF 作为字节数组返回。 + ```java @RestController @RequestMapping("/api/documents") @@ -187,6 +252,8 @@ public class DocumentAnnotationController { ``` ### 批量文档处理 +遍历合同目录，为每个文件添加 “已审阅” 印章，并将处理后的文件移动到归档文件夹。 + ```java public class BatchAnnotationProcessor { @@ -204,6 +271,8 @@ public class BatchAnnotationProcessor { ## 高级注释技术 ### 动态注释定位 +使用 OCR 或 PDF 文本提取 API 根据检测到的文本位置实时计算注释坐标，然后在关键字周围放置椭圆。 + ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); @@ -211,31 +280,42 @@ ellipse.setBox(dynamicPosition); ``` ### 条件注释样式 +根据注释作者的角色应用不同的颜色或不透明度（例如，审阅者 = 蓝色，批准者 = 绿色）。 + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow ellipse.setBackgroundColor(color); ``` -## 实际应用场景 +## 实际应用与使用场景 - **教育平台：** 突出概念，添加教师评论，创建交互式学习指南。 - **法律文档审阅：** 标记条款，添加机密备注，维护审计轨迹。 - **医疗记录：** 注释观察结果，突出关键数据，实现安全协作。 -- **企业工作流：** 简化报告审批，添加审阅人印章，跟踪更改。 +- **企业工作流：** 简化报告审批，添加审阅印章，跟踪更改。 ## 何时使用不同的注释类型 -虽然本指南侧重于椭圆注释，但 groupdocs annotation library java 还提供以下功能： + +当需要非矩形高亮时，椭圆注释是理想选择，例如强调圆形图表、徽标或更适合用椭圆形表示的区域。它们提供清晰的视觉提示，同时保持可读性，适用于设计评审、品牌检查以及任何需要圆形强调的场景。 + +虽然本指南侧重于椭圆注释，GroupDocs Annotation Library Java 还提供以下注释类型： - **文本注释** 用于详细评论。 - **箭头注释** 用于指向特定元素。 -- **矩形注释** 用于品牌或安全。 +- **矩形注释** 用于区域高亮。 +- **水印注释** 用于品牌或安全。 - **印章注释** 用于批准。 -当您需要非矩形、视觉上独特的高亮时请选择椭圆——非常适合突出圆形图表 故障排查指南 +## 故障排查指南 ### 性能问题 -- **症：** 文件过大、注释或状：** 不同查看器中注释显示不同。 -- **诊断：** 使用了非标准 PDF 特性。 -- **解决方案：** 在 Adobe Acrobat、Chrome 和 Firefox 中测试；坚持使用 PDF 标准的注释标志。 +- **症状：** 处理速度慢。 +- **诊断：** 文件大小大，注释数量多，内存受限。 +- **解决方案：** 优化注释属性，采用异步处理，或对大型 PDF 进行分页。 + +### 兼容性问题 +- **症状：** 在不同查看器中注释显示不同。 +- **诊断：** 非标准 PDF 特性。 +- **解决方案：** 使用 Adobe Acrobat、Chrome 和 Firefox 进行测试；坚持使用 PDF 标准注释标记。 ### 集成挑战 - **症状：** 依赖冲突。 @@ -244,40 +324,46 @@ ellipse.setBackgroundColor(color); ## 常见问答 -**Q: 我可以给受密码保护的 PDF 添加注释吗？** -A: 可以。使用 `new Annotator(filePath, loadOptions)` 重载，其中 `loadOptions` 包含密码。 +**问：我可以对受密码保护的 PDF 添加注释吗？** +**答：** 可以。使用 `new Annotator(filePath, loadOptions)` 重载，其中 `loadOptions` 包含密码。 -**Q: 我该如何处理大于 100 MB 的 PDF？** -A: 单独处理每页，增大堆内存，或利用 GroupDocs Annotation Cloud API 处理大负载。 +**问：如何处理大于 100 MB 的 PDF？** +**答：** 单独处理页面，增大堆内存，或利用 GroupDocs Annotation Cloud API 处理大负载。 -**Q: 每个文档的注释数量有限制吗？** -A: 没有硬性限制，但在数千条注释后性能可能下降。考虑分页或分组。 +**问：每个文档的注释数量是否有限制？** +**答：** 没有硬性限制，但在数千条注释后性能可能下降。考虑分页或分组。 -**Q: 我可以提取已有的注释吗？** -A: 完全可以。调用 `annotator.get()` 即可获取 PDF 中的所有注释。 +**问：我可以提取已有的注释吗？** +**答：** 当然。调用 `annotator.get()` 可检索 PDF 中的所有注释。 -**Q: 我如何确保只有特定用户可以编辑注释？** -A: 该库提供基于用户的权限设置；可通过 `AnnotationPermission` API 进行配置。 +**问：如何确保只有特定用户可以编辑注释？** +**答：** 该库提供基于用户的权限设置；可通过 `AnnotationPermission` API 进行配置。 ## 结论 -**groupdocs annotation library java** 为您提供了一种简洁、高性能的方式，可直接从 Java 代码中嵌入丰富的 PDF 注释。按照上述步骤，您即可添加椭圆注释、管理评论，并扩展至企业级工作负载。 +**GroupDocs Annotation Library Java** 为您提供了一种简洁、高性能的方式，可直接在 Java 代码中嵌入丰富的 PDF 注释。按照上述步骤，您即可添加椭圆注释、管理评论，并扩展至企业级工作负载。 **后续步骤：** -1. 尝试其他注释类型（文本、印章、水印）。 +1. 试验其他注释类型（文本、印章、水印）。 2. 将库集成到现有的文档工作流或 Web 服务中。 3. 探索 REST API，以实现语言无关的场景。 --- -**最后更新：** 2026-02-03 +**最后更新：** 2026-07-25 **测试环境：** GroupDocs.Annotation 25.2 for Java **作者：** GroupDocs -**Essential Links:** +**重要链接：** - **文档：** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) - **API 参考：** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) - **下载：** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) - **购买：** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) - **免费试用：** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) - **临时许可证：** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **支持：** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **支持：** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## 相关教程 + +- [如何在 Java 中向 PDF 添加箭头 – 完整教程与最佳实践](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [如何使用 Java 和 GroupDocs Annotation 向 PDF 添加图像](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [完整指南 - 如何使用 GroupDocs.Annotation for Java 保存带注释的 PDF](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/czech/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/czech/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 6f5170450..d24ad61ef 100644 --- a/content/czech/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/czech/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,106 @@ --- -"date": "2025-05-06" -"description": "Naučte se, jak přidávat elipsovité anotace do PDF dokumentů pomocí výkonné knihovny GroupDocs.Annotation v Javě. Postupujte podle tohoto podrobného návodu a vylepšete spolupráci na dokumentech." -"title": "Přidání elipsovitých anotací do PDF v Javě pomocí GroupDocs.Annotation pro Javu" -"url": "/cs/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: Naučte se, jak anotovat PDF pomocí GroupDocs Annotation Library Java + – krok za krokem průvodce, ukázky kódu, tipy na výkon a osvědčené postupy. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Přidání anotací PDF v Javě +og_description: Naučte se, jak anotovat PDF pomocí GroupDocs Annotation Library Java + – průvodce zahrnující eliptické anotace, komentáře, licencování a tipy pro vývojáře + Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Jak anotovat PDF pomocí GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: Jak anotovat PDF pomocí GroupDocs Annotation Library Java type: docs -"weight": 1 +url: /cs/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Jak přidat elipsovité anotace do PDF pomocí GroupDocs.Annotation pro Javu +# Jak anotovat PDF pomocí knihovny GroupDocs Annotation Library pro Java -## Zavedení -Přidávání anotací do PDF souborů může výrazně zlepšit spolupráci a komunikaci, zejména při práci se složitými dokumenty. Pokud chcete programově zvýraznit nebo anotovat určité oblasti ve vašich PDF souborech pomocí Javy, tento tutoriál vás provede procesem bezproblémového přidávání elipsovitých anotací. Využitím možností GroupDocs.Annotation pro Javu mohou vývojáři snadno začlenit sofistikované funkce anotací do svých aplikací. +Přidávání vizuálních poznámek, komentářů nebo razítek do PDF programově může dramaticky zrychlit revizní cykly, kontrolu souladu a kolaborativní pracovní postupy. V tomto tutoriálu se dozvíte **jak anotovat PDF** soubory pomocí GroupDocs Annotation Library pro Java, od nastavení projektu až po pokročilé elipsové anotace, licencování, ladění výkonu a tipy pro reálnou integraci. -V tomto tutoriálu se budeme zabývat: -- Jak nastavit a integrovat GroupDocs.Annotation v projektu Java. -- Podrobné pokyny, jak přidat eliptickou anotaci do dokumentu PDF. -- Praktické příklady demonstrující případy použití v reálném světě. +## Rychlé odpovědi +- **Která knihovna přidává anotace do PDF v Javě?** GroupDocs Annotation Library for Java. +- **Potřebuji licenci?** Zkušební verze funguje pro testování; pro komerční použití je vyžadována produkční licence. +- **Které IDE je nejlepší?** Jakékoli Java IDE (IntelliJ IDEA, Eclipse, VS Code) funguje dobře. +- **Mohu anotovat PDF chráněná heslem?** Ano — zadejte heslo při vytváření `Annotator`. +- **Je podpora dávkového zpracování?** Rozhodně; viz příklad dávkového zpracování níže. -Pojďme se ponořit do předpokladů, které potřebujete, než začnete! +## Co je GroupDocs Annotation Library pro Java? -## Předpoklady -Abyste mohli pokračovat v tomto tutoriálu, budete potřebovat: -- **Vývojová sada pro Javu (JDK)**Ujistěte se, že máte nainstalovaný JDK. Tento příklad používá Javu 8 nebo vyšší. -- **GroupDocs.Annotation pro knihovnu Java**Budeme používat verzi knihovny 25.2. -- **Nastavení Mavenu**Maven je vyžadován pro snadnou správu závislostí. +GroupDocs Annotation Library Java je připravené API, které umožňuje vývojářům vytvářet, upravovat, načítat a mazat PDF anotace výhradně v Java kódu. Podporuje **více než 50 formátů dokumentů**, nabízí vestavěné vlákna komentářů a poskytuje detailní řízení oprávnění. -Ujistěte se, že vaše vývojové prostředí tyto požadavky podporuje a že znáte základní koncepty programování v Javě, zejména práci s knihovnami a manipulaci se soubory v Javě. +## Proč používat GroupDocs Annotation Library pro Java? -## Nastavení GroupDocs.Annotation pro Javu -### Instalace přes Maven -Chcete-li integrovat GroupDocs.Annotation do svého projektu pomocí Mavenu, přidejte do svého repozitáře následující repozitář a závislost. `pom.xml` soubor: +Můžete přidat bohaté značky — včetně elips, textových poznámek, razítek a vodoznaků — pomocí několika volání metod a knihovna zpracovává **PDF s několika stovkami stran** bez načítání celého souboru do paměti. Ve srovnání s nízkoúrovňovými nástroji jako iText nebo PDFBox snižuje vývojový čas až o **70 %** a podporuje složité funkce PDF (vrstvy, formuláře, digitální podpisy) přímo z krabice. + +## Požadavky a nastavení +- **JDK 8+** (JDK 11 recommended) +- **Maven or Gradle** for dependency management +- **IDE** of your choice (IntelliJ IDEA, Eclipse, VS Code) +- Základní znalost Java I/O souborů + +### Integrace s Maven +Add the repository and dependency to your `pom.xml`: ```xml @@ -48,31 +119,27 @@ Chcete-li integrovat GroupDocs.Annotation do svého projektu pomocí Mavenu, př ``` -### Získání licence -Než začnete, nezapomeňte si pořídit licenci pro GroupDocs.Annotation. Můžete získat bezplatnou zkušební verzi nebo si zakoupit plnou licenci z jejich webových stránek. Použití licence je jednoduché a zajistí vám přístup ke všem funkcím bez omezení. - -Zde je návod, jak si zažádat o licenci: +### Konfigurace licence +Apply your license before any annotation work: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Průvodce implementací -### Přidání anotace elipsy -Přidání elipsovitých anotací zahrnuje inicializaci knihovny anotací, nastavení dokumentu a konfiguraci vlastností anotací. Zde je postup krok za krokem. +*Tip:* Uložte soubor licence do `src/main/resources` a načtěte jej pomocí `getClass().getResourceAsStream()` pro snadnější nasazení. -#### Krok 1: Inicializace anotátoru se vstupním dokumentem -Nejprve vytvořte `Annotator` instanci zadáním cesty k vašemu PDF souboru: +## Kompletní průvodce implementací + +### Krok 1: Inicializace PDF anotátoru +`Annotator` třída je vstupním bodem pro všechny operace s anotacemi. Načte cílový PDF, aplikuje bezpečnostní nastavení a připraví paměťovou reprezentaci pro úpravy. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Tím se inicializuje prostředí pro přidávání anotací. - -#### Krok 2: Vytvoření a konfigurace odpovědí -Anotace mohou obsahovat odpovědi nebo komentáře. Zde je návod, jak nastavit odpovědi: +### Krok 2: Vytvoření interaktivních komentářů a odpovědí +`CommentAnnotation` vám umožní vložit volný text, zatímco objekty `Reply` umožňují vlákna diskuzí přímo na stránce PDF. ```java Reply reply1 = new Reply(); @@ -88,83 +155,215 @@ replies.add(reply1); replies.add(reply2); ``` -Tyto odpovědi budou připojeny k anotaci elipsy. - -#### Krok 3: Vytvoření a konfigurace elipsové anotace -Nyní vytvořte `EllipseAnnotation` objekt a nakonfigurujte jeho vlastnosti: +### Krok 3: Konfigurace elipsové anotace +`EllipseAnnotation` kreslí škálovatelný oválný tvar. Můžete nastavit barvu čáry, barvu výplně, průhlednost a vlastní tloušťku okraje podle vašich UI směrnic. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Žlutá barva pozadí -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Definuje polohu a velikost +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // Cílové číslo stránky pro anotaci -ellipse.setPenColor(65535); // Barva pera ve formátu RGB -ellipse.setPenStyle(PenStyle.DOT); // Pero s tečkou -ellipse.setPenWidth((byte) 3); // Šířka pera +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Toto nastavení definuje vzhled a metadata vaší anotace elipsy. - -#### Krok 4: Přidání anotace do dokumentu -Přidejte do dokumentu nakonfigurovanou anotaci elipsy pomocí: +### Krok 4: Přidání a uložení anotací +Po nakonfigurování všech objektů anotací zavolejte `annotator.save()`, aby se změny zapsaly zpět na disk. Nezapomeňte zavolat `dispose()`, aby se uvolnily nativní zdroje, zejména při zpracování mnoha souborů ve smyčce. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); ``` -#### Krok 5: Uložení a likvidace zdrojů -Nakonec uložte anotovaný dokument a uvolněte zdroje: +> **Proč volat `dispose()`?** Uvolňuje nativní zdroje, zabraňuje únikům paměti — což je zvláště důležité při zpracování mnoha PDF ve smyčce. + +## Časté problémy a řešení + +### Problém 1 – „Dokument nenalezen“ +*Příčina:* Nesprávná cesta k souboru nebo pracovní adresář. +*Řešení:* Ověřte absolutní cestu nebo vytiskněte `System.getProperty("user.dir")` pro potvrzení základního adresáře. + +### Problém 2 – Anotace nejsou viditelné +*Příčina:* Špatný souřadnicový systém nebo index stránky. +*Řešení:* Pamatujte, že souřadnice PDF začínají v levém dolním rohu a stránky jsou číslovány od nuly. + +### Problém 3 – OutOfMemoryError u velkých PDF +*Příčina:* Celý dokument načten do paměti. +*Řešení:* Zvyšte haldu JVM (`-Xmx2g`) nebo zpracovávejte stránky po dávkách (viz příklad níže). + +### Problém 4 – Chyby ověření licence +*Příčina:* Chybějící nebo neodpovídající soubor licence. +*Řešení:* Zkontrolujte cestu k souboru a ujistěte se, že verze licence odpovídá verzi knihovny. + +## Tipy pro optimalizaci výkonu + +### Nejlepší praktiky správy paměti +Vyhněte se držení odkazů na velké instance `Annotator` déle, než je nutné. Používejte try‑with‑resources nebo explicitní volání `dispose()` po zpracování každého souboru. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -## Praktické aplikace -- **Vzdělávací nástroje**Zvýraznění klíčových konceptů v učebnicích PDF. -- **Právní dokumenty**Anotace sekcí pro kontrolu nebo schválení. -- **Lékařské záznamy**Označování důležitých pozorování nebo poznámek. +### Strategie dávkového zpracování +- **Malé PDF (<10 MB):** Zpracovávejte jednotlivě. +- **Střední PDF (10‑50 MB):** Zpracovávejte v dávkách po 5‑10. +- **Velké PDF (>50 MB):** Použijte streamování nebo zpracování po částech, aby nedošlo k OOM. -GroupDocs.Annotation se může integrovat se systémy pro správu dokumentů a vylepšit tak jejich možnosti anotací. +### Úvahy o cachování +Třída `AnnotationAppearance` zapouzdřuje vizuální vlastnosti jako barvu a průhlednost anotací. Cacheujte znovupoužitelné objekty, jako jsou instance `AnnotationAppearance` nebo `Color`, když anotujete mnoho stránek se stejným stylem. -## Úvahy o výkonu -Pro optimální výkon: -- **Správa paměti**Sledování a správa využití paměti při zpracování velkých dokumentů. -- **Dávkové zpracování**Pokud anotujete více PDF souborů, zvažte jejich dávkové zpracování, abyste optimalizovali využití zdrojů. +```java +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} +``` -Tyto postupy zajišťují efektivní provoz vaší Java aplikace s využitím GroupDocs.Annotation. +## Příklady reálné integrace -## Závěr -Díky tomuto tutoriálu jste se naučili, jak přidávat elipsovité anotace do PDF souborů pomocí GroupDocs.Annotation pro Javu. Tato funkce je neocenitelná pro aplikace vyžadující detailní kontrolu dokumentů a kolaborativní úpravy. +### Integrace webové aplikace +Zveřejněte REST endpoint, který přijímá PDF stream, aplikuje elipsovou anotaci na souřadnice poskytnuté front‑endem, a vrátí anotované PDF jako pole bytů. -Chcete-li si dále vylepšit dovednosti, prozkoumejte další typy anotací dostupné v knihovně GroupDocs nebo integrujte tuto funkci do většího projektu. +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` -## Sekce Často kladených otázek -**Otázka: Mohu pomocí GroupDocs.Annotation anotovat i jiné typy dokumentů?** -A: Ano, GroupDocs podporuje anotace v různých formátech dokumentů kromě PDF, včetně souborů Word a Excel. +### Dávkové zpracování dokumentů +Procházejte adresář smluv, přidejte ke každému razítko „Reviewed“ a přesuňte zpracované soubory do archivační složky. -**Otázka: Jak mohu dynamicky změnit barvu anotace na základě obsahu?** -A: Můžete programově nastavit `penColor` vlastnost na základě vaší logiky před přidáním anotace. +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` + +## Pokročilé techniky anotací + +### Dynamické umístění anotací +Vypočítejte souřadnice anotací za běhu na základě detekovaných umístění textu pomocí OCR nebo API pro extrakci textu z PDF, a poté umístěte elipsy kolem klíčových slov. + +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Podmíněné stylování anotací +Použijte různé barvy nebo úrovně průhlednosti v závislosti na roli autora anotace (např. reviewer = modrá, approver = zelená). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` -**Otázka: Jaký je maximální počet podporovaných anotací?** -A: GroupDocs.Annotation umožňuje velké množství anotací, ale je vhodné otestovat výkon s vašimi konkrétními velikostmi a typy dokumentů. +## Praktické aplikace a příklady použití +- **Vzdělávací platformy:** Zvýrazňujte pojmy, přidávejte učitelské komentáře, vytvářejte interaktivní studijní materiály. +- **Právní revize dokumentů:** Označujte klauzule, přidávejte důvěrné poznámky, udržujte auditní stopy. +- **Zdravotní záznamy:** Anotujte pozorování, zvýrazňujte kritická data, umožněte bezpečnou spolupráci. +- **Firemní workflow:** Zefektivněte schvalování zpráv, přidávejte razítka recenzentů, sledujte změny. -**Otázka: Jak mám řešit překrývající se anotace?** -A: Upravte `box` kóty a polohy pro správu překrývání nebo vrstvení více anotací dle potřeby. +## Kdy použít různé typy anotací -**Otázka: Jaké jsou některé osvědčené postupy pro používání GroupDocs.Annotation ve webové aplikaci?** -A: Využívejte asynchronní zpracování pro velké dokumenty, zajistěte bezpečné ukládání anotovaných souborů a poskytujte uživatelsky přívětivá rozhraní pro interakce s anotacemi. +Elipsové anotace jsou ideální, když potřebujete neobdélníkové zvýraznění, například zdůraznění kruhových diagramů, loga nebo oblastí, které jsou lépe reprezentovány oválným tvarem. Poskytují jasný vizuální signál při zachování čitelnosti, což je vhodné pro designové revize, kontrolu značek a jakýkoli scénář, kde je preferováno kulaté zvýraznění. -## Zdroje -- **Dokumentace**: [Dokumentace k anotacím GroupDocs v Javě](https://docs.groupdocs.com/annotation/java/) -- **Referenční informace k API**: [Referenční příručka k rozhraní GroupDocs API](https://reference.groupdocs.com/annotation/java/) -- **Stáhnout**: [Stáhnout soubor GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Nákup**: [Koupit licenci GroupDocs](https://purchase.groupdocs.com/buy) -- **Bezplatná zkušební verze**: [Zahájit bezplatnou zkušební verzi](https://releases.groupdocs.com/annotation/java/) -- **Dočasná licence**: [Žádost o dočasnou licenci](https://purchase.groupdocs.com/temporary-license/) -- **Podpora**: [Fórum podpory GroupDocs](https://forum.groupdocs.com/c/annotation/) +Zatímco tento průvodce se zaměřuje na elipsové anotace, GroupDocs Annotation Library Java také nabízí: +- **Textové anotace** pro podrobné komentáře. +- **Šipkové anotace** pro ukazování na konkrétní prvky. +- **Obdélníkové anotace** pro zvýraznění oblastí. +- **Vodoznakové anotace** pro branding nebo zabezpečení. +- **Razítkové anotace** pro schválení. -Tato komplexní příručka by vám měla poskytnout znalosti pro efektivní přidávání elipsovitých anotací do vašich Java aplikací pomocí GroupDocs.Annotation. Přejeme vám příjemné programování! \ No newline at end of file +## Průvodce řešením problémů + +### Problémy s výkonem +- **Příznak:** Pomalejší zpracování. +- **Diagnóza:** Velikost souboru, mnoho anotací, omezená RAM. +- **Řešení:** Optimalizujte vlastnosti anotací, zpracovávejte asynchronně nebo stránkujte velké PDF. + +### Problémy s kompatibilitou +- **Příznak:** Anotace vypadají různě v různých prohlížečích. +- **Diagnóza:** Nestandardní funkce PDF. +- **Řešení:** Testujte s Adobe Acrobat, Chrome a Firefox; držte se standardních PDF anotací. + +### Výzvy při integraci +- **Příznak:** Konflikty závislostí. +- **Diagnóza:** Nesoulad verzí s jinými knihovnami. +- **Řešení:** Použijte Maven `` k vynucení kompatibilních verzí nebo přejděte na REST API pro jazykově neutrální integraci. + +## Často kladené otázky + +**Q: Mohu přidávat anotace do PDF chráněných heslem?** +A: Ano. Použijte přetížení `new Annotator(filePath, loadOptions)`, kde `loadOptions` obsahuje heslo. + +**Q: Jak mám zacházet s PDF většími než 100 MB?** +A: Zpracovávejte stránky jednotlivě, zvyšte velikost haldy, nebo využijte GroupDocs Annotation Cloud API pro náročné úlohy. + +**Q: Existuje limit počtu anotací v dokumentu?** +A: Žádný pevný limit, ale výkon může klesat po tisících anotací. Zvažte stránkování nebo seskupování. + +**Q: Mohu extrahovat existující anotace?** +A: Rozhodně. Zavolejte `annotator.get()`, abyste získali všechny anotace z PDF. + +**Q: Jak zabezpečím anotace tak, aby je mohli upravovat jen určití uživatelé?** +A: Knihovna poskytuje nastavení oprávnění na základě uživatele; nakonfigurujte je pomocí API `AnnotationPermission`. + +## Závěr +**GroupDocs Annotation Library Java** vám poskytuje čistý, výkonný způsob, jak vložit bohaté PDF anotace přímo z Java kódu. Dodržením výše uvedených kroků můžete přidávat elipsové anotace, spravovat komentáře a škálovat na úroveň podnikového zatížení. + +**Další kroky:** +1. Experimentujte s dalšími typy anotací (text, razítko, vodoznak). +2. Integrovejte knihovnu do existujícího dokumentového workflow nebo webové služby. +3. Prozkoumejte REST API pro jazykově neutrální scénáře. + +**Last Updated:** 2026-07-25 +**Tested With:** GroupDocs.Annotation 25.2 for Java +**Author:** GroupDocs + +**Důležité odkazy:** +- **Dokumentace:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **API reference:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Stáhnout:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Koupit:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Bezplatná zkušební verze:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **Dočasná licence:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **Podpora:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## Související tutoriály + +- [Jak přidat šipku do PDF pomocí Java – Kompletní tutoriál a osvědčené postupy](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Jak přidat obrázek do PDF pomocí Java a GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Kompletní průvodce – Jak uložit anotovaný PDF pomocí GroupDocs.Annotation pro Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/dutch/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/dutch/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 52dd2244d..a3fdc2145 100644 --- a/content/dutch/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/dutch/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,53 +1,103 @@ --- categories: - Java Development -date: '2026-02-03' -description: Leer hoe u annotaties aan PDF‑bestanden kunt toevoegen met de GroupDocs - Annotation Library voor Java. Stapsgewijze handleiding, codevoorbeelden, probleemoplossingstips - en best practices. -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: Leer hoe je PDF kunt annoteren met GroupDocs Annotation Library Java + – stapsgewijze handleiding, codefragmenten, prestatie‑tips en best practices. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: PDF‑annotaties toevoegen in Java +og_description: Leer hoe je PDF kunt annoteren met GroupDocs Annotation Library Java + – een gids over ellips‑annotaties, opmerkingen, licenties en tips voor Java‑ontwikkelaars. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Hoe PDF annoteren met GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'GroupDocs Annotatiebibliotheek Java: PDF-annotaties toevoegen' +- document processing +- ellipse annotation +title: Hoe PDF annoteren met GroupDocs Annotation Library Java type: docs url: /nl/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java: PDF‑annotaties toevoegen +# Hoe PDF annoteren met GroupDocs Annotation Library Java -Heb je je ooit afgevraagd hoe je programmatisch annotaties aan PDF‑documenten kunt toevoegen in Java? Met de **groupdocs annotation library java** kun je rijke markup—zoals ellipsen, opmerkingen en stempels—direct in PDF's embedden. Of je nu een document‑review‑systeem, een educatief platform of een samenwerkingsomgeving bouwt, deze tutorial laat je precies zien hoe je kunt beginnen. +Visuele notities, opmerkingen of stempels toevoegen aan een PDF via code kan de beoordelingscycli, compliance‑controles en samenwerkingsworkflows aanzienlijk versnellen. In deze tutorial ontdek je **hoe PDF te annoteren** met de GroupDocs Annotation Library voor Java, met alles van projectconfiguratie tot geavanceerde ellips‑annotaties, licenties, prestatie‑afstemming en praktische integratietips. -## Snelle antwoorden -?** De groupdocs annotation library java. +## Snelle Antwoorden +- **Welke bibliotheek voegt annotaties toe aan PDF's in Java?** De GroupDocs Annotation Library for Java. - **Heb ik een licentie nodig?** Een proefversie werkt voor testen; een productie‑licentie is vereist voor commercieel gebruik. - **Welke IDE werkt het beste?** Elke Java‑IDE (IntelliJ IDEA, Eclipse, VS Code) werkt prima. -- **Kan ik wachtwoord‑beveiligde PDF's annoteren?** Ja—geef het wachtwoord op bij het maken van de `Annotator`. -- **Wordt batchverwerking ondersteund?** Absoluut; zie het batchverwerking‑voorbeeld later. +- **Kan ik wachtwoord‑beveiligde PDF's annoteren?** Ja—geef het wachtwoord op bij het aanmaken van de `Annotator`. +- **Wordt batchverwerking ondersteund?** Absoluut; zie later het voorbeeld voor batchverwerking. ## Wat is de GroupDocs Annotation Library Java? -De groupdocs annotation library java is een krachtige, enterprise‑ready Java‑API waarmee je programmatisch PDF‑annotaties kunt maken, bewerken en ophalen. Het ondersteunt meer dan 50 documentformaten en biedt samenwerkingsfuncties zoals antwoorden en commentaarthreads. + +De GroupDocs Annotation Library Java is een kant‑en‑klaar API waarmee ontwikkelaars PDF‑annotaties kunnen maken, bewerken, ophalen en verwijderen volledig in Java‑code. Het ondersteunt **meer dan 50 documentformaten**, biedt ingebouwde commentaarthreads en levert fijnmazige permissie‑controles. ## Waarom de GroupDocs Annotation Library Java gebruiken? -- **Rijke annotatietypen** – vormen, tekst, stempels, watermerken en meer. -- **Klaar voor samenwerking** – ingebouwde antwoorden en commentaarthreads. -- **Prestaties geoptimaliseerd** – verwerkt grote PDF's efficiënt. -- **Eenvoudige API** – verkort de ontwikkelingstijd vergeleken met lagere‑niveau bibliotheken zoals iText of PDFBox. -## Vereisten en installatie -- **JDK 8+** (JDK 11 aanbevolen) +Je kunt rijke markeringen toevoegen — waaronder ellipsen, tekstnotities, stempels en watermerken — met slechts een paar methode‑aanroepen, en de bibliotheek verwerkt **PDF's met honderden pagina's** zonder het volledige bestand in het geheugen te laden. Vergeleken met low‑level tools zoals iText of PDFBox, vermindert het de ontwikkelingstijd tot **70 %** en behandelt het complexe PDF‑functies (lagen, formulieren, digitale handtekeningen) direct uit de doos. + +## Vereisten en Installatie +- **JDK 8+** (JDK 11 aanbevolen) - **Maven of Gradle** voor afhankelijkheidsbeheer -- **IDE** naar keuze (IntelliJ IDEA, Eclipse, enz.) +- **IDE** naar keuze (IntelliJ IDEA, Eclipse, VS Code) - Basiskennis van Java bestands‑I/O -## De GroupDocs Annotation Library Java instellen - ### Maven‑integratie Voeg de repository en afhankelijkheid toe aan je `pom.xml`: @@ -69,7 +119,7 @@ Voeg de repository en afhankelijkheid toe aan je `pom.xml`: ``` ### Licentieconfiguratie -Pas je licentie toe vóór enige annotatiewerkzaamheden: +Pas je licentie toe voordat je annotaties maakt: ```java License license = new License(); @@ -78,14 +128,18 @@ license.setLicense("path/to/your/license/file"); *Pro tip:* Sla het licentiebestand op in `src/main/resources` en laad het met `getClass().getResourceAsStream()` voor soepelere implementaties. -## Volledige implementatie‑gids +## Volledige Implementatiegids ### Stap 1: Initialiseer de PDF‑Annotator +De `Annotator`‑klasse is het startpunt voor alle annotatie‑operaties. Het laadt de doel‑PDF, past beveiligingsinstellingen toe en bereidt een in‑memory representatie voor bewerking voor. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### Stap 2: Maak interactieve opmerkingen en antwoorden +`CommentAnnotation` stelt je in staat vrije tekst in te sluiten, terwijl `Reply`‑objecten thread‑discussies direct op de PDF‑pagina mogelijk maken. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -101,6 +155,8 @@ replies.add(reply2); ``` ### Stap 3: Configureer je ellips‑annotatie +`EllipseAnnotation` tekent een schaalbare ovale vorm. Je kunt lijnkleur, vulkleur, doorzichtigheid en aangepaste randdikte instellen om aan je UI‑richtlijnen te voldoen. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -115,23 +171,25 @@ ellipse.setReplies(replies); ``` ### Stap 4: Voeg je annotaties toe en sla ze op +Na het configureren van alle annotatie‑objecten, roep je `annotator.save()` aan om de wijzigingen terug naar schijf te schrijven. Vergeet niet `dispose()` aan te roepen om native resources vrij te geven, vooral bij het verwerken van veel bestanden in een lus. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **Waarom `dispose()` aanroepen?** Het vrijgeeft native resources, waardoor geheugenlekken worden voorkomen—vooral belangrijk bij het verwerken van veel PDF's in een lus. +> **Waarom `dispose()` aanroepen?** Het vrijgeeft native resources, waardoor geheugenlekken worden voorkomen — vooral belangrijk bij het verwerken van veel PDF's in een lus. -## Veelvoorkomende problemen en oplossingen +## Veelvoorkomende Problemen en Oplossingen ### Probleem 1 – “Document niet gevonden” *Oorzaak:* Onjuist bestandspad of werkmap. -*Oplossing:* Controleer het absolute pad of print `System.getProperty("user.dir")` om de basisdirectory te bevestigen. +*Oplossing:* Controleer het absolute pad of print `System.getProperty("user.dir")` om de basismap te bevestigen. ### Probleem 2 – Annotaties niet zichtbaar *Oorzaak:* Verkeerd coördinatensysteem of paginanummer. -*Oplossing:* Onthoud dat PDF‑coördinaten beginnen links‑onder en dat pagina's nul‑gebaseerd zijn. +*Oplossing:* Onthoud dat PDF‑coördinaten beginnen links‑onder, en pagina's nul‑gebaseerd zijn. ### Probleem 3 – OutOfMemoryError bij grote PDF's *Oorzaak:* Het volledige document wordt in het geheugen geladen. @@ -139,11 +197,13 @@ annotator.dispose(); ### Probleem 4 – Licentie‑validatiefouten *Oorzaak:* Ontbrekend of niet‑overeenkomend licentiebestand. -*Oplossing:* Controleer het bestandspad nogmaals en zorg ervoor dat de licentieversie overeenkomt met de bibliotheekversie. +*Oplossing:* Controleer het bestandspad en zorg dat de licentieversie overeenkomt met de bibliotheekversie. -## Tips voor prestatie‑optimalisatie +## Tips voor Prestatie‑optimalisatie + +### Best Practices voor Geheugenbeheer +Vermijd het vasthouden van referenties naar grote `Annotator`‑instanties langer dan nodig. Gebruik try‑with‑resources of expliciete `dispose()`‑aanroepen na het verwerken van elk bestand. -### Beste praktijken voor geheugenbeheer ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -154,12 +214,14 @@ for (String documentPath : documentPaths) { } ``` -### Batchverwerkingsstrategieën +### Strategieën voor Batchverwerking - **Kleine PDF's (<10 MB):** Individueel verwerken. - **Middelgrote PDF's (10‑50 MB):** Verwerken in batches van 5‑10. - **Grote PDF's (>50 MB):** Streaming of chunk‑verwerking gebruiken om OOM te voorkomen. -### Overwegingen bij caching +### Overwegingen voor Caching +De `AnnotationAppearance`‑klasse omvat visuele eigenschappen zoals kleur en doorzichtigheid voor annotaties. Cache herbruikbare objecten zoals `AnnotationAppearance` of `Color`‑instanties wanneer je veel pagina's met identieke styling annoteert. + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -169,9 +231,11 @@ private static EllipseAnnotation createStandardEllipse() { } ``` -## Praktische integratie‑voorbeelden +## Praktische Integratie‑voorbeelden + +### Integratie met Webapplicatie +Exposeer een REST‑endpoint dat een PDF‑stream accepteert, een ellips‑annotatie toepast op coördinaten die door de front‑end worden geleverd, en de geannoteerde PDF als byte‑array teruggeeft. -### Integratie in webapplicatie ```java @RestController @RequestMapping("/api/documents") @@ -189,6 +253,8 @@ public class DocumentAnnotationController { ``` ### Batch‑documentverwerking +Itereer over een map met contracten, voeg een “Reviewed”‑stempel toe aan elk bestand, en verplaats de verwerkte bestanden naar een archiefmap. + ```java public class BatchAnnotationProcessor { @@ -203,69 +269,78 @@ public class BatchAnnotationProcessor { } ``` -## Geavanceerde annotatietechnieken +## Geavanceerde Annotatietechnieken ### Dynamische annotatie‑positionering +Bereken annotatie‑coördinaten on‑the‑fly op basis van gedetecteerde tekstlocaties met OCR of PDF‑tekst‑extractie‑API's, en plaats vervolgens ellipsen rond trefwoorden. + ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); ellipse.setBox(dynamicPosition); ``` -### Voorwaardelijke annotatie‑styling +### Conditionele annotatie‑styling +Pas verschillende kleuren of doorzichtigheidsniveaus toe afhankelijk van de rol van de auteur van de annotatie (bijv. reviewer = blauw, approver = groen). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow ellipse.setBackgroundColor(color); ``` -## Praktische toepassingen en use‑cases +## Praktische Toepassingen en Use‑cases - **Educatieve platforms:** Concepten markeren, docenten‑commentaren toevoegen, interactieve studiegidsen maken. - **Juridische documentreview:** Clausules markeren, vertrouwelijke notities toevoegen, audit‑trails bijhouden. -- **Medische dossiers:** Observaties annoteren, kritieke gegevens markeren, veilige samenwerking mogelijk maken. -- **Bedrijfsprocessen:** Rapportgoedkeuringen stroomlijnen, reviewer‑stempels toevoegen, wijzigingen bijhouden. +- **Medische dossiers:** Observaties annoteren, kritieke data markeren, veilige samenwerking mogelijk maken. +- **Bedrijfsworkflows:** Rapportgoedkeuringen stroomlijnen, reviewer‑stempels toevoegen, wijzigingen bijhouden. + +## Wanneer verschillende annotatietypen te gebruiken +Ellips‑annotaties zijn ideaal wanneer je een niet‑rechthoekige markering nodig hebt, zoals het benadrukken van cirkelvormige diagrammen, logo's of gebieden die beter worden weergegeven door een ovale vorm. Ze bieden een duidelijke visuele aanwijzing terwijl ze de leesbaarheid behouden, waardoor ze geschikt zijn voor design‑reviews, merkontcontroles en elke situatie waarin een ronde nadruk gewenst is. -## Wanneer verschillende annotatietypen gebruiken -Hoewel deze gids zich richt op ellips‑annotaties, biedt de groupdocs annotation library java ook: +Hoewel deze gids zich richt op ellips‑annotaties, biedt de GroupDocs Annotation Library Java ook: - **Tekst‑annotaties** voor gedetailleerde commentaren. - **Pijl‑annotaties** om naar specifieke elementen te wijzen. - **Rechthoek‑annotaties** voor gebiedsmarkering. - **Watermerk‑annotaties** voor branding of beveiliging. - **Stempel‑annotaties** voor goedkeuringen. -Kies ellipsen wanneer je een niet‑rechthoekige, visueel onderscheidende markering nodig hebt—perfect om de aandacht te vestigen op cirkelvormige diagrammen of logo‑gebieden. - ## Probleemoplossingsgids -### Prestatieproblemen +### Prestatie‑problemen - **Symptoom:** Trage verwerking. -- **Diagnose:** Groot bestand, veel annotaties, beperkte RAM. +- **Diagnose:** Groot bestand, veel annotaties, beperkt RAM. - **Oplossing:** Optimaliseer annotatie‑eigenschappen, verwerk asynchroon, of pagineer grote PDF's. ### Compatibiliteitsproblemen -- **Symptoom:** Annotaties zien. -- **Diagnose:** Niet‑standaard PDF‑functies. +- **Symptoom:** Annotaties zien er verschillend uit in verschillende viewers. +- **Diagnose:** Niet‑standaard PDF‑features. - **Oplossing:** Test met Adobe Acrobat, Chrome en Firefox; houd je aan PDF‑standaard annotatie‑flags. ### Integratie‑uitdagingen -- **Symptoom:**ie‑conflicten met:** +- **Symptoom:** Afhankelijkheidsconflicten. +- **Diagnose:** Versie‑mismatches met andere bibliotheken. +- **Oplossing:** Gebruik Maven’s `` om compatibele versies af te dwingen of schakel over naar de REST‑API voor taal‑agnostische integratie. + +## Veelgestelde Vragen - Gebruik de overload `new Annotator(filePath, loadOptions)` waarbij `loadOptions` het wachtwoord bevat. +**V: Kan ik annotaties toevoegen aan wachtwoord‑beveiligde PDF's?** +A: Ja. Gebruik de overload `new Annotator(filePath, loadOptions)` waarbij `loadOptions` het wachtwoord bevat. -**Q: Hoe moet ik omgaan met PDF's groter dan 100 MB?** -A: Verwerk pagina's individueel, vergroot de heap zware workloads. +**V: Hoe moet ik omgaan met PDF's groter dan 100 MB?** +A: Verwerk pagina's individueel, vergroot de heap‑grootte, of maak gebruik van de GroupDocs Annotation Cloud API voor zware workloads. -**Q: Is er een limiet aan het aantal annotaties per document?** +**V: Is er een limiet aan het aantal annotaties per document?** A: Geen harde limiet, maar de prestaties kunnen afnemen na duizenden annotaties. Overweeg paginering of groeperen. -**Q: Kan ik bestaande annotaties extraheren?** -A: Zeker. Roep `annotator.get()` aan om alle annotaties uit een PDF op te halen. +**V: Kan ik bestaande annotaties extraheren?** +A: Absoluut. Roep `annotator.get()` aan om alle annotaties uit een PDF op te halen. -**Q: Hoe beveilig ik annotaties zodat alleen bepaalde gebruikers ze kunnen bewerken?** -A: De bibliotheek biedt gebruikersgebaseerde permissie‑instellingen; configureer ze via de `AnnotationPermission` API. +**V: Hoe beveilig ik annotaties zodat alleen bepaalde gebruikers ze kunnen bewerken?** +A: De bibliotheek biedt gebruikers‑gebaseerde permissie‑instellingen; configureer ze via de `AnnotationPermission` API. ## Conclusie -De **groupdocs annotation library java** biedt een nette, high‑performance manier om rijke PDF‑annotaties direct vanuit Java‑code in te voegen. Door de bovenstaande stappen te volgen, kun je ellips‑annotaties toevoegen, opmerkingen beheren en opschalen naar enterprise‑niveau workloads. +De **GroupDocs Annotation Library Java** biedt een nette, high‑performance manier om rijke PDF‑annotaties direct vanuit Java‑code in te voegen. Door de bovenstaande stappen te volgen, kun je ellips‑annotaties toevoegen, opmerkingen beheren en opschalen naar enterprise‑niveau workloads. **Volgende stappen:** 1. Experimenteer met andere annotatietypen (tekst, stempel, watermerk). @@ -274,7 +349,7 @@ De **groupdocs annotation library java** biedt een nette, high‑performance man --- -**Laatst bijgewerkt:** 2026-02-03 +**Laatst bijgewerkt:** 2026-07-25 **Getest met:** GroupDocs.Annotation 25.2 for Java **Auteur:** GroupDocs @@ -282,7 +357,13 @@ De **groupdocs annotation library java** biedt een nette, high‑performance man - **Documentatie:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) - **API‑referentie:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) - **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Aankoop:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) -- **Gratis proefversie:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) -- **Tijdelijke licentie:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Ondersteuning:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **Aankoop:** [Koop GroupDocs License](https://purchase.groupdocs.com/buy) +- **Gratis proefversie:** [Start een gratis proefversie](https://releases.groupdocs.com/annotation/java/) +- **Tijdelijke licentie:** [Vraag een tijdelijke licentie aan](https://purchase.groupdocs.com/temporary-license/) +- **Ondersteuning:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## Gerelateerde Tutorials + +- [Hoe een pijl toevoegen aan pdf met Java – Complete Tutorial & Best Practices](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Hoe een afbeelding toevoegen aan PDF met Java en GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Complete gids - Hoe een geannoteerde PDF opslaan met GroupDocs.Annotation voor Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/english/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/english/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 61d83cbbe..b45425fc3 100644 --- a/content/english/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/english/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,45 +1,105 @@ --- -title: "GroupDocs Annotation Library Java: Add PDF Annotations" -linktitle: "Add PDF Annotations in Java" -description: "Learn how to add annotations to PDF files using the groupdocs annotation library java. Step‑by‑step guide, code examples, troubleshooting tips, and best practices." -keywords: "add annotations to PDF Java, Java PDF annotation library, programmatic PDF annotation Java, GroupDocs annotation tutorial, PDF markup Java" -weight: 1 -url: "/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" -date: "2026-02-03" -lastmod: "2026-02-03" -categories: ["Java Development"] -tags: ["pdf-annotation", "java-tutorial", "groupdocs", "document-processing"] +categories: +- Java Development +date: '2026-07-25' +description: Learn how to annotate PDF with GroupDocs Annotation Library Java – step‑by‑step + guide, code snippets, performance tips, and best practices. +images: +- /java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/og-image.png +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Add PDF Annotations in Java +og_description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + a guide covering ellipse annotations, comments, licensing, and tips for Java developers. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: How to Annotate PDF with GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: How to Annotate PDF with GroupDocs Annotation Library Java type: docs +url: /java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# GroupDocs Annotation Library Java: Add PDF Annotations +# How to Annotate PDF with GroupDocs Annotation Library Java -Ever wondered how to add annotations to PDF documents programmatically in Java? With the **groupdocs annotation library java**, you can embed rich markup—like ellipses, comments, and stamps—directly into PDFs. Whether you're building a document review system, an educational platform, or a collaborative workspace, this tutorial shows you exactly how to get started. +Adding visual notes, comments, or stamps to a PDF programmatically can dramatically speed up review cycles, compliance checks, and collaborative workflows. In this tutorial you’ll discover **how to annotate PDF** files using the GroupDocs Annotation Library for Java, covering everything from project setup to advanced ellipse annotations, licensing, performance tuning, and real‑world integration tips. ## Quick Answers -- **What library adds annotations to PDFs in Java?** The groupdocs annotation library java. +- **What library adds annotations to PDFs in Java?** The GroupDocs Annotation Library for Java. - **Do I need a license?** A trial works for testing; a production license is required for commercial use. - **Which IDE works best?** Any Java IDE (IntelliJ IDEA, Eclipse, VS Code) works fine. - **Can I annotate password‑protected PDFs?** Yes—provide the password when creating the `Annotator`. - **Is batch processing supported?** Absolutely; see the batch processing example later. ## What is the GroupDocs Annotation Library Java? -The groupdocs annotation library java is a powerful, enterprise‑ready Java API that lets you create, edit, and retrieve PDF annotations programmatically. It supports over 50 document formats and provides collaboration features such as replies and comment threads. + +The GroupDocs Annotation Library Java is a ready‑to‑use API that enables developers to create, edit, retrieve, and delete PDF annotations entirely in Java code. It supports **over 50 document formats**, offers built‑in comment threads, and provides fine‑grained permission controls. ## Why Use the GroupDocs Annotation Library Java? -- **Rich annotation types** – shapes, text, stamps, watermarks, and more. -- **Collaboration ready** – built‑in replies and comment threads. -- **Performance‑tuned** – handles large PDFs efficiently. -- **Simple API** – reduces development time compared with lower‑level libraries like iText or PDFBox. + +You can add rich markup—including ellipses, text notes, stamps, and watermarks—with just a few method calls, and the library processes **multi‑hundred‑page PDFs** without loading the whole file into memory. Compared with low‑level tools like iText or PDFBox, it reduces development time by up to **70 %** and handles complex PDF features (layers, forms, digital signatures) out‑of‑the‑box. ## Prerequisites and Setup -- **JDK 8+** (JDK 11 recommended) +- **JDK 8+** (JDK 11 recommended) - **Maven or Gradle** for dependency management -- **IDE** of your choice (IntelliJ IDEA, Eclipse, etc.) +- **IDE** of your choice (IntelliJ IDEA, Eclipse, VS Code) - Basic familiarity with Java file I/O -## Setting Up the GroupDocs Annotation Library Java - ### Maven Integration Add the repository and dependency to your `pom.xml`: @@ -73,11 +133,15 @@ license.setLicense("path/to/your/license/file"); ## Complete Implementation Guide ### Step 1: Initialize the PDF Annotator +The `Annotator` class is the entry point for all annotation operations. It loads the target PDF, applies security settings, and prepares an in‑memory representation for editing. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### Step 2: Create Interactive Comments and Replies +`CommentAnnotation` lets you embed free‑form text, while `Reply` objects enable threaded discussions directly on the PDF page. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -93,6 +157,8 @@ replies.add(reply2); ``` ### Step 3: Configure Your Ellipse Annotation +`EllipseAnnotation` draws a scalable oval shape. You can set line color, fill color, opacity, and custom border thickness to match your UI guidelines. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -107,6 +173,8 @@ ellipse.setReplies(replies); ``` ### Step 4: Add and Save Your Annotations +After configuring all annotation objects, invoke `annotator.save()` to write the changes back to disk. Remember to call `dispose()` to free native resources, especially when processing many files in a loop. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); @@ -136,6 +204,8 @@ annotator.dispose(); ## Performance Optimization Tips ### Memory Management Best Practices +Avoid holding references to large `Annotator` instances longer than necessary. Use try‑with‑resources or explicit `dispose()` calls after each file is processed. + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -152,6 +222,8 @@ for (String documentPath : documentPaths) { - **Large PDFs (>50 MB):** Use streaming or chunked processing to avoid OOM. ### Caching Considerations +The `AnnotationAppearance` class encapsulates visual properties like color and opacity for annotations. Cache reusable objects such as `AnnotationAppearance` or `Color` instances when you annotate many pages with identical styling. + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -164,6 +236,8 @@ private static EllipseAnnotation createStandardEllipse() { ## Real‑World Integration Examples ### Web Application Integration +Expose a REST endpoint that accepts a PDF stream, applies an ellipse annotation at coordinates supplied by the front‑end, and returns the annotated PDF as a byte array. + ```java @RestController @RequestMapping("/api/documents") @@ -181,6 +255,8 @@ public class DocumentAnnotationController { ``` ### Batch Document Processing +Iterate over a directory of contracts, add a “Reviewed” stamp to each, and move the processed files to an archive folder. + ```java public class BatchAnnotationProcessor { @@ -198,6 +274,8 @@ public class BatchAnnotationProcessor { ## Advanced Annotation Techniques ### Dynamic Annotation Positioning +Calculate annotation coordinates on the fly based on detected text locations using OCR or PDF text extraction APIs, then place ellipses around keywords. + ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); @@ -205,6 +283,8 @@ ellipse.setBox(dynamicPosition); ``` ### Conditional Annotation Styling +Apply different colors or opacity levels depending on the annotation’s author role (e.g., reviewer = blue, approver = green). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow @@ -218,15 +298,16 @@ ellipse.setBackgroundColor(color); - **Corporate workflows:** Streamline report approvals, add reviewer stamps, track changes. ## When to Use Different Annotation Types -While this guide focuses on ellipse annotations, the groupdocs annotation library java also offers: + +Ellipse annotations are ideal when you need a non‑rectangular highlight, such as emphasizing circular diagrams, logos, or areas that are better represented by an oval shape. They provide a clear visual cue while preserving readability, making them suitable for design reviews, branding checks, and any scenario where a round emphasis is preferred. + +While this guide focuses on ellipse annotations, the GroupDocs Annotation Library Java also offers: - **Text annotations** for detailed comments. - **Arrow annotations** to point at specific elements. - **Rectangle annotations** for area highlighting. - **Watermark annotations** for branding or security. - **Stamp annotations** for approvals. -Choose ellipses when you need a non‑rectangular, visually distinct highlight—perfect for drawing attention to circular diagrams or logo areas. - ## Troubleshooting Guide ### Performance Issues @@ -262,7 +343,7 @@ A: Absolutely. Call `annotator.get()` to retrieve all annotations from a PDF. A: The library provides user‑based permission settings; configure them via the `AnnotationPermission` API. ## Conclusion -The **groupdocs annotation library java** gives you a clean, high‑performance way to embed rich PDF annotations directly from Java code. By following the steps above, you can add ellipse annotations, manage comments, and scale to enterprise‑level workloads. +The **GroupDocs Annotation Library Java** gives you a clean, high‑performance way to embed rich PDF annotations directly from Java code. By following the steps above, you can add ellipse annotations, manage comments, and scale to enterprise‑level workloads. **Next steps:** 1. Experiment with other annotation types (text, stamp, watermark). @@ -271,7 +352,7 @@ The **groupdocs annotation library java** gives you a clean, high‑performance --- -**Last Updated:** 2026-02-03 +**Last Updated:** 2026-07-25 **Tested With:** GroupDocs.Annotation 25.2 for Java **Author:** GroupDocs @@ -284,4 +365,8 @@ The **groupdocs annotation library java** gives you a clean, high‑performance - **Temporary License:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) - **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) ---- \ No newline at end of file +## Related Tutorials + +- [How to add arrow to pdf with Java – Complete Tutorial & Best Practices](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [How to add image to PDF using Java and GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Complete Guide - How to Save Annotated PDF with GroupDocs.Annotation for Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/english/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/og-image.png b/content/english/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/og-image.png new file mode 100644 index 0000000000000000000000000000000000000000..ac883abde8386d31633774d097e973042084edf1 GIT binary patch literal 45364 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%0DuK>bn-KFUjzEv zu?JNY5YkC%OKhUp*TwK{{Eov%^JPU54b?z_KiI;ZcIp%s0GF<=uHyUO!jaUxKs@Ov zegfIferLVV-4B$?vC2H8rzAVY!cVO0l*HZ==V6Wb^r@jK_rtSiEihoF0@UNjf)sea zpTN}cy&5U+L`ulcU%HGd0ses5QAq-P#@5c-$A*!@47IJlydUYL zK#c-`GLWi+y_(ywc6OqM1iv3aL&UX!c6;ys3x6>F-sqE=@V4)I$LUk=GlS*LPB89& z0{=m*0QUzlZ52gMFoy3%fIQz6$n!J*m_gdV(4qZ9M*J=ewM;<%G3m+4`ilo}luNB; z4EcJpxz7Df4g7m*LsHr90*OJFmDImy9{A}){%7J)dgYJHCE@kLYSc3IX>b+Ev~z!q z7XMHFmXdsLGLKjPW7KNgt(xToH)(O`+vir~XCzYay@5#>5heyVr*4>xk+ z26*y20Bk(@6TtQEiMQszi=KSbd+DFv=O3<_|NeIV%LLE=V~fTA&8Kn8BERE)9hl9; z8&Qvqq15Rl)khjE0&PN|*co~4Q{~wW)t7Ba7|B56i9i|l@|DYRyFa+RSZq+m(56@_ zjR(E)d+0GvE-qNqjcG*%F^}2NnV%k13k$i(+Yv81J6?1ubOP#ZpwOr;@vHmlXy|yA z0zbY_SP&#Fu1#Z+`U2Pe(w}DWq+nT(&U#}R835IgmzxKT3ZGC^P?B$SKiWvi|FuKi z&n95|S}8oLs)smrEV+mCN|RTC4LE9?Le1@N+aXScaazDzakJQ02|m{D23&fQAh z?%HnNC$favKn95#O-RTXiBi|E``iWb2KwX97*U(S>VT!N;i4n7TgOl&1-($`1uZ!T z{UqXXFm}MPWM}W)BQ}5L) zm&1KBIzds<)UZ5wUTc!;W|NR14>z~wE|r1;1UM+F6utlLBxW)fA8(NQ#?4pGAr?o7 z59f*+I_Q(dSOni;di>Qz5+gTML}H*dEXLY;l}=Flb|~nVW|p7u#LsUILbMh9{go7z z;^X7JrGM1!eZF$#vMmkWaqlmk_4*@s`^h@Gsc*6UpTGaghie3~TzdBG)7~E0tr={B z!Nk@(`{kQMis}c36FWXC);1)*HnR6EAG!EYNQP;ss@m;#WYkO}92e*9q$n5|65Md~ zuX?nBY-wwoCtl>Rr*;T@!jDSNF;PCdKLL=%^ZMMTR0E(`$^=h~qw-k^5J~wk(NtSXaXb$JODcmSHW5kDri7 zuXJ?og+6y{X(6>3~~Rt8I0 zy;x*+SGhyq(w;jNE0}nzo|WScKWC=1??DwYyC@9`8S#E>^0bq{w#*9)SWoteANugatkYN?%i4pIk;6NWSt#$bxq6!tPl~0)!CKF#o-|S z1RQtmm|QI`u!a~)>&4=}-_l9DQdOQ!!d-ht^{fvWpMU_>xtVoMt}6hIDbhDIti%^J z>pJ-9Vn%RcJC>%3Hd2VGI9~Cz=&;W`lbI3^LF*^4xJ%t0Ur+^~x|W*=TO&+E5r)$$ zxO-h*7GGfEd!5n=sy=~s9Qsy{u0AvVNk+Ey!nyMzkA-7mW2onsEG*39g%LYH`6Ey*Jfy@fSk0fB&2iWLbL_VDVKGa5feZLC=s zjgO8ciaEYnt1`L=*@L-n#K_!6Ra!OSBRb1@c!D0mjEy&^mZo3n=p~8U*-YW=Whfn- z>^#tOyug@guZw=9U|#`!IBD#$^Z$-mScVWxQlDmN^cDsEI)n2La0reqt{x27*pJCJiLHD-Uf>~ zW?$r!2+Cg(N2s}6+vAdoM@uh=qQW4OL|$SZL){!Li)Xy1lJLE*rfEI1gvro?U2-nj7+w{aeI&XyVw z5G=s%RbP)8ossdAseZTOt|eOwhlE5=ZPI*IMz7u+tQV1`>XIF3Nj`k&?IV_0x?3@k zGPq3XAdUxh#p7y;l=W{ZGuIOI^$nh>sPFl&bA>(!+{J970qH&JphreJI(C?i@6pxb zK$=_X{FZ}8KlkLG{y??!ul?SQ&qJOB*Db(M zrb=rI;ZmC9oL8<54flAqeO84;@eVoA3%uwZ?mo_0GIDZwSD2H7s@YBYDOP81Z;xSQ zsC_0&PAlH={rl#og(3ckAXN5<&lGL+*jZ~&u5M#b?mDh>z=~$rkmBQNE++`5VDVL4 ztSb!xPz8^{<1FE&DBgI_#S*KA*~1_t445{rH*VE0*W1P}>Qwj)7CAX)A+M;Foe~%` z6&M(N)6*YYrJ{#o9y4%MY;;%MlaqYg7R*gtt`F;*7Ed)dSgwR^?m$`L4Wkv|^FSnj zfjZcqN44s(LN|t1D5t>l+p1ZB3d56EYWkR|G1f+6a$?D*p{;wS#KBIy%2ZKKPM`7F zfj4J?T#eZi-&}co8axRV;W9Wn6LPN|}8F83?%i&}oldqjO?(G!)}86Z%eC=1*Td z9r(pO5k)~c()#mfIlL#@Ku_piVl?_1BiAMA7h4g5dP0tm-uF?m{Fc<)NbX-fU6YMgPses4d`XD!{ThMMblWT3%xd5Z+7s3iO}5T$G|vD>C42@X%wA$hJz< zgghr$YdgCYuz0{q$w1U0Wf0ci^Ii6U>~<)s5OMJtVJ>)F;7ymFOU(;@aA#hFeMrL! zeUo@?AWPi*a^S+h~q z)U=bA-|Q+M9Ajr2yg}V3A4w#@kGVcRy|_n4FVH>sD__omxA`F#W14aB8)0TX{x!0U zRF&S=WiAn}?IYBHF{7|-a|=utnF$K}LYO1g*aF6T1dnrgY8iU~(Jo4#uAiA%V5Az* zvs(h$V3=d`MciF}tu%ojgiEBg(!;4jQ$N$!lW&!hkU+Et#R9Zc4I7;fu1isf*4Ll) zemW?>vE!Fks-E=$`*TFX{k2g8j%RJMLTRe3v!{q*v`m5G92W$_yDk_D&BR{@0;;y2 zC+#8fM1$q$!uCgPQc@JsO(KJd4^@UshMD^C=g;Zt>O@3E*^XBOSg^LbwtWQn=-|k& zMxMVQoFjwX%1>}ZYuD8dIGeU*X!L_-E?*Q zdR~*Q4R&X6h<{Byb-eMJ;fsun+3%})>xiS>iD~rF2v=j0tU>BbTrIE^BWL8Rh~DOA9OMZ%qf7(XZV_U+ri<%xoBxd!|W<++sNVoAZM zibRgiqwgN@b5a{S(78FZ(Gr*H!-f-M)9lBH{nu&yx~vl+y^`GcE5>n^jZS-HrBH>P z8)MDe@(T-QV6T_DWvtC(P>pu5I{aK1+9!@cD0lOKe|OB(2}@X2Pw%#YXN54U>vMR{ zRh9)nRx56FIX$VM+}S1P7ZRd5C*`!S>VSFqW`s!$?5EZ=vD`=q|B9liLw;IVm~T{- zjlV1E8*b~<_NPzh!KQJrkN@FB7<&(~llRSX~n7g}Cfa_!tq?}vunsruL$JBzO&pq$gMw3Ir# z?qvV=?bVQFjtLLfm*$>73cDw7i-|T6&UmSPx^;Bum)77!6jag-1UY&Ze=UZAsz0kQ(6?7SxK29X)@k;*? zX}eGd%B)YGMKFC)=i$~7-aGZ)HfPSF987)br>p-q^&P7%tU$)F>hvcz z@MS48Od+)iHI%DgNK4O4RU4?~XBB4J;jT^Yac{{r+Z=OO35&aLn;lFi)b0Xlf;y*~ zI(Q5@IeC$Vclb&Sbe2Avntpi--#wHU7L7Y1yjn&bcexfYFKX)%jgL6>$ zz+edm(bGGao@1Nlg`n6&7@w4T_7u=tH9z|l5fM>(V~RK{f?`}s9eh%!f7j{RGrUnD ze`BXM;oO28nb|->6rpaSV@$WPIJ@{as9V7H2Fe0w*tm_A*#erG<1AFl`p<<2 zJll$Ye|Z3qZUE7KDc%GBSmPk2ts-Cv^9GqExNn) zYEa$N9Lp&@y$9n&+yjT7H|_1W4L1qH_x0|RnAFPQuAiH6@23q~yx4EMNQq;Uaac3A zHKFXQ882z_bKYw;wDV#ywJ_tHGBPQag?v1`1_+2=y@;qzx$In{0xtMUBq*#aohIRX z;EjGaiYXwHv@HaH(_g`sOIlc5{?%R&E_&Q6LS23SPGRHjkD9W?DO<0xPqDEv=RbXn ziH-)o81A#1|X}~y4ee;uzaP%7!aI^}#|74R*dtKgAL80?@ zK?_=!AMC#`#Zx2Xd~$&sL%vR<>D*WZ2&ku}ut#US-3ez+Ri?xR(KP~{)azrFItdP5 z($bSdE<4@*{kaMu9L;jSmv7SFCALV`F}~1AN*?Lc20Qd-lV9k=2G%qap?pI_9UYVy zr*35$cDkW#=2?p4Vo$;o%~xO6e=pxaMXIKQ39y@y;dEanD z!Nm6QrAwqQ#J#sqs;zY{3e)f6BU2m`+K zyuM1QnKkRGYjTcN$$4RY7Fbcy22=XN=1*tLPJ;HYBb>6}dSzn;`;7vj`-;LIYEELk zz&p<*YHe;k4ooOMo1JO`+)48Yz9#!=c~rcV@^n)Dc5JC*rr4fo)LJOOw&?G&*l;qY z-P(p-b*Ou~QYX8InP8$F7;hP_1e3by;$HL5U9gF=NDwhOl%%{@3iyoF)$RAcH6B0p z0eh75JG=Itt_TArz={FKGlApNirY+lLVVnAk$sT%D6_JcG7c-5&{G81xWKi#(pz!3 zoXa$ALtJ3ad9gUGFx{<{9$|8h9ElNDM8Nf)yTDPeaX)H^EnKBF563=LL@A}K>T9@c z`&{UmX=7fDbmXe-uvgDF!U}3Rp0=)P-_`J6gln153co223jl4!St<+>21Nsu1T1SV zTAH~MHpX(;XPnmBZchH_YbFo;8fY?$SWeSotaH#Nq=DG{Qs2_roDEKL6f_9Y)lX6# z{#HKv4bt9TrSRgM6tFr}NbROCrP9#UWE6?7#wH<8I&rIBF4ZPg1Sx^q|D4og`>kmI zA?2jUz_h_gGTApuh%qfwBn=w!rsZjsNO)sNcg{#*hj}lSYI=G^qF71KNQ&Y*4qKSh z_ub(UX}kMu<2fmcJJ;nwDuAi@_$SJx?LR2KM)o=u7ajAy_#nHmaH?j3S&G7~83&=E zE9};u&#E)!n;fC0VCb)#{>Em&0`{y@du7Dw4`M{IJnj)5etp3{6u?j%*@W{rc#*O0 zIusv4(o%Z)nf3IB)2$USua8elflT!Z*bw!=VWj4tM(LdNRL@h2K?snnF(Y-E%G@(2dz4wp%km$Uy$@H{+aU8`s?z>m zuD2Kw)Zq?HbV*{lq?W^P7XmGG5xTRjL%X8QYXoFdk20MPgA*7S7|xfhmO5|{AARTPV__&PgFXBAWsQ~)xzLuCWEz1nRzVeZoOXX+~QjbEJz zx*#_O*TKchD^e|#GVkOU7YF8q(>)~19D ziOB##0aLrq?XDfn3wo0BRNHR*6n_pzoR%V7n4UwmSb%9TQpBdM5iSA>$tvr~5(qAK zb(Kni`m$HA^Y7kbvTI9W-TDpha*A1y*~yY$o&%_}&LLz~$TIuBi`J5lm<}n}({d1w zQaV;E5dll%pDNawCLxo#Wa=A_dpSKS@N5&OThH^YGIEpTEzFZI}Y zF&vZW?E`rYw&J_{7thz#RM80_{8=u6C?KQKdvoSgCMqQ6@};;_X6syGI#q900B8Y_ zF9QQYr?XK|!jYs#(G)<7f$L4`nDf&8W80~G8bhEyS_fB$Y2yq7NnOZ+1aZ9p7w1qD zaf8N#xWFFL<<{Mxi3VYGm-$itUKYswk;f0%6)<-eK)QnqWPmTN*ZG#I`HAmznjxhce z+(b-RE1J|sIpOgzPkuu|fkA7xK?w5`nbz#S?(FfjXk#Ch-F~RA_0KeWu(QriopYU8 zR~XG{QnP)&2v8t?^L`Idfq^Q+i-qAyHS$IK6B<^AZ~W^I`A!>`sR4VId7SIz@hXt2 zoxk8)U0tiAt24z@W1z1Q9T(=Y>E8b-osYJH=Z)z^?ZHZ25&2Cw*x_d&!|4Xg8>JJ| z3bYedaJjSW6MWY}L`kYAScB10HmHNU9ljbL4UdX2OP?0C-`bxt7?0>G14WGW3U<6y z2zrmqg7?lOEymo;+|sVYc4Zwo^}Jy!18xc-=LNNS^O8k*XBo#_krDUbo0yh=COonc zID`9dZIzbxd)3#M528m34WBq3eHM1^TJb;r^XODS<%ZZB^aI4$$I6fmlB@3=97-!o zKtDN8gTdE?h!`-)yJ{bTI#;)N%|HIE-Zd2xpgQ~;oY z0rZRe9Xq5j?^xu;gWPqRhJl;P4D><=2vpToW(vWSVAU!)LzCfejJc}8-G@%=U(SC# zaIIP5cNGYTZ%3{lWS0d9+}Q?|I7pQI@i-q6Ds@-dzgA@&X?xQ^)MrGobysIN*{Nh# zw2M!Cunw2VzvvnhdEk&Ey&yrrud6}=8grmI;M*`E0|f;J;yuNv?_CC za4`LjQOfhaj~iD{glD=OeloL*Q`SESljqzy`|Puy0D@)q;jdrv)jx0L27^I2|_!W(kzOCN9(^mJ3-`%ujj6Z#Y% zGe~IetW7E@{B^;-@lS-Gh!OGQWMsiDUt*HK^kyY`g8Zd`egyWa?CaPqmUHhT3$@*+ zH*rdo=Vm6g4coff1;_YLkI`GMDwXHp=-orSy@B<77pPW~MC^0(%frXcolcQr1f1+0 zJBbBJ?w4nh#ZK`%3I^?&yMRIyl}x2+37#s z1j%L(`S?H@oLTFWD(Ow9RyM&Y0zU+?yCP&6gIQHG)Iy+T$3P?iGdC>Qb=Gh zcUun}onb+x9~3{Ds=0(rzdiF?7hCyn-g%KTnLuFHd#X$+)Udw z7Y7{YBQ`;n>;%lUnfm&PZ3~t4v09zF0f`UaZ-qWAIsWjSOgR`B1OVU~lx$!=0?zEM zyu4k4_}yG>{VeEYL;W}iQIQc5=2Nwfi-Ud*b(K+35$)P##lCa|dc;N- zDf^6j@Bn(kkv1HHEFvy8X2H~qN#dR5$gmQ~Mun{;R(owLhBK8fheu2W`=RM+DbZ84 z6*6B;%_oH2mVX1BE;ldt2BpJ0J3q8YvB9fqy*w>yYHA?Sd3OH1kXliasM9!9P5PTH7e!cJyfTm|AiaPDLeLw3jQDDF=lx~|{6W7L^ALY88 z)&pUGMD&G$ygYM-EiWc>6(QesBvhPSZYe$1=Ss}1p2?_ENQLA4R>8q?kPrYT0G7B4 zs_zN*g@ohY{!(rIX~3sWOz6p9v5sSKcF#2iI%)>GO6R4$vMlABY~-LS2XH&!hz%2cLB@)e zZlZLu5pl++m%?;(btiGXX^eGFc@4!Cz7_x$18J7$uO#@^=(XML*S041(@#U3mIpKT zq=j%=(6s{Tak+E8ACHeaL$((FVifa1dP>|at8_Y+`VL+okt5)ngg_WK1%gD*U`FAa zlp|Rlt;zrp1(Doef^jIXO6E3z34b4p38N(KNw#T2L}|vvQ=OJl&7S~Kt1=wp2WY{z zC>OUXK;@k9-|NVIK+!2qW96!ba?g{H1YBf>-+s)W?{v7cxf>F=wmUbHL`5~F>76pe z$b@i@{FIU5?&s~D243K?w?&UGcpf*xaLQt~262^$9^@YASq)b12CtcGjB|K$ylXej zr}GEGIcC_#jAQ7V_e#TF!v`bT$^5q9S*sI)q4-0gB*4rS>x!wowS4vR`Evg!B-2Dy z>(qDS7R=Ik`7U97;0pkjip@NafN&zKk#f*&WB_WR+VWtiU}Vua`s<*rlmOnY>t?MT z_JXd`&P&KX6nSf|@Pgpgg4UP|;_25Z=mdbFj82g@NIR?utDv5srlPK`uHM5iPQ!X% z>cQb>=f8jdZnwzSGd?z^sig%yhGYA@FM^z3|3uxl8-SMRHI!#kR8(Y6*i{5IffPk| zqHu}Hw#5HJB02*S(fuzHQHz~?ad9z3f*`F&JOzH9Jpt9=xDBW?|E+g&78cI9VK6z0 zataGQg0VSE#HHnVeRcIR(8ln;(0~1Z(SJurgsRdL`j2^{ik+=6#Lv$Ptnj)@sG2DG zAZu+D%Ox-|9ziDu+b;y)6zSuAVA)lAmpz!V(Lf(VLoq);n`-VjA!4p?>Eb)&$$i3u ztE#5t#f|sQq}A+XZ*MHH_e`N_yj02H(s3l9Gs;#5r z1;I8!L)RX=8ZposV$kT4Qp{3Rocyi7W2||oLeI3v&;t*z+Kky7otsANsWw4$>R?vo zar%vKk7HVy@}0+og9LTD_#^rpghmSgnl})l*7!yVrTZA3+h89Z6UN^00#>z468)Cw z&6H?JxfbU%Gl9Cu6k`RksIr_=0qZ*_n*&E~Ewu8%S6_cpRwe$c!=fnyT6lcjrmZl` z+%|V$>ZIgo8phM_EIlYBo`aw#~`H!FuFDt2tc#(lT-p3x4WtouxzIM1sKQbze586TSX=_@x z1Gu0U%aI`Nu#9~@9^R>_V$@(`CnYuYxrFi=atIhkp&s5dZmk4(GZk%U-b*PAEB{>)nt%^}u~X#mRyFHnC?7+9JxBmhgtS9`7NTS76Q1cpwR z-@>|e{K_&aE-$4MSvXE=Y_w-?uE^8whfQs4Yz6!KX-=qmOG_I}PJmLYnpaAjezZmp z2NNf}L@+5J;1R;L4k5AI?T28Vw{yLjsZWYGm^?ajCe37yXxNat$9+y1CQ)0Ug>_gP zo;&0fuW{e3$0Suj)42_*lhf1FiNE0hLIkr0t1^1`kmJE)8K+9ezM~`_qv|rm-)x>n z^W|ZOI!Evk9=m<;iYN^#8c>F1fHtFdE3>RBzsRnVZIWNT&KP5*(K%L0+T}zEsL4f- zw7mmu zFfs*>Kn6L$WT|n&UsGVR`*z2_#S>R4fwjNmiCYHpsco9WAt|l1K)tc0P&fblt%?IH zt+0+)y5JPtYv4>lP$?}mBu;mQDNS9lX}@zX z1!#(TXFpt+4HrmDt=D&g{%YzJdGI)WN)$xrmR)*|OVTX`acC``JoYAPYOz!kGj`p1 z!lwyPbGC*s0MLZL-dnE#xGb)XvtIJba;9fCA_64Ge}(&!H0Wa9Z1Q!e_~1*98QC$f zAKT@T_;v&*lXrXF!y`qJpI-nHkL992tJ`Vk_vwRMFV>PO@=U9YfBxK!;0>RC8J-kn zp`quD|M?J=M)m^D|qdcRRbON`qH?#Wume3OK)5-` zvZ>E~Z>VS;_8ji?7K#C#b!KAqo-d0n5e{EppLG_)I#H`$$c8oul6yy_ca!8^3xTxs z20?^+`-Q|9t?Bc|VQtk4?4(Zz>@shW=X9x+)k=>JPfwpDpy$k-kCKEDgX&>v3DoX{ zGp4SO?RJW1vq0rNU($4Toz~F8^&gxd*|QxC=HGFGDS#8qW+y-X0Pu5AgbEj{AOgJn zBg|;U5i&=lf~{nCov`5XNx!V?#dxlBJ&vy?PCc9ho)Pety+X0R;D`uE03w2A0rEE; zot#3!mjf0**H_O6118ah58HjK7u77VtLvXQ76Q%Fgrq8!01E0?`y9Y+8$8Bzb#yv8 zx%lR~r5t_?T6IzrA`>F4_6tZL%zXl-Ss_Wtu(Gm@49x^zYOrSM{`E)~R6Uy}#GO>) zRLHL}2riIxvRv|KRh6Q6)DNrN+IVYcM@4v&aA)+Jfl6J%v+&codPQALukYq;ds+XS zi+$)YH%3~%qom?H*0Q=s|7fjWzNyzC-m2{>=joJ^FaxQ`1iBjrQmA(Zi{A;#O#Lu_ z;&4Hn&<&c(y`8TFy9TYaqJQG`+_rxMF04I~-Z{xeJz+*q2>RJ#e|o^T5Rhe`Kn5b8 zr6TLFHdZ0mBhVSyw(h)6M{5Rp^Cc?M@*lgt${A4ub_|RlYca6gM>D&-@o|G@N|JlpJVrGR4<&fDr}Zq1tqy*h zsQAb^Xp{uk)I2*2(dn#A8G@#cC=C}H_45!{X~Jcdo{L;qo}PbKR@N+d)J<_mh+Phq z6&X3Jq|AO<@a;(gan0=g>M&&c!7KUI`eeGzYV)g;)lO%*Jq89+Dobh!vap-6!F;5y z&+oGEJ8d0HqeQI$_Hg0X(;OG34w)@;TU*w{xfEIz`3$w0HB`Jc(U!2DaDfwaUrw*c zcfJs4dmH1D67h#TtKHlB*>L$$5^H6G&Av zUtsEsG%#6?QwRsW0$na`HMgzU0*_?EZYwxU_6ZwXVG&5bwCR}v?*(k$DbC%xd(aU{ zivDV?G?}?wa8k1CNFYG7(bGfRRBfoPzJ>;91ywjA@HSSci>tiHS4{L)rp!Q7kxIj* zM*W;bI;tW(7$={V>D9>%kY&flT9>F~c(FWJ?OGK}-RrJz=Ie&})KWu zcJYKN5_S2!ASJ%E4p^;sD?e&3M0y|XIRL82(Og44)K~?!9oj`8I)z7}-O+#3X>Y-P(5Li30P?H*1$y%5b3q;EgCggBJs9Pq z#pAAMT4U#2G9^KZik!QfyE#1!}ZJ`ZUchGc@EjuxyAm+rbazmFkfRJFT$Q zdX+A?);uXK6DfRCl2i)wtBw46zpk&weuT+C33%}MvyD!YlKCxUfsFm|8?5&VfK{5LeSlk60;COc1@+%bj&AAhZ zKz5VOWfGcPQo+1HWqd=Adu$$*p{6j~#!xqd-HK4q9RRX^=;0FR76Ul^{Cd?8b~uJG zt{(R}!7s$$&vv3RWfH1JSVwo8%H2z_DP85?Er}C~FJ&{GC&cwVGHp$L1|P6JnF{>Y zG`7)R{Re+12*R*cpC^NK`^6bRNPBZNgfGbbhLoh`O8|(qlCfX$qUfuE)D`bJiU;|j z^K3W^<`rnnJY{gf+WT5bp!ITfDJ8Z3Xf#Deiek)pHGls##GNRW+LNiRt-U@`Do^nd z5YwRBK&Y4j=nnzyeqTgh(EZm(w@3P_c9ukODGHE{!CQtWk3a!hDxVF?4AuCLoLsDg z)ddC6pWX7aa(%S@`*&3e_%H1xdP^IuT=VIco0YYCrYa}~p9)e&@s6qQz&eF+S!76F z=J=A*3ii5(O~TPnYni25)-upz54;9#{u&-N{riVc_t-f89v`&-8_Gvp$6c1Rr6zra z4J*a9yJMn(DFMUIQY%M)$5Sx@M-OIeQuon*UmyOfyR9cn;$jtctf(xB zIsS?994-(?%)eAM{!o^u2YR;=-abqc?l1SG6NS~j7J>7!hBFIb#9K`rot@-sN*px? zvx|#NlOp1XZ@)pfleKTC+` zq96a{bJ5qQ%YE_SX9FB)8tP*rb+vRsIJaH;{Tnk&2WtE=@mXBWbl$dCf^D3T&ohS| zl1r;XF4-1wg5X5Z8iYViYU)H^I|>j4!3K3h8YB6yN}pG5wN&JdIb-JMF^`N_`9a?` z8Ahq?AIuW1fa$)apA0~vD&KA1zRM1~e&p>1T55ynBmjCge)ldwd?*dntLQB?uyW^3 zMppq-(;ZEi08EX_-%JhXUrbFY-)BEK5ncqD{_ymNung#+wBPMm_~CVw>UBoyww;q5 zwqLAt8nmdXvsbW756%pmnVAD_r+Gx;0b8Mpt1IgGqrpMV6S81s16DW?Sj_f+vbS{~ z>tOo~yRVC31MEYF8i*tIY2Tr=9DbCG= zIU8zkM_67!PX|VR7p5MFo%^I?8qy8L~T}{ zo~8GRol`9ETv&-R3~N~4C5#ZY*#+1BAj6cPda0T%V$?g%A%p@+L=lqcm;VllUluzf zou>XJNeDO23rg_(pdf79W|(Yn(jB5D=y0=8NebV+ra9!uUWT{-&a2X}QCd(iS*&W} z8$`#Y#}V;jq(~P)vMH*PuU@^{*pBBl|8)Y}Aoim-n_2^rT;y5GpZC;(c_Y#tH#FLg zliOWoq#ThO_T%_^$y({Owt?pEKs;}z_|Yq0WrH7Mavv)~vdeyKHeG}y+~mR^cd9VQ z?Vg}DfPOf}KvHf?>SPoqcf@cfN8!M>L^*ZM7eI z+k=(i$LebqasX)ew?zmS(JDj;+9dJ1)5xbGGAj75tx^= z04QDE$rY(O3j6AQ_s;zZi3g(~EPQWQz5VbW4<`sLZXg+B^*dZp(OEV@190YOXHw|G z)rKk$8FqGyrLCl#(9sHpe06PJB3Umu*X0`@PDQs9l9mm+( zE@URaN5QlxErXTHAp>(g`OGh%Uul#Jd23c>@>`!k7u;7mZU#eiH6m{T$;k!XF@arK zi9x!p;vovQ>y!sM)CK}40k}oN|AF~G)PF;<+OgBaCvgC%2|(YtAp&prv>Se5EM%q~ z<_K6Cox9D?G?)XwX?0*_vv%D0ki9yN|sAL zo(os$=zdjY7esVrI-(azQ>A(l?`21Zd!~QBRXq#T=Ef*~5z}2xC zMw;(mo!NLe*Y)dHSafEDl6?Q4JlWoB zd}hqg@7(xnIa&O7FQ=RSF)Zyw0?NALZAlbHKt&i(Uj z{Eu(yUoJcT^X45AU;j7~pXv>?`$Tc_#{by>z|Z)?NRfA@VdvzRd-MN`@A4ntLGrce zyGAHpyp*fXwSTGG|G)GR0rOxVU=6(%CyJPwfQ2wBKUb3P=&4CW%+1DxUDPT%+Kz}y zLXTyr+fQx?84- z0_4$A6Zi@94ED}4i{D~vKWfspk`P;)a#oz+QE+py#6LC$P?WDHeiIFxT+Us*DE#CJ z0AYY@6&_#7*o*ARB`MU~Z; z*4XR9XI1C5(T(LDs}CQJwX`D3El$0^_BA?M(QO9>XBRgu<`sk)C%{j>{k@lP?+U=s zHoqUjy5kND>gwWFhcFo190V)B>uj~KLVo`J)<7nycK*wAtwCFRTj?iTY3!9U^GdN0 zQFkIH%e;*k6BZ`2G@c}QT(*F((4bTws1&!w@A!GV9Sh$mez`hzN#|8`2qWwDL#0Ii zJ#e&Wy89{z2S>T{mSFDvgTupi;_=Fo5%2(P*xI^cedUzyGRMG#`-Ha&71g}$tG&1x zWT97iruho5k*d^tMS#>V|9(vzrswS>x{3*K3qm)vjXXVPeq{6mTlBAA?U#6u_6Lr# zmygNCkM;}nXtxBYlA2>5Aa){^@?iQBM&X`mu%s#HE1f@02iuGTh|$jCE6<%;h644X zR2Ziva9K~lQNhFQ@*_M6^Ou=K;$I%7@roZxZmzI3U%iTSUT#5ZryGbw*`c=zvGkdW zbXnC6w&VDtow<=HUWT6TYPZ$>W85^nsjp8;(=0E+vj!Nv0ZV$Iwo25qqIm>05Rb3k zZe2%WP-SvhM|}eWL(ko2a2|4c=A8vIBfvnp5vK}}-G|317qcp@7YbEL$!JA;Q7HL6 zTqtYn_BM&BryMSDXV+HG!mL@E9?Xqc&47Wzgw7W#;>ED>w1F%EQ;(qkQQUVvHT8X8 z^Rc3cASkFbktRryjz9nrL_m5k5$U~Gsfvg+2`x(Ry&6goNQg=&5L)OZbOHndgkFDF zzyHAV?m2U3GLsjl%-v_7z0X~Ht($5-t}C;@&z4l_&SVVEJ^Mf>NlxYru2o-{(~nnj z&D5DEfhBmn-LJzY#auy#ykl!maX-X(rNQB_HyHQ#vUOhbzsBCRb z`MOc=b5mLwiz;4K*ra2sDoB0P%L+4em z(5lzyOMULY_#^0qDyp!={+x-4X}RyL(nszwxxAfS6Tpn4LrlAWcaVdPO^5o5t3V&q zMGybItX=x=Jr=AL5iD*J~dS4+7vU06St1*!`_k zC|h?<4DqTK5Mf_Q{g!X;!O>{o@ZyZe5Mec*R)qrizJTOoOpxtu$O7o7nK%A*dki!G zNmFB^|Ek&3Tc#*r-(3lN>|iGHGcy%#X&XuxIW{(iW%j)p`p&|_!o>xCT7}c=Ns_Q0 z{8`%F&1H-1-}=zs-d^Y<^5kH)7NCBXf#V^-Rr}b)1i!I_fqN+w?i@4$-_ts+EIa}# zufXu#`eb~uzvsyxQjMe1C(1bjLB#G|$orfMa1-nEqf*{ScdwZ5w7T2lv~q%;qSi; zcW$y;Q9vN2Epzh#o}8qL@u!7Fr&?VVCccG5whya=|I1b;U+u3`^#br?`>~ir<{*9e zvxWA(3IwV|eDZXoNkP#I^1RyjWXZEgHxRrJ2t{YbMO3;}NcZyb zqR}q4GmY+>tvRPtPVXJ`#o&3H0leZ;mL11S8%?i{4zEv+jhi(E&dqN2($FSGLZrc_ z$rlG^6pQPVQj$mYj>Lg>fcAU<+e7eiANcCnrOb63xWq1*(XJnP%X$Y4o-zSgmH^=A z844){ah%7Tkey#nAY+}o*09(tprz1eOjRCX5FN2+2ZC4VPj1veCSBGyCw!WalhZOj zCIJ&8BYD{o;$P^a^sioN5Ljw%}=?%?D#0bs?Q z2~3n<{dQ(%Dr4c*xl?O9+Q)}R>$|ZN)rBVUA#TNaWknxZ4cPA{E#ew=l3$X;(g^dk zcP(tphjAJY*GpZ%C|){mS&xAAutqDad-Y{ddSYUcx0H5?)2IpY=(uk-ZGxn>0Vtx@ zy0=Ik%fagn&f78d;Hk?&r}E85`%3=&%OY=r&Vo{}0p-^Zkv4f1pGMOgqFt?51{Zvr zVV@*#&ukG=yKe7$Nmn78(Otu`kL-L-VLEJL#rCJ`Bd>(Zeh=9uEMv@sx-cyr0_?}D zltt=XgC~PYav=`cb#>0>hl%=Pl|G3`+n$?~KkU~5Ev7URW31WQ@IXA{?X-vLs!c|? z{$!6;6@%{|9xf~|)6fX1wGrfV+(@328%#i%(TK0F?~rv1tp;zui~rXII;0I74lDEg z=+fC>xSC1H#urzIi}8yf<*$gKA_9_12E5hk;fh|jBX2I2Hcg&~CPttmw4+(zI|)pXXyisSPAW%H>%6k{&L z|6->-jg@sMwCJi<$SXxqiuY5chDU^r_M5gH4yKEBQYvJcho`S8U?|o(_%l0lSivvuI|i;8g0ziF=vquY+x-9sEOM zV#))0&o=|Iv<)tq{q#GsJMHRC%gkwSl8|x`KQq)nMk?@v+fH>j*WbtlY}ZT&_=N1= z5w&s9oE`HG6MR)^&&l#ex8*=(!>;xw4NW2dFXQ9wxxpH*!56Tx2li-4Z?hPHkl8yr zYP^v=`7kO#_KPitUAC;8U1R;Nxo(e(g^eH}kR<>5y>hU-OQGSIvy+VshZTlBpu>pb zv3lESr*x66g9|rwcj{--l&--r8(oQC2jD6G5O$ZtjkN$8HiOaDKSGcE;B^(BG-h|x zW6BOv(bKk3v9an#?m(a6ug7}l@C<3GP4BPo?s4lPzNdVyyQnn^i<_V7ky30(V2&?o z7{(fr7^e~88q)KR?UJsDrlgv5TMh1FYxaikg;7s-VRUSJYkt7DDQ|Y65$fcEbw75f zZWoMTHbNPdA)P&c{EhK}1wV#kzM>cUZkv>LScs13-J4RO^{Txi|E7m`I_T0WE!9MU zLB==H>8RE}n`JBNqT<*!Jl^kEV=oP;EIoDtfj~U>Ko&Wlp=$V04o(}o+x*O;O9haT z8Oa9yLubxrhZmJCseeEg)Pk4GL9GPmTKb=%fMgxi)O=2fXj^qAZaz$I)}*=tMHscGXAO)B=)9D%i}eh}_%tBukp-(B zgMu$?rPA_4*eUz0Z^-4AJcR#cX!#!rNHmbVHsCzU5hc;C?(8 zoo!EpO^WxgMC8j2vVGf)c&b7%q|>KOR79?=trh`y{#wR<>&MnSgm3MQNnv>^ZAGcD z_lIu=EMaS9XaSDadJ(KL2Th5>ATZ*Fg}kcewBcZxIy#ketGgkw4(e;A9jQB*=u1k? zuE}T_sNxnV(9VfNr!hECxD?!x@8RPDd7NOwBwreWbyUst?%$s+0<#Gj36LK7Wh1Pn zDna4cHnq`!{$$$-KG)^O*YGRB;NEe&SWGRsgiZS#0noLe4 zaWc;o7H$g{83av^eGh2PpuwYrJf81yK|0cC@Uk5JA>Lk#K-_!QmPtHsUe8*~4?3F| z{>1X?fsywfCDu(vrBtq8tqrJ)qieRCTNPGru_bOm#Q_l*gL&jm)%mWa(JEVr^!uM2 z=}`a=w7wu^S}*fS?6Ys3qP>fsA{|cAITAj+DbTkD4Zo>5y_+B1wcJ5qJaSL}as!(k2D z<-il}W&GB}h%-^;*3VbruMo`faSrg@S~+gSM7NNEfUKHjO)ZQqENR&m65u~ z>hm;H#mi#~YA-n8Mn?6&2`c$`!|%xdCjBazcjL?xpOyxurj+rOal^`%(7xGv^T z5zR_VMXAwrm@+gZ{xtSA57c?;bUwz&+_m{Ecxr$a5Kq~ydF;PohQSp6=fBxDp~n3d_ZI2zTH}zc@7s3Bg@uQf(AW6KnxPpcnue#de;qfG zF)dGn{K1U(7sD|%a&yn{sU0qw(ml~$(RsdD{}Cy-#*zjOM?A#0M+zTa#{X1VO{Ovq zZHqBMSZt8A80!0sYX6M*3P7pYJ#^1!>dbnwBnj3P^e?Ac7tBkV6gJ_7F$M!nOvk_A8& zV^q;cS3k+lDewk|9%(Ba&St$ox||ppaIKz-fx*!q{iC`%on(kFcCD8P+%l&E=#iP3 zU3Rk+6*xvm$=<8xSMJ^t#h{Zm1({k_H>_Z*5kOX?oemYgx z5Z9%yvrLE`Y>($*&c_HwY(BA)jHDNz57G*i*Ir5yweU7j#Kg4uaQ0u~WQahx;o$LcH=lonoK4S9+ zQ8eiCOK%$@RQU$0Dcch188#*5ZHg5>pkyx~*Ff$E>u7OF^YUrenB@s7_H2%nOuP{A zA-a4vm03dohZgq@rG@#9%0(4O7qF4Foh;#b=8=IGmMTD+4$9%$Vy%o-X8Y z)0B;wRe>|H^j2DxqSIwxnupsRAmmzY`GCI2oLX_H<|BOY!I=hL79>3t+~nc2{;e0_ zn{^UH|B}N^PA2w_Ec1-Bxp%D20dd3l{=6sP)AxPgEJ25m+1W?O1&2)#@$!<&g4nA! zSOaA)D!^4~si}v@ek>EH(O+^Q*!q)MWc?rd&)a?ovJhO5Y_OuiCDA%>?3{=E{5x4X zhD>nN(q}aro5I-GMAVVPK?K#uevxxC%XvJ&7vB5a>m3oBEyw@e(bka`U^tW6Bnwhm zS%A!pA1sVIX2t@-VRhBjRy9UGa50&gPxTUOuxqr<#Ez;}oscxK%A$@cGy00{!Z+M_uExXHH@vl=<^Su|y$Y}2mfBm!Npuh>G`Fs8+i?iWjhCVNeBTb`( z4L-FnY6Bwccl|Z|TBG0bK$S!H7&e_cAuYJBuH-FGye35Chr62vb9)T@M-&GBt$H4T zU0evGrb0csM_XSnMk}8V3ZD||TgFdHHIy9rIB>q`)gAgzLZV5yV@#^SeV3Bm;*R%P zg2PCg=j$;b_Wm20RMf#TspscdL^fCTik41b_i`Qu8U`Mm$&{kiqB1IaQL;g@vMc@p zs(PxH@7urL6{RYH5@e}gnu)dB)X1D2PIp%$=KrJ#xZ>nBJh%GI8+{erH8j?sj=QQ= z=SR@g?mxBb^hwNJK>~@KMl7IeR1SP`V%XD*7#$V|ksVhXPC21!9rPWCjhFYG@4fI= zeDPwF(#G}BGV)?H`KROPbrv_2#ZdxQHBxO4phXmdFps0~kym#+q9P-^N{hJ;f)4;# z_e!_xN^QL^^se=}IjLqBvAQa*Cs6+Jqs+7|8|z{N{o6v8O1X=Z(`eUgWlHVS;RjG) zQ-&=HN>+eTVvWs($)&+1q%8Xw-P89SEbFDwXqB3aMp7S-h353E#H(|+WzQ*l*iCX) zfC#vSXbKAAjC>CY9r=2h?9F1RW=>pJzA0NX5NB3yz5{dJ^-^hl%#5>gzz4o$V~*~H zr&~!0Sa9@>>1K?hRd;}>i79>hC9|28lLN*A*2`P5!WSzdSc8Xlm3FJtlIsn!Jq|m( z@_9?G$IE-~=c_;}RCfQ5f;@~wh;kB;_I|GW3Z%UT29S=wiOq}f89x?y;NAqER5Djx z@#K~%AP3Xqm)>X{-~AzV<@K;eXlhAeZ*o&-+fd)HxH8vwc*2~p=UWNZ{Bpn9^(I7Z zHVTDn8xpWvHqC@_|C_BiFi`Wyk94qU{%)<#B_PKleSc*%KH<4b38Y*qRA2h}0XGmR z3(r-ecbw-NbgUxsJmC#K$Uv2CZm@wsI%h?TT~^4lQ77rzi!TA7n*#f8r&&IT-;AV@ zNg@{))562s<1kOs&CMxpgP>SdUb>5|p^tNYg}9JM%PVHLDG4+3b3p#8(aNG->RMLj z7~J$t>@+5Gw5bp@qcAmS44Hx$XD0wbUK%G@4R+&bm8s6-1i%Te>*K-|L=DV^71F(S^ZIl zR!P>#)D#wj{WzIu3mZ3AbtYsu5xz{(8R{oVecLS^+BqAGVg@(TdXxlD`2Irs9>*G7 z_^)|cczb_+&7Rx1$;;0Va^LB}pw2CgJEuO+X#g5{WjGs4OHyt`XK$agY+{@#uKx+N z+n+rFP!UKT%R}pz2b-@y-Bq+sBBUd>+TsB*ho;6W+9l;bf9_@xgAi^5Q6nR8E!?_m zNXSYGrAehJlAqe^;5B=S(fH)siS0oaGi&w4_;}Hi?KV_(yEXPyBehaAGf zO_j|rIM;!!cUZIzxPx&4!lxRB`dI&sbK~}f>l*1QRx`m}y!p`&>eYm@4E@aPQ)}DX zm$xFITi{B=D_R$)QGSyGVvC;4_Q6{DkAR9Z#-cXqVOECZAiLw(t#y!c^*9%}yPfc@>K4w#VjxT1>HtW^zWR z2d8?@eMEfqqo*5y743iH{4CF(sJ!mTgUO0nwR0Wdhc}j1=O13SZad0#d100%Kgi}% zT4gT7DF64i?tdmGNuoyx%~Oci#LnvwJ_-s7R#xylJk)#1n`yQ3F`dkgi`{CX&GQqa zDkjD_WNzL%AK+_e_Hc?l9~@?&Y(NabWN%!}pxUXR{P`-r&&k=t?s;Bpi#HK Ob5>SVSE!VK7y5suyWSxH literal 0 HcmV?d00001 diff --git a/content/french/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/french/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 0b0d0ac68..b2160c4c7 100644 --- a/content/french/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/french/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,55 +1,106 @@ --- categories: - Java Development -date: '2026-02-03' -description: Apprenez à ajouter des annotations aux fichiers PDF à l'aide de la bibliothèque - GroupDocs Annotation Java. Guide étape par étape, exemples de code, conseils de - dépannage et meilleures pratiques. -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: Apprenez à annoter un PDF avec GroupDocs Annotation Library Java – guide + étape par étape, extraits de code, conseils de performance et meilleures pratiques. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Ajouter des annotations PDF en Java +og_description: Apprenez à annoter un PDF avec GroupDocs Annotation Library Java – + un guide couvrant les annotations elliptiques, les commentaires, la licence et les + conseils pour les développeurs Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Comment annoter un PDF avec GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'Bibliothèque d''annotation GroupDocs Java : ajouter des annotations PDF' +- document processing +- ellipse annotation +title: Comment annoter un PDF avec GroupDocs Annotation Library Java type: docs url: /fr/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# Bibliothèque GroupDocs Annotation Java : Ajouter des annotations PDF +# Comment annoter un PDF avec la bibliothèque GroupDocs Annotation pour Java -Vous vous êtes déjà demandé comment ajouter des annotations à des documents PDF de manière programmatique en Java ? Avec la **groupdocs annotation library java**, vous pouvez intégrer des balisages riches—comme des ellipses, des commentaires et des tampons—directement dans les PDF. Que vous construisiez un système de révision de documents, une plateforme éducative ou un espace de travail collaboratif, ce tutoriel vous montre exactement comment démarrer. +Ajouter des notes visuelles, des commentaires ou des tampons à un PDF de manière programmatique peut accélérer considérablement les cycles de révision, les contrôles de conformité et les flux de travail collaboratifs. Dans ce tutoriel, vous découvrirez **comment annoter des PDF** à l'aide de la bibliothèque GroupDocs Annotation pour Java, couvrant tout, de la configuration du projet aux annotations ellipses avancées, la licence, l'optimisation des performances et des conseils d'intégration concrets. ## Réponses rapides -- **Quelle bibliothèque ajoute des annotations aux PDF en Java ?** La groupdocs annotation library java. -- **Ai-je besoin d'une licence ?** Un essai fonctionne pour les tests ; une licence de production est requise pour une utilisation commerciale. -- **Quel IDE fonctionne le mieux ?** Tout IDE Java (IntelliJ IDEA, Eclipse, VS Code) fonctionne bien. -- **Puis-je annoter des PDF protégés par mot de passe ?** Oui—fournissez le mot de passe lors de la création du `Annotator`. -- **Le traitement par lots est‑il supporté ?** Absolument ; voir l'exemple de traitement par lots plus loin. +- **Quelle bibliothèque ajoute des annotations aux PDF en Java ?** La bibliothèque GroupDocs Annotation pour Java. +- **Ai-je besoin d'une licence ?** Un essai fonctionne pour les tests ; une licence de production est requise pour une utilisation commerciale. +- **Quel IDE fonctionne le mieux ?** Tout IDE Java (IntelliJ IDEA, Eclipse, VS Code) fonctionne correctement. +- **Puis-je annoter des PDF protégés par mot de passe ?** Oui — fournissez le mot de passe lors de la création du `Annotator`. +- **Le traitement par lots est‑il pris en charge ?** Absolument ; voir l'exemple de traitement par lots plus tard. -## Qu'est‑ce que la Bibliothèque GroupDocs Annotation Java ? -La groupdocs annotation library java est une API Java puissante, prête pour l'entreprise, qui vous permet de créer, modifier et récupérer des annotations PDF de manière programmatique. Elle prend en charge plus de 50 formats de documents et offre des fonctionnalités de collaboration telles que les réponses et les fils de commentaires. +## Qu'est-ce que la bibliothèque GroupDocs Annotation Java ? -## Pourquoi utiliser la Bibliothèque GroupDocs Annotation Java ? -- **Types d'annotation riches** – formes, texte, tampons, filigranes, etc. -- **Prête pour la collaboration** – réponses intégrées et fils de commentaires. -- **Optimisée pour la performance** – gère efficacement les gros PDF. -- **API simple** – réduit le temps de développement comparé aux bibliothèques de bas niveau comme iText ou PDFBox. +La bibliothèque GroupDocs Annotation Java est une API prête à l'emploi qui permet aux développeurs de créer, modifier, récupérer et supprimer des annotations PDF entièrement en code Java. Elle prend en charge **plus de 50 formats de documents**, offre des fils de commentaires intégrés et fournit des contrôles d'autorisations granulaire. + +## Pourquoi utiliser la bibliothèque GroupDocs Annotation Java ? + +Vous pouvez ajouter des annotations riches — y compris des ellipses, des notes textuelles, des tampons et des filigranes — en quelques appels de méthode seulement, et la bibliothèque traite des **PDF de plusieurs centaines de pages** sans charger le fichier complet en mémoire. Comparée aux outils bas‑niveau comme iText ou PDFBox, elle réduit le temps de développement jusqu'à **70 %** et gère les fonctionnalités PDF complexes (couches, formulaires, signatures numériques) dès le départ. ## Prérequis et configuration -- **JDK 8+** (JDK 11 recommandé) +- **JDK 8+** (JDK 11 recommandé) - **Maven ou Gradle** pour la gestion des dépendances -- **IDE** de votre choix (IntelliJ IDEA, Eclipse, etc.) -- Familiarité de base avec les I/O de fichiers Java - -## Configuration de la Bibliothèque GroupDocs Annotation Java +- **IDE** de votre choix (IntelliJ IDEA, Eclipse, VS Code) +- Connaissances de base de la gestion de fichiers Java (I/O) -### Maven Integration -Ajoutez le dépôt et la dépendance à votre `pom.xml` : +### Intégration Maven +Ajoutez le dépôt et la dépendance à votre `pom.xml` : ```xml @@ -68,8 +119,8 @@ Ajoutez le dépôt et la dépendance à votre `pom.xml` : ``` -### License Configuration -Appliquez votre licence avant toute opération d'annotation : +### Configuration de licence +Appliquez votre licence avant toute opération d'annotation : ```java License license = new License(); @@ -80,12 +131,16 @@ license.setLicense("path/to/your/license/file"); ## Guide complet d'implémentation -### Étape 1 : Initialiser le PDF Annotator +### Étape 1 : Initialiser le PDF Annotator +La classe `Annotator` est le point d'entrée pour toutes les opérations d'annotation. Elle charge le PDF cible, applique les paramètres de sécurité et prépare une représentation en mémoire pour l'édition. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -### Étape 2 : Créer des commentaires interactifs et des réponses +### Étape 2 : Créer des commentaires interactifs et des réponses +`CommentAnnotation` vous permet d'intégrer du texte libre, tandis que les objets `Reply` permettent des discussions en fil directement sur la page PDF. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -100,7 +155,9 @@ replies.add(reply1); replies.add(reply2); ``` -### Étape 3 : Configurer votre annotation ellipse +### Étape 3 : Configurer votre annotation ellipse +`EllipseAnnotation` dessine une forme ovale évolutive. Vous pouvez définir la couleur de la ligne, la couleur de remplissage, l'opacité et l'épaisseur de bordure personnalisée pour correspondre aux directives de votre interface. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -114,14 +171,16 @@ ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -### Étape 4 : Ajouter et enregistrer vos annotations +### Étape 4 : Ajouter et enregistrer vos annotations +Après avoir configuré tous les objets d'annotation, appelez `annotator.save()` pour écrire les modifications sur le disque. N'oubliez pas d'appeler `dispose()` pour libérer les ressources natives, surtout lors du traitement de nombreux fichiers dans une boucle. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **Pourquoi appeler `dispose()` ?** Cela libère les ressources natives, évitant les fuites de mémoire—particulièrement important lors du traitement de nombreux PDF dans une boucle. +> **Pourquoi appeler `dispose()` ?** Il libère les ressources natives, évitant les fuites de mémoire — surtout important lors du traitement de nombreux PDF dans une boucle. ## Problèmes courants et solutions @@ -131,16 +190,21 @@ annotator.dispose(); ### Problème 2 – Annotations invisibles *Cause :* Système de coordonnées ou index de page incorrect. -*Solution :* Rappelez‑vous que les coordonnées PDF commencent en bas‑à‑gauche, et que les pages sont indexées à partir de zéro. +*Solution :* Rappelez‑vous que les coordonnées PDF commencent en bas à gauche, et que les pages sont indexées à partir de zéro. -### Problème 3 – OutOfMemoryError sur les gros PDF +### Problème 3 – OutOfMemoryError sur de gros PDF *Cause :* Document entier chargé en mémoire. *Solution :* Augmentez le tas JVM (`-Xmx2g`) ou traitez les pages par lots (voir l'exemple de traitement par lots ci‑dessous). -### Problème 4 – Er manquant ou non correspondant. +### Problème 4 – Erreurs de validation de licence +*Cause :* Fichier de licence manquant ou non correspondant. *Solution :* Vérifiez à nouveau le chemin du fichier et assurez‑vous que la version de la licence correspond à la version de la bibliothèque. -## Conseils d'optimilleures pratiques de gestion de la mémoire +## Conseils d'optimisation des performances + +### Meilleures pratiques de gestion de la mémoire +Évitez de conserver des références à de grandes instances `Annotator` plus longtemps que nécessaire. Utilisez try‑with‑resources ou des appels explicites à `dispose()` après le traitement de chaque fichier. + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -151,9 +215,14 @@ for (String documentPath : documentPaths) { } ``` - PDF (<10 Mo) :**5iser le streaming ou le traitement par morceaux pour éviter les OOM. +### Stratégies de traitement par lots +- **Petits PDF (<10 Mo) :** Traiter individuellement. +- **PDF moyens (10‑50 Mo) :** Traiter par lots de 5‑10. +- **Gros PDF (>50 Mo) :** Utiliser le streaming ou le traitement par blocs pour éviter les OOM. ### Considérations de mise en cache +La classe `AnnotationAppearance` encapsule les propriétés visuelles comme la couleur et l'opacité des annotations. Mettez en cache les objets réutilisables tels que les instances `AnnotationAppearance` ou `Color` lorsque vous annotez de nombreuses pages avec le même style. + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -166,6 +235,8 @@ private static EllipseAnnotation createStandardEllipse() { ## Exemples d'intégration réels ### Intégration d'application web +Exposez un point d'accès REST qui accepte un flux PDF, applique une annotation ellipse aux coordonnées fournies par le front‑end, et renvoie le PDF annoté sous forme de tableau d'octets. + ```java @RestController @RequestMapping("/api/documents") @@ -183,6 +254,8 @@ public class DocumentAnnotationController { ``` ### Traitement de documents par lots +Itérez sur un répertoire de contrats, ajoutez un tampon « Reviewed » à chacun, puis déplacez les fichiers traités vers un dossier d'archive. + ```java public class BatchAnnotationProcessor { @@ -200,6 +273,8 @@ public class BatchAnnotationProcessor { ## Techniques d'annotation avancées ### Positionnement dynamique des annotations +Calculez les coordonnées des annotations à la volée en fonction des emplacements de texte détectés à l'aide d'OCR ou d'API d'extraction de texte PDF, puis placez des ellipses autour des mots‑clés. + ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); @@ -207,6 +282,8 @@ ellipse.setBox(dynamicPosition); ``` ### Style d'annotation conditionnel +Appliquez des couleurs ou des niveaux d'opacité différents en fonction du rôle de l'auteur de l'annotation (par ex., reviewer = bleu, approver = vert). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow @@ -216,19 +293,20 @@ ellipse.setBackgroundColor(color); ## Applications pratiques et cas d'utilisation - **Plateformes éducatives :** Mettre en évidence des concepts, ajouter des commentaires d'enseignant, créer des guides d'étude interactifs. - **Revue de documents juridiques :** Marquer des clauses, ajouter des notes confidentielles, maintenir des pistes d'audit. -- **Dossiers médicaux :** Annoter des observations, mettre en évidence des données critiques, permettre une collaboration sécurisée. +- **Dossiers médicaux :** Annoter les observations, mettre en évidence les données critiques, permettre une collaboration sécurisée. - **Flux de travail d'entreprise :** Rationaliser les approbations de rapports, ajouter des tampons de relecteur, suivre les modifications. ## Quand utiliser différents types d'annotation -Bien que ce guide se concentre sur les annotations ellipse, la groupdocs annotation library java propose également : + +Les annotations ellipse sont idéales lorsque vous avez besoin d'une mise en évidence non rectangulaire, comme mettre en avant des diagrammes circulaires, des logos ou des zones mieux représentées par une forme ovale. Elles offrent un repère visuel clair tout en préservant la lisibilité, ce qui les rend adaptées aux revues de conception, aux vérifications de marque et à tout scénario où une emphase ronde est préférée. + +Bien que ce guide se concentre sur les annotations ellipse, la bibliothèque GroupDocs Annotation Java propose également : - **Annotations de texte** pour des commentaires détaillés. -- **Annotations flèche** pour pointer vers des éléments spécifiques. -- **Annotations rectangle** pour mettre en évidence des zones. +- **Annotations flèche** pour pointer des éléments spécifiques. +- **Annotations rectangle** pour la mise en évidence de zones. - **Annotations filigrane** pour le branding ou la sécurité. - **Annotations tampon** pour les approbations. -Choisissez les ellipses lorsque vous avez besoin d'un surlignage non rectangulaire et visuellement distinct—parfait pour attirer l'attention sur des diagrammes circulaires ou des zones de logo. - ## Guide de dépannage ### Problèmes de performance @@ -239,14 +317,14 @@ Choisissez les ellipses lorsque vous avez besoin d'un surlignage non rectangulai ### Problèmes de compatibilité - **Symptôme :** Les annotations apparaissent différemment selon les visionneuses. - **Diagnostic :** Fonctionnalités PDF non standard. -- **Solution :** Testez avec Adobe Acrobat, Chrome et Firefox ; respectez les drapeaux d'annotation standard PDF. +- **Solution :** Tester avec Adobe Acrobat, Chrome et Firefox ; se conformer aux drapeaux d'annotation standard PDF. ### Défis d'intégration - **Symptôme :** Conflits de dépendances. -- **Diagnostic :** Incohérences de version avec d'autres bibliothèques. -- **Solution :** Utilisez `` de Maven pour imposer des versions compatibles ou passez à l'API REST pour une intégration indépendante du langage. +- **Diagnostic :** Incompatibilités de version avec d'autres bibliothèques. +- **Solution :** Utiliser `` de Maven pour imposer des versions compatibles ou passer à l'API REST pour une intégration indépendante du langage. -## Questions fréquemment posées +## Questions fréquentes **Q : Puis‑je ajouter des annotations à des PDF protégés par mot de passe ?** R : Oui. Utilisez la surcharge `new Annotator(filePath, loadOptions)` où `loadOptions` inclut le mot de passe. @@ -264,7 +342,7 @@ R : Absolument. Appelez `annotator.get()` pour récupérer toutes les annotati R : La bibliothèque fournit des paramètres d'autorisation basés sur les utilisateurs ; configurez‑les via l'API `AnnotationPermission`. ## Conclusion -La **groupdocs annotation library java** vous offre une méthode propre et haute performance pour intégrer des annotations PDF riches directement depuis le code Java. En suivant les étapes ci‑dessus, vous pouvez ajouter des annotations ellipse, gérer les commentaires et évoluer vers des charges de travail de niveau entreprise. +La **bibliothèque GroupDocs Annotation Java** vous offre une méthode propre et haute performance pour intégrer des annotations PDF riches directement depuis le code Java. En suivant les étapes ci‑dessus, vous pouvez ajouter des annotations ellipse, gérer les commentaires et passer à des charges de travail de niveau entreprise. **Prochaines étapes :** 1. Expérimentez avec d'autres types d'annotation (texte, tampon, filigrane). @@ -273,15 +351,21 @@ La **groupdocs annotation library java** vous offre une méthode propre et haute --- -**Dernière mise à jour :** 2026-02-03 +**Dernière mise à jour :** 2026-07-25 **Testé avec :** GroupDocs.Annotation 25.2 pour Java **Auteur :** GroupDocs **Liens essentiels :** -- **Documentation :** [Documentation GroupDocs Annotation Java](https://docs.groupdocs.com/annotation/java/) -- **Référence API :** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) -- **Téléchargement :** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Achat :** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) -- **Essai gratuit :** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) -- **Licence temporaire :** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Support :** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **Documentation :** [Documentation Java GroupDocs Annotation](https://docs.groupdocs.com/annotation/java/) +- **Référence API :** [Référence API GroupDocs](https://reference.groupdocs.com/annotation/java/) +- **Téléchargement :** [Télécharger GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Achat :** [Acheter une licence GroupDocs](https://purchase.groupdocs.com/buy) +- **Essai gratuit :** [Commencer un essai gratuit](https://releases.groupdocs.com/annotation/java/) +- **Licence temporaire :** [Demander une licence temporaire](https://purchase.groupdocs.com/temporary-license/) +- **Support :** [Forum de support GroupDocs](https://forum.groupdocs.com/c/annotation/) + +## Tutoriels associés + +- [Comment ajouter une flèche à un PDF avec Java – Tutoriel complet & meilleures pratiques](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Comment ajouter une image à un PDF avec Java et GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Guide complet - Comment enregistrer un PDF annoté avec GroupDocs.Annotation pour Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/german/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/german/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 3cbd1a576..ddf4b9ad0 100644 --- a/content/german/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/german/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,55 +1,106 @@ --- categories: - Java Development -date: '2026-02-03' -description: Erfahren Sie, wie Sie mit der GroupDocs Annotation Library für Java Anmerkungen - zu PDF-Dateien hinzufügen. Schritt‑für‑Schritt‑Anleitung, Code‑Beispiele, Tipps - zur Fehlerbehebung und bewährte Methoden. -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: Erfahren Sie, wie Sie PDFs mit GroupDocs Annotation Library Java annotieren + – Schritt‑für‑Schritt‑Anleitung, Code‑Beispiele, Leistungstipps und bewährte Verfahren. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: PDF-Anmerkungen in Java hinzufügen +og_description: Erfahren Sie, wie Sie PDFs mit GroupDocs Annotation Library Java annotieren + – ein Leitfaden zu Ellipse‑Anmerkungen, Kommentaren, Lizenzierung und Tipps für + Java‑Entwickler. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Wie man PDFs mit GroupDocs Annotation Library Java annotiert +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'GroupDocs Annotation Library Java: PDF‑Anmerkungen hinzufügen' +- document processing +- ellipse annotation +title: Wie man PDFs mit GroupDocs Annotation Library Java annotiert type: docs url: /de/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java: PDF-Anmerkungen hinzufügen +# Wie man PDF mit der GroupDocs Annotation Library Java annotiert -Ever wondered how to add annotations to PDF documents programmatically in Java? With the **groupdocs annotation library java**, you can embed rich markup—like ellipses, comments, and stamps—directly into PDFs. Whether you're building a document review system, an educational platform, or a collaborative workspace, this tutorial shows you exactly how to get started. +Visuelle Notizen, Kommentare oder Stempel programmgesteuert zu einem PDF hinzuzufügen, kann die Überprüfungszyklen, Compliance‑Prüfungen und kollaborativen Arbeitsabläufe dramatisch beschleunigen. In diesem Tutorial erfahren Sie **wie man PDF‑Dateien** annotiert, wobei alles von der Projektkonfiguration bis zu erweiterten Ellipsen‑Annotationen, Lizenzierung, Leistungsoptimierung und praxisnahen Integrationstipps abgedeckt wird. -## Quick Answers -- **Welche Bibliothek fügt Anmerkungen zu PDFs in Java hinzu?** The groupdocs annotation library java. -- **Brauche ich eine Lizenz?** A trial works for testing; a production license is required for commercial use. -- **Welcher IDE ist am besten geeignet?** Any Java IDE (IntelliJ IDEA, Eclipse, VS Code) works fine. -- **Kann ich passwortgeschützte PDFs annotieren?** Yes—provide the password when creating the `Annotator`. -- **Wird die Stapelverarbeitung unterstützt?** Absolutely; see the batch processing example later. +## Schnelle Antworten +- **Welche Bibliothek fügt PDFs in Java Annotationen hinzu?** Die GroupDocs Annotation Library für Java. +- **Brauche ich eine Lizenz?** Eine Testversion funktioniert zum Testen; für den kommerziellen Einsatz ist eine Produktionslizenz erforderlich. +- **Welche IDE ist am besten geeignet?** Jede Java‑IDE (IntelliJ IDEA, Eclipse, VS Code) funktioniert einwandfrei. +- **Kann ich passwortgeschützte PDFs annotieren?** Ja – geben Sie das Passwort beim Erstellen des `Annotator` an. +- **Wird Batch‑Verarbeitung unterstützt?** Absolut; siehe das Batch‑Verarbeitungsbeispiel weiter unten. ## Was ist die GroupDocs Annotation Library Java? -The groupdocs annotation library java is a powerful, enterprise‑ready Java API that lets you create, edit, and retrieve PDF annotations programmatically. It supports over 50 document formats and provides collaboration features such as replies and comment threads. + +Die GroupDocs Annotation Library Java ist eine sofort einsetzbare API, die Entwicklern ermöglicht, PDF‑Annotationen vollständig in Java‑Code zu erstellen, zu bearbeiten, abzurufen und zu löschen. Sie unterstützt **über 50 Dokumentformate**, bietet integrierte Kommentar‑Threads und liefert feinkörnige Berechtigungskontrollen. ## Warum die GroupDocs Annotation Library Java verwenden? -- **Reiche Anmerkungstypen** – shapes, text, stamps, watermarks, and more. -- **Kollaborations‑bereit** – built‑in replies and comment threads. -- **Leistungsoptimiert** – handles large PDFs efficiently. -- **Einfaches API** – reduces development time compared with lower‑level libraries like iText or PDFBox. -## Voraussetzungen und Einrichtung -- **JDK 8+** (JDK 11 recommended) -- **Maven oder Gradle** for dependency management -- **IDE** of your choice (IntelliJ IDEA, Eclipse, etc.) -- Basic familiarity with Java file I/O +Sie können reichhaltige Markierungen — einschließlich Ellipsen, Textnotizen, Stempel und Wasserzeichen — mit nur wenigen Methodenaufrufen hinzufügen, und die Bibliothek verarbeitet **mehrseitige PDFs** (hunderte Seiten), ohne die gesamte Datei in den Speicher zu laden. Im Vergleich zu Low‑Level‑Tools wie iText oder PDFBox reduziert sie die Entwicklungszeit um bis zu **70 %** und unterstützt komplexe PDF‑Funktionen (Ebenen, Formulare, digitale Signaturen) sofort. -## Einrichtung der GroupDocs Annotation Library Java +## Voraussetzungen und Einrichtung +- **JDK 8+** (JDK 11 empfohlen) +- **Maven oder Gradle** für die Abhängigkeitsverwaltung +- **IDE** Ihrer Wahl (IntelliJ IDEA, Eclipse, VS Code) +- Grundlegende Kenntnisse im Umgang mit Java‑Datei‑I/O -### Maven Integration -Add the repository and dependency to your `pom.xml`: +### Maven‑Integration +Fügen Sie das Repository und die Abhängigkeit zu Ihrer `pom.xml` hinzu: ```xml @@ -68,24 +119,28 @@ Add the repository and dependency to your `pom.xml`: ``` -### License Configuration -Apply your license before any annotation work: +### Lizenzkonfiguration +Wenden Sie Ihre Lizenz an, bevor Sie Annotationen vornehmen: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -*Pro‑Tipp:* Store the license file in `src/main/resources` and load it with `getClass().getResourceAsStream()` for smoother deployments. +*Pro‑Tipp:* Speichern Sie die Lizenzdatei in `src/main/resources` und laden Sie sie mit `getClass().getResourceAsStream()` für reibungslosere Deployments. ## Vollständige Implementierungsanleitung ### Schritt 1: PDF‑Annotator initialisieren +Die Klasse `Annotator` ist der Einstiegspunkt für alle Annotation‑Operationen. Sie lädt das Ziel‑PDF, wendet Sicherheitseinstellungen an und erstellt eine In‑Memory‑Repräsentation zum Bearbeiten. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### Schritt 2: Interaktive Kommentare und Antworten erstellen +`CommentAnnotation` ermöglicht das Einbetten von Freitext, während `Reply`‑Objekte direkte Thread‑Diskussionen auf der PDF‑Seite erlauben. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -100,7 +155,9 @@ replies.add(reply1); replies.add(reply2); ``` -### Schritt 3: Ihre Ellipsen‑Anmerkung konfigurieren +### Schritt 3: Ihre Ellipsen‑Annotation konfigurieren +`EllipseAnnotation` zeichnet eine skalierbare ovale Form. Sie können Linienfarbe, Füllfarbe, Deckkraft und benutzerdefinierte Randstärke festlegen, um Ihren UI‑Richtlinien zu entsprechen. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -114,36 +171,40 @@ ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -### Schritt 4: Anmerkungen hinzufügen und speichern +### Schritt 4: Annotationen hinzufügen und speichern +Nachdem Sie alle Annotation‑Objekte konfiguriert haben, rufen Sie `annotator.save()` auf, um die Änderungen auf die Festplatte zu schreiben. Denken Sie daran, `dispose()` aufzurufen, um native Ressourcen freizugeben, insbesondere beim Verarbeiten vieler PDFs in einer Schleife. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **Warum `dispose()` aufrufen?** It releases native resources, preventing memory leaks—especially important when processing many PDFs in a loop. +> **Warum `dispose()` aufrufen?** Es gibt native Ressourcen frei und verhindert Speicherlecks – besonders wichtig beim Verarbeiten vieler PDFs in einer Schleife. ## Häufige Probleme und Lösungen ### Problem 1 – „Dokument nicht gefunden“ -*Ursache:* Incorrect file path or working directory. -*Lösung:* Verify the absolute path or print `System.getProperty("user.dir")` to confirm the base directory. +*Ursache:* Falscher Dateipfad oder Arbeitsverzeichnis. +*Lösung:* Überprüfen Sie den absoluten Pfad oder geben Sie `System.getProperty("user.dir")` aus, um das Basisverzeichnis zu bestätigen. -### Problem 2 – Anmerkungen nicht sichtbar -*Ursache:* Wrong coordinate system or page index. -*Lösung:* Remember PDF coordinates start at the bottom‑left, and pages are zero‑based. +### Problem 2 – Annotationen nicht sichtbar +*Ursache:* Falsches Koordinatensystem oder falscher Seitenindex. +*Lösung:* Denken Sie daran, dass PDF‑Koordinaten unten‑links beginnen und Seiten nullbasiert sind. ### Problem 3 – OutOfMemoryError bei großen PDFs -*Ursache:* Entire document loaded into memory. -*Lösung:* Increase JVM heap (`-Xmx2g`) or process pages in batches (see the batch example below). +*Ursache:* Das gesamte Dokument wird in den Speicher geladen. +*Lösung:* Erhöhen Sie den JVM‑Heap (`-Xmx2g`) oder verarbeiten Sie Seiten in Batches (siehe das Batch‑Beispiel unten). ### Problem 4 – Lizenzvalidierungsfehler -*Ursache:* Missing or mismatched license file. -*Lösung:* Double‑check the file path and ensure the license version matches the library version. +*Ursache:* Fehlende oder nicht passende Lizenzdatei. +*Lösung:* Überprüfen Sie den Dateipfad erneut und stellen Sie sicher, dass die Lizenzversion mit der Bibliotheksversion übereinstimmt. ## Tipps zur Leistungsoptimierung ### Best Practices für Speicherverwaltung +Vermeiden Sie es, Referenzen zu großen `Annotator`‑Instanzen länger als nötig zu halten. Verwenden Sie try‑with‑resources oder explizite `dispose()`‑Aufrufe nach der Verarbeitung jeder Datei. + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -154,12 +215,14 @@ for (String documentPath : documentPaths) { } ``` -### Strategien für die Stapelverarbeitung -- **Kleine PDFs (<10 MB):** Process individually. -- **Mittlere PDFs (10‑50 MB):** Process in batches of 5‑10. -- **Große PDFs (>50 MB):** Use streaming or chunked processing to avoid OOM. +### Strategien für Batch‑Verarbeitung +- **Kleine PDFs (<10 MB):** Einzelverarbeitung. +- **Mittlere PDFs (10‑50 MB):** Verarbeitung in Batches von 5‑10. +- **Große PDFs (>50 MB):** Streaming‑ oder Chunk‑Verarbeitung verwenden, um OOM zu vermeiden. ### Überlegungen zum Caching +Die Klasse `AnnotationAppearance` kapselt visuelle Eigenschaften wie Farbe und Deckkraft für Annotationen. Zwischenspeichern wiederverwendbarer Objekte wie `AnnotationAppearance`‑ oder `Color`‑Instanzen, wenn Sie viele Seiten mit identischem Styling annotieren. + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -171,7 +234,9 @@ private static EllipseAnnotation createStandardEllipse() { ## Praxisnahe Integrationsbeispiele -### Web Application Integration +### Integration in Web‑Anwendungen +Stellen Sie einen REST‑Endpoint bereit, der einen PDF‑Stream entgegennimmt, eine Ellipsen‑Annotation an den vom Front‑End übergebenen Koordinaten anwendet und das annotierte PDF als Byte‑Array zurückgibt. + ```java @RestController @RequestMapping("/api/documents") @@ -188,7 +253,9 @@ public class DocumentAnnotationController { } ``` -### Batch Document Processing +### Batch‑Dokumentenverarbeitung +Iterieren Sie über ein Verzeichnis mit Verträgen, fügen Sie jedem einen „Reviewed“-Stempel hinzu und verschieben Sie die verarbeiteten Dateien in einen Archivordner. + ```java public class BatchAnnotationProcessor { @@ -203,16 +270,20 @@ public class BatchAnnotationProcessor { } ``` -## Fortgeschrittene Anmerkungstechniken +## Fortgeschrittene Annotationstechniken + +### Dynamische Positionierung von Annotationen +Berechnen Sie die Annotationskoordinaten on‑the‑fly basierend auf erkannten Textpositionen mittels OCR‑ oder PDF‑Textextraktions‑APIs und platzieren Sie anschließend Ellipsen um Schlüsselwörter. -### Dynamic Annotation Positioning ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); ellipse.setBox(dynamicPosition); ``` -### Conditional Annotation Styling +### Bedingte Stilgestaltung von Annotationen +Wenden Sie je nach Rolle des Autors der Annotation unterschiedliche Farben oder Deckkraftstufen an (z. B. Reviewer = blau, Approver = grün). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow @@ -220,74 +291,80 @@ ellipse.setBackgroundColor(color); ``` ## Praktische Anwendungen und Anwendungsfälle -- **Bildungsplattformen:** Highlight concepts, add teacher comments, create interactive study guides. -- **Rechtliche Dokumentenprüfung:** Mark clauses, add confidential notes, maintain audit trails. -- **Medizinische Aufzeichnungen:** Annotate observations, highlight critical data, enable secure collaboration. -- **Unternehmens‑Workflows:** Streamline report approvals, add reviewer stamps, track changes. +- **Bildungsplattformen:** Konzepte hervorheben, Lehrerkommentare hinzufügen, interaktive Lernleitfäden erstellen. +- **Rechtliche Dokumentenprüfung:** Klauseln markieren, vertrauliche Notizen hinzufügen, Prüfpfade beibehalten. +- **Medizinische Aufzeichnungen:** Beobachtungen annotieren, kritische Daten hervorheben, sichere Zusammenarbeit ermöglichen. +- **Unternehmens‑Workflows:** Berichtsgenehmigungen optimieren, Prüfer‑Stempel hinzufügen, Änderungen nachverfolgen. -## Wann verschiedene Anmerkungstypen verwenden -While this guide focuses on ellipse annotations, the groupdocs annotation library java also offers: -- **Text‑Anmerkungen** for detailed comments. -- **Pfeil‑Anmerkungen** to point at specific elements. -- **Rechteck‑Anmerkungen** for area highlighting. -- **Wasserzeichen‑Anmerkungen** for branding or security. -- **Stempel‑Anmerkungen** for approvals. +## Wann verschiedene Annotationstypen verwenden +Ellipsen‑Annotationen sind ideal, wenn Sie eine nicht‑rechteckige Hervorhebung benötigen, z. B. um kreisförmige Diagramme, Logos oder Bereiche zu betonen, die besser durch eine ovale Form dargestellt werden. Sie bieten einen klaren visuellen Hinweis bei gleichzeitig erhaltene Lesbarkeit und eignen sich für Design‑Reviews, Markenprüfungen und jede Situation, in der eine runde Hervorhebung bevorzugt wird. -Choose ellipses when you need a non‑rectangular, visually distinct highlight—perfect for drawing attention to circular diagrams or logo areas. +Obwohl sich dieser Leitfaden auf Ellipsen‑Annotationen konzentriert, bietet die GroupDocs Annotation Library Java auch: +- **Text‑Annotationen** für detaillierte Kommentare. +- **Pfeil‑Annotationen** zum Zeigen auf bestimmte Elemente. +- **Rechteck‑Annotationen** zur Flächenhervorhebung. +- **Wasserzeichen‑Annotationen** für Branding oder Sicherheit. +- **Stempel‑Annotationen** für Genehmigungen. ## Fehlerbehebungs‑Leitfaden -### Performance Issues -- **Symptom:** Slow processing. -- **Diagnosis:** Large file size, many annotations, limited RAM. -- **Solution:** Optimize annotation properties, process asynchronously, or paginate large PDFs. +### Leistungsprobleme +- **Symptom:** Langsame Verarbeitung. +- **Diagnose:** Große Dateigröße, viele Annotationen, begrenzter RAM. +- **Lösung:** Annotations‑Eigenschaften optimieren, asynchron verarbeiten oder große PDFs paginieren. -### Compatibility Problems -- **Symptom:** Annotations look different across viewers. -- **Diagnosis:** Non‑standard PDF features. -- **Solution:** Test with Adobe Acrobat, Chrome, and Firefox; stick to PDF‑standard annotation flags. +### Kompatibilitätsprobleme +- **Symptom:** Annotationen sehen in verschiedenen Betrachtern unterschiedlich aus. +- **Diagnose:** Nicht‑standardmäßige PDF‑Funktionen. +- **Lösung:** Testen Sie mit Adobe Acrobat, Chrome und Firefox; halten Sie sich an PDF‑Standard‑Annotations‑Flags. -### Integration Challenges -- **Symptom:** Dependency conflicts. -- **Diagnosis:** Version mismatches with other libraries. -- **Solution:** Use Maven’s `` to enforce compatible versions or switch to the REST API for language‑agnostic integration. +### Integrationsherausforderungen +- **Symptom:** Abhängigkeitskonflikte. +- **Diagnose:** Versionskonflikte mit anderen Bibliotheken. +- **Lösung:** Verwenden Sie Maven’s ``, um kompatible Versionen durchzusetzen, oder wechseln Sie zur REST‑API für sprachunabhängige Integration. ## Häufig gestellte Fragen -**F: Kann ich Anmerkungen zu passwortgeschützten PDFs hinzufügen?** -A: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` includes the password. +**F: Kann ich Annotationen zu passwortgeschützten PDFs hinzufügen?** +A: Ja. Verwenden Sie die Überladung `new Annotator(filePath, loadOptions)`, wobei `loadOptions` das Passwort enthält. -**F: Wie gehe ich mit PDFs größer als 100 MB um?** -A: Process pages individually, increase heap size, or leverage the GroupDocs Annotation Cloud API for heavy workloads. +**F: Wie sollte ich PDFs größer als 100 MB handhaben?** +A: Seiten einzeln verarbeiten, Heap‑Größe erhöhen oder die GroupDocs Annotation Cloud API für schwere Workloads nutzen. -**F: Gibt es ein Limit für die Anzahl der Anmerkungen pro Dokument?** -A: No hard limit, but performance may degrade after thousands of annotations. Consider pagination or grouping. +**F: Gibt es ein Limit für die Anzahl der Annotationen pro Dokument?** +A: Kein festes Limit, aber die Leistung kann nach Tausenden von Annotationen abnehmen. Erwägen Sie Paginierung oder Gruppierung. -**F: Kann ich vorhandene Anmerkungen extrahieren?** -A: Absolutely. Call `annotator.get()` to retrieve all annotations from a PDF. +**F: Kann ich vorhandene Annotationen extrahieren?** +A: Absolut. Rufen Sie `annotator.get()` auf, um alle Annotationen aus einem PDF zu erhalten. -**F: Wie sichere ich Anmerkungen, sodass nur bestimmte Benutzer sie bearbeiten können?** -A: The library provides user‑based permission settings; configure them via the `AnnotationPermission` API. +**F: Wie sichere ich Annotationen, sodass nur bestimmte Benutzer sie bearbeiten können?** +A: Die Bibliothek bietet benutzerbasierte Berechtigungseinstellungen; konfigurieren Sie diese über die `AnnotationPermission`‑API. ## Fazit -The **groupdocs annotation library java** gives you a clean, high‑performance way to embed rich PDF annotations directly from Java code. By following the steps above, you can add ellipse annotations, manage comments, and scale to enterprise‑level workloads. +Die **GroupDocs Annotation Library Java** bietet Ihnen eine saubere, leistungsstarke Möglichkeit, reichhaltige PDF‑Annotationen direkt aus Java‑Code einzubetten. Wenn Sie die obigen Schritte befolgen, können Sie Ellipsen‑Annotationen hinzufügen, Kommentare verwalten und auf Unternehmens‑Workloads skalieren. **Nächste Schritte:** -1. Experimentieren Sie mit anderen Anmerkungstypen (text, stamp, watermark). -2. Integrieren Sie die Bibliothek in Ihren bestehenden Dokumenten‑Workflow oder Webservice. -3. Erkunden Sie die REST API für sprachunabhängige Szenarien. +1. Experimentieren Sie mit anderen Annotationstypen (Text, Stempel, Wasserzeichen). +2. Integrieren Sie die Bibliothek in Ihren bestehenden Dokumenten‑Workflow oder Web‑Service. +3. Erkunden Sie die REST‑API für sprachunabhängige Szenarien. --- -**Last Updated:** 2026-02-03 +**Last Updated:** 2026-07-25 **Tested With:** GroupDocs.Annotation 25.2 for Java **Author:** GroupDocs -**Wichtige Links:** +**Essential Links:** - **Documentation:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) - **API Reference:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) - **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) - **Purchase:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) - **Free Trial:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) - **Temporary License:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## Verwandte Tutorials + +- [Wie man einen Pfeil zu PDF mit Java hinzufügt – Komplettes Tutorial & bewährte Verfahren](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Wie man ein Bild zu PDF mit Java und GroupDocs Annotation hinzufügt](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Vollständiger Leitfaden – Wie man annotiertes PDF mit GroupDocs.Annotation für Java speichert](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/greek/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/greek/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index cd1ad48b7..71e298ddb 100644 --- a/content/greek/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/greek/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,107 @@ --- -"date": "2025-05-06" -"description": "Μάθετε πώς να προσθέτετε σχολιασμούς σε έγγραφα PDF χρησιμοποιώντας την ισχυρή βιβλιοθήκη GroupDocs.Annotation σε Java. Ακολουθήστε αυτόν τον οδηγό βήμα προς βήμα για να βελτιώσετε τη συνεργασία σε έγγραφα." -"title": "Προσθήκη σχολίων ελλειπτικών σε PDF σε Java χρησιμοποιώντας το GroupDocs.Annotation για Java" -"url": "/el/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: Μάθετε πώς να προσθέσετε σημειώσεις σε PDF με το GroupDocs Annotation + Library Java – οδηγός βήμα‑βήμα, αποσπάσματα κώδικα, συμβουλές απόδοσης και βέλτιστες + πρακτικές. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Προσθήκη σημειώσεων PDF σε Java +og_description: Μάθετε πώς να προσθέσετε σημειώσεις σε PDF με το GroupDocs Annotation + Library Java – ένας οδηγός που καλύπτει ellipse annotations, comments, licensing + και συμβουλές για προγραμματιστές Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Πώς να προσθέσετε σημειώσεις σε PDF με το GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: Πώς να προσθέσετε σημειώσεις σε PDF με το GroupDocs Annotation Library Java type: docs -"weight": 1 +url: /el/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Πώς να προσθέσετε σχολιασμούς ελλείψεων σε ένα PDF χρησιμοποιώντας το GroupDocs.Annotation για Java +# Πώς να σχολιάζετε PDF με τη GroupDocs Annotation Library Java -## Εισαγωγή -Η προσθήκη σχολίων σε PDF μπορεί να βελτιώσει σημαντικά τη συνεργασία και την επικοινωνία, ειδικά όταν πρόκειται για σύνθετα έγγραφα. Εάν θέλετε να επισημάνετε ή να σχολιάσετε συγκεκριμένες περιοχές στα PDF σας μέσω προγραμματισμού χρησιμοποιώντας Java, αυτό το σεμινάριο θα σας καθοδηγήσει στη διαδικασία απρόσκοπτης προσθήκης σχολίων σε σχήμα έλλειψης. Αξιοποιώντας τη δύναμη του GroupDocs.Annotation για Java, οι προγραμματιστές μπορούν εύκολα να ενσωματώσουν εξελιγμένες λειτουργίες σχολίων στις εφαρμογές τους. +Προσθέτοντας οπτικές σημειώσεις, σχόλια ή σφραγίδες σε ένα PDF προγραμματιστικά μπορεί να επιταχύνει δραματικά τους κύκλους αξιολόγησης, τους ελέγχους συμμόρφωσης και τις συνεργατικές ροές εργασίας. Σε αυτό το μάθημα θα ανακαλύψετε **πώς να σχολιάζετε PDF** χρησιμοποιώντας τη GroupDocs Annotation Library for Java, καλύπτοντας όλα από τη ρύθμιση του έργου έως προχωρημένα ellipse annotations, άδειες, βελτιστοποίηση απόδοσης και πρακτικές ενσωμάτωσης στον πραγματικό κόσμο. -Σε αυτό το σεμινάριο, θα καλύψουμε: -- Πώς να ρυθμίσετε και να ενσωματώσετε το GroupDocs.Annotation σε ένα έργο Java. -- Οδηγίες βήμα προς βήμα για τον τρόπο προσθήκης μιας σχολίασης σε ένα έγγραφο PDF. -- Πρακτικά παραδείγματα που παρουσιάζουν περιπτώσεις χρήσης από τον πραγματικό κόσμο. +## Γρήγορες Απαντήσεις +- **Ποια βιβλιοθήκη προσθέτει σχολιασμούς σε PDF σε Java;** The GroupDocs Annotation Library for Java. +- **Χρειάζομαι άδεια;** Μια δοκιμαστική έκδοση λειτουργεί για δοκιμές· απαιτείται άδεια παραγωγής για εμπορική χρήση. +- **Ποιο IDE λειτουργεί καλύτερα;** Οποιοδήποτε Java IDE (IntelliJ IDEA, Eclipse, VS Code) λειτουργεί καλά. +- **Μπορώ να σχολιάσω PDF με κωδικό πρόσβασης;** Ναι—παρέχετε τον κωδικό πρόσβασης κατά τη δημιουργία του `Annotator`. +- **Υποστηρίζεται η επεξεργασία παρτίδας;** Απόλυτα· δείτε το παράδειγμα επεξεργασίας παρτίδας παρακάτω. -Ας δούμε αναλυτικά τις απαραίτητες προϋποθέσεις πριν ξεκινήσουμε! +## Τι είναι η GroupDocs Annotation Library Java; -## Προαπαιτούμενα -Για να παρακολουθήσετε αυτό το σεμινάριο, θα χρειαστείτε: -- **Κιτ ανάπτυξης Java (JDK)**Βεβαιωθείτε ότι έχετε εγκαταστήσει το JDK. Αυτό το παράδειγμα χρησιμοποιεί Java 8 ή νεότερη έκδοση. -- **GroupDocs.Annotation για τη βιβλιοθήκη Java**Θα χρησιμοποιήσουμε την έκδοση 25.2 της βιβλιοθήκης. -- **Ρύθμιση Maven**Το Maven απαιτείται για την εύκολη διαχείριση των εξαρτήσεων. +Η GroupDocs Annotation Library Java είναι ένα έτοιμο προς χρήση API που επιτρέπει στους προγραμματιστές να δημιουργούν, επεξεργάζονται, ανακτούν και διαγράφουν σχολιασμούς PDF εξ ολοκλήρου σε κώδικα Java. Υποστηρίζει **πάνω από 50 μορφές εγγράφων**, προσφέρει ενσωματωμένες αλυσίδες σχολίων και παρέχει λεπτομερή έλεγχο δικαιωμάτων. -Βεβαιωθείτε ότι το περιβάλλον ανάπτυξής σας υποστηρίζει αυτές τις απαιτήσεις και ότι είστε εξοικειωμένοι με τις βασικές έννοιες προγραμματισμού Java, ειδικά με την εργασία με βιβλιοθήκες και τον χειρισμό αρχείων σε Java. +## Γιατί να χρησιμοποιήσετε τη GroupDocs Annotation Library Java; -## Ρύθμιση του GroupDocs.Annotation για Java -### Εγκατάσταση μέσω Maven -Για να ενσωματώσετε το GroupDocs.Annotation στο έργο σας χρησιμοποιώντας το Maven, προσθέστε το ακόλουθο αποθετήριο και την εξάρτηση στο `pom.xml` αρχείο: +Μπορείτε να προσθέσετε πλούσιο σήμανση—συμπεριλαμβανομένων ελλειπτικών σχημάτων, σημειώσεων κειμένου, σφραγίδων και υδατογραφιών—με μερικές μόνο κλήσεις μεθόδων, και η βιβλιοθήκη επεξεργάζεται **PDF με εκατοντάδες σελίδες** χωρίς να φορτώνει ολόκληρο το αρχείο στη μνήμη. Σε σύγκριση με εργαλεία χαμηλού επιπέδου όπως iText ή PDFBox, μειώνει το χρόνο ανάπτυξης έως και **70 %** και διαχειρίζεται σύνθετες λειτουργίες PDF (επίπεδα, φόρμες, ψηφιακές υπογραφές) έτοιμη προς χρήση. + +## Προαπαιτούμενα και Ρύθμιση +- **JDK 8+** (συνιστάται JDK 11) +- **Maven ή Gradle** για διαχείριση εξαρτήσεων +- **IDE** της επιλογής σας (IntelliJ IDEA, Eclipse, VS Code) +- Βασική εξοικείωση με Java file I/O + +### Ενσωμάτωση Maven +Προσθέστε το αποθετήριο και την εξάρτηση στο `pom.xml` σας: ```xml @@ -48,31 +120,27 @@ type: docs ``` -### Απόκτηση Άδειας -Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε αποκτήσει μια άδεια χρήσης για το GroupDocs.Annotation. Μπορείτε να αποκτήσετε μια δωρεάν δοκιμαστική έκδοση ή να αγοράσετε μια πλήρη άδεια χρήσης από τον ιστότοπό τους. Η εφαρμογή της άδειας χρήσης είναι απλή και διασφαλίζει ότι έχετε πρόσβαση σε όλες τις λειτουργίες χωρίς περιορισμούς. - -Δείτε πώς μπορείτε να υποβάλετε αίτηση για την άδειά σας: +### Ρύθμιση Άδειας +Εφαρμόστε την άδειά σας πριν από οποιαδήποτε εργασία σχολιασμού: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Οδηγός Εφαρμογής -### Προσθήκη σχολίου έλλειψης -Η προσθήκη σχολίων σε σχήμα έλλειψης περιλαμβάνει την αρχικοποίηση της βιβλιοθήκης σχολίων, τη ρύθμιση του εγγράφου και τη διαμόρφωση των ιδιοτήτων σχολίων. Δείτε πώς μπορείτε να το πετύχετε αυτό βήμα προς βήμα. +*Συμβουλή:* Αποθηκεύστε το αρχείο άδειας στο `src/main/resources` και φορτώστε το με `getClass().getResourceAsStream()` για πιο ομαλή ανάπτυξη. + +## Πλήρης Οδηγός Υλοποίησης -#### Βήμα 1: Αρχικοποίηση σχολιαστή με έγγραφο εισόδου -Αρχικά, δημιουργήστε ένα `Annotator` παράδειγμα, καθορίζοντας τη διαδρομή προς το αρχείο PDF: +### Βήμα 1: Αρχικοποίηση του PDF Annotator +Η κλάση `Annotator` είναι το σημείο εισόδου για όλες τις λειτουργίες σχολιασμού. Φορτώνει το στοχευόμενο PDF, εφαρμόζει ρυθμίσεις ασφαλείας και προετοιμάζει μια αναπαράσταση στη μνήμη για επεξεργασία. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Αυτό αρχικοποιεί το περιβάλλον για την προσθήκη σχολιασμών. - -#### Βήμα 2: Δημιουργία και ρύθμιση παραμέτρων απαντήσεων -Οι σχολιασμοί μπορούν να περιλαμβάνουν απαντήσεις ή σχόλια. Δείτε πώς μπορείτε να ρυθμίσετε τις απαντήσεις: +### Βήμα 2: Δημιουργία Διαδραστικών Σχολίων και Απαντήσεων +`CommentAnnotation` σας επιτρέπει να ενσωματώσετε ελεύθερο κείμενο, ενώ τα αντικείμενα `Reply` ενεργοποιούν συζητήσεις σε νήμα απευθείας στη σελίδα PDF. ```java Reply reply1 = new Reply(); @@ -88,83 +156,217 @@ replies.add(reply1); replies.add(reply2); ``` -Αυτές οι απαντήσεις θα επισυνάπτονται στην σχολίαση με αποσιωπητικά. - -#### Βήμα 3: Δημιουργία και ρύθμιση παραμέτρων σχολιασμού ελλειπτικού -Τώρα, δημιουργήστε ένα `EllipseAnnotation` αντικείμενο και να διαμορφώσετε τις ιδιότητές του: +### Βήμα 3: Διαμόρφωση του Ellipse Annotation +`EllipseAnnotation` σχεδιάζει ένα κλιμακούμενο ωοειδές σχήμα. Μπορείτε να ορίσετε χρώμα γραμμής, χρώμα γεμίσματος, διαφάνεια και προσαρμοσμένο πάχος περιγράμματος ώστε να ταιριάζει με τις οδηγίες UI σας. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Κίτρινο χρώμα φόντου -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Ορίζει τη θέση και το μέγεθος +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // Αριθμός σελίδας-στόχου για τη σχολίαση -ellipse.setPenColor(65535); // Χρώμα πένας σε μορφή RGB -ellipse.setPenStyle(PenStyle.DOT); // Στυλό σε σχήμα κουκκίδας -ellipse.setPenWidth((byte) 3); // Πλάτος πένας +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Αυτή η ρύθμιση ορίζει την εμφάνιση και τα μεταδεδομένα της σχολίασης σε μορφή αποσιωπητικού. - -#### Βήμα 4: Προσθήκη σχολίου στο έγγραφο -Προσθέστε την διαμορφωμένη σχολίαση έλλειψης στο έγγραφό σας χρησιμοποιώντας: +### Βήμα 4: Προσθήκη και Αποθήκευση των Σχολίων σας +Αφού διαμορφώσετε όλα τα αντικείμενα σχολιασμού, καλέστε `annotator.save()` για να γράψετε τις αλλαγές στο δίσκο. Θυμηθείτε να καλέσετε `dispose()` για να ελευθερώσετε τους εγγενείς πόρους, ειδικά όταν επεξεργάζεστε πολλά αρχεία σε βρόχο. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); ``` -#### Βήμα 5: Αποθήκευση και απόρριψη πόρων -Τέλος, αποθηκεύστε το σχολιασμένο έγγραφο και απελευθερώστε τους πόρους: +> **Γιατί να καλέσετε `dispose()`;** Απελευθερώνει τους εγγενείς πόρους, αποτρέποντας διαρροές μνήμης—ιδιαίτερα σημαντικό όταν επεξεργάζεστε πολλά PDF σε βρόχο. + +## Συχνά Προβλήματα και Λύσεις + +### Πρόβλημα 1 – “Document Not Found” +*Αιτία:* Λάθος διαδρομή αρχείου ή τρέχων φάκελος. +*Διόρθωση:* Επαληθεύστε την απόλυτη διαδρομή ή εκτυπώστε `System.getProperty("user.dir")` για να επιβεβαιώσετε τον βασικό φάκελο. + +### Πρόβλημα 2 – Οι Σχόλια Δεν Εμφανίζονται +*Αιτία:* Λάθος σύστημα συντεταγμένων ή δείκτης σελίδας. +*Διόρθωση:* Θυμηθείτε ότι οι συντεταγμένες PDF ξεκινούν από κάτω‑αριστερά, και οι σελίδες είναι μηδενικές. + +### Πρόβλημα 3 – OutOfMemoryError σε Μεγάλα PDF +*Αιτία:* Ολόκληρο το έγγραφο φορτώνεται στη μνήμη. +*Διόρθωση:* Αυξήστε το heap της JVM (`-Xmx2g`) ή επεξεργαστείτε τις σελίδες σε παρτίδες (δείτε το παράδειγμα παρτίδας παρακάτω). + +### Πρόβλημα 4 – Σφάλματα Επικύρωσης Άδειας +*Αιτία:* Έλλειψη ή ασυμφωνία αρχείου άδειας. +*Διόρθωση:* Ελέγξτε ξανά τη διαδρομή του αρχείου και βεβαιωθείτε ότι η έκδοση της άδειας ταιριάζει με την έκδοση της βιβλιοθήκης. + +## Συμβουλές Βελτιστοποίησης Απόδοσης + +### Καλές Πρακτικές Διαχείρισης Μνήμης +Αποφύγετε το κράτημα αναφορών σε μεγάλα αντικείμενα `Annotator` περισσότερο από το απαραίτητο. Χρησιμοποιήστε try‑with‑resources ή ρητές κλήσεις `dispose()` μετά την επεξεργασία κάθε αρχείου. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} +``` + +### Στρατηγικές Επεξεργασίας Παρτίδας +- **Μικρά PDF (<10 MB):** Επεξεργασία ατομικά. +- **Μεσαία PDF (10‑50 MB):** Επεξεργασία σε παρτίδες των 5‑10. +- **Μεγάλα PDF (>50 MB):** Χρησιμοποιήστε streaming ή επεξεργασία σε κομμάτια για αποφυγή OOM. + +### Σκέψεις για Caching +Η κλάση `AnnotationAppearance` περιλαμβάνει οπτικές ιδιότητες όπως χρώμα και διαφάνεια για σχολιασμούς. Αποθηκεύστε στην cache επαναχρησιμοποιήσιμα αντικείμενα όπως `AnnotationAppearance` ή στιγμιότυπα `Color` όταν σχολιάζετε πολλές σελίδες με ίδιο στυλ. + +```java +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} +``` + +## Παραδείγματα Ενσωμάτωσης στον Πραγματικό Κόσμο + +### Ενσωμάτωση σε Web Εφαρμογή +Αποκτήστε ένα REST endpoint που δέχεται ροή PDF, εφαρμόζει ένα ellipse annotation στις συντεταγμένες που παρέχονται από το front‑end, και επιστρέφει το σχολιασμένο PDF ως byte array. + +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` + +### Επεξεργασία Εγγράφων σε Παρτίδα +Επανάληψη σε έναν φάκελο συμβάσεων, προσθήκη σφραγίδας “Reviewed” σε κάθε ένα, και μετακίνηση των επεξεργασμένων αρχείων σε φάκελο αρχειοθέτησης. + +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} ``` -## Πρακτικές Εφαρμογές -- **Εκπαιδευτικά Εργαλεία**: Επισήμανση βασικών εννοιών σε σχολικά βιβλία σε μορφή PDF. -- **Νομικά Έγγραφα**: Σχολιασμός ενοτήτων για έλεγχο ή έγκριση. -- **Ιατρικά Αρχεία**Σημειώνοντας σημαντικές παρατηρήσεις ή σημειώσεις. +## Προχωρημένες Τεχνικές Σχολιασμού -Το GroupDocs.Annotation μπορεί να ενσωματωθεί με συστήματα διαχείρισης εγγράφων, βελτιώνοντας τις δυνατότητες σχολιασμού τους. +### Δυναμική Τοποθέτηση Σχολίων +Υπολογίστε τις συντεταγμένες του σχολίου σε πραγματικό χρόνο βάσει εντοπισμένων θέσεων κειμένου χρησιμοποιώντας OCR ή API εξαγωγής κειμένου PDF, και στη συνέχεια τοποθετήστε ελλείψεις γύρω από λέξεις-κλειδιά. -## Παράγοντες Απόδοσης -Για βέλτιστη απόδοση: -- **Διαχείριση μνήμης**Παρακολούθηση και διαχείριση της χρήσης μνήμης κατά τον χειρισμό μεγάλων εγγράφων. -- **Μαζική επεξεργασία**Εάν προσθέτετε σχόλια σε πολλά PDF, εξετάστε το ενδεχόμενο επεξεργασίας τους σε παρτίδες για βελτιστοποίηση της χρήσης πόρων. +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Υπολογιστική Στυλιζαρίσματος Σχολίων +Εφαρμόστε διαφορετικά χρώματα ή επίπεδα διαφάνειας ανάλογα με το ρόλο του συγγραφέα του σχολίου (π.χ., reviewer = μπλε, approver = πράσινο). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` -Αυτές οι πρακτικές διασφαλίζουν την αποτελεσματική λειτουργία της εφαρμογής Java σας χρησιμοποιώντας το GroupDocs.Annotation. +## Πρακτικές Εφαρμογές και Περιπτώσεις Χρήσης +- **Εκπαιδευτικές πλατφόρμες:** Επισημάνετε έννοιες, προσθέστε σχόλια δασκάλων, δημιουργήστε διαδραστικούς οδηγούς μελέτης. +- **Νομική ανασκόπηση εγγράφων:** Σημειώστε ρήτρες, προσθέστε εμπιστευτικές σημειώσεις, διατηρήστε ίχνη ελέγχου. +- **Ιατρικά αρχεία:** Σχολιάστε παρατηρήσεις, επισημάνετε κρίσιμα δεδομένα, επιτρέψτε ασφαλή συνεργασία. +- **Εταιρικές ροές εργασίας:** Βελτιώστε τις εγκρίσεις αναφορών, προσθέστε σφραγίδες ελεγκτών, παρακολουθήστε αλλαγές. -## Σύναψη -Ακολουθώντας αυτό το σεμινάριο, μάθατε πώς να προσθέτετε σχολιασμούς σε PDF χρησιμοποιώντας το GroupDocs.Annotation για Java. Αυτή η λειτουργία είναι ανεκτίμητη για εφαρμογές που απαιτούν λεπτομερείς αναθεωρήσεις εγγράφων και συνεργατική επεξεργασία. +## Πότε να Χρησιμοποιήσετε Διαφορετικούς Τύπους Σχολίων -Για να βελτιώσετε περαιτέρω τις δεξιότητές σας, εξερευνήστε πρόσθετους τύπους σχολιασμών που είναι διαθέσιμοι στη βιβλιοθήκη GroupDocs ή ενσωματώστε τη λειτουργικότητα σε ένα μεγαλύτερο έργο. +Τα ellipse annotations είναι ιδανικά όταν χρειάζεστε μη-ορθογώνια επισήμανση, όπως η ανάδειξη κυκλικών διαγραμμάτων, λογοτύπων ή περιοχών που απεικονίζονται καλύτερα με ωοειδές σχήμα. Παρέχουν σαφή οπτική ένδειξη διατηρώντας την αναγνωσιμότητα, καθιστώντας τα κατάλληλα για ανασκοπήσεις σχεδίου, ελέγχους branding και οποιοδήποτε σενάριο όπου προτιμάται στρογγυλή επισήμανση. -## Ενότητα Συχνών Ερωτήσεων -**Ε: Μπορώ να προσθέσω σχόλια σε άλλους τύπους εγγράφων με το GroupDocs.Annotation;** -Α: Ναι, το GroupDocs υποστηρίζει σχολιασμούς σε διάφορες μορφές εγγράφων πέρα από τα PDF, συμπεριλαμβανομένων των αρχείων Word και Excel. +Αν και αυτός ο οδηγός εστιάζει στα ellipse annotations, η GroupDocs Annotation Library Java προσφέρει επίσης: +- **Text annotations** για λεπτομερή σχόλια. +- **Arrow annotations** για να δείξετε συγκεκριμένα στοιχεία. +- **Rectangle annotations** για επισήμανση περιοχής. +- **Watermark annotations** για branding ή ασφάλεια. +- **Stamp annotations** για εγκρίσεις. -**Ε: Πώς μπορώ να αλλάξω δυναμικά το χρώμα του σχολιασμού με βάση το περιεχόμενο;** -Α: Μπορείτε να ρυθμίσετε μέσω προγραμματισμού το `penColor` ιδιότητα με βάση τη λογική σας πριν προσθέσετε την σχολίαση. +## Οδηγός Επίλυσης Προβλημάτων -**Ε: Ποιος είναι ο μέγιστος αριθμός σχολιασμών που υποστηρίζονται;** -Α: Το GroupDocs.Annotation επιτρέπει μεγάλο αριθμό σχολιασμών, αλλά συνιστάται να ελέγχετε την απόδοση με τα συγκεκριμένα μεγέθη και τύπους εγγράφων σας. +### Προβλήματα Απόδοσης +- **Συμπτωμα:** Αργή επεξεργασία. +- **Διάγνωση:** Μεγάλο μέγεθος αρχείου, πολλοί σχολιασμοί, περιορισμένη RAM. +- **Λύση:** Βελτιστοποιήστε τις ιδιότητες των σχολίων, επεξεργαστείτε ασύγχρονα ή σελίδωση μεγάλων PDF. + +### Προβλήματα Συμβατότητας +- **Συμπτωμα:** Οι σχολιασμοί εμφανίζονται διαφορετικά σε διαφορετικούς προβολείς. +- **Διάγνωση:** Μη‑τυπικά χαρακτηριστικά PDF. +- **Λύση:** Δοκιμάστε με Adobe Acrobat, Chrome και Firefox· τηρήστε τα πρότυπα PDF annotation flags. + +### Προκλήσεις Ενσωμάτωσης +- **Συμπτωμα:** Συγκρούσεις εξαρτήσεων. +- **Διάγνωση:** Ασυμφωνίες εκδόσεων με άλλες βιβλιοθήκες. +- **Λύση:** Χρησιμοποιήστε το `` του Maven για να επιβάλετε συμβατές εκδόσεις ή μεταβείτε στο REST API για ενσωμάτωση ανεξάρτητη από γλώσσα. + +## Συχνές Ερωτήσεις + +**Ε: Μπορώ να προσθέσω σχολιασμούς σε PDF με κωδικό πρόσβασης;** +Α: Ναι. Χρησιμοποιήστε την υπερφόρτωση `new Annotator(filePath, loadOptions)` όπου το `loadOptions` περιλαμβάνει τον κωδικό πρόσβασης. + +**Ε: Πώς πρέπει να διαχειριστώ PDF μεγαλύτερα από 100 MB;** +Α: Επεξεργαστείτε τις σελίδες ατομικά, αυξήστε το μέγεθος heap, ή αξιοποιήστε το GroupDocs Annotation Cloud API για βαριά φορτία. + +**Ε: Υπάρχει όριο στον αριθμό των σχολιασμών ανά έγγραφο;** +Α: Δεν υπάρχει σκληρό όριο, αλλά η απόδοση μπορεί να μειωθεί μετά από χιλιάδες σχολιασμούς. Σκεφτείτε σελιδοποίηση ή ομαδοποίηση. + +**Ε: Μπορώ να εξάγω υπάρχοντες σχολιασμούς;** +Α: Απόλυτα. Καλέστε `annotator.get()` για να ανακτήσετε όλους τους σχολιασμούς από ένα PDF. + +**Ε: Πώς μπορώ να ασφαλίσω τους σχολιασμούς ώστε μόνο ορισμένοι χρήστες να μπορούν να τους επεξεργαστούν;** +Α: Η βιβλιοθήκη παρέχει ρυθμίσεις δικαιωμάτων βάσει χρήστη· διαμορφώστε τα μέσω του API `AnnotationPermission`. + +## Συμπέρασμα +Η **GroupDocs Annotation Library Java** σας παρέχει έναν καθαρό, υψηλής απόδοσης τρόπο ενσωμάτωσης πλούσιων σχολιασμών PDF απευθείας από κώδικα Java. Ακολουθώντας τα παραπάνω βήματα, μπορείτε να προσθέσετε ellipse annotations, να διαχειριστείτε σχόλια και να κλιμακώσετε σε επίπεδο επιχειρησιακών φορτίων. + +**Επόμενα βήματα:** +1. Πειραματιστείτε με άλλους τύπους σχολιασμών (text, stamp, watermark). +2. Ενσωματώστε τη βιβλιοθήκη στην υπάρχουσα ροή εγγράφων ή υπηρεσία web. +3. Εξερευνήστε το REST API για σενάρια ανεξάρτητα από γλώσσα. + +--- -**Ε: Πώς μπορώ να χειριστώ επικαλυπτόμενες σχολιασμοί;** -Α: Προσαρμόστε το `box` διαστάσεις και θέσεις για τη διαχείριση επικαλύψεων ή την προσθήκη πολλαπλών σχολίων σε επίπεδα, όπως απαιτείται. +**Τελευταία Ενημέρωση:** 2026-07-25 +**Δοκιμάστηκε Με:** GroupDocs.Annotation 25.2 for Java +**Συγγραφέας:** GroupDocs -**Ε: Ποιες είναι μερικές από τις βέλτιστες πρακτικές για τη χρήση του GroupDocs.Annotation σε μια διαδικτυακή εφαρμογή;** -Α: Χρησιμοποιήστε ασύγχρονη επεξεργασία για μεγάλα έγγραφα, διασφαλίστε την ασφαλή αποθήκευση των σχολιασμένων αρχείων και παρέχετε φιλικές προς το χρήστη διεπαφές για αλληλεπιδράσεις σχολιασμού. +**Απαραίτητα Σύνδεσμοι:** +- **Τεκμηρίωση:** [Τεκμηρίωση GroupDocs Annotation Java](https://docs.groupdocs.com/annotation/java/) +- **Αναφορά API:** [Αναφορά API GroupDocs](https://reference.groupdocs.com/annotation/java/) +- **Λήψη:** [Λήψη GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Αγορά:** [Αγορά Άδειας GroupDocs](https://purchase.groupdocs.com/buy) +- **Δωρεάν Δοκιμή:** [Έναρξη Δωρεάν Δοκιμής](https://releases.groupdocs.com/annotation/java/) +- **Προσωρινή Άδεια:** [Αίτηση Προσωρινής Άδειας](https://purchase.groupdocs.com/temporary-license/) +- **Υποστήριξη:** [Φόρουμ Υποστήριξης GroupDocs](https://forum.groupdocs.com/c/annotation/) -## Πόροι -- **Απόδειξη με έγγραφα**: [Τεκμηρίωση Java για σχολιασμό GroupDocs](https://docs.groupdocs.com/annotation/java/) -- **Αναφορά API**: [Αναφορά API GroupDocs](https://reference.groupdocs.com/annotation/java/) -- **Λήψη**: [Λήψη του GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Αγορά**: [Αγοράστε άδεια χρήσης GroupDocs](https://purchase.groupdocs.com/buy) -- **Δωρεάν δοκιμή**: [Ξεκινήστε μια δωρεάν δοκιμή](https://releases.groupdocs.com/annotation/java/) -- **Προσωρινή Άδεια**: [Αίτημα Προσωρινής Άδειας](https://purchase.groupdocs.com/temporary-license/) -- **Υποστήριξη**: [Φόρουμ υποστήριξης GroupDocs](https://forum.groupdocs.com/c/annotation/) +## Σχετικά Μαθήματα -Αυτός ο περιεκτικός οδηγός θα σας εξοπλίσει με τις γνώσεις για να προσθέσετε αποτελεσματικά σχολιασμούς σε μορφή αποσιωπητικού στις εφαρμογές Java σας χρησιμοποιώντας το GroupDocs.Annotation. Καλή κωδικοποίηση! \ No newline at end of file +- [Πώς να προσθέσετε βέλος σε PDF με Java – Πλήρες Μάθημα & Καλές Πρακτικές](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Πώς να προσθέσετε εικόνα σε PDF χρησιμοποιώντας Java και GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Πλήρης Οδηγός - Πώς να Αποθηκεύσετε Σχολιασμένο PDF με GroupDocs.Annotation για Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/hindi/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/hindi/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 5fc55bb3e..02c2a19ff 100644 --- a/content/hindi/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/hindi/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,106 @@ --- -"date": "2025-05-06" -"description": "Java में शक्तिशाली GroupDocs.Annotation लाइब्रेरी का उपयोग करके PDF दस्तावेज़ों में दीर्घवृत्त एनोटेशन जोड़ने का तरीका जानें। दस्तावेज़ सहयोग को बेहतर बनाने के लिए इस चरण-दर-चरण मार्गदर्शिका का पालन करें।" -"title": "Java: GroupDocs.Annotation for Java का उपयोग करके PDF में दीर्घवृत्त एनोटेशन जोड़ें" -"url": "/hi/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: GroupDocs Annotation Library Java के साथ PDF को एनोटेट करना सीखें – चरण‑दर‑चरण + गाइड, कोड स्निपेट्स, प्रदर्शन टिप्स, और सर्वोत्तम प्रथाएँ। +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Java में PDF एनोटेशन जोड़ें +og_description: GroupDocs Annotation Library Java के साथ PDF को एनोटेट करना सीखें + – एक गाइड जिसमें ellipse annotations, comments, licensing, और Java developers के + लिए टिप्स शामिल हैं। +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: GroupDocs Annotation Library Java के साथ PDF को कैसे एनोटेट करें +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: GroupDocs Annotation Library Java के साथ PDF को कैसे एनोटेट करें type: docs -"weight": 1 +url: /hi/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Java के लिए GroupDocs.Annotation का उपयोग करके PDF में दीर्घवृत्त एनोटेशन कैसे जोड़ें +# GroupDocs Annotation Library Java के साथ PDF पर टिप्पणी कैसे जोड़ें -## परिचय -PDF में एनोटेशन जोड़ने से सहयोग और संचार में काफी सुधार हो सकता है, खासकर जब जटिल दस्तावेज़ों से निपटना हो। यदि आप जावा का उपयोग करके प्रोग्रामेटिक रूप से अपने PDF में विशिष्ट क्षेत्रों को हाइलाइट या एनोटेट करना चाहते हैं, तो यह ट्यूटोरियल आपको दीर्घवृत्त एनोटेशन को सहजता से जोड़ने की प्रक्रिया के माध्यम से मार्गदर्शन करेगा। Java के लिए GroupDocs.Annotation की शक्ति का लाभ उठाकर, डेवलपर्स आसानी से अपने अनुप्रयोगों में परिष्कृत एनोटेशन सुविधाओं को शामिल कर सकते हैं। +Adding visual notes, comments, or stamps to a PDF programmatically can dramatically speed up review cycles, compliance checks, and collaborative workflows. In this tutorial you’ll discover **how to annotate PDF** files using the GroupDocs Annotation Library for Java, covering everything from project setup to advanced ellipse annotations, licensing, performance tuning, and real‑world integration tips. -इस ट्यूटोरियल में हम निम्नलिखित विषयों पर चर्चा करेंगे: -- जावा प्रोजेक्ट में GroupDocs.Annotation को कैसे सेट अप और एकीकृत करें। -- पीडीएफ दस्तावेज़ में दीर्घवृत्त एनोटेशन जोड़ने के बारे में चरण-दर-चरण निर्देश। -- वास्तविक दुनिया के उपयोग के मामलों को प्रदर्शित करने वाले व्यावहारिक उदाहरण। +## त्वरित उत्तर +- **Java में PDFs पर टिप्पणी जोड़ने वाली लाइब्रेरी कौन सी है?** GroupDocs Annotation Library for Java. +- **क्या मुझे लाइसेंस चाहिए?** परीक्षण के लिए ट्रायल काम करता है; व्यावसायिक उपयोग के लिए प्रोडक्शन लाइसेंस आवश्यक है। +- **कौन सा IDE सबसे अच्छा है?** कोई भी Java IDE (IntelliJ IDEA, Eclipse, VS Code) ठीक काम करता है। +- **क्या मैं पासवर्ड‑सुरक्षित PDFs पर टिप्पणी कर सकता हूँ?** हाँ—`Annotator` बनाते समय पासवर्ड प्रदान करें। +- **क्या बैच प्रोसेसिंग समर्थित है?** बिल्कुल; बाद में बैच प्रोसेसिंग उदाहरण देखें। -आइये शुरू करने से पहले उन पूर्वापेक्षाओं पर नजर डालें जिनकी आपको आवश्यकता है! +## GroupDocs Annotation Library Java क्या है? -## आवश्यक शर्तें -इस ट्यूटोरियल का अनुसरण करने के लिए आपको निम्न की आवश्यकता होगी: -- **जावा डेवलपमेंट किट (JDK)**: सुनिश्चित करें कि आपके पास JDK इंस्टॉल है। यह उदाहरण Java 8 या उच्चतर का उपयोग करता है। -- **जावा लाइब्रेरी के लिए GroupDocs.Annotation**हम लाइब्रेरी के संस्करण 25.2 का उपयोग करेंगे। -- **मावेन सेटअप**निर्भरताओं को आसानी से प्रबंधित करने के लिए मावेन की आवश्यकता होती है। +GroupDocs Annotation Library Java एक तैयार‑से‑उपयोग API है जो डेवलपर्स को पूरी तरह से Java कोड में PDF एनोटेशन बनाना, संपादित करना, प्राप्त करना और हटाना सक्षम करता है। यह **50 से अधिक दस्तावेज़ फ़ॉर्मेट** का समर्थन करता है, अंतर्निहित टिप्पणी थ्रेड्स प्रदान करता है, और सूक्ष्म अनुमति नियंत्रण देता है। -सुनिश्चित करें कि आपका विकास वातावरण इन आवश्यकताओं का समर्थन करता है और आप बुनियादी जावा प्रोग्रामिंग अवधारणाओं, विशेष रूप से लाइब्रेरीज़ के साथ काम करने और जावा में फ़ाइलों को संभालने में सहज हैं। +## GroupDocs Annotation Library Java का उपयोग क्यों करें? -## Java के लिए GroupDocs.Annotation सेट अप करना -### मावेन के माध्यम से स्थापना -Maven का उपयोग करके अपने प्रोजेक्ट में GroupDocs.Annotation को एकीकृत करने के लिए, अपने प्रोजेक्ट में निम्नलिखित रिपॉजिटरी और निर्भरता जोड़ें `pom.xml` फ़ाइल: +आप कुछ ही मेथड कॉल्स से समृद्ध मार्कअप—जैसे एलिप्स, टेक्स्ट नोट्स, स्टैम्प और वॉटरमार्क—जोड़ सकते हैं, और लाइब्रेरी **सैकड़ों‑पृष्ठों वाले PDFs** को पूरी फ़ाइल को मेमोरी में लोड किए बिना प्रोसेस करती है। iText या PDFBox जैसे लो‑लेवल टूल्स की तुलना में, यह विकास समय को **70 %** तक कम कर देता है और जटिल PDF सुविधाओं (लेयर्स, फ़ॉर्म, डिजिटल सिग्नेचर) को बॉक्स से बाहर संभालता है। + +## पूर्वापेक्षाएँ और सेटअप +- **JDK 8+** (JDK 11 अनुशंसित) +- **Maven या Gradle** निर्भरता प्रबंधन के लिए +- **IDE** आपका चयन (IntelliJ IDEA, Eclipse, VS Code) +- Java फ़ाइल I/O की बुनियादी परिचितता + +### Maven इंटीग्रेशन +`pom.xml` में रिपॉज़िटरी और डिपेंडेंसी जोड़ें: ```xml @@ -48,31 +119,27 @@ Maven का उपयोग करके अपने प्रोजेक् ``` -### लाइसेंस अधिग्रहण -शुरू करने से पहले, GroupDocs.Annotation के लिए लाइसेंस प्राप्त करना सुनिश्चित करें। आप एक निःशुल्क परीक्षण प्राप्त कर सकते हैं या उनकी वेबसाइट से पूर्ण लाइसेंस खरीद सकते हैं। लाइसेंस लागू करना सरल है और यह सुनिश्चित करता है कि आपको बिना किसी प्रतिबंध के सभी सुविधाओं तक पहुँच प्राप्त है। - -अपना लाइसेंस आवेदन करने का तरीका इस प्रकार है: +### लाइसेंस कॉन्फ़िगरेशन +किसी भी एनोटेशन कार्य से पहले अपना लाइसेंस लागू करें: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## कार्यान्वयन मार्गदर्शिका -### दीर्घवृत्त एनोटेशन जोड़ना -दीर्घवृत्त एनोटेशन जोड़ने में एनोटेशन लाइब्रेरी को आरंभ करना, दस्तावेज़ को सेट करना और एनोटेशन गुणों को कॉन्फ़िगर करना शामिल है। यहाँ बताया गया है कि आप इसे चरण-दर-चरण कैसे प्राप्त कर सकते हैं। +*Pro tip:* लाइसेंस फ़ाइल को `src/main/resources` में रखें और `getClass().getResourceAsStream()` से लोड करें ताकि डिप्लॉयमेंट आसान हो। + +## पूर्ण कार्यान्वयन गाइड -#### चरण 1: इनपुट दस्तावेज़ के साथ एनोटेटर आरंभ करें -सबसे पहले, एक बनाएं `Annotator` अपनी PDF फ़ाइल का पथ निर्दिष्ट करके: +### चरण 1: PDF Annotator को इनिशियलाइज़ करें +`Annotator` क्लास सभी एनोटेशन ऑपरेशन्स का एंट्री पॉइंट है। यह लक्ष्य PDF को लोड करता है, सुरक्षा सेटिंग्स लागू करता है, और संपादन के लिए मेमोरी में प्रतिनिधित्व तैयार करता है। ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -यह एनोटेशन जोड़ने के लिए वातावरण को आरंभ करता है। - -#### चरण 2: उत्तर बनाएँ और कॉन्फ़िगर करें -एनोटेशन में उत्तर या टिप्पणियाँ शामिल हो सकती हैं। यहाँ बताया गया है कि आप उत्तर कैसे सेट करते हैं: +### चरण 2: इंटरैक्टिव टिप्पणियाँ और उत्तर बनाएं +`CommentAnnotation` आपको फ्री‑फ़ॉर्म टेक्स्ट एम्बेड करने देता है, जबकि `Reply` ऑब्जेक्ट्स सीधे PDF पेज पर थ्रेडेड चर्चा सक्षम करते हैं। ```java Reply reply1 = new Reply(); @@ -88,83 +155,217 @@ replies.add(reply1); replies.add(reply2); ``` -ये उत्तर दीर्घवृत्त एनोटेशन से संलग्न किए जाएंगे। - -#### चरण 3: दीर्घवृत्त एनोटेशन बनाएँ और कॉन्फ़िगर करें -अब, एक बनाएं `EllipseAnnotation` ऑब्जेक्ट और उसके गुणों को कॉन्फ़िगर करें: +### चरण 3: अपनी एलिप्स एनोटेशन कॉन्फ़िगर करें +`EllipseAnnotation` एक स्केलेबल ओवल आकार बनाता है। आप लाइन रंग, फ़िल रंग, अपारदर्शिता, और कस्टम बॉर्डर मोटाई सेट कर सकते हैं ताकि यह आपके UI दिशानिर्देशों से मेल खाए। ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // पीला पृष्ठभूमि रंग -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // स्थिति और आकार को परिभाषित करता है +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // एनोटेशन के लिए लक्ष्य पृष्ठ संख्या -ellipse.setPenColor(65535); // RGB प्रारूप में पेन का रंग -ellipse.setPenStyle(PenStyle.DOT); // डॉट स्टाइल पेन -ellipse.setPenWidth((byte) 3); // पेन की चौड़ाई +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -यह सेटअप आपके दीर्घवृत्त एनोटेशन के स्वरूप और मेटाडेटा को परिभाषित करता है। - -#### चरण 4: दस्तावेज़ में एनोटेशन जोड़ें -अपने दस्तावेज़ में कॉन्फ़िगर किया गया दीर्घवृत्त एनोटेशन जोड़ें: +### चरण 4: अपनी एनोटेशन जोड़ें और सहेजें +सभी एनोटेशन ऑब्जेक्ट्स को कॉन्फ़िगर करने के बाद, `annotator.save()` को कॉल करें ताकि परिवर्तन डिस्क पर लिखे जा सकें। विशेष रूप से जब लूप में कई फ़ाइलों को प्रोसेस करते समय `dispose()` को कॉल करना याद रखें ताकि नेटिव रिसोर्सेज़ मुक्त हो सकें। ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); +``` + +> **`dispose()` क्यों कॉल करें?** यह नेटिव रिसोर्सेज़ को रिलीज़ करता है, मेमोरी लीक को रोकता है—विशेष रूप से जब लूप में कई PDFs प्रोसेस किए जा रहे हों तो यह महत्वपूर्ण है। + +## सामान्य समस्याएँ और समाधान + +### समस्या 1 – “Document Not Found” +*कारण:* गलत फ़ाइल पाथ या कार्य निर्देशिका। +*समाधान:* पूर्ण पाथ की जाँच करें या बेस डायरेक्टरी की पुष्टि के लिए `System.getProperty("user.dir")` प्रिंट करें। + +### समस्या 2 – एनोटेशन दिखाई नहीं दे रहे हैं +*कारण:* गलत कोऑर्डिनेट सिस्टम या पेज इंडेक्स। +*समाधान:* याद रखें PDF कोऑर्डिनेट्स बॉटम‑लेफ़्ट से शुरू होते हैं, और पेजेज़ ज़ीरो‑बेस्ड होते हैं। + +### समस्या 3 – बड़े PDFs पर OutOfMemoryError +*कारण:* पूरा दस्तावेज़ मेमोरी में लोड हो रहा है। +*समाधान:* JVM हीप बढ़ाएँ (`-Xmx2g`) या पेजेज़ को बैच में प्रोसेस करें (नीचे बैच उदाहरण देखें)। + +### समस्या 4 – लाइसेंस वैधता त्रुटियाँ +*कारण:* लाइसेंस फ़ाइल गायब या मेल नहीं खा रही है। +*समाधान:* फ़ाइल पाथ को दोबारा जांचें और सुनिश्चित करें कि लाइसेंस संस्करण लाइब्रेरी संस्करण से मेल खाता हो। + +## प्रदर्शन अनुकूलन टिप्स + +### मेमोरी प्रबंधन सर्वोत्तम प्रैक्टिसेज़ +बड़े `Annotator` इंस्टेंस के रेफ़रेंस को अनावश्यक रूप से लंबे समय तक न रखें। प्रत्येक फ़ाइल प्रोसेस होने के बाद try‑with‑resources या स्पष्ट `dispose()` कॉल का उपयोग करें। + +```java +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -#### चरण 5: संसाधनों को सहेजें और उनका निपटान करें -अंत में, एनोटेट दस्तावेज़ को सहेजें और संसाधन जारी करें: +### बैच प्रोसेसिंग रणनीतियाँ +- **छोटे PDFs (<10 MB):** व्यक्तिगत रूप से प्रोसेस करें। +- **मध्यम PDFs (10‑50 MB):** 5‑10 के बैच में प्रोसेस करें। +- **बड़े PDFs (>50 MB):** OOM से बचने के लिए स्ट्रीमिंग या चंंक्ड प्रोसेसिंग का उपयोग करें। + +### कैशिंग विचार +`AnnotationAppearance` क्लास एनोटेशन के विज़ुअल प्रॉपर्टीज़ जैसे रंग और अपारदर्शिता को समेटता है। जब आप कई पेजों पर समान स्टाइलिंग के साथ एनोटेट करते हैं, तो `AnnotationAppearance` या `Color` इंस्टेंस जैसे पुन: उपयोग योग्य ऑब्जेक्ट्स को कैश करें। ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} ``` -## व्यावहारिक अनुप्रयोगों -- **शैक्षिक उपकरण**: पीडीएफ पाठ्यपुस्तकों में प्रमुख अवधारणाओं पर प्रकाश डालना। -- **कानूनी दस्तावेजों**: समीक्षा या अनुमोदन के लिए अनुभागों पर टिप्पणी करना। -- **मेडिकल रिकॉर्ड**महत्वपूर्ण अवलोकनों या नोट्स को चिह्नित करना। +## वास्तविक‑दुनिया इंटीग्रेशन उदाहरण -GroupDocs.Annotation दस्तावेज़ प्रबंधन प्रणालियों के साथ एकीकृत हो सकता है, जिससे उनकी एनोटेशन क्षमताएं बढ़ जाती हैं। +### वेब एप्लिकेशन इंटीग्रेशन +एक REST एन्डपॉइंट बनाएं जो PDF स्ट्रीम स्वीकार करे, फ्रंट‑एंड द्वारा प्रदान किए गए कोऑर्डिनेट्स पर एलिप्स एनोटेशन लागू करे, और एनोटेटेड PDF को बाइट एरे के रूप में वापस करे। -## प्रदर्शन संबंधी विचार -इष्टतम प्रदर्शन के लिए: -- **स्मृति प्रबंधन**बड़े दस्तावेज़ों को संभालते समय मेमोरी उपयोग की निगरानी और प्रबंधन करें। -- **प्रचय संसाधन**यदि आप एकाधिक PDF पर टिप्पणी कर रहे हैं, तो संसाधन उपयोग को अनुकूलित करने के लिए उन्हें बैचों में संसाधित करने पर विचार करें। +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` -ये अभ्यास GroupDocs.Annotation का उपयोग करके आपके Java अनुप्रयोग के कुशल संचालन को सुनिश्चित करते हैं। +### बैच डॉक्यूमेंट प्रोसेसिंग +कॉन्ट्रैक्ट्स की डायरेक्टरी पर इटरेट करें, प्रत्येक पर “Reviewed” स्टैम्प जोड़ें, और प्रोसेस की गई फ़ाइलों को आर्काइव फ़ोल्डर में ले जाएँ। -## निष्कर्ष -इस ट्यूटोरियल का अनुसरण करके, आपने सीखा है कि GroupDocs.Annotation for Java का उपयोग करके PDF में दीर्घवृत्त एनोटेशन कैसे जोड़ें। यह सुविधा उन अनुप्रयोगों के लिए अमूल्य है जिन्हें विस्तृत दस्तावेज़ समीक्षा और सहयोगी संपादन की आवश्यकता होती है। +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` + +## उन्नत एनोटेशन तकनीकें + +### डायनामिक एनोटेशन पोजिशनिंग +OCR या PDF टेक्स्ट एक्सट्रैक्शन API का उपयोग करके पहचाने गए टेक्स्ट लोकेशन के आधार पर एनोटेशन कोऑर्डिनेट्स को रीयल‑टाइम में गणना करें, फिर कीवर्ड्स के चारों ओर एलिप्स रखें। + +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### कंडीशनल एनोटेशन स्टाइलिंग +एनोटेशन के लेखक की भूमिका के आधार पर विभिन्न रंग या अपारदर्शिता स्तर लागू करें (जैसे, reviewer = नीला, approver = हरा)। + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` + +## व्यावहारिक अनुप्रयोग और उपयोग केस +- **शैक्षिक प्लेटफ़ॉर्म:** अवधारणाओं को हाइलाइट करें, शिक्षक की टिप्पणियाँ जोड़ें, इंटरैक्टिव स्टडी गाइड बनाएं। +- **कानूनी दस्तावेज़ समीक्षा:** क्लॉज़ को मार्क करें, गोपनीय नोट्स जोड़ें, ऑडिट ट्रेल बनाए रखें। +- **मेडिकल रिकॉर्ड्स:** अवलोकन को एनोटेट करें, महत्वपूर्ण डेटा को हाइलाइट करें, सुरक्षित सहयोग सक्षम करें। +- **कॉर्पोरेट वर्कफ़्लो:** रिपोर्ट अनुमोदन को सुव्यवस्थित करें, रिव्यूअर स्टैम्प जोड़ें, बदलावों को ट्रैक करें। + +## विभिन्न एनोटेशन प्रकार कब उपयोग करें -अपने कौशल को और बढ़ाने के लिए, ग्रुपडॉक्स लाइब्रेरी में उपलब्ध अतिरिक्त एनोटेशन प्रकारों का पता लगाएं या कार्यक्षमता को एक बड़ी परियोजना में एकीकृत करें। +एलिप्स एनोटेशन तब आदर्श होते हैं जब आपको गैर‑आयताकार हाइलाइट चाहिए, जैसे सर्कुलर डायग्राम, लोगो, या ऐसे क्षेत्र जिन्हें ओवल आकार से बेहतर दर्शाया जा सकता है। ये स्पष्ट विज़ुअल संकेत देते हैं जबकि पठनीयता बनाए रखते हैं, जिससे वे डिज़ाइन रिव्यू, ब्रांडिंग चेक, और किसी भी स्थिति में जहाँ गोल ज़ोर देना पसंद किया जाता है, उपयुक्त होते हैं। -## अक्सर पूछे जाने वाले प्रश्न अनुभाग -**प्रश्न: क्या मैं GroupDocs.Annotation के साथ अन्य प्रकार के दस्तावेज़ों पर टिप्पणी कर सकता हूँ?** -उत्तर: हां, ग्रुपडॉक्स पीडीएफ से परे विभिन्न दस्तावेज़ प्रारूपों पर एनोटेशन का समर्थन करता है, जिसमें वर्ड और एक्सेल फाइलें शामिल हैं। +जबकि यह गाइड एलिप्स एनोटेशन पर केंद्रित है, GroupDocs Annotation Library Java निम्नलिखित भी प्रदान करता है: +- **टेक्स्ट एनोटेशन** विस्तृत टिप्पणियों के लिए। +- **एरो एनोटेशन** विशिष्ट तत्वों की ओर संकेत करने के लिए। +- **रेक्टेंगल एनोटेशन** क्षेत्र हाइलाइट करने के लिए। +- **वॉटरमार्क एनोटेशन** ब्रांडिंग या सुरक्षा के लिए। +- **स्टैम्प एनोटेशन** अनुमोदन के लिए। -**प्रश्न: मैं सामग्री के आधार पर एनोटेशन का रंग गतिशील रूप से कैसे बदल सकता हूँ?** -उत्तर: आप प्रोग्रामेटिक रूप से सेट कर सकते हैं `penColor` एनोटेशन जोड़ने से पहले अपने तर्क के आधार पर संपत्ति का चयन करें। +## ट्रबलशूटिंग गाइड -**प्रश्न: समर्थित एनोटेशन की अधिकतम संख्या क्या है?** -उत्तर: GroupDocs.Annotation बड़ी संख्या में एनोटेशन की अनुमति देता है, लेकिन अपने विशिष्ट दस्तावेज़ आकार और प्रकार के साथ प्रदर्शन का परीक्षण करना उचित है। +### प्रदर्शन समस्याएँ +- **लक्षण:** प्रोसेसिंग धीमी। +- **निदान:** बड़ी फ़ाइल साइज, कई एनोटेशन, सीमित RAM। +- **समाधान:** एनोटेशन प्रॉपर्टीज़ को ऑप्टिमाइज़ करें, असिंक्रोनस प्रोसेस करें, या बड़े PDFs को पेजिनेट करें। + +### संगतता समस्याएँ +- **लक्षण:** विभिन्न व्यूअर्स में एनोटेशन अलग दिखते हैं। +- **निदान:** गैर‑मानक PDF फीचर्स। +- **समाधान:** Adobe Acrobat, Chrome, और Firefox के साथ टेस्ट करें; PDF‑स्टैंडर्ड एनोटेशन फ्लैग्स पर टिके रहें। + +### इंटीग्रेशन चुनौतियाँ +- **लक्षण:** डिपेंडेंसी कॉन्फ्लिक्ट्स। +- **निदान:** अन्य लाइब्रेरीज़ के साथ संस्करण मेल नहीं। +- **समाधान:** Maven के `` का उपयोग करके संगत संस्करण लागू करें या भाषा‑अज्ञेय इंटीग्रेशन के लिए REST API पर स्विच करें। + +## अक्सर पूछे जाने वाले प्रश्न + +**प्रश्न:** क्या मैं पासवर्ड‑सुरक्षित PDFs पर एनोटेशन जोड़ सकता हूँ? +**उत्तर:** हाँ। `new Annotator(filePath, loadOptions)` ओवरलोड का उपयोग करें जहाँ `loadOptions` में पासवर्ड शामिल हो। + +**प्रश्न:** 100 MB से बड़े PDFs को कैसे हैंडल करें? +**उत्तर:** पेजेज़ को व्यक्तिगत रूप से प्रोसेस करें, हीप साइज बढ़ाएँ, या भारी वर्कलोड के लिए GroupDocs Annotation Cloud API का उपयोग करें। + +**प्रश्न:** क्या दस्तावेज़ प्रति एनोटेशन की संख्या पर कोई सीमा है? +**उत्तर:** कोई कठोर सीमा नहीं है, लेकिन हजारों एनोटेशन के बाद प्रदर्शन घट सकता है। पेजिनेशन या ग्रुपिंग पर विचार करें। + +**प्रश्न:** क्या मैं मौजूदा एनोटेशन निकाल सकता हूँ? +**उत्तर:** बिल्कुल। `annotator.get()` को कॉल करके PDF से सभी एनोटेशन प्राप्त करें। + +**प्रश्न:** मैं एनोटेशन को कैसे सुरक्षित करूँ ताकि केवल कुछ उपयोगकर्ता ही उन्हें संपादित कर सकें? +**उत्तर:** लाइब्रेरी उपयोगकर्ता‑आधारित अनुमति सेटिंग्स प्रदान करती है; इन्हें `AnnotationPermission` API के माध्यम से कॉन्फ़िगर करें। + +## निष्कर्ष +**GroupDocs Annotation Library Java** आपको एक साफ़, उच्च‑प्रदर्शन तरीका देता है जिससे आप सीधे Java कोड से समृद्ध PDF एनोटेशन एम्बेड कर सकते हैं। ऊपर दिए गए चरणों का पालन करके आप एलिप्स एनोटेशन जोड़ सकते हैं, टिप्पणियों का प्रबंधन कर सकते हैं, और एंटरप्राइज़‑स्तर के वर्कलोड को स्केल कर सकते हैं। + +**अगले कदम:** +1. अन्य एनोटेशन प्रकारों (टेक्स्ट, स्टैम्प, वॉटरमार्क) के साथ प्रयोग करें। +2. लाइब्रेरी को अपने मौजूदा दस्तावेज़ वर्कफ़्लो या वेब सर्विस में इंटीग्रेट करें। +3. भाषा‑अज्ञेय परिदृश्यों के लिए REST API का अन्वेषण करें। + +--- -**प्रश्न: मैं ओवरलैपिंग एनोटेशन को कैसे संभालूँ?** -A: समायोजित करें `box` आयाम और स्थिति, ओवरलैप्स को प्रबंधित करने या आवश्यकतानुसार एकाधिक एनोटेशन को स्तरित करने के लिए। +**अंतिम अपडेट:** 2026-07-25 +**परीक्षित संस्करण:** GroupDocs.Annotation 25.2 for Java +**लेखक:** GroupDocs -**प्रश्न: वेब अनुप्रयोग में GroupDocs.Annotation का उपयोग करने के लिए कुछ सर्वोत्तम अभ्यास क्या हैं?** -उत्तर: बड़े दस्तावेज़ों के लिए एसिंक्रोनस प्रसंस्करण का उपयोग करें, एनोटेट फ़ाइलों का सुरक्षित भंडारण सुनिश्चित करें, और एनोटेशन इंटरैक्शन के लिए उपयोगकर्ता-अनुकूल इंटरफेस प्रदान करें। +**महत्वपूर्ण लिंक:** +- **डॉक्यूमेंटेशन:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **API रेफ़रेंस:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **डाउनलोड:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **खरीदें:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **फ़्री ट्रायल:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **टेम्पररी लाइसेंस:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **सपोर्ट:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) -## संसाधन -- **प्रलेखन**: [ग्रुपडॉक्स एनोटेशन जावा डॉक्यूमेंटेशन](https://docs.groupdocs.com/annotation/java/) -- **एपीआई संदर्भ**: [ग्रुपडॉक्स एपीआई संदर्भ](https://reference.groupdocs.com/annotation/java/) -- **डाउनलोड करना**: [ग्रुपडॉक्स.एनोटेशन डाउनलोड करें](https://releases.groupdocs.com/annotation/java/) -- **खरीदना**: [ग्रुपडॉक्स लाइसेंस खरीदें](https://purchase.groupdocs.com/buy) -- **मुफ्त परीक्षण**: [निःशुल्क परीक्षण शुरू करें](https://releases.groupdocs.com/annotation/java/) -- **अस्थायी लाइसेंस**: [अस्थायी लाइसेंस का अनुरोध करें](https://purchase.groupdocs.com/temporary-license/) -- **सहायता**: [ग्रुपडॉक्स सहायता फ़ोरम](https://forum.groupdocs.com/c/annotation/) +## संबंधित ट्यूटोरियल -यह व्यापक गाइड आपको GroupDocs.Annotation का उपयोग करके अपने जावा अनुप्रयोगों में प्रभावी रूप से दीर्घवृत्त एनोटेशन जोड़ने के ज्ञान से लैस करेगी। हैप्पी कोडिंग! \ No newline at end of file +- [Java के साथ PDF में एरो कैसे जोड़ें – पूर्ण ट्यूटोरियल और सर्वोत्तम प्रैक्टिसेज़](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Java और GroupDocs Annotation का उपयोग करके PDF में इमेज कैसे जोड़ें](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [पूर्ण गाइड - Java के लिए GroupDocs.Annotation के साथ एनोटेटेड PDF कैसे सहेजें](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/hongkong/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/hongkong/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index d4a8bda14..6fd9709ba 100644 --- a/content/hongkong/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/hongkong/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,48 +1,104 @@ --- categories: - Java Development -date: '2026-02-03' -description: 學習如何使用 GroupDocs Annotation Library for Java 為 PDF 檔案添加註釋。逐步指南、程式碼範例、故障排除技巧與最佳實踐。 -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: 了解如何使用 GroupDocs Annotation Library Java 為 PDF 加註 – 步驟教學、程式碼範例、效能技巧與最佳實踐。 +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: 在 Java 中為 PDF 加註 +og_description: 了解如何使用 GroupDocs Annotation Library Java 為 PDF 加註 – 本指南涵蓋 ellipse + annotations、comments、licensing，以及給 Java developers 的技巧。 +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: 如何使用 GroupDocs Annotation Library Java 為 PDF 加註 +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: GroupDocs 註解庫 Java：新增 PDF 註解 +- document processing +- ellipse annotation +title: 如何使用 GroupDocs Annotation Library Java 為 PDF 加註 type: docs url: /zh-hant/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java：新增 PDF 註解 +# 如何使用 GroupDocs Annotation Library Java 為 PDF 加註 -有沒有想過如何在 Java 中以程式方式為 PDF 文件加入註解？使用 **groupdocs annotation library java**，您可以直接在 PDF 中嵌入橢或門。 +Adding visual notes, comments, or stamps to a PDF programmatically can dramatically speed up review cycles, compliance checks, and collaborative workflows. In this tutorial you’ll discover **how to annotate PDF** files using the GroupDocs Annotation Library for Java, covering everything from project setup to advanced ellipse annotations, licensing, performance tuning, and real‑world integration tips. ## 快速解答 -- **什麼程式庫可在 Java 中為 PDF 加入註解？** groupdocs購個VS Code）皆可。 -- **我可以為受密碼保護的 PDF 加註解嗎？** 可以——在建立 `Annotator` 時提供密碼。 -- **支援批次處理嗎？** 當然；請參閱下方批次處理範例。 +- **哪個程式庫可在 Java 中為 PDF 加註？** GroupDocs Annotation Library for Java。 +- **我需要授權嗎？** 測試可使用試用版；商業使用需購買正式授權。 +- **哪個 IDE 最適合？** 任何 Java IDE（IntelliJ IDEA、Eclipse、VS Code）皆可正常使用。 +- **我可以為受密碼保護的 PDF 加註嗎？** 是——在建立 `Annotator` 時提供密碼即可。 +- **是否支援批次處理？** 當然可以；請參閱下方的批次處理範例。 ## 什麼是 GroupDocs Annotation Library Java？ -groupdocs annotation library java 是一套功能強大、企業級的 Java API，讓您能以程式方式建立、編輯與取得 PDF 註解。它支援超過 50 種文件格式，並提供回覆與評論串等協作功能。 + +GroupDocs Annotation Library Java 是一套即用型 API，讓開發人員能在 Java 程式碼中完整建立、編輯、取得與刪除 PDF 加註。它支援 **超過 50 種文件格式**，內建評論串功能，並提供細緻的權限控制。 ## 為何使用 GroupDocs Annotation Library Java？ -- **豐富的註解類型** – 形狀、文字、印章、水印等。 -- **協作就緒** – 內建回覆與評論串。 -- **效能優化** – 能有效處理大型 PDF。 -- **簡易 API** – 相較於 iText 或 PDFBox 等底層函式庫，可短開發時間。 -## 前置條件與設定 -- **JDK 8+**（建議使用 JDK 11） -- **Maven 或 Gradle** 用於相依管理 -- **IDE**（自行選擇，如 IntelliJ IDEA、E 設定 GroupDocs Annotation Library Java +只需幾個方法呼叫，即可加入豐富的標註——包括橢圓、文字註解、印章與浮水印，且此程式庫能在不將整個檔案載入記憶體的情況下處理 **數百頁的 PDF**。與 iText 或 PDFBox 等底層工具相比，可將開發時間縮短最高 **70 %**，且內建支援複雜的 PDF 功能（圖層、表單、數位簽章）。 + +## 先決條件與設定 +- **JDK 8 以上（建議使用 JDK 11）** +- **Maven 或 Gradle 以管理相依性** +- **自行選擇的 IDE（IntelliJ IDEA、Eclipse、VS Code）** +- **具備基本的 Java 檔案 I/O 知識** ### Maven 整合 -在 `pom.xml` 中加入倉庫與相依： +在 `pom.xml` 中加入儲存庫與相依性： ```xml @@ -62,23 +118,27 @@ groupdocs annotation library java 是一套功能強大、企業級的 Java API ``` ### 授權設定 -在執行任何註解操作前先套用授權： +在任何加註操作之前套用授權： ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -*小技巧：* 將授權檔案放在 `src/main/resources`，並使用 `getClass().getResourceAsStream()` 載入，以便更順利部署。 +*小技巧：*將授權檔案放在 `src/main/resources`，並使用 `getClass().getResourceAsStream()` 載入，以便更順暢的部署。 ## 完整實作指南 -### 步驟 1：初始化 PDF 註解器 +### 步驟 1：初始化 PDF Annotator +`Annotator` 類別是所有加註操作的入口。它會載入目標 PDF、套用安全設定，並建立供編輯的記憶體表示。 + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### 步驟 2：建立互動式評論與回覆 +`CommentAnnotation` 讓您嵌入自由文字，而 `Reply` 物件則可在 PDF 頁面上直接建立串狀討論。 + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -93,7 +153,9 @@ replies.add(reply1); replies.add(reply2); ``` -### 步驟 3：設定橢圓註解 +### 步驟 3：設定橢圓形加註 +`EllipseAnnotation` 繪製可縮放的橢圓形。您可以設定線條顏色、填充顏色、不透明度以及自訂邊框粗細，以符合 UI 規範。 + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -107,34 +169,40 @@ ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -### 步驟 4：新增並儲存註解 +### 步驟 4：加入並儲存加註 +完成所有加註物件的設定後，呼叫 `annotator.save()` 將變更寫回磁碟。務必呼叫 `dispose()` 釋放原生資源，特別是在迴圈中處理大量檔案時。 + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **為何要呼叫 `dispose()`？** 它會釋放原生資源，防止記憶體泄漏——在迴圈處理大量 PDF 時尤為重要。 +> **為何要呼叫 `dispose()`？**它會釋放原生資源，防止記憶體洩漏——在迴圈處理大量 PDF 時尤為重要。 ## 常見問題與解決方案 ### 問題 1 – 「找不到文件」 -*原因：* 檔案路徑或工作目錄不正確。 -*解決方法：* 檢查絕對路徑，或列印 `System.getProperty("user.dir")` 以確認基礎目錄。 +*原因：*檔案路徑或工作目錄不正確。 +*解決方法：*確認絕對路徑，或列印 `System.getProperty("user.dir")` 以驗證基礎目錄。 -### 問題 2 – 註解未顯示 -*原因：* 坐標系統或頁碼錯誤。 -*解決方法：* 記得 PDF 坐標從左下角開始，且頁碼從 0 起算。 +### 問題 2 – 加註未顯示 +*原因：*座標系統或頁碼錯誤。 +*解決方法：*請記得 PDF 座標以左下角為原點，且頁碼從 0 開始計算。 ### 問題 3 – 大型 PDF 發生 OutOfMemoryError -*原因：* 整份文件一次載入記憶體。 -*解決方法：* 增加 JVM 堆積大小（`-X### 問題 4 – 授權驗證錯誤 -*原因：* 授權檔案遺失或版本不符。 -*解決方法：* 再次確認檔案路徑，並確保授權版本與函式庫版本相符。 +*原因：*整份文件被載入記憶體。 +*解決方法：*增加 JVM 堆積大小（`-Xmx2g`）或分批處理頁面（請參閱下方的批次範例）。 -## 效能最佳化建議 +### 問題 4 – 授權驗證錯誤 +*原因：*授權檔案遺失或不相符。 +*解決方法：*再次確認檔案路徑，並確保授權版本與程式庫版本相符。 + +## 效能最佳化技巧 ### 記憶體管理最佳實踐 +避免長時間保留大型 `Annotator` 例項的參考。處理完每個檔案後，使用 try‑with‑resources 或明確呼叫 `dispose()` 釋放資源。 + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -146,11 +214,13 @@ for (String documentPath : documentPaths) { ``` ### 批次處理策略 -- **小型 PDF（<10 MB）：** 單獨處理。 +- **小型 PDF（<10 MB）：** 個別處理。 - **中型 PDF（10‑50 MB）：** 以 5‑10 個為一批處理。 - **大型 PDF（>50 MB）：** 使用串流或分塊處理以避免 OOM。 ### 快取考量 +`AnnotationAppearance` 類別封裝了加註的視覺屬性，如顏色與不透明度。當在多頁使用相同樣式時，請快取可重複使用的物件，例如 `AnnotationAppearance` 或 `Color` 實例。 + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -160,9 +230,11 @@ private static EllipseAnnotation createStandardEllipse() { } ``` -## 真實案例整合範例 +## 實務整合範例 + +### Web 應用程式整合 +提供一個 REST 端點，接受 PDF 串流、在前端傳入的座標處加上橢圓形加註，並以位元組陣列回傳已加註的 PDF。 -### 網頁應用程式整合 ```java @RestController @RequestMapping("/api/documents") @@ -180,6 +252,8 @@ public class DocumentAnnotationController { ``` ### 批次文件處理 +遍歷合同資料夾，為每個檔案加上「已審閱」印章，然後將處理過的檔案移至歸檔資料夾。 + ```java public class BatchAnnotationProcessor { @@ -194,74 +268,102 @@ public class BatchAnnotationProcessor { } ``` -## 進階註解技巧 +## 進階加註技巧 + +### 動態加註定位 +使用 OCR 或 PDF 文字擷取 API 即時計算文字位置，依據偵測結果取得座標，然後在關鍵字周圍放置橢圓形加註。 -### 動態註解定位 ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); ellipse.setBox(dynamicPosition); ``` -### 條件式註解樣式 +### 條件式加註樣式 +根據加註作者的角色套用不同顏色或不透明度（例如，審閱者＝藍色，批准者＝綠色）。 + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow ellipse.setBackgroundColor(color); ``` -## 實務應用與使用情境 +## 實用應用與案例 - **教育平台：** 標示概念、加入教師評論、製作互動式學習指南。 -- **法律文件審閱：** 標註條款、加入機密備註、保留稽核紀錄。 -- **醫療紀錄：**協作。 -- **企業工作流程：** 簡化報告審批、加入審核印章、追蹤變更。 +- **法律文件審查：** 標註條款、加入機密備註、保留稽核追蹤。 +- **醫療紀錄：** 加註觀察結果、突顯關鍵資料、支援安全協作。 +- **企業工作流程：** 簡化報告批准、加入審閱印章、追蹤變更。 + +## 何時使用不同的加註類型 -## 何時使用不同的註解類型 -雖圓註解，groupdocs annotation library java 亦提供以下類型： -- **文字。 -- **矩形註解**：用於區域標示。 --**：用於批准。 +當需要非矩形的強調時，橢圓形加註最為理想，例如突顯圓形圖示、商標或以橢圓形較能表達的區域。它提供明顯的視覺提示，同時不影響可讀性，適用於設計審查、品牌檢查以及任何需要圓形強調的情境。 -當需要非矩形、視覺上突出的標示時，請選擇橢圓——非常適合強調圓形圖示或標誌區域。 +雖然本指南聚焦於橢圓形加註，GroupDocs Annotation Library Java 亦提供以下類型： +- **文字加註** 用於詳細評論。 +- **箭頭加註** 用於指向特定元素。 +- **矩形加註** 用於區域標示。 +- **浮水印加註** 用於品牌或安全目的。 +- **印章加註** 用於批准。 -## 疑難排解指南 +## 故障排除指南 ### 效能問題 -- **症狀：** 處理緩慢。 -- **診斷：** 檔案過大、註解過多、記憶體不足。 -- **解決方案：** 最佳化註解屬性、非同步處理，或將大型 PDF 分頁處理。 +- **症狀：** 處理速度緩慢。 +- **診斷：** 檔案過大、加註過多、記憶體不足。 +- **解決方案：** 最佳化加註屬性、非同步處理，或將大型 PDF 分頁處理。 ### 相容性問題 -- **症狀：** 不同檢視器的註解呈現不同。 +- **症狀：** 加註在不同檢視器上顯示不同。 - **診斷：** 非標準 PDF 功能。 -- **解決方案：** 使用 Adobe Acrobat、Chrome 與 Firefox 測試；遵循 PDF 標準註解旗標。 +- **解決方案：** 使用 Adobe Acrobat、Chrome 與 Firefox 測試；遵循 PDF 標準的加註旗標。 ### 整合挑戰 -- **症狀：** 相依衝突。 -- **診斷：** 與其他函式庫版本不符。 +- **症狀：** 相依性衝突。 +- **診斷：** 與其他程式庫版本不匹配。 - **解決方案：** 使用 Maven 的 `` 以強制相容版本，或改用 REST API 進行語言無關的整合。 ## 常見問答 -**Q: 我可以為受密碼保護的 PDF 加註解嗎？** -A: 可以。使用 `new Annotator(filePath, loadOptions)` 的重載，並在 `loadOptions` 中提供密碼。 +**Q: 我可以為受密碼保護的 PDF 加註嗎？** +A: 可以。使用 `new Annotator(filePath, loadOptions)` 的重載，於 `loadOptions` 中提供密碼。 -**Q: 我該如何處理大於 100 MB 的 PDF？** -A: 可逐頁處理、增加堆積大小，或使用 GroupDocs Annotation Cloud API 以應付大量工作負載。 +**Q: 如何處理大於 100 MB 的 PDF？** +A: 可逐頁處理、增加堆積大小，或使用 GroupDocs Annotation Cloud API 以應對大量工作負載。 -**Q: 每份文件的註解數量有限制嗎？** -A: 沒有硬性上限，但數千 我可以擷取既有的 當然可以。呼叫 ` 我該式庫提供基於使用者的權限設定，可透過 `AnnotationPermission` API 進行配置。 +**Q: 每份文件的加註數量有上限嗎？** +A: 沒有硬性上限，但超過數千個加註可能會影響效能。建議使用分頁或分組方式。 + +**Q: 我可以擷取現有的加註嗎？** +A: 當然可以。呼叫 `annotator.get()` 即可取得 PDF 中的所有加註。 + +**Q: 如何保護加註，使只有特定使用者能編輯？** +A: 程式庫提供基於使用者的權限設定，可透過 `AnnotationPermission` API 進行配置。 ## 結論 -**groupdocs annotation library java** 為您提供一種簡潔且高效的方式，直接從 Java 程式碼嵌入豐富的 PDF 註解。依照上述步驟，即可新增橢圓註解、.水印）。 -2支援03 GroupDocs.Annotation 25.2 for Java +**GroupDocs Annotation Library Java** 為您提供一個簡潔且高效能的方式，直接從 Java 程式碼嵌入豐富的 PDF 加註。依循上述步驟，即可加入橢圓形加註、管理評論，並擴展至企業級工作負載。 + +**後續步驟：** +1. 嘗試其他加註類型（文字、印章、浮水印）。 +2. 將程式庫整合至現有的文件工作流程或 Web 服務。 +3. 探索 REST API，以支援語言無關的情境。 + +--- + +**最後更新：** 2026-07-25 +**測試環境：** GroupDocs.Annotation 25.2 for Java **作者：** GroupDocs **重要連結：** -- **文件說明：** [GroupDocs Annotation Java 文件說明](https://docs.groupdocs.com/annotation/java/) +- **文件：** [GroupDocs Annotation Java 文件](https://docs.groupdocs.com/annotation/java/) - **API 參考：** [GroupDocs API 參考](https://reference.groupdocs.com/annotation/java/) - **下載：** [下載 GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) - **購買：** [購買 GroupDocs 授權](https://purchase.groupdocs.com/buy) - **免費試用：** [開始免費試用](https://releases.groupdocs.com/annotation/java/) - **臨時授權：** [申請臨時授權](https://purchase.groupdocs.com/temporary-license/) -- **支援：** [GroupDocs 支援論壇](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **支援：** [GroupDocs 支援論壇](https://forum.groupdocs.com/c/annotation/) + +## 相關教學 + +- [如何使用 Java 為 PDF 加入箭頭 – 完整教學與最佳實踐](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [如何使用 Java 與 GroupDocs Annotation 為 PDF 加入圖片](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [完整指南 - 如何使用 GroupDocs.Annotation for Java 儲存已加註的 PDF](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/hungarian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/hungarian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 97c922a69..3321e0c5c 100644 --- a/content/hungarian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/hungarian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,107 @@ --- -"date": "2025-05-06" -"description": "Ismerje meg, hogyan adhat ellipszis alakú jegyzeteket PDF dokumentumokhoz a hatékony GroupDocs.Annotation Java könyvtár segítségével. Kövesse ezt a lépésről lépésre szóló útmutatót a dokumentumokkal való együttműködés fejlesztéséhez." -"title": "Java Ellipszis alakú jegyzetek hozzáadása PDF-ekhez a GroupDocs.Annotation for Java használatával" -"url": "/hu/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: Ismerje meg, hogyan annotálhat PDF-et a GroupDocs Annotation Library + Java használatával – lépésről‑lépésre útmutató, kódrészletek, teljesítmény tippek + és legjobb gyakorlatok. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: PDF-annotációk hozzáadása Java-ban +og_description: Ismerje meg, hogyan annotálhat PDF-et a GroupDocs Annotation Library + Java segítségével – egy útmutató, amely az ellipszis-annotációkat, megjegyzéseket, + licencelést és tippeket tartalmaz Java fejlesztők számára. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Hogyan lehet PDF-et annotálni a GroupDocs Annotation Library Java segítségével +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: Hogyan lehet PDF-et annotálni a GroupDocs Annotation Library Java segítségével type: docs -"weight": 1 +url: /hu/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Ellipszis alakú jegyzetek hozzáadása PDF-hez a GroupDocs.Annotation for Java használatával +# Hogyan lehet PDF-et annotálni a GroupDocs Annotation Library Java-val -## Bevezetés -A PDF-ekhez fűzött megjegyzések jelentősen javíthatják az együttműködést és a kommunikációt, különösen összetett dokumentumok kezelésekor. Ha programozott módon, Java használatával szeretné kiemelni vagy megjegyzésekkel ellátni a PDF-fájlok bizonyos területeit, ez az oktatóanyag végigvezeti Önt az ellipszis megjegyzések zökkenőmentes hozzáadásának folyamatán. A GroupDocs.Annotation for Java erejét kihasználva a fejlesztők könnyen beépíthetnek kifinomult megjegyzésfunkciókat alkalmazásaikba. +A PDF-hez vizuális jegyzetek, megjegyzések vagy bélyegek programozott hozzáadása drámaian felgyorsíthatja az átnézési ciklusokat, a megfelelőségi ellenőrzéseket és az együttműködő munkafolyamatokat. Ebben az útmutatóban felfedezheti, **hogyan kell PDF-et annotálni** a GroupDocs Annotation Library for Java használatával, lefedve mindent a projekt beállításától a fejlett ellipszis annotációkig, a licencelésig, a teljesítményhangolásig és a valós példák integrációs tippekig. -Ebben az oktatóanyagban a következőket fogjuk áttekinteni: -- A GroupDocs.Annotation beállítása és integrálása egy Java projektbe. -- Lépésről lépésre útmutató arról, hogyan adhat hozzá ellipszis alakú jegyzeteket egy PDF dokumentumhoz. -- Gyakorlati példák, amelyek valós felhasználási eseteket mutatnak be. +## Gyors válaszok +- **Melyik könyvtár ad hozzá annotációkat a PDF-ekhez Java-ban?** The GroupDocs Annotation Library for Java. +- **Szükségem van licencre?** A próba verzió tesztelésre működik; egy termelési licenc szükséges kereskedelmi használathoz. +- **Melyik IDE a legjobb?** Bármely Java IDE (IntelliJ IDEA, Eclipse, VS Code) megfelelő. +- **Annotálhatok jelszóval védett PDF-eket?** Igen—adja meg a jelszót az `Annotator` létrehozásakor. +- **Támogatott a kötegelt feldolgozás?** Teljesen; lásd a kötegelt feldolgozási példát később. -Nézzük át, milyen előfeltételekre van szükséged, mielőtt belevágsz! +## Mi az a GroupDocs Annotation Library Java? -## Előfeltételek -A bemutató követéséhez a következőkre lesz szükséged: -- **Java fejlesztőkészlet (JDK)**Győződjön meg róla, hogy telepítve van a JDK. Ez a példa Java 8-as vagy újabb verziót használ. -- **GroupDocs.Annotation Java könyvtárhoz**A könyvtár 25.2-es verzióját fogjuk használni. -- **Maven beállítás**A függőségek egyszerű kezeléséhez Maven szükséges. +A GroupDocs Annotation Library Java egy kész‑használatra szánt API, amely lehetővé teszi a fejlesztők számára PDF-annotációk létrehozását, szerkesztését, lekérdezését és törlését teljesen Java kódból. **Több mint 50 dokumentumformátumot** támogat, beépített megjegyzés szálakat kínál, és finomhangolt jogosultságkezelést biztosít. -Győződj meg róla, hogy a fejlesztői környezeted támogatja ezeket a követelményeket, és hogy ismered az alapvető Java programozási fogalmakat, különösen a könyvtárakkal és a fájlok kezelésével Java nyelven. +## Miért használjuk a GroupDocs Annotation Library Java-t? -## GroupDocs.Annotation beállítása Java-hoz -### Telepítés Maven-en keresztül -A GroupDocs.Annotation Maven használatával történő integrálásához a projektbe, adja hozzá a következő adattárat és függőséget a `pom.xml` fájl: +Néhány metódushívással gazdag jelöléseket adhat hozzá — beleértve ellipsziseket, szövegjegyzeteket, bélyegeket és vízjeleket —, és a könyvtár **több száz oldalas PDF-eket** dolgoz fel anélkül, hogy a teljes fájlt a memóriába töltené. Az iText vagy PDFBox alacsony szintű eszközeivel összehasonlítva a fejlesztési időt akár **70 %**‑kal csökkenti, és natívan kezeli a komplex PDF funkciókat (rétegek, űrlapok, digitális aláírások). + +## Előkövetelmények és beállítás +- **JDK 8+** (JDK 11 ajánlott) +- **Maven vagy Gradle** a függőségkezeléshez +- **IDE** a választásod szerint (IntelliJ IDEA, Eclipse, VS Code) +- Alapvető ismeretek a Java fájl I/O-val + +### Maven integráció +Adja hozzá a tárolót és a függőséget a `pom.xml`-hez: ```xml @@ -48,31 +120,27 @@ A GroupDocs.Annotation Maven használatával történő integrálásához a proj ``` -### Licencszerzés -Mielőtt elkezdenéd, mindenképpen szerezd be a GroupDocs.Annotation licencét. Ingyenes próbaverziót igényelhetsz, vagy teljes licencet vásárolhatsz a weboldalukról. A licenc igénylése egyszerű, és biztosítja, hogy korlátozás nélkül hozzáférhess az összes funkcióhoz. - -Így igényelheti a licencét: +### Licenc konfiguráció +Alkalmazza a licencet minden annotációs művelet előtt: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Megvalósítási útmutató -### Ellipszis annotáció hozzáadása -Az ellipszis alakú annotációk hozzáadása magában foglalja az annotációs könyvtár inicializálását, a dokumentum beállítását és az annotációs tulajdonságok konfigurálását. Íme, hogyan érheti el ezt lépésről lépésre. +*Pro tipp:* Tárolja a licencfájlt a `src/main/resources` könyvtárban, és töltse be a `getClass().getResourceAsStream()`‑vel a zökkenőmentes telepítéshez. + +## Teljes megvalósítási útmutató -#### 1. lépés: Inicializálja az Annotátort a bemeneti dokumentummal -Először hozzon létre egy `Annotator` például a PDF fájl elérési útjának megadásával: +### 1. lépés: PDF Annotator inicializálása +Az `Annotator` osztály a belépési pont minden annotációs művelethez. Betölti a cél PDF-et, alkalmazza a biztonsági beállításokat, és egy memóriában lévő reprezentációt készít a szerkesztéshez. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Ez inicializálja a környezetet a megjegyzések hozzáadásához. - -#### 2. lépés: Válaszok létrehozása és konfigurálása -A jegyzetek tartalmazhatnak válaszokat vagy megjegyzéseket. A válaszok beállításának módja: +### 2. lépés: Interaktív megjegyzések és válaszok létrehozása +A `CommentAnnotation` lehetővé teszi szabad szöveg beágyazását, míg a `Reply` objektumok szálas beszélgetéseket tesznek lehetővé közvetlenül a PDF oldalon. ```java Reply reply1 = new Reply(); @@ -88,83 +156,218 @@ replies.add(reply1); replies.add(reply2); ``` -Ezek a válaszok a kilipszis annotációhoz lesznek csatolva. - -#### 3. lépés: Ellipszis annotáció létrehozása és konfigurálása -Most hozzon létre egy `EllipseAnnotation` objektum és konfigurálja a tulajdonságait: +### 3. lépés: Ellipszis annotáció konfigurálása +Az `EllipseAnnotation` egy skálázható ovális alakzatot rajzol. Beállíthatja a vonal színét, a kitöltés színét, az átlátszóságot és az egyéni keretvastagságot, hogy megfeleljen a UI irányelveinek. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Sárga háttérszín -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Meghatározza a pozíciót és a méretet +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // A jegyzet céloldalszáma -ellipse.setPenColor(65535); // Toll színe RGB formátumban -ellipse.setPenStyle(PenStyle.DOT); // Pontozott toll -ellipse.setPenWidth((byte) 3); // Toll szélessége +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Ez a beállítás határozza meg az ellipszis annotáció megjelenését és metaadatait. - -#### 4. lépés: Jegyzet hozzáadása a dokumentumhoz -Adja hozzá a konfigurált ellipszis jegyzetet a dokumentumához a következőképpen: +### 4. lépés: Annotációk hozzáadása és mentése +Az összes annotációs objektum konfigurálása után hívja meg a `annotator.save()`‑t a változások lemezre írásához. Ne felejtse el meghívni a `dispose()`‑t a natív erőforrások felszabadításához, különösen, ha sok fájlt dolgoz fel egy ciklusban. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); ``` -#### 5. lépés: Erőforrások mentése és megsemmisítése -Végül mentse el a jegyzetekkel ellátott dokumentumot, és engedje fel az erőforrásokat: +> **Miért hívjuk a `dispose()`‑t?** Felszabadítja a natív erőforrásokat, megakadályozva a memória szivárgásokat — különösen fontos, ha sok PDF-et dolgoz fel egy ciklusban. + +## Gyakori problémák és megoldások + +### 1. probléma – „Dokumentum nem található” +*Ok:** Helytelen fájlútvonal vagy munkakönyvtár. +*Megoldás:** Ellenőrizze a abszolút útvonalat, vagy nyomtassa ki a `System.getProperty("user.dir")`‑t a báziskönyvtár megerősítéséhez. + +### 2. probléma – Az annotációk nem láthatók +*Ok:** Hibás koordináta rendszer vagy oldal index. +*Megoldás:** Ne feledje, hogy a PDF koordináták a bal alsó sarokból indulnak, és az oldalak nullától indexeltek. + +### 3. probléma – OutOfMemoryError nagy PDF-eknél +*Ok:** Az egész dokumentum a memóriába van betöltve. +*Megoldás:** Növelje a JVM heap méretét (`-Xmx2g`), vagy dolgozza fel az oldalakat kötegekben (lásd az alábbi kötegelt példát). + +### 4. probléma – Licenc ellenőrzési hibák +*Ok:** Hiányzó vagy nem egyező licencfájl. +*Megoldás:** Ellenőrizze újra a fájlútvonalat, és győződjön meg róla, hogy a licenc verziója megegyezik a könyvtár verziójával. + +## Teljesítményoptimalizálási tippek + +### Memóriakezelés legjobb gyakorlatai +Kerülje a nagy `Annotator` példányokra való hivatkozások felesleges megtartását. Használjon try‑with‑resources vagy explicit `dispose()` hívásokat minden fájl feldolgozása után. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -## Gyakorlati alkalmazások -- **Oktatási eszközök**: Kulcsfontosságú fogalmak kiemelése a PDF tankönyvekben. -- **Jogi dokumentumok**: Szakaszok megjegyzésekkel való ellátása ellenőrzés vagy jóváhagyás céljából. -- **Orvosi feljegyzések**Fontos megfigyelések vagy megjegyzések megjelölése. +### Kötegelt feldolgozási stratégiák +- **Kis PDF-ek (<10 MB):** Egyenkénti feldolgozás. +- **Közepes PDF-ek (10‑50 MB):** 5‑10 fájlos kötegekben feldolgozás. +- **Nagy PDF-ek (>50 MB):** Streaming vagy darabolt feldolgozás használata az OOM elkerüléséhez. -A GroupDocs.Annotation integrálható dokumentumkezelő rendszerekkel, javítva azok annotációs képességeit. +### Gyorsítótárazási szempontok +Az `AnnotationAppearance` osztály a vizuális tulajdonságokat, például a színt és az átlátszóságot tartalmazza az annotációkhoz. Gyorsítótárazza az újrahasználható objektumokat, mint az `AnnotationAppearance` vagy a `Color` példányok, ha sok oldalt annotál azonos stílussal. -## Teljesítménybeli szempontok -Az optimális teljesítmény érdekében: -- **Memóriakezelés**Memóriahasználat figyelése és kezelése nagyméretű dokumentumok kezelésekor. -- **Kötegelt feldolgozás**Ha több PDF-fájlt jegyzetel, érdemes lehet kötegekben feldolgozni őket az erőforrás-felhasználás optimalizálása érdekében. +```java +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} +``` -Ezek a gyakorlatok biztosítják a Java-alkalmazás hatékony működését a GroupDocs.Annotation használatával. +## Valós példák integrációra -## Következtetés -Ezzel az oktatóanyaggal megtanultad, hogyan adhatsz hozzá ellipszis alakú jegyzeteket PDF-ekhez a GroupDocs.Annotation for Java segítségével. Ez a funkció felbecsülhetetlen értékű azokban az alkalmazásokban, amelyek részletes dokumentum-ellenőrzést és közös szerkesztést igényelnek. +### Webalkalmazás integráció +Hozzon létre egy REST végpontot, amely PDF adatfolyamot fogad, ellipszis annotációt alkalmaz a front‑end által megadott koordinátákon, és a annotált PDF-et bájt tömbként adja vissza. -Készségeid további fejlesztéséhez fedezd fel a GroupDocs könyvtárban elérhető további annotációtípusokat, vagy integráld a funkciókat egy nagyobb projektbe. +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` + +### Kötegelt dokumentumfeldolgozás +Iteráljon egy szerződések könyvtárán, adjon minden fájlhoz egy „Reviewed” bélyeget, és mozgassa a feldolgozott fájlokat egy archív mappába. + +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` -## GYIK szekció -**K: Más típusú dokumentumokat is elláthatok jegyzetekkel a GroupDocs.Annotation segítségével?** -V: Igen, a GroupDocs támogatja a jegyzetek hozzáadását a PDF-eken kívül számos dokumentumformátumhoz, beleértve a Word- és Excel-fájlokat is. +## Fejlett annotációs technikák -**K: Hogyan tudom dinamikusan módosítani a megjegyzés színét a tartalom alapján?** -V: Programozottan beállíthatja a `penColor` tulajdonságot a logikád alapján, mielőtt hozzáadnád az annotációt. +### Dinamikus annotáció pozicionálás +Számítsa ki az annotáció koordinátákat menet közben a detektált szöveghelyek alapján OCR vagy PDF szövegkinyerő API-k használatával, majd helyezzen ellipsziseket a kulcsszavak köré. -**K: Maximálisan hány a támogatott annotációt lehet hozzáadni?** -A: A GroupDocs.Annotation nagyszámú annotációt tesz lehetővé, de ajánlott a teljesítményt az adott dokumentumméretekkel és -típusokkal tesztelni. +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Feltételes annotáció stílus +Alkalmazzon különböző színeket vagy átlátszósági szinteket az annotáció szerzőjének szerepe alapján (pl. reviewer = kék, approver = zöld). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` + +## Gyakorlati alkalmazások és felhasználási esetek +- **Oktatási platformok:** Fogalmak kiemelése, tanári megjegyzések hozzáadása, interaktív tanulási útmutatók létrehozása. +- **Jogi dokumentum átnézés:** Záradékok jelölése, bizalmas megjegyzések hozzáadása, audit nyomvonalak fenntartása. +- **Orvosi feljegyzések:** Megfigyelések annotálása, kritikus adatok kiemelése, biztonságos együttműködés engedélyezése. +- **Vállalati munkafolyamatok:** Jelentés jóváhagyások egyszerűsítése, reviewer bélyegek hozzáadása, változások nyomon követése. + +## Mikor használjunk különböző annotáció típusokat + +Az ellipszis annotációk ideálisak, ha nem téglalap alakú kiemelésre van szükség, például kördiagramok, logók vagy olyan területek hangsúlyozására, amelyeket jobb egy ovális alakzat ábrázol. Egyértelmű vizuális jelzést adnak, miközben megőrzik az olvashatóságot, így alkalmasak tervezési átnézésekhez, márkaellenőrzésekhez és minden olyan helyzethez, ahol a kör alakú hangsúly előnyös. + +Bár ez az útmutató az ellipszis annotációkra fókuszál, a GroupDocs Annotation Library Java további lehetőségeket is kínál: +- **Szöveg annotációk** részletes megjegyzésekhez. +- **Nyíl annotációk** konkrét elemekre mutatáshoz. +- **Téglalap annotációk** terület kiemeléshez. +- **Vízjel annotációk** márka vagy biztonság céljából. +- **Bélyeg annotációk** jóváhagyásokhoz. + +## Hibaelhárítási útmutató + +### Teljesítmény problémák +- **Tünet:** Lassú feldolgozás. +- **Diagnózis:** Nagy fájlméret, sok annotáció, korlátozott RAM. +- **Megoldás:** Annotációs tulajdonságok optimalizálása, aszinkron feldolgozás, vagy nagy PDF-ek lapozása. + +### Kompatibilitási problémák +- **Tünet:** Az annotációk különböznek a nézők között. +- **Diagnózis:** Nem szabványos PDF funkciók. +- **Megoldás:** Tesztelje Adobe Acrobat, Chrome és Firefox segítségével; ragaszkodjon a PDF‑standard annotációs flag-ekhez. + +### Integrációs kihívások +- **Tünet:** Függőségi ütközések. +- **Diagnózis:** Verzióeltérések más könyvtárakkal. +- **Megoldás:** Használja a Maven ``‑et a kompatibilis verziók kikényszerítéséhez, vagy váltson a REST API-ra nyelvfüggetlen integrációhoz. + +## Gyakran ismételt kérdések + +**K: Hozzáadhatok annotációkat jelszóval védett PDF-ekhez?** +V: Igen. Használja a `new Annotator(filePath, loadOptions)` túlterhelést, ahol a `loadOptions` tartalmazza a jelszót. + +**K: Hogyan kezeljem a 100 MB-nél nagyobb PDF-eket?** +V: Oldalanként dolgozza fel, növelje a heap méretét, vagy használja a GroupDocs Annotation Cloud API-t nagy terhelés esetén. + +**K: Van korlát a dokumentumonkénti annotációk számában?** +V: Nincs szigorú korlát, de a teljesítmény romolhat több ezer annotáció után. Fontolja meg a lapozást vagy csoportosítást. + +**K: Kinyerhetem a meglévő annotációkat?** +V: Természetesen. Hívja meg a `annotator.get()`‑t a PDF összes annotációjának lekéréséhez. + +**K: Hogyan biztosíthatom az annotációkat, hogy csak bizonyos felhasználók szerkeszthessék őket?** +V: A könyvtár felhasználó‑alapú jogosultság beállításokat biztosít; konfigurálja őket az `AnnotationPermission` API‑val. + +## Összegzés + +A **GroupDocs Annotation Library Java** tiszta, nagy teljesítményű módot biztosít a gazdag PDF annotációk közvetlen beágyazásához Java kódból. A fenti lépések követésével ellipszis annotációkat adhat hozzá, kezelheti a megjegyzéseket, és vállalati szintű terhelésekhez skálázhat. + +**Következő lépések:** +1. Kísérletezzen más annotáció típusokkal (szöveg, bélyeg, vízjel). +2. Integrálja a könyvtárat a meglévő dokumentum munkafolyamatba vagy webszolgáltatásba. +3. Fedezze fel a REST API-t nyelvfüggetlen szcenáriókhoz. + +--- -**K: Hogyan kezelhetem az átfedésben lévő annotációkat?** -A: Állítsa be a `box` méretek és pozíciók az átfedések kezeléséhez, vagy több annotáció rétegezéséhez szükség szerint. +**Last Updated:** 2026-07-25 +**Tested With:** GroupDocs.Annotation 25.2 for Java +**Author:** GroupDocs -**K: Milyen ajánlott eljárások vannak a GroupDocs.Annotation webes alkalmazásokban történő használatához?** -A: Nagy dokumentumok esetén aszinkron feldolgozást kell alkalmazni, biztosítani kell a jegyzetekkel ellátott fájlok biztonságos tárolását, és felhasználóbarát felületeket kell biztosítani a jegyzetekkel való interakciókhoz. +**Essential Links:** +- **Dokumentáció:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **API Referencia:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Letöltés:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Vásárlás:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Ingyenes próba:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **Ideiglenes licenc:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **Támogatás:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) -## Erőforrás -- **Dokumentáció**: [GroupDocs annotáció Java dokumentáció](https://docs.groupdocs.com/annotation/java/) -- **API-referencia**: [GroupDocs API-referencia](https://reference.groupdocs.com/annotation/java/) -- **Letöltés**: [GroupDocs.Annotation letöltése](https://releases.groupdocs.com/annotation/java/) -- **Vásárlás**: [GroupDocs licenc vásárlása](https://purchase.groupdocs.com/buy) -- **Ingyenes próbaverzió**: [Ingyenes próbaverzió indítása](https://releases.groupdocs.com/annotation/java/) -- **Ideiglenes engedély**: [Ideiglenes engedély igénylése](https://purchase.groupdocs.com/temporary-license/) -- **Támogatás**: [GroupDocs támogatási fórum](https://forum.groupdocs.com/c/annotation/) +## Kapcsolódó útmutatók -Ez az átfogó útmutató felvértezi Önt azzal a tudással, amellyel hatékonyan adhat ellipszis annotációkat Java-alkalmazásaihoz a GroupDocs.Annotation használatával. Jó kódolást! \ No newline at end of file +- [Hogyan adjunk hozzá nyilat a PDF-hez Java-val – Teljes útmutató és legjobb gyakorlatok](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Hogyan adjunk hozzá képet a PDF-hez Java és GroupDocs Annotation használatával](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Teljes útmutató – Hogyan mentse el az annotált PDF-et a GroupDocs.Annotation for Java használatával](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/indonesian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/indonesian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 270b15e65..32974f038 100644 --- a/content/indonesian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/indonesian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,106 @@ --- -"date": "2025-05-06" -"description": "Pelajari cara menambahkan anotasi elips ke dokumen PDF menggunakan pustaka GroupDocs.Annotation yang canggih di Java. Ikuti panduan langkah demi langkah ini untuk meningkatkan kolaborasi dokumen." -"title": "Java: Menambahkan Anotasi Elips ke PDF Menggunakan GroupDocs.Annotation untuk Java" -"url": "/id/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: Pelajari cara menandai PDF dengan GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, dan best practices. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Tambahkan Anotasi PDF di Java +og_description: Pelajari cara menandai PDF dengan GroupDocs Annotation Library Java + – panduan yang mencakup ellipse annotations, comments, licensing, dan tips untuk + pengembang Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Cara Menandai PDF dengan GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: Cara Menandai PDF dengan GroupDocs Annotation Library Java type: docs -"weight": 1 +url: /id/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Cara Menambahkan Anotasi Elips ke PDF Menggunakan GroupDocs.Annotation untuk Java +# Cara Menandai PDF dengan GroupDocs Annotation Library Java -## Perkenalan -Menambahkan anotasi ke PDF dapat meningkatkan kolaborasi dan komunikasi secara signifikan, terutama saat menangani dokumen yang rumit. Jika Anda ingin menyorot atau memberi anotasi pada area tertentu dalam PDF Anda secara terprogram menggunakan Java, tutorial ini akan memandu Anda melalui proses penambahan anotasi elips dengan mudah. Dengan memanfaatkan kekuatan GroupDocs.Annotation untuk Java, pengembang dapat dengan mudah memasukkan fitur anotasi yang canggih ke dalam aplikasi mereka. +Menambahkan catatan visual, komentar, atau stempel ke PDF secara programatik dapat secara dramatis mempercepat siklus tinjauan, pemeriksaan kepatuhan, dan alur kerja kolaboratif. Dalam tutorial ini Anda akan menemukan **cara menandai PDF** menggunakan GroupDocs Annotation Library untuk Java, mencakup semua mulai dari penyiapan proyek hingga anotasi elips lanjutan, lisensi, penyetelan kinerja, dan tip integrasi dunia nyata. -Dalam tutorial ini, kita akan membahas: -- Cara mengatur dan mengintegrasikan GroupDocs.Annotation dalam proyek Java. -- Petunjuk langkah demi langkah tentang cara menambahkan anotasi elips ke dokumen PDF. -- Contoh praktis yang menunjukkan kasus penggunaan di dunia nyata. +## Jawaban Cepat +- **Perpustakaan apa yang menambahkan anotasi ke PDF di Java?** GroupDocs Annotation Library untuk Java. +- **Apakah saya memerlukan lisensi?** Versi percobaan dapat digunakan untuk pengujian; lisensi produksi diperlukan untuk penggunaan komersial. +- **IDE mana yang paling cocok?** Semua IDE Java (IntelliJ IDEA, Eclipse, VS Code) dapat bekerja dengan baik. +- **Bisakah saya menandai PDF yang dilindungi kata sandi?** Ya—berikan kata sandi saat membuat `Annotator`. +- **Apakah pemrosesan batch didukung?** Tentu; lihat contoh pemrosesan batch di bawah. -Mari kita bahas prasyarat yang Anda perlukan sebelum memulai! +## Apa itu GroupDocs Annotation Library Java? -## Prasyarat -Untuk mengikuti tutorial ini, Anda memerlukan: -- **Kit Pengembangan Java (JDK)**: Pastikan Anda telah menginstal JDK. Contoh ini menggunakan Java 8 atau yang lebih tinggi. -- **GroupDocs.Annotation untuk Pustaka Java**Kami akan menggunakan pustaka versi 25.2. -- **Pengaturan Maven**:Maven diperlukan untuk mengelola dependensi dengan mudah. +GroupDocs Annotation Library Java adalah API siap pakai yang memungkinkan pengembang membuat, mengedit, mengambil, dan menghapus anotasi PDF sepenuhnya dalam kode Java. Ini mendukung **lebih dari 50 format dokumen**, menawarkan thread komentar bawaan, dan menyediakan kontrol izin yang detail. -Pastikan lingkungan pengembangan Anda mendukung persyaratan ini dan Anda memahami konsep dasar pemrograman Java, terutama bekerja dengan pustaka dan menangani berkas di Java. +## Mengapa Menggunakan GroupDocs Annotation Library Java? -## Menyiapkan GroupDocs.Annotation untuk Java -### Instalasi melalui Maven -Untuk mengintegrasikan GroupDocs.Annotation ke dalam proyek Anda menggunakan Maven, tambahkan repositori dan dependensi berikut ke `pom.xml` mengajukan: +Anda dapat menambahkan markup kaya—termasuk elips, catatan teks, stempel, dan watermark—hanya dengan beberapa pemanggilan metode, dan perpustakaan memproses **PDF beratus‑ratus halaman** tanpa memuat seluruh file ke memori. Dibandingkan dengan alat tingkat rendah seperti iText atau PDFBox, ini mengurangi waktu pengembangan hingga **70 %** dan menangani fitur PDF kompleks (lapisan, formulir, tanda tangan digital) secara langsung. + +## Prasyarat dan Penyiapan +- **JDK 8+** (JDK 11 disarankan) +- **Maven atau Gradle** untuk manajemen dependensi +- **IDE** pilihan Anda (IntelliJ IDEA, Eclipse, VS Code) +- Familiaritas dasar dengan I/O file Java + +### Integrasi Maven +Tambahkan repositori dan dependensi ke `pom.xml` Anda: ```xml @@ -48,31 +119,27 @@ Untuk mengintegrasikan GroupDocs.Annotation ke dalam proyek Anda menggunakan Mav ``` -### Akuisisi Lisensi -Sebelum memulai, pastikan untuk memperoleh lisensi untuk GroupDocs.Annotation. Anda dapat memperoleh uji coba gratis atau membeli lisensi lengkap dari situs web mereka. Menerapkan lisensi mudah dan memastikan bahwa Anda memiliki akses ke semua fitur tanpa batasan. - -Berikut cara mengajukan lisensi Anda: +### Konfigurasi Lisensi +Terapkan lisensi Anda sebelum melakukan pekerjaan anotasi apa pun: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Panduan Implementasi -### Menambahkan Anotasi Elips -Menambahkan anotasi elips melibatkan inisialisasi pustaka anotasi, pengaturan dokumen, dan konfigurasi properti anotasi. Berikut ini cara melakukannya langkah demi langkah. +*Tip pro:* Simpan file lisensi di `src/main/resources` dan muat dengan `getClass().getResourceAsStream()` untuk penyebaran yang lebih lancar. + +## Panduan Implementasi Lengkap -#### Langkah 1: Inisialisasi Anotator dengan Dokumen Input -Pertama, buatlah `Annotator` misalnya dengan menentukan jalur ke berkas PDF Anda: +### Langkah 1: Inisialisasi PDF Annotator +Kelas `Annotator` adalah titik masuk untuk semua operasi anotasi. Ia memuat PDF target, menerapkan pengaturan keamanan, dan menyiapkan representasi dalam memori untuk penyuntingan. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Ini menginisialisasi lingkungan untuk menambahkan anotasi. - -#### Langkah 2: Membuat dan Mengonfigurasi Balasan -Anotasi dapat menyertakan balasan atau komentar. Berikut cara menyiapkan balasan: +### Langkah 2: Buat Komentar Interaktif dan Balasan +`CommentAnnotation` memungkinkan Anda menyematkan teks bebas, sementara objek `Reply` memungkinkan diskusi berulir langsung pada halaman PDF. ```java Reply reply1 = new Reply(); @@ -88,83 +155,217 @@ replies.add(reply1); replies.add(reply2); ``` -Balasan ini akan dilampirkan pada anotasi elips. - -#### Langkah 3: Membuat dan Mengonfigurasi Anotasi Elips -Sekarang, buatlah `EllipseAnnotation` objek dan konfigurasikan propertinya: +### Langkah 3: Konfigurasikan Anotasi Elips Anda +`EllipseAnnotation` menggambar bentuk oval yang dapat diskalakan. Anda dapat mengatur warna garis, warna isi, opasitas, dan ketebalan batas khusus untuk menyesuaikan panduan UI Anda. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Warna latar belakang kuning -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Menentukan posisi dan ukuran +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // Nomor halaman target untuk anotasi -ellipse.setPenColor(65535); // Warna pena dalam format RGB -ellipse.setPenStyle(PenStyle.DOT); // Pena gaya titik -ellipse.setPenWidth((byte) 3); // Lebar pena +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Pengaturan ini menentukan tampilan dan metadata anotasi elips Anda. - -#### Langkah 4: Tambahkan Anotasi ke Dokumen -Tambahkan anotasi elips yang dikonfigurasi ke dokumen Anda menggunakan: +### Langkah 4: Tambahkan dan Simpan Anotasi Anda +Setelah mengonfigurasi semua objek anotasi, panggil `annotator.save()` untuk menulis perubahan kembali ke disk. Ingatlah untuk memanggil `dispose()` untuk membebaskan sumber daya native, terutama saat memproses banyak file dalam sebuah loop. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); +``` + +> **Mengapa memanggil `dispose()`?** Itu melepaskan sumber daya native, mencegah kebocoran memori—terutama penting saat memproses banyak PDF dalam sebuah loop. + +## Masalah Umum dan Solusinya + +### Masalah 1 – “Dokumen Tidak Ditemukan” +*Penyebab:* Jalur file atau direktori kerja yang salah. +*Solusi:* Verifikasi jalur absolut atau cetak `System.getProperty("user.dir")` untuk memastikan direktori dasar. + +### Masalah 2 – Anotasi Tidak Terlihat +*Penyebab:* Sistem koordinat atau indeks halaman yang salah. +*Solusi:* Ingat bahwa koordinat PDF dimulai dari kiri‑bawah, dan halaman diindeks mulai dari nol. + +### Masalah 3 – OutOfMemoryError pada PDF Besar +*Penyebab:* Seluruh dokumen dimuat ke memori. +*Solusi:* Tingkatkan heap JVM (`-Xmx2g`) atau proses halaman secara batch (lihat contoh batch di bawah). + +### Masalah 4 – Kesalahan Validasi Lisensi +*Penyebab:* File lisensi hilang atau tidak cocok. +*Solusi:* Periksa kembali jalur file dan pastikan versi lisensi cocok dengan versi perpustakaan. + +## Tips Optimasi Kinerja + +### Praktik Terbaik Manajemen Memori +Hindari menyimpan referensi ke instance `Annotator` besar lebih lama dari yang diperlukan. Gunakan try‑with‑resources atau panggilan `dispose()` eksplisit setelah setiap file diproses. + +```java +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -#### Langkah 5: Simpan dan Buang Sumber Daya -Terakhir, simpan dokumen yang diberi anotasi dan lepaskan sumber daya: +### Strategi Pemrosesan Batch +- **PDF kecil (<10 MB):** Proses secara individual. +- **PDF menengah (10‑50 MB):** Proses dalam batch 5‑10. +- **PDF besar (>50 MB):** Gunakan streaming atau pemrosesan berpotongan untuk menghindari OOM. + +### Pertimbangan Caching +Kelas `AnnotationAppearance` mengenkapsulasi properti visual seperti warna dan opasitas untuk anotasi. Cache objek yang dapat digunakan kembali seperti instance `AnnotationAppearance` atau `Color` ketika Anda menandai banyak halaman dengan gaya yang identik. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} ``` -## Aplikasi Praktis -- **Alat Pendidikan**: Menyorot konsep utama dalam buku teks PDF. -- **Dokumen Hukum**: Memberi anotasi pada bagian untuk ditinjau atau disetujui. -- **Rekam medis**: Menandai pengamatan atau catatan penting. +## Contoh Integrasi Dunia Nyata -GroupDocs.Annotation dapat terintegrasi dengan sistem manajemen dokumen, meningkatkan kemampuan anotasinya. +### Integrasi Aplikasi Web +Ekspos endpoint REST yang menerima aliran PDF, menerapkan anotasi elips pada koordinat yang diberikan oleh front‑end, dan mengembalikan PDF yang telah dianotasi sebagai array byte. -## Pertimbangan Kinerja -Untuk kinerja optimal: -- **Manajemen Memori**Pantau dan kelola penggunaan memori saat menangani dokumen besar. -- **Pemrosesan Batch**: Jika membuat anotasi pada beberapa PDF, pertimbangkan untuk memprosesnya secara bertahap untuk mengoptimalkan penggunaan sumber daya. +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` -Praktik ini memastikan pengoperasian aplikasi Java Anda yang efisien menggunakan GroupDocs.Annotation. +### Pemrosesan Dokumen Batch +Iterasi melalui direktori kontrak, tambahkan stempel “Reviewed” pada masing‑masing, dan pindahkan file yang diproses ke folder arsip. -## Kesimpulan -Dengan mengikuti tutorial ini, Anda telah mempelajari cara menambahkan anotasi elips ke PDF menggunakan GroupDocs.Annotation for Java. Fitur ini sangat berguna untuk aplikasi yang memerlukan tinjauan dokumen terperinci dan penyuntingan kolaboratif. +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` + +## Teknik Anotasi Lanjutan + +### Penempatan Anotasi Dinamis +Hitung koordinat anotasi secara dinamis berdasarkan lokasi teks yang terdeteksi menggunakan OCR atau API ekstraksi teks PDF, lalu tempatkan elips di sekitar kata kunci. + +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Gaya Anotasi Bersyarat +Terapkan warna atau tingkat opasitas yang berbeda tergantung pada peran penulis anotasi (misalnya, reviewer = biru, approver = hijau). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` + +## Aplikasi Praktis dan Kasus Penggunaan +- **Platform edukasi:** Sorot konsep, tambahkan komentar guru, buat panduan belajar interaktif. +- **Peninjauan dokumen hukum:** Tandai klausa, tambahkan catatan rahasia, pertahankan jejak audit. +- **Rekam medis:** Anotasi observasi, sorot data kritis, memungkinkan kolaborasi aman. +- **Alur kerja korporat:** Mempercepat persetujuan laporan, tambahkan stempel peninjau, lacak perubahan. + +## Kapan Menggunakan Berbagai Jenis Anotasi -Untuk lebih meningkatkan keterampilan Anda, jelajahi jenis anotasi tambahan yang tersedia di pustaka GroupDocs atau integrasikan fungsionalitas ke dalam proyek yang lebih besar. +Anotasi elips ideal ketika Anda membutuhkan sorotan non‑rektangular, seperti menekankan diagram melingkar, logo, atau area yang lebih baik direpresentasikan dengan bentuk oval. Mereka memberikan isyarat visual yang jelas sambil mempertahankan keterbacaan, menjadikannya cocok untuk tinjauan desain, pemeriksaan merek, dan skenario apa pun di mana penekanan bulat lebih disukai. -## Bagian FAQ -**T: Dapatkah saya membuat anotasi pada jenis dokumen lain dengan GroupDocs.Annotation?** -A: Ya, GroupDocs mendukung anotasi pada berbagai format dokumen selain PDF, termasuk file Word dan Excel. +Meskipun panduan ini berfokus pada anotasi elips, GroupDocs Annotation Library Java juga menawarkan: +- **Anotasi teks** untuk komentar detail. +- **Anotasi panah** untuk menunjuk elemen tertentu. +- **Anotasi persegi panjang** untuk menyorot area. +- **Anotasi watermark** untuk branding atau keamanan. +- **Anotasi stempel** untuk persetujuan. -**T: Bagaimana cara mengubah warna anotasi secara dinamis berdasarkan konten?** -A: Anda dapat mengatur secara terprogram `penColor` properti berdasarkan logika Anda sebelum menambahkan anotasi. +## Panduan Pemecahan Masalah -**T: Berapa jumlah maksimum anotasi yang didukung?** -A: GroupDocs.Annotation memungkinkan sejumlah besar anotasi, tetapi disarankan untuk menguji kinerja dengan ukuran dan jenis dokumen spesifik Anda. +### Masalah Kinerja +- **Gejala:** Proses lambat. +- **Diagnosa:** Ukuran file besar, banyak anotasi, RAM terbatas. +- **Solusi:** Optimalkan properti anotasi, proses secara asinkron, atau paginasi PDF besar. + +### Masalah Kompatibilitas +- **Gejala:** Anotasi terlihat berbeda di berbagai penampil. +- **Diagnosa:** Fitur PDF non‑standar. +- **Solusi:** Uji dengan Adobe Acrobat, Chrome, dan Firefox; gunakan flag anotasi standar PDF. + +### Tantangan Integrasi +- **Gejala:** Konflik dependensi. +- **Diagnosa:** Versi tidak cocok dengan perpustakaan lain. +- **Solusi:** Gunakan `` Maven untuk menegakkan versi yang kompatibel atau beralih ke REST API untuk integrasi lintas bahasa. + +## Pertanyaan yang Sering Diajukan + +**Q: Bisakah saya menambahkan anotasi ke PDF yang dilindungi kata sandi?** +A: Ya. Gunakan overload `new Annotator(filePath, loadOptions)` dimana `loadOptions` mencakup kata sandi. + +**Q: Bagaimana sebaiknya menangani PDF yang lebih besar dari 100 MB?** +A: Proses halaman secara individual, tingkatkan ukuran heap, atau manfaatkan GroupDocs Annotation Cloud API untuk beban kerja berat. + +**Q: Apakah ada batasan jumlah anotasi per dokumen?** +A: Tidak ada batas keras, tetapi kinerja dapat menurun setelah ribuan anotasi. Pertimbangkan paginasi atau pengelompokan. + +**Q: Bisakah saya mengekstrak anotasi yang ada?** +A: Tentu. Panggil `annotator.get()` untuk mengambil semua anotasi dari PDF. + +**Q: Bagaimana cara mengamankan anotasi sehingga hanya pengguna tertentu yang dapat mengeditnya?** +A: Perpustakaan menyediakan pengaturan izin berbasis pengguna; konfigurasikan melalui API `AnnotationPermission`. + +## Kesimpulan +**GroupDocs Annotation Library Java** memberikan cara yang bersih dan berperforma tinggi untuk menyematkan anotasi PDF kaya langsung dari kode Java. Dengan mengikuti langkah‑langkah di atas, Anda dapat menambahkan anotasi elips, mengelola komentar, dan menskalakan beban kerja tingkat perusahaan. + +**Langkah selanjutnya:** +1. Bereksperimen dengan jenis anotasi lain (teks, stempel, watermark). +2. Integrasikan perpustakaan ke alur kerja dokumen atau layanan web Anda yang ada. +3. Jelajahi REST API untuk skenario lintas bahasa. + +--- -**T: Bagaimana cara menangani anotasi yang tumpang tindih?** -A: Sesuaikan `box` dimensi dan posisi untuk mengelola tumpang tindih atau melapisi beberapa anotasi sesuai kebutuhan. +**Terakhir Diperbarui:** 2026-07-25 +**Diuji Dengan:** GroupDocs.Annotation 25.2 for Java +**Penulis:** GroupDocs -**T: Apa saja praktik terbaik untuk menggunakan GroupDocs.Annotation dalam aplikasi web?** -A: Manfaatkan pemrosesan asinkron untuk dokumen besar, pastikan penyimpanan file yang dianotasi aman, dan sediakan antarmuka yang mudah digunakan untuk interaksi anotasi. +**Tautan Penting:** +- **Dokumentasi:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **Referensi API:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Unduh:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Pembelian:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Uji Coba Gratis:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **Lisensi Sementara:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **Dukungan:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) -## Sumber daya -- **Dokumentasi**: [Anotasi GroupDocs Dokumentasi Java](https://docs.groupdocs.com/annotation/java/) -- **Referensi API**: [Referensi API GroupDocs](https://reference.groupdocs.com/annotation/java/) -- **Unduh**: [Unduh GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Pembelian**: [Beli Lisensi GroupDocs](https://purchase.groupdocs.com/buy) -- **Uji Coba Gratis**: [Mulai Uji Coba Gratis](https://releases.groupdocs.com/annotation/java/) -- **Lisensi Sementara**: [Minta Lisensi Sementara](https://purchase.groupdocs.com/temporary-license/) -- **Mendukung**: [Forum Dukungan GroupDocs](https://forum.groupdocs.com/c/annotation/) +## Tutorial Terkait -Panduan lengkap ini akan membekali Anda dengan pengetahuan untuk menambahkan anotasi elips secara efektif dalam aplikasi Java Anda menggunakan GroupDocs.Annotation. Selamat membuat kode! \ No newline at end of file +- [Cara menambahkan panah ke PDF dengan Java – Tutorial Lengkap & Praktik Terbaik](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Cara menambahkan gambar ke PDF menggunakan Java dan GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Panduan Lengkap - Cara Menyimpan PDF yang Dianotasi dengan GroupDocs.Annotation untuk Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/italian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/italian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index dc43363af..33fed88c8 100644 --- a/content/italian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/italian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,55 +1,106 @@ --- categories: - Java Development -date: '2026-02-03' -description: Scopri come aggiungere annotazioni ai file PDF usando la libreria GroupDocs - Annotation per Java. Guida passo‑passo, esempi di codice, suggerimenti per la risoluzione - dei problemi e migliori pratiche. -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: Scopri come annotare PDF con GroupDocs Annotation Library Java – guida + passo‑passo, esempi di codice, consigli sulle prestazioni e best practice. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Aggiungi annotazioni PDF in Java +og_description: Scopri come annotare PDF con GroupDocs Annotation Library Java – una + guida che copre le annotazioni ellittiche, i commenti, la licenza e consigli per + gli sviluppatori Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Come annotare PDF con GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'Libreria GroupDocs Annotation Java: Aggiungi annotazioni PDF' +- document processing +- ellipse annotation +title: Come annotare PDF con GroupDocs Annotation Library Java type: docs url: /it/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java: Aggiungere annotazioni PDF +# Come Annotare PDF con la Libreria GroupDocs Annotation Java -Ti sei mai chiesto come aggiungere annotazioni ai documenti PDF in modo programmatico in Java? Con la **groupdocs annotation library java**, puoi incorporare markup ricco—come ellissi, commenti e timbri—direttamente nei PDF. Che tu stia costruendo un sistema di revisione documenti, una piattaforma educativa o uno spazio di lavoro collaborativo, questo tutorial ti mostra esattamente come iniziare. +Aggiungere note visive, commenti o timbri a un PDF in modo programmatico può accelerare notevolmente i cicli di revisione, i controlli di conformità e i flussi di lavoro collaborativi. In questo tutorial scoprirai **come annotare PDF** utilizzando la GroupDocs Annotation Library per Java, coprendo tutto, dalla configurazione del progetto alle annotazioni ellittiche avanzate, licenze, ottimizzazione delle prestazioni e consigli di integrazione nel mondo reale. -## Risposte rapide -- **Quale libreria aggiunge annotazioni ai PDF in Java?** La groupdocs annotation library java. +## Risposte Rapide +- **Quale libreria aggiunge annotazioni ai PDF in Java?** La GroupDocs Annotation Library per Java. - **Ho bisogno di una licenza?** Una versione di prova funziona per i test; è necessaria una licenza di produzione per l'uso commerciale. -- **Quale IDE è il migliore?** Qualsiasi IDE Java (IntelliJ IDEA, Eclipse, VS Code) va bene. -- **Posso annotare PDF protetti da password?** Sì—fornisci la password quando crei l`Annotator`. -- **Il batch processing è supportato?** Assolutamente; vedi l'esempio di elaborazione batch più avanti. +- **Quale IDE funziona meglio?** Qualsiasi IDE Java (IntelliJ IDEA, Eclipse, VS Code) va bene. +- **Posso annotare PDF protetti da password?** Sì—fornisci la password quando crei l'`Annotator`. +- **È supportata l'elaborazione batch?** Assolutamente; vedi l'esempio di elaborazione batch più avanti. ## Cos'è la GroupDocs Annotation Library Java? -La groupdocs annotation library java è una potente API Java pronta per l'enterprise che ti consente di creare, modificare e recuperare annotazioni PDF in modo programmatico. Supporta oltre 50 formati di documento e offre funzionalità di collaborazione come risposte e thread di commenti. + +La GroupDocs Annotation Library Java è un'API pronta all'uso che consente agli sviluppatori di creare, modificare, recuperare ed eliminare le annotazioni PDF interamente in codice Java. Supporta **oltre 50 formati di documento**, offre thread di commenti integrati e fornisce controlli di autorizzazione granulari. ## Perché usare la GroupDocs Annotation Library Java? -- **Tipi di annotazione ricchi** – forme, testo, timbri, filigrane e altro. -- **Pronta per la collaborazione** – risposte integrate e thread di commenti. -- **Ottimizzata per le prestazioni** – gestisce PDF di grandi dimensioni in modo efficiente. -- **API semplice** – riduce i tempi di sviluppo rispetto a librerie di livello inferiore come iText o PDFBox. -## Prerequisiti e configurazione -- **JDK 8+** (consigliato JDK 11) +Puoi aggiungere markup ricco—incluse ellissi, note di testo, timbri e filigrane—con poche chiamate di metodo, e la libreria elabora **PDF di centinaia di pagine** senza caricare l'intero file in memoria. Rispetto a strumenti di basso livello come iText o PDFBox, riduce il tempo di sviluppo fino al **70 %** e gestisce funzionalità PDF complesse (livelli, moduli, firme digitali) subito pronto all'uso. + +## Prerequisiti e Configurazione +- **JDK 8+** (JDK 11 consigliato) - **Maven o Gradle** per la gestione delle dipendenze -- **IDE** a tua scelta (IntelliJ IDEA, Eclipse, ecc.) +- **IDE** a tua scelta (IntelliJ IDEA, Eclipse, VS Code) - Familiarità di base con Java file I/O -## Configurare la GroupDocs Annotation Library Java - ### Integrazione Maven -Aggiungi il repository e la dipendenza al tuo `pom.xml`: +Add the repository and dependency to your `pom.xml`: ```xml @@ -68,24 +119,28 @@ Aggiungi il repository e la dipendenza al tuo `pom.xml`: ``` -### Configurazione della licenza -Applica la tua licenza prima di qualsiasi operazione di annotazione: +### Configurazione Licenza +Apply your license before any annotation work: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -*Consiglio professionale:* conserva il file di licenza in `src/main/resources` e caricalo con `getClass().getResourceAsStream()` per distribuzioni più fluide. +*Suggerimento professionale:* Conserva il file di licenza in `src/main/resources` e caricalo con `getClass().getResourceAsStream()` per distribuzioni più fluide. -## Guida completa all'implementazione +## Guida Completa all'Implementazione ### Passo 1: Inizializzare l'Annotatore PDF +The `Annotator` class is the entry point for all annotation operations. It loads the target PDF, applies security settings, and prepares an in‑memory representation for editing. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -### Passo 2: Creare commenti interattivi e risposte +### Passo 2: Creare Commenti Interattivi e Risposte +`CommentAnnotation` lets you embed free‑form text, while `Reply` objects enable threaded discussions directly on the PDF page. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -100,7 +155,9 @@ replies.add(reply1); replies.add(reply2); ``` -### Passo 3: Configurare l'annotazione ellisse +### Passo 3: Configurare l'Annotazione Ellisse +`EllipseAnnotation` draws a scalable oval shape. You can set line color, fill color, opacity, and custom border thickness to match your UI guidelines. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -114,7 +171,9 @@ ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -### Passo 4: Aggiungere e salvare le tue annotazioni +### Passo 4: Aggiungere e Salvare le Tue Annotazioni +After configuring all annotation objects, invoke `annotator.save()` to write the changes back to disk. Remember to call `dispose()` to free native resources, especially when processing many files in a loop. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); @@ -123,27 +182,29 @@ annotator.dispose(); > **Perché chiamare `dispose()`?** Rilascia le risorse native, prevenendo perdite di memoria—particolarmente importante quando si elaborano molti PDF in un ciclo. -## Problemi comuni e soluzioni +## Problemi Comuni e Soluzioni -### Problema 1 – “Documento non trovato” -*Causa:* Percorso file errato o directory di lavoro. -*Soluzione:* Verifica il percorso assoluto o stampa `System.getProperty("user.dir")` per confermare la directory di base. +### Problema 1 – “Documento Non Trovato” +*Causa:* Percorso file o directory di lavoro errati. +*Risoluzione:* Verifica il percorso assoluto o stampa `System.getProperty("user.dir")` per confermare la directory di base. -### Problema 2 – Annotazioni non visibili -*Causa:* Sistema di coordinate o indice di pagina errato. -*Soluzione:* Ricorda che le coordinate PDF partono dall'angolo in basso a sinistra e le pagine sono indicizzate da zero. +### Problema 2 – Annotazioni Non Visibili +*Causa:* Sistema di coordinate o indice di pagina errati. +*Risoluzione:* Ricorda che le coordinate PDF partono dall'angolo in basso a sinistra e le pagine sono indicizzate da zero. ### Problema 3 – OutOfMemoryError su PDF di grandi dimensioni *Causa:* L'intero documento caricato in memoria. -*Soluzione:* Aumenta l'heap JVM (`-Xmx2g`) o elabora le pagine in batch (vedi l'esempio batch più sotto). +*Risoluzione:* Aumenta l'heap JVM (`-Xmx2g`) o elabora le pagine in batch (vedi l'esempio di batch più sotto). -### Problema 4 – Errori di validazione della licenza +### Problema 4 – Errori di Validazione della Licenza *Causa:* File di licenza mancante o non corrispondente. -*Soluzione:* Controlla nuovamente il percorso del file e assicurati che la versione della licenza corrisponda alla versione della libreria. +*Risoluzione:* Controlla nuovamente il percorso del file e assicurati che la versione della licenza corrisponda alla versione della libreria. -## Suggerimenti per l'ottimizzazione delle prestazioni +## Suggerimenti per l'Ottimizzazione delle Prestazioni + +### Best Practice per la Gestione della Memoria +Avoid holding references to large `Annotator` instances longer than necessary. Use try‑with‑resources or explicit `dispose()` calls after each file is processed. -### Best practice per la gestione della memoria ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -154,12 +215,14 @@ for (String documentPath : documentPaths) { } ``` -### Strategie di elaborazione batch +### Strategie di Elaborazione Batch - **PDF piccoli (<10 MB):** Elaborare singolarmente. - **PDF medi (10‑50 MB):** Elaborare in batch di 5‑10. - **PDF grandi (>50 MB):** Usa lo streaming o l'elaborazione a blocchi per evitare OOM. -### Considerazioni sulla cache +### Considerazioni sulla Cache +La classe `AnnotationAppearance` incapsula proprietà visive come colore e opacità per le annotazioni. Metti in cache oggetti riutilizzabili come `AnnotationAppearance` o istanze di `Color` quando annoti molte pagine con lo stesso stile. + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -169,9 +232,11 @@ private static EllipseAnnotation createStandardEllipse() { } ``` -## Esempi di integrazione nel mondo reale +## Esempi di Integrazione nel Mondo Reale + +### Integrazione di Applicazione Web +Expose a REST endpoint that accepts a PDF stream, applies an ellipse annotation at coordinates supplied by the front‑end, and returns the annotated PDF as a byte array. -### Integrazione in applicazioni web ```java @RestController @RequestMapping("/api/documents") @@ -188,7 +253,9 @@ public class DocumentAnnotationController { } ``` -### Elaborazione batch di documenti +### Elaborazione Batch di Documenti +Itera su una directory di contratti, aggiungi un timbro “Reviewed” a ciascuno e sposta i file elaborati in una cartella di archivio. + ```java public class BatchAnnotationProcessor { @@ -203,91 +270,102 @@ public class BatchAnnotationProcessor { } ``` -## Tecniche avanzate di annotazione +## Tecniche Avanzate di Annotazione + +### Posizionamento Dinamico delle Annotazioni +Calculate annotation coordinates on the fly based on detected text locations using OCR or PDF text extraction APIs, then place ellipses around keywords. -### Posizionamento dinamico delle annotazioni ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); ellipse.setBox(dynamicPosition); ``` -### Stile condizionale delle annotazioni +### Stile Condizionale delle Annotazioni +Apply different colors or opacity levels depending on the annotation’s author role (e.g., reviewer = blue, approver = green). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow ellipse.setBackgroundColor(color); ``` -## Applicazioni pratiche e casi d'uso +## Applicazioni Pratiche e Casi d'Uso - **Piattaforme educative:** Evidenziare concetti, aggiungere commenti degli insegnanti, creare guide di studio interattive. -- **Revisione di documenti legali:** Evidenziare clausole, aggiungere note riservate, mantenere tracciamenti di audit. +- **Revisione di documenti legali:** Evidenziare clausole, aggiungere note riservate, mantenere tracce di audit. - **Cartelle cliniche:** Annotare osservazioni, evidenziare dati critici, abilitare collaborazione sicura. -- **Flussi di lavoro aziendali:** Snellire le approvazioni dei report, aggiungere timbri dei revisori, tracciare le modifiche. +- **Flussi di lavoro aziendali:** Semplificare le approvazioni dei report, aggiungere timbri dei revisori, tracciare le modifiche. + +## Quando Usare Diversi Tipi di Annotazione -## Quando usare diversi tipi di annotazione -Mentre questa guida si concentra sulle annotazioni ellisse, la groupdocs annotation library java offre anche: +Le annotazioni ellisse sono ideali quando è necessario un evidenziatore non rettangolare, come per enfatizzare diagrammi circolari, loghi o aree meglio rappresentate da una forma ovale. Forniscono un chiaro segnale visivo mantenendo la leggibilità, rendendole adatte per revisioni di design, controlli di branding e qualsiasi scenario in cui è preferito un'enfasi rotonda. + +While this guide focuses on ellipse annotations, the GroupDocs Annotation Library Java also offers: - **Annotazioni di testo** per commenti dettagliati. - **Annotazioni a freccia** per indicare elementi specifici. - **Annotazioni rettangolari** per evidenziare aree. -- **Annotazioni di filigrana** per branding o sicurezza. +- **Annotazioni filigrana** per branding o sicurezza. - **Annotazioni timbro** per approvazioni. -Scegli le ellissi quando hai bisogno di un evidenziatore non rettangolare, visivamente distintivo—perfetto per attirare l'attenzione su diagrammi circolari o aree di logo. - -## Guida alla risoluzione dei problemi +## Guida alla Risoluzione dei Problemi -### Problemi di prestazioni +### Problemi di Prestazioni - **Sintomo:** Elaborazione lenta. - **Diagnosi:** File di grandi dimensioni, molte annotazioni, RAM limitata. -- **Soluzione:** Ottimizzare le proprietà delle annotazioni, elaborare in modo asincrono o paginare PDF di grandi dimensioni. +- **Soluzione:** Ottimizza le proprietà delle annotazioni, elabora in modo asincrono o pagina PDF di grandi dimensioni. -### Problemi di compatibilità -- **Sintomo:** Le annotazioni appaiono diverse su vari visualizzatori. +### Problemi di Compatibilità +- **Sintomo:** Le annotazioni appaiono diverse nei vari visualizzatori. - **Diagnosi:** Funzionalità PDF non standard. -- **Soluzione:** Testare con Adobe Acrobat, Chrome e Firefox; attenersi ai flag di annotazione standard PDF. +- **Soluzione:** Testa con Adobe Acrobat, Chrome e Firefox; attenersi ai flag di annotazione standard PDF. -### Sfide di integrazione +### Sfide di Integrazione - **Sintomo:** Conflitti di dipendenze. -- **Diagnosi:** Incongruenze di versione con altre librerie. -- **Soluzione:** Usa `` di Maven per imporre versioni compatibili o passa all'API REST per integrazione indipendente dal linguaggio. +- **Diagnosi:** Incompatibilità di versioni con altre librerie. +- **Soluzione:** Usa `` di Maven per imporre versioni compatibili o passa alla REST API per integrazione indipendente dal linguaggio. -## Domande frequenti +## Domande Frequenti **D: Posso aggiungere annotazioni a PDF protetti da password?** R: Sì. Usa il sovraccarico `new Annotator(filePath, loadOptions)` dove `loadOptions` include la password. **D: Come devo gestire PDF più grandi di 100 MB?** -R: Elabora le pagine singolarmente, aumenta la dimensione dell'heap o sfrutta l'API GroupDocs Annotation Cloud per carichi di lavoro intensi. +R: Elabora le pagine singolarmente, aumenta la dimensione dell'heap o utilizza l'API GroupDocs Annotation Cloud per carichi di lavoro intensi. **D: Esiste un limite al numero di annotazioni per documento?** -R: Non c'è un limite rigido, ma le prestazioni possono degradare dopo migliaia di annotazioni. Considera la paginazione o il raggruppamento. +R: Nessun limite rigido, ma le prestazioni possono degradare dopo migliaia di annotazioni. Considera la paginazione o il raggruppamento. **D: Posso estrarre le annotazioni esistenti?** R: Assolutamente. Chiama `annotator.get()` per recuperare tutte le annotazioni da un PDF. -**D: Come posso proteggere le annotazioni affinché solo determinati utenti possano modificarle?** +**D: Come posso proteggere le annotazioni affinché solo alcuni utenti possano modificarle?** R: La libreria fornisce impostazioni di permesso basate sull'utente; configurale tramite l'API `AnnotationPermission`. ## Conclusione -La **groupdocs annotation library java** ti offre un modo pulito e ad alte prestazioni per incorporare ricche annotazioni PDF direttamente dal codice Java. Seguendo i passaggi sopra, puoi aggiungere annotazioni ellisse, gestire i commenti e scalare a carichi di lavoro di livello enterprise. +La **GroupDocs Annotation Library Java** ti offre un modo pulito e ad alte prestazioni per incorporare ricche annotazioni PDF direttamente dal codice Java. Seguendo i passaggi sopra, puoi aggiungere annotazioni ellisse, gestire commenti e scalare a carichi di lavoro a livello enterprise. **Passi successivi:** 1. Sperimenta con altri tipi di annotazione (testo, timbro, filigrana). -2. Integra la libreria nel tuo flusso di lavoro documentale esistente o nel servizio web. -3. Esplora l'API REST per scenari indipendenti dal linguaggio. +2. Integra la libreria nel tuo flusso di lavoro documentale esistente o servizio web. +3. Esplora la REST API per scenari indipendenti dal linguaggio. --- -**Ultimo aggiornamento:** 2026-02-03 -**Testato con:** GroupDocs.Annotation 25.2 per Java +**Ultimo Aggiornamento:** 2026-07-25 +**Testato Con:** GroupDocs.Annotation 25.2 per Java **Autore:** GroupDocs -**Link essenziali:** -- **Documentazione:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) -- **Riferimento API:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +**Link Essenziali:** +- **Documentazione:** [Documentazione GroupDocs Annotation Java](https://docs.groupdocs.com/annotation/java/) +- **Riferimento API:** [Riferimento API GroupDocs](https://reference.groupdocs.com/annotation/java/) - **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Acquisto:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) -- **Prova gratuita:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) -- **Licenza temporanea:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Supporto:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **Acquista Licenza GroupDocs:** [Acquista Licenza GroupDocs](https://purchase.groupdocs.com/buy) +- **Inizia una Prova Gratuita:** [Inizia una Prova Gratuita](https://releases.groupdocs.com/annotation/java/) +- **Richiedi una Licenza Temporanea:** [Richiedi una Licenza Temporanea](https://purchase.groupdocs.com/temporary-license/) +- **Forum di Supporto GroupDocs:** [Forum di Supporto GroupDocs](https://forum.groupdocs.com/c/annotation/) + +## Tutorial Correlati + +- [Come aggiungere una freccia a PDF con Java – Tutorial Completo & Best Practices](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Come aggiungere un'immagine a PDF usando Java e GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Guida Completa - Come Salvare PDF Annotato con GroupDocs.Annotation per Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/japanese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/japanese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 3c9c408dd..d83b0a3ea 100644 --- a/content/japanese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/japanese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,52 +1,103 @@ --- categories: - Java Development -date: '2026-02-03' -description: GroupDocs Annotation Library Java を使用して PDF ファイルに注釈を追加する方法を学びましょう。ステップバイステップのガイド、コード例、トラブルシューティングのヒント、ベストプラクティス。 -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: GroupDocs Annotation Library Java を使用して PDF に注釈を付ける方法を学びましょう – ステップバイステップのガイド、コードスニペット、パフォーマンスのヒント、ベストプラクティスをご紹介します。 +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Java で PDF 注釈を追加する +og_description: GroupDocs Annotation Library Java を使用して PDF に注釈を付ける方法 – 楕円形注釈、コメント、ライセンス、Java + 開発者向けのヒントを網羅したガイドです。 +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: GroupDocs Annotation Library Java を使用して PDF に注釈を付ける方法 +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: GroupDocs アノテーション ライブラリ Java：PDF アノテーションの追加 +- document processing +- ellipse annotation +title: GroupDocs Annotation Library Java を使用して PDF に注釈を付ける方法 type: docs url: /ja/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java: PDF アノテーションの追加 +# PDFにGroupDocs Annotation Library Javaで注釈を付ける方法 -Java でプログラム的に PDF ドキュメントにアノテーションを追加したいと思ったことはありませんか？ **groupdocs annotation library java** を使用すれば、楕円、コメント、スタンプなどのリッチなマークアップを PDF に直接埋め込むことができます。ドキュメントレビューシステム、教育プラットフォーム、コラボレーションワークスペースの構築を検討している方に、本チュートリアルは具体的な開始手順を示します。 +PDFに視覚的なメモ、コメント、またはスタンプをプログラムで追加することで、レビューサイクル、コンプライアンスチェック、協働ワークフローを大幅に高速化できます。このチュートリアルでは、GroupDocs Annotation Library for Java を使用して **PDFに注釈を付ける方法** を学び、プロジェクトのセットアップから高度な楕円形注釈、ライセンス、パフォーマンスチューニング、実際の統合ヒントまで網羅します。 -## Quick Answers -- **What library adds annotations to PDFs in Java?** The groupdocs annotation library java. -- **Do I need a license?** A trial works for testing; a production license is required for commercial use. -- **Which IDE works best?** Any Java IDE (IntelliJ IDEA, Eclipse, VS Code) works fine. -- **Can I annotate password‑protected PDFs?** Yes—provide the password when creating the `Annotator`. -- **Is batch processing supported?** Absolutely; see the batch processing example later. +## クイック回答 +- **JavaでPDFに注釈を追加するライブラリは何ですか？** GroupDocs Annotation Library for Javaです。 +- **ライセンスは必要ですか？** テスト用のトライアルは動作しますが、商用利用には本番ライセンスが必要です。 +- **どのIDEが最適ですか？** 任意のJava IDE（IntelliJ IDEA、Eclipse、VS Code）で問題ありません。 +- **パスワード保護されたPDFに注釈を付けられますか？** はい—`Annotator` を作成する際にパスワードを指定してください。 +- **バッチ処理はサポートされていますか？** もちろんです。後述のバッチ処理例をご参照ください。 -## What is the GroupDocs Annotation Library Java? -The groupdocs annotation library java is a powerful, enterprise‑ready Java API that lets you create, edit, and retrieve PDF annotations programmatically. It supports over 50 document formats and provides collaboration features such as replies and comment threads. +## GroupDocs Annotation Library Javaとは？ -## Why Use the GroupDocs Annotation Library Java? -- **Rich annotation types** – shapes, text, stamps, watermarks, and more. -- **Collaboration ready** – built‑in replies and comment threads. -- **Performance‑tuned** – handles large PDFs efficiently. -- **Simple API** – reduces development time compared with lower‑level libraries like iText or PDFBox. +GroupDocs Annotation Library Java は、開発者が Java コードだけで PDF の注釈を作成、編集、取得、削除できるすぐに使える API です。**50 以上のドキュメント形式** をサポートし、組み込みのコメントスレッドを提供し、細かい権限制御も可能です。 -## Prerequisites and Setup -- **JDK 8+** (JDK 11 recommended) -- **Maven or Gradle** for dependency management -- **IDE** of your choice (IntelliJ IDEA, Eclipse, etc.) -- Basic familiarity with Java file I/O +## なぜ GroupDocs Annotation Library Java を使用するのか？ -## Setting Up the GroupDocs Annotation Library Java +数行のメソッド呼び出しだけで、楕円形、テキストノート、スタンプ、透かしなどのリッチなマークアップを追加でき、ライブラリは **数百ページに及ぶ PDF** をファイル全体をメモリに読み込むことなく処理します。iText や PDFBox などの低レベルツールと比較して、開発時間を最大 **70 %** 短縮でき、レイヤー、フォーム、デジタル署名といった複雑な PDF 機能も標準でサポートします。 -### Maven Integration +## 前提条件とセットアップ +- **JDK 8+**（JDK 11 推奨） +- **Maven または Gradle**（依存関係管理用） +- **IDE**（IntelliJ IDEA、Eclipse、VS Code など） +- Java のファイル I/O に関する基本的な知識 + +### Maven 統合 Add the repository and dependency to your `pom.xml`: ```xml @@ -66,7 +117,7 @@ Add the repository and dependency to your `pom.xml`: ``` -### License Configuration +### ライセンス設定 Apply your license before any annotation work: ```java @@ -74,16 +125,20 @@ License license = new License(); license.setLicense("path/to/your/license/file"); ``` -*Pro tip:* Store the license file in `src/main/resources` and load it with `getClass().getResourceAsStream()` for smoother deployments. +*Pro tip:* ライセンスファイルを `src/main/resources` に保存し、`getClass().getResourceAsStream()` でロードするとデプロイがスムーズになります。 + +## 完全実装ガイド -## Complete Implementation Guide +### 手順 1: PDF アノテータの初期化 +`Annotator` クラスはすべての注釈操作のエントリーポイントです。対象 PDF を読み込み、セキュリティ設定を適用し、編集用のインメモリ表現を準備します。 -### Step 1: Initialize the PDF Annotator ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -### Step 2: Create Interactive Comments and Replies +### 手順 2: インタラクティブなコメントと返信の作成 +`CommentAnnotation` を使用すると自由形式のテキストを埋め込め、`Reply` オブジェクトで PDF ページ上にスレッド化されたディスカッションを実現できます。 + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -98,7 +153,9 @@ replies.add(reply1); replies.add(reply2); ``` -### Step 3: Configure Your Ellipse Annotation +### 手順 3: 楕円形注釈の設定 +`EllipseAnnotation` は拡大縮小可能な楕円形を描画します。線の色、塗りつぶし色、不透明度、カスタムの枠線太さを設定して UI ガイドラインに合わせることができます。 + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -112,36 +169,40 @@ ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -### Step 4: Add and Save Your Annotations +### 手順 4: 注釈の追加と保存 +注釈オブジェクトの設定が完了したら、`annotator.save()` を呼び出して変更をディスクに書き戻します。特に多数のファイルをループで処理する場合は、`dispose()` を呼び出してネイティブリソースを解放することを忘れないでください。 + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **Why call `dispose()`?** It releases native resources, preventing memory leaks—especially important when processing many PDFs in a loop. +> **なぜ `dispose()` を呼び出すのか？** ネイティブリソースを解放し、メモリリークを防止します—特に多数の PDF をループで処理する際に重要です。 + +## よくある問題と解決策 -## Common Issues and Solutions +### 問題 1 – “Document Not Found” +*原因:* ファイルパスまたは作業ディレクトリが間違っている。 +*対策:* 絶対パスを確認するか、`System.getProperty("user.dir")` を出力してベースディレクトリを確認してください。 -### Issue 1 – “Document Not Found” -*Cause:* Incorrect file path or working directory. -*Fix:* Verify the absolute path or print `System.getProperty("user.dir")` to confirm the base directory. +### 問題 2 – 注釈が表示されない +*原因:* 座標系またはページインデックスが誤っている。 +*対策:* PDF の座標は左下が原点で、ページ番号は 0 から始まることを覚えておいてください。 -### Issue 2 – Annotations Not Visible -*Cause:* Wrong coordinate system or page index. -*Fix:* Remember PDF coordinates start at the bottom‑left, and pages are zero‑based. +### 問題 3 – 大きな PDF で OutOfMemoryError が発生 +*原因:* ドキュメント全体がメモリに読み込まれる。 +*対策:* JVM ヒープを増やす（`-Xmx2g`）か、ページをバッチで処理する（下記のバッチ例を参照）。 -### Issue 3 – OutOfMemoryError on Large PDFs -*Cause:* Entire document loaded into memory. -*Fix:* Increase JVM heap (`-Xmx2g`) or process pages in batches (see the batch example below). +### 問題 4 – ライセンス検証エラー +*原因:* ライセンスファイルがない、またはバージョンが合わない。 +*対策:* ファイルパスを再確認し、ライセンスのバージョンがライブラリのバージョンと一致していることを確認してください。 -### Issue 4 – License Validation Errors -*Cause:* Missing or mismatched license file. -*Fix:* Double‑check the file path and ensure the license version matches the library version. +## パフォーマンス最適化のヒント -## Performance Optimization Tips +### メモリ管理のベストプラクティス +不要に大きな `Annotator` インスタンスへの参照を保持しないでください。各ファイル処理後に try‑with‑resources または明示的な `dispose()` 呼び出しを使用します。 -### Memory Management Best Practices ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -152,12 +213,14 @@ for (String documentPath : documentPaths) { } ``` -### Batch Processing Strategies -- **Small PDFs (<10 MB):** Process individually. -- **Medium PDFs (10‑50 MB):** Process in batches of 5‑10. -- **Large PDFs (>50 MB):** Use streaming or chunked processing to avoid OOM. +### バッチ処理戦略 +- **小さな PDF (<10 MB):** 個別に処理。 +- **中規模 PDF (10‑50 MB):** 5‑10 件のバッチで処理。 +- **大きな PDF (>50 MB):** ストリーミングまたはチャンク処理を使用して OOM を回避。 + +### キャッシュの考慮事項 +`AnnotationAppearance` クラスは注釈の色や不透明度などの視覚プロパティをカプセル化します。同一スタイルで多数のページに注釈を付ける場合、`AnnotationAppearance` や `Color` インスタンスなど再利用可能なオブジェクトをキャッシュしてください。 -### Caching Considerations ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -167,9 +230,11 @@ private static EllipseAnnotation createStandardEllipse() { } ``` -## Real‑World Integration Examples +## 実践的な統合例 + +### Web アプリケーション統合 +PDF ストリームを受け取り、フロントエンドから提供された座標に楕円形注釈を適用し、注釈付き PDF をバイト配列で返す REST エンドポイントを公開します。 -### Web Application Integration ```java @RestController @RequestMapping("/api/documents") @@ -186,7 +251,9 @@ public class DocumentAnnotationController { } ``` -### Batch Document Processing +### バッチドキュメント処理 +契約書が格納されたディレクトリを走査し、各ファイルに “Reviewed” スタンプを付加して、処理済みファイルをアーカイブフォルダへ移動します。 + ```java public class BatchAnnotationProcessor { @@ -201,91 +268,103 @@ public class BatchAnnotationProcessor { } ``` -## Advanced Annotation Techniques +## 高度な注釈テクニック + +### 動的な注釈位置決め +OCR や PDF テキスト抽出 API を使用して検出されたテキスト位置に基づき、注釈座標を動的に計算し、キーワードの周囲に楕円形を配置します。 -### Dynamic Annotation Positioning ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); ellipse.setBox(dynamicPosition); ``` -### Conditional Annotation Styling +### 条件付き注釈スタイリング +注釈の作成者ロールに応じて色や不透明度を変えます（例: レビューア＝青、承認者＝緑）。 + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow ellipse.setBackgroundColor(color); ``` -## Practical Applications and Use Cases -- **Educational platforms:** Highlight concepts, add teacher comments, create interactive study guides. -- **Legal document review:** Mark clauses, add confidential notes, maintain audit trails. -- **Medical records:** Annotate observations, highlight critical data, enable secure collaboration. -- **Corporate workflows:** Streamline report approvals, add reviewer stamps, track changes. +## 実用的な応用例とユースケース +- **教育プラットフォーム:** コンセプトをハイライトし、教師のコメントを追加し、インタラクティブな学習ガイドを作成。 +- **法務文書レビュー:** 条項にマークを付け、機密コメントを追加し、監査トレイルを維持。 +- **医療記録:** 観察結果に注釈を付け、重要データをハイライトし、安全な共同作業を実現。 +- **企業ワークフロー:** レポート承認を効率化し、レビュアースタンプを追加し、変更履歴を追跡。 + +## いつどの注釈タイプを使うべきか -## When to Use Different Annotation Types -While this guide focuses on ellipse annotations, the groupdocs annotation library java also offers: -- **Text annotations** for detailed comments. -- **Arrow annotations** to point at specific elements. -- **Rectangle annotations** for area highlighting. -- **Watermark annotations** for branding or security. -- **Stamp annotations** for approvals. +楕円形注釈は、円形の図やロゴ、楕円で表現した方が適切な領域など、矩形以外のハイライトが必要な場合に最適です。視認性を保ちつつ明確な視覚的指示を提供するため、デザインレビューやブランドチェック、丸い強調が求められるシーンに適しています。 -Choose ellipses when you need a non‑rectangular, visually distinct highlight—perfect for drawing attention to circular diagrams or logo areas. +このガイドは楕円形注釈に焦点を当てていますが、GroupDocs Annotation Library Java では以下も利用可能です: +- **テキスト注釈**：詳細なコメント用。 +- **矢印注釈**：特定要素を指し示す。 +- **矩形注釈**：領域ハイライト用。 +- **透かし注釈**：ブランディングやセキュリティ用。 +- **スタンプ注釈**：承認用。 -## Troubleshooting Guide +## トラブルシューティングガイド -### Performance Issues -- **Symptom:** Slow processing. -- **Diagnosis:** Large file size, many annotations, limited RAM. -- **Solution:** Optimize annotation properties, process asynchronously, or paginate large PDFs. +### パフォーマンス問題 +- **症状:** 処理が遅い。 +- **診断:** ファイルサイズが大きい、注釈が多数、RAM が不足。 +- **解決策:** 注釈プロパティを最適化し、非同期処理や大きな PDF のページ分割を行う。 -### Compatibility Problems -- **Symptom:** Annotations look different across viewers. -- **Diagnosis:** Non‑standard PDF features. -- **Solution:** Test with Adobe Acrobat, Chrome, and Firefox; stick to PDF‑standard annotation flags. +### 互換性の問題 +- **症状:** ビューア間で注釈の表示が異なる。 +- **診断:** 標準外の PDF 機能。 +- **解決策:** Adobe Acrobat、Chrome、Firefox でテストし、PDF 標準の注釈フラグに従う。 -### Integration Challenges -- **Symptom:** Dependency conflicts. -- **Diagnosis:** Version mismatches with other libraries. -- **Solution:** Use Maven’s `` to enforce compatible versions or switch to the REST API for language‑agnostic integration. +### 統合上の課題 +- **症状:** 依存関係の衝突。 +- **診断:** 他のライブラリとのバージョン不一致。 +- **解決策:** Maven の `` を使用して互換バージョンを強制するか、言語非依存の統合のために REST API に切り替える。 -## Frequently Asked Questions +## よくある質問 -**Q: Can I add annotations to password‑protected PDFs?** -A: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` includes the password. +**Q: パスワード保護された PDF に注釈を追加できますか？** +A: はい。`new Annotator(filePath, loadOptions)` のオーバーロードを使用し、`loadOptions` にパスワードを含めてください。 -**Q: How should I handle PDFs larger than 100 MB?** -A: Process pages individually, increase heap size, or leverage the GroupDocs Annotation Cloud API for heavy workloads. +**Q: 100 MB を超える PDF はどう扱うべきですか？** +A: ページ単位で処理し、ヒープサイズを増やすか、重い負荷には GroupDocs Annotation Cloud API を活用してください。 -**Q: Is there a limit to the number of annotations per document?** -A: No hard limit, but performance may degrade after thousands of annotations. Consider pagination or grouping. +**Q: ドキュメントあたりの注釈数に上限はありますか？** +A: 厳密な上限はありませんが、数千件を超えるとパフォーマンスが低下する可能性があります。ページ分割やグルーピングを検討してください。 -**Q: Can I extract existing annotations?** -A: Absolutely. Call `annotator.get()` to retrieve all annotations from a PDF. +**Q: 既存の注釈を抽出できますか？** +A: もちろんです。`annotator.get()` を呼び出して PDF からすべての注釈を取得します。 -**Q: How do I secure annotations so only certain users can edit them?** -A: The library provides user‑based permission settings; configure them via the `AnnotationPermission` API. +**Q: 特定のユーザーだけが編集できるように注釈を保護するには？** +A: ライブラリはユーザー単位の権限設定を提供します。`AnnotationPermission` API を使用して設定してください。 -## Conclusion -The **groupdocs annotation library java** gives you a clean, high‑performance way to embed rich PDF annotations directly from Java code. By following the steps above, you can add ellipse annotations, manage comments, and scale to enterprise‑level workloads. +## 結論 -**Next steps:** -1. Experiment with other annotation types (text, stamp, watermark). -2. Integrate the library into your existing document workflow or web service. -3. Explore the REST API for language‑agnostic scenarios. +**GroupDocs Annotation Library Java** は、Java コードから直接リッチな PDF 注釈を埋め込むためのシンプルで高性能な手段を提供します。上記の手順に従えば、楕円形注釈の追加、コメント管理、エンタープライズ規模のワークロードへのスケーリングが可能です。 + +**次のステップ:** +1. 他の注釈タイプ（テキスト、スタンプ、透かし）を試す。 +2. 既存のドキュメントワークフローや Web サービスにライブラリを統合する。 +3. 言語非依存のシナリオ向けに REST API を検討する。 --- -**Last Updated:** 2026-02-03 -**Tested With:** GroupDocs.Annotation 25.2 for Java -**Author:** GroupDocs - -**Essential Links:** -- **Documentation:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) -- **API Reference:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) -- **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Purchase:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) -- **Free Trial:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) -- **Temporary License:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +**最終更新:** 2026-07-25 +**テスト環境:** GroupDocs.Annotation 25.2 for Java +**作者:** GroupDocs + +**重要なリンク:** +- **ドキュメント:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **API リファレンス:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **ダウンロード:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **購入:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **無料トライアル:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **一時ライセンス:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **サポート:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## 関連チュートリアル + +- [JavaでPDFに矢印を追加する方法 – 完全チュートリアルとベストプラクティス](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [JavaとGroupDocs Annotationを使用してPDFに画像を追加する方法](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [完全ガイド - GroupDocs.Annotation for Javaで注釈付きPDFを保存する方法](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/korean/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/korean/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index d6aa10de4..37e97de15 100644 --- a/content/korean/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/korean/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,53 +1,103 @@ --- categories: - Java Development -date: '2026-02-03' -description: groupdocs annotation library java를 사용하여 PDF 파일에 주석을 추가하는 방법을 배웁니다. 단계별 - 가이드, 코드 예제, 문제 해결 팁 및 모범 사례. -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: GroupDocs Annotation Library Java를 사용하여 PDF에 주석을 다는 방법을 배우세요 – 단계별 가이드, + 코드 스니펫, 성능 팁 및 모범 사례. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Java에서 PDF 주석 추가 +og_description: GroupDocs Annotation Library Java를 사용하여 PDF에 주석을 다는 방법을 배우세요 – ellipse + annotations, comments, licensing, 그리고 Java developers를 위한 팁을 다루는 가이드. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: GroupDocs Annotation Library Java로 PDF에 주석 달기 방법 +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'GroupDocs Annotation Library Java: PDF 주석 추가' +- document processing +- ellipse annotation +title: GroupDocs Annotation Library Java로 PDF에 주석 달기 방법 type: docs url: /ko/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java: PDF 주석 추가 +# PDF에 GroupDocs Annotation Library Java로 주석 달기 -Java에서 프로그래밍 방식으로 PDF 문서에 주석을 추가하는 방법이 궁금하셨나요? **groupdocs annotation library java**를 사용하면 타원, 댓글, 스탬프와 같은 풍부한 마크업을 PDF에 직접 삽입할 수 있습니다. 문서 검토 시스템, 교육 플랫폼, 협든, 이 튜토리니다. +PDF에 시각적 메모, 댓글 또는 스탬프를 프로그래밍 방식으로 추가하면 검토 주기, 규정 준수 검사 및 협업 워크플로우를 크게 가속화할 수 있습니다. 이 튜토리얼에서는 Java용 GroupDocs Annotation Library를 사용하여 **PDF에 주석을 다는 방법**을 배우게 되며, 프로젝트 설정부터 고급 타원 주석, 라이선스, 성능 튜닝 및 실제 통합 팁까지 모두 다룹니다. ## 빠른 답변 -- **Java판션 라이선스가 필요합니다. -- **어떤 IDE가 가장 적합합니까?** Any Java IDE (IntelliJ IDEA, Eclipse, VS Code) works fine. -- **비밀번호로 보호된 PDF에 주석을 달 수 있나요?** Yes—provide the password when creating the `Annotator`. -- **배치 처리 지원이 되나요?** Absolutely; see the batch processing example later. +- **Java에서 PDF에 주석을 추가하는 라이브러리는?** GroupDocs Annotation Library for Java. +- **라이선스가 필요합니까?** 테스트용 트라이얼은 사용할 수 있지만, 상업적 사용을 위해서는 정식 라이선스가 필요합니다. +- **어떤 IDE가 가장 적합합니까?** IntelliJ IDEA, Eclipse, VS Code 등 모든 Java IDE에서 정상적으로 작동합니다. +- **비밀번호로 보호된 PDF에 주석을 달 수 있나요?** 예—`Annotator`를 생성할 때 비밀번호를 제공하면 됩니다. +- **배치 처리를 지원합니까?** 물론입니다; 아래 배치 처리 예제를 참고하세요. ## GroupDocs Annotation Library Java란? -groupdocs annotation library java는 강력하고 엔터프라이즈 수준의 Java API로, 프로그래밍 방식으로 PDF 주석을 생성, 편집 및 검색할 수 있습니다. 50개 이상의 문서 형식을 지원하며, 답글 및 댓글 스레드와 같은 협업 기능을 제공합니다. +GroupDocs Annotation Library Java는 개발자가 Java 코드만으로 PDF 주석을 생성, 편집, 검색 및 삭제할 수 있는 즉시 사용 가능한 API입니다. **50개 이상의 문서 형식**을 지원하며, 내장된 댓글 스레드를 제공하고 세밀한 권한 제어 기능을 제공합니다. ## 왜 GroupDocs Annotation Library Java를 사용해야 할까요? -- **Rich annotation types** – 도형, 텍스트, 스탬프, 워터마크 등 다양한 주석 유형을 제공합니다. -- **Collaboration ready** – 내장된 답글 및 댓글 스레드를 제공합니다. -- **Performance‑tuned** – 대용량 PDF를 효율적으로 처리합니다. -- **Simple API** – iText 또는 PDFBox와 같은 저수준 라이브러리 대비 개발 시간을 단축합니다. +몇 번의 메서드 호출만으로 타원, 텍스트 메모, 스탬프, 워터마크 등 풍부한 마크업을 추가할 수 있으며, 라이브러리는 전체 파일을 메모리에 로드하지 않고도 **수백 페이지 PDF**를 처리합니다. iText나 PDFBox와 같은 저수준 도구와 비교했을 때 개발 시간을 최대 **70 %**까지 단축하고, 복잡한 PDF 기능(레이어, 양식, 디지털 서명)을 바로 지원합니다. -## 사전 요구 사항 및 설정 -- **JDK 8+** (JDK 11 권장) -- **Maven or Gradle** – 의존성 관리를 위해 -- **IDE** – 선택한 IDE (IntelliJ IDEA, Eclipse 등) -- Java 파일 I/O에 대한 기본 지식 - -## GroupDocs Annotation Library Java 설정 +## 전제 조건 및 설정 +- **JDK 8+** (JDK 11 권장) +- **Maven 또는 Gradle** (의존성 관리용) +- **IDE** (IntelliJ IDEA, Eclipse, VS Code 등 선택 가능) +- Java 파일 I/O에 대한 기본적인 이해 ### Maven 통합 -다음과 같이 `pom.xml`에 저장소와 의존성을 추가합니다: +Add the repository and dependency to your `pom.xml`: ```xml @@ -67,23 +117,27 @@ groupdocs annotation library java는 강력하고 엔터프라이즈 수준의 J ``` ### 라이선스 구성 -주석 작업을 시작하기 전에 라이선스를 적용합니다: +Apply your license before any annotation work: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -*Pro tip:* 라이선스 파일을 `src/main/resources`에 저장하고 `getClass().getResourceAsStream()`으로 로드하면 배포가 원활합니다. +*프로 팁:* 라이선스 파일을 `src/main/resources`에 저장하고 `getClass().getResourceAsStream()`으로 로드하면 배포가 원활합니다. ## 전체 구현 가이드 ### 단계 1: PDF Annotator 초기화 +`Annotator` 클래스는 모든 주석 작업의 진입점입니다. 대상 PDF를 로드하고 보안 설정을 적용하며, 편집을 위한 메모리 내 표현을 준비합니다. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### 단계 2: 인터랙티브 댓글 및 답글 생성 +`CommentAnnotation`을 사용하면 자유 형식 텍스트를 삽입할 수 있고, `Reply` 객체를 통해 PDF 페이지에 직접 스레드형 토론을 구현할 수 있습니다. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -99,6 +153,8 @@ replies.add(reply2); ``` ### 단계 3: 타원 주석 구성 +`EllipseAnnotation`은 확장 가능한 타원 형태를 그립니다. 선 색상, 채우기 색상, 불투명도 및 사용자 정의 테두리 두께를 설정하여 UI 가이드라인에 맞출 수 있습니다. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -113,35 +169,39 @@ ellipse.setReplies(replies); ``` ### 단계 4: 주석 추가 및 저장 +모든 주석 객체를 구성한 후 `annotator.save()`를 호출하여 변경 사항을 디스크에 기록합니다. 특히 여러 파일을 루프에서 처리할 때는 `dispose()`를 호출해 네이티브 리소스를 해제하는 것을 기억하세요. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **왜 `dispose()`를 호출하나요?** 네이티브 리소스를 해제하여 메모리 누수를 방지합니다—특히 루프에서 많은 PDF를 처리할 때 중요합니다. +> **왜 `dispose()`를 호출해야 할까요?** 네이티브 리소스를 해제하여 메모리 누수를 방지합니다—특히 다수의 PDF를 루프에서 처리할 때 중요합니다. ## 일반적인 문제 및 해결책 -### Issue 1 – “문서를 찾을 수 없음” -*원인:* 파일 경로 또는 작업 디렉터리가 올바르지 않음. -*해결:* 절대 경로를 확인하거나 `System.getProperty("user.dir")`를 출력해 기본 디렉터리를 확인합니다. +### 문제 1 – “문서를 찾을 수 없음” +*원인:* 파일 경로나 작업 디렉터리가 잘못되었습니다. +*해결:* 절대 경로를 확인하거나 `System.getProperty("user.dir")`를 출력하여 기본 디렉터리를 확인하세요. -### Issue 2 – 주석이 보이지 않음 -*원인:* 좌표계 또는 페이지 인덱스 오류. +### 문제 2 – 주석이 보이지 않음 +*원인:* 좌표계 또는 페이지 인덱스가 잘못되었습니다. *해결:* PDF 좌표는 왼쪽 하단이 원점이며, 페이지 인덱스는 0부터 시작한다는 점을 기억하세요. -### Issue 3 – 대용량 PDF에서 OutOfMemoryError -*원인:* 전체 문서를 메모리에 로드함. -*해결:* JVM 힙을 늘리세요 (`-Xmx2g`) 또는 페이지를 배치로 처리하세요(아래 배치 예시 참고). +### 문제 3 – 대용량 PDF에서 OutOfMemoryError 발생 +*원인:* 전체 문서를 메모리에 로드했습니다. +*해결:* JVM 힙을 늘리세요(`-Xmx2g`) 또는 페이지를 배치로 처리하세요(아래 배치 예시 참고). -### Issue 4 – 라이선스 검증 오류 -*원인:* 라이선스 파일이 없거나 버전이 맞지 않음. -*해결:* 파일 경로를 다시 확인하고, 라이선스 버전이 라이브러리 버전과 일치하는지 확인하세요. +### 문제 4 – 라이선스 검증 오류 +*원인:* 라이선스 파일이 없거나 버전이 일치하지 않습니다. +*해결:* 파일 경로를 다시 확인하고 라이선스 버전이 라이브러리 버전과 일치하는지 확인하세요. ## 성능 최적화 팁 ### 메모리 관리 모범 사례 +필요 이상으로 큰 `Annotator` 인스턴스에 대한 참조를 유지하지 마세요. 파일을 처리한 후에는 try‑with‑resources 구문이나 명시적인 `dispose()` 호출을 사용하세요. + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -153,11 +213,13 @@ for (String documentPath : documentPaths) { ``` ### 배치 처리 전략 -- **Small PDFs (<10 MB):** 개별 처리합니다. -- **Medium PDFs (10‑50 MB):** 5‑10개씩 배치 처리합니다. -- **Large PDFs (>50 MB):** 스트리밍 또는 청크 처리로 OOM을 방지합니다. +- **작은 PDF (<10 MB):** 개별 처리. +- **중간 PDF (10‑50 MB):** 5‑10개씩 배치 처리. +- **대형 PDF (>50 MB):** 스트리밍 또는 청크 처리로 OOM을 방지하세요. ### 캐싱 고려 사항 +`AnnotationAppearance` 클래스는 색상 및 불투명도와 같은 주석의 시각적 속성을 캡슐화합니다. 동일한 스타일을 여러 페이지에 적용할 경우 `AnnotationAppearance`나 `Color` 인스턴스와 같은 재사용 가능한 객체를 캐시하세요. + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -170,6 +232,8 @@ private static EllipseAnnotation createStandardEllipse() { ## 실제 통합 예시 ### 웹 애플리케이션 통합 +프론트엔드에서 전달한 좌표에 타원 주석을 적용하고, 주석이 달린 PDF를 바이트 배열로 반환하는 REST 엔드포인트를 노출합니다. + ```java @RestController @RequestMapping("/api/documents") @@ -187,6 +251,8 @@ public class DocumentAnnotationController { ``` ### 배치 문서 처리 +계약서가 들어 있는 디렉터리를 순회하면서 각 파일에 “Reviewed” 스탬프를 추가하고, 처리된 파일을 아카이브 폴더로 이동합니다. + ```java public class BatchAnnotationProcessor { @@ -204,6 +270,8 @@ public class BatchAnnotationProcessor { ## 고급 주석 기법 ### 동적 주석 위치 지정 +OCR 또는 PDF 텍스트 추출 API를 사용해 감지된 텍스트 위치를 기반으로 주석 좌표를 실시간으로 계산하고, 키워드 주변에 타원을 배치합니다. + ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); @@ -211,69 +279,88 @@ ellipse.setBox(dynamicPosition); ``` ### 조건부 주석 스타일링 +주석 작성자의 역할에 따라 색상이나 불투명도 수준을 다르게 적용합니다(예: 검토자 = 파란색, 승인자 = 녹색). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow ellipse.setBackgroundColor(color); ``` -## 실용적인 적용 사례 및 사용 예시 -- **Educational platforms:** 개념을 강조하고, 교사 댓글을 추가하며, 인터랙티브 학습 가이드를 만듭니다. -- **Legal document review:** 조항을 표시하고, 기밀 메모를 추가하며, 감사 추적을 유지합니다. -- **Medical records:** 관찰 내용을 주석 달고, 중요한 데이터를 강조하며, 안전한 협업을 가능하게 합니다. -- **Corporate workflows:** 보고서 승인 절차를 간소화하고, 검토자 스탬프를 추가하며, 변경 사항을 추적합니다. +## 실용적인 적용 사례 및 사용 사례 +- **교육 플랫폼:** 개념 강조, 교사 댓글 추가, 인터랙티브 학습 가이드 생성. +- **법률 문서 검토:** 조항 표시, 기밀 메모 추가, 감사 로그 유지. +- **의료 기록:** 관찰 내용 주석, 중요한 데이터 강조, 안전한 협업 지원. +- **기업 워크플로우:** 보고서 승인 간소화, 검토자 스탬프 추가, 변경 사항 추적. -## 언제 다른 주석 유형을 사용해야 할까요 -이 가이드는 타원 주석에 중점을 두지만, groupdocs annotation library java는 다음과 같은 주석 유형도 제공합니다: -- **Text annotations** – 상세 댓글용. -- **Arrow annotations** – 특정 요소를 가리키는 화살표. -- **Rectangle annotations** – 영역 강조용 사각형. -- **Watermark annotations** – 브랜드 또는 보안을 위한 워터마크. -- **Stamp annotations** – 승인용 스탬프. +## 언제 다른 주석 유형을 사용해야 할까 +타원 주석은 원형 다이어그램, 로고 또는 타원 형태가 더 적합한 영역을 강조해야 할 때와 같이 사각형이 아닌 강조가 필요할 때 이상적입니다. 가독성을 유지하면서 명확한 시각적 신호를 제공하므로 디자인 검토, 브랜드 확인 및 원형 강조가 필요한 모든 상황에 적합합니다. -비직사각형이며 시각적으로 돋보이는 강조가 필요할 때 타원을 선택하세요—원형 다이어그램이나 로고 영역에 주목을 끌기에 적합합니다. +- **텍스트 주석:** 상세 댓글용. +- **화살표 주석:** 특정 요소를 가리킬 때. +- **사각형 주석:** 영역 강조용. +- **워터마크 주석:** 브랜드 또는 보안용. +- **스탬프 주석:** 승인용. ## 문제 해결 가이드 ### 성능 문제 -- **Symptom:** 처리 속도가 느림. -- **Diagnosis:** 파일 크기가 크고, 주석이 많으며, RAM이 제한됨. -- **Solution:** 주석 속성을 최적화하고, 비동기 처리하거나 대용량 PDF를 페이지 단위로 나눕니다. +- **증상:** 처리 속도가 느림. +- **진단:** 파일 크기 큼, 주석 많음, RAM 제한. +- **해결:** 주석 속성 최적화, 비동기 처리, 대용량 PDF 페이지 나누기. ### 호환성 문제 -- **Symptom:** 뷰어마다 주석 모양이 다르게 보임. -- **Diagnosis:** 비표준 PDF 기능 사용. -- **Solution:** Adobe Acrobat, Chrome, Firefox에서 테스트하고, PDF 표준 주석 플래그만 사용합니다. +- **증상:** 뷰어마다 주석 표시가 다름. +- **진단:** 비표준 PDF 기능. +- **해결:** Adobe Acrobat, Chrome, Firefox 등에서 테스트하고 PDF 표준 주석 플래그를 사용하세요. ### 통합 문제 -- **Symptom:** 의존성 충돌. -- **Diagnosis:** 다른 라이브러리와 버전 불일치. -- **Solution:** Maven의 ``를 사용해 호환 버전을 강제하거나, 언어에 구애받지 않는 통합을 위해 REST API로 전환합니다. +- **증상:** 의존성 충돌. +- **진단:** 다른 라이브러리와 버전 불일치. +- **해결:** Maven ``를 사용해 호환 버전을 강제하거나 언어에 구애받지 않는 통합을 위해 REST API로 전환하세요. ## 자주 묻는 질문 -**Q: 비밀번호로 보호된 PDF에 주석을 달 수 있나요?** -A: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` includes the password. +**Q: 비밀번호로 보호된 PDF에 주석을 추가할 수 있나요?** +A: 예. 비밀번호를 포함하는 `loadOptions`를 사용해 `new Annotator(filePath, loadOptions)`를 호출하면 됩니다. -**Q: 100 MB보다 큰 PDF는 어떻게 처리해야 하나요?** -A: 페이지를 개별 처리하고, 힙 크기를 늘리거나, 대용량 작업을 위해 GroupDocs Annotation Cloud API를 활용합니다. +**Q: 100 MB보다 큰 PDF를 어떻게 처리해야 하나요?** +A: 페이지를 개별적으로 처리하거나 힙 크기를 늘리거나, 대용량 작업을 위해 GroupDocs Annotation Cloud API를 활용하세요. -**Q: 문서당 주석 개수에 제한이 있나요?** -A: 하드 제한은 없지만, 수천 개 이상의 주석이 있으면 성능이 저하될 수 있습니다. 페이지네이션이나 그룹화를 고려하세요. +**Q: 문서당 주석 수에 제한이 있나요?** +A: 명확한 제한은 없지만 수천 개 이상의 주석이 있으면 성능이 저하될 수 있습니다. 페이지 나누기나 그룹화를 고려하세요. **Q: 기존 주석을 추출할 수 있나요?** -A: Absolutely. Call `annotator.get()` to retrieve all annotations from a PDF. +A: 물론입니다. `annotator.get()`을 호출하면 PDF의 모든 주석을 가져올 수 있습니다. **Q: 특정 사용자만 주석을 편집하도록 보안 설정을 할 수 있나요?** -A: The library provides user‑based permission settings; configure them via the `AnnotationPermission** gives you a clean, high‑performance way to embed rich PDF annotations directly from Java code. By following the steps above, you can add ellipse annotations, manage comments, and scale to enterprise‑level workloads. - -** Experiment with other annotation types (text, stamp, watermark). -2. -3. Explore the REST API forDocs심 링크:** -- **Documentation:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) -- **API Reference:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) -- **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Purchase:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) -- **Free Trial:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) -- **Temporary License:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +A: 라이브러리는 사용자 기반 권한 설정을 제공하며, `AnnotationPermission` API를 통해 구성할 수 있습니다. + +## 결론 +**GroupDocs Annotation Library Java**는 Java 코드만으로 풍부한 PDF 주석을 삽입할 수 있는 깔끔하고 고성능의 방법을 제공합니다. 위 단계들을 따르면 타원 주석을 추가하고, 댓글을 관리하며, 엔터프라이즈 수준의 작업량에도 확장할 수 있습니다. + +**다음 단계:** +1. 다른 주석 유형(텍스트, 스탬프, 워터마크)도 실험해 보세요. +2. 기존 문서 워크플로우 또는 웹 서비스에 라이브러리를 통합하세요. +3. 언어에 구애받지 않는 시나리오를 위해 REST API를 살펴보세요. + +--- + +**Last Updated:** 2026-07-25 +**Tested With:** GroupDocs.Annotation 25.2 for Java +**Author:** GroupDocs + +## 필수 링크: +- **문서:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **API 레퍼런스:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **다운로드:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **구매:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **무료 체험:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **임시 라이선스:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **지원:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## 관련 튜토리얼 + +- [Java로 PDF에 화살표 추가 방법 – 완전 튜토리얼 및 모범 사례](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Java와 GroupDocs Annotation을 사용해 PDF에 이미지 추가하는 방법](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [완전 가이드 - Java용 GroupDocs.Annotation으로 주석이 달린 PDF 저장 방법](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/polish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/polish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index da3393908..936b67e47 100644 --- a/content/polish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/polish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,108 @@ --- -"date": "2025-05-06" -"description": "Dowiedz się, jak dodawać adnotacje elipsy do dokumentów PDF za pomocą potężnej biblioteki GroupDocs.Annotation w Javie. Postępuj zgodnie z tym przewodnikiem krok po kroku, aby usprawnić współpracę nad dokumentami." -"title": "Java: Dodawanie adnotacji elipsy do plików PDF przy użyciu GroupDocs.Annotation dla Java" -"url": "/pl/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: Dowiedz się, jak anotować PDF przy użyciu GroupDocs Annotation Library + Java – przewodnik krok po kroku, fragmenty kodu, wskazówki dotyczące wydajności + oraz najlepsze praktyki. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Dodaj adnotacje PDF w Javie +og_description: Dowiedz się, jak anotować PDF przy użyciu GroupDocs Annotation Library + Java – przewodnik obejmujący adnotacje eliptyczne, komentarze, licencjonowanie oraz + wskazówki dla programistów Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Jak anotować PDF przy użyciu GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: Jak anotować PDF przy użyciu GroupDocs Annotation Library Java type: docs -"weight": 1 +url: /pl/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Jak dodać adnotacje elipsy do pliku PDF za pomocą GroupDocs.Annotation dla języka Java +# Jak oznaczać PDF przy użyciu biblioteki GroupDocs Annotation Library Java -## Wstęp -Dodawanie adnotacji do plików PDF może znacznie usprawnić współpracę i komunikację, zwłaszcza w przypadku złożonych dokumentów. Jeśli chcesz programowo wyróżnić lub opatrzyć adnotacjami określone obszary w plikach PDF za pomocą języka Java, ten samouczek przeprowadzi Cię przez proces płynnego dodawania adnotacji elipsy. Wykorzystując moc GroupDocs.Annotation dla języka Java, programiści mogą łatwo włączać zaawansowane funkcje adnotacji do swoich aplikacji. +Dodawanie wizualnych notatek, komentarzy lub pieczęci do pliku PDF programowo może znacząco przyspieszyć cykle przeglądu, kontrole zgodności i współpracę zespołową. W tym samouczku odkryjesz **jak oznaczać PDF** przy użyciu biblioteki GroupDocs Annotation Library dla Javy, obejmując wszystko od konfiguracji projektu po zaawansowane adnotacje elips, licencjonowanie, optymalizację wydajności i praktyczne wskazówki integracyjne. -W tym samouczku omówimy: -- Jak skonfigurować i zintegrować GroupDocs.Annotation w projekcie Java. -- Instrukcje krok po kroku, jak dodać adnotację w postaci elipsy do dokumentu PDF. -- Praktyczne przykłady demonstrujące rzeczywiste przypadki użycia. +## Szybkie odpowiedzi +- **Jaką bibliotekę dodaje adnotacje do PDF w Javie?** GroupDocs Annotation Library for Java. +- **Czy potrzebna jest licencja?** Wersja próbna działa do testów; licencja produkcyjna jest wymagana do użytku komercyjnego. +- **Które IDE jest najlepsze?** Każde IDE Java (IntelliJ IDEA, Eclipse, VS Code) działa dobrze. +- **Czy mogę adnotować PDF zabezpieczone hasłem?** Tak — podaj hasło przy tworzeniu `Annotator`. +- **Czy obsługiwane jest przetwarzanie wsadowe?** Zdecydowanie; zobacz przykład przetwarzania wsadowego później. -Przyjrzyjmy się bliżej wymaganiom wstępnym, które musisz spełnić zanim zaczniesz! +## Co to jest GroupDocs Annotation Library Java? -## Wymagania wstępne -Aby skorzystać z tego samouczka, będziesz potrzebować: -- **Zestaw narzędzi programistycznych Java (JDK)**: Upewnij się, że masz zainstalowany JDK. Ten przykład używa Java 8 lub nowszej. -- **GroupDocs.Annotation dla biblioteki Java**:Będziemy korzystać z wersji 25.2 biblioteki. -- **Konfiguracja Maven**:Maven jest wymagany do łatwego zarządzania zależnościami. +GroupDocs Annotation Library Java to gotowe do użycia API, które umożliwia programistom tworzenie, edytowanie, pobieranie i usuwanie adnotacji PDF w całości w kodzie Java. Obsługuje **ponad 50 formatów dokumentów**, oferuje wbudowane wątki komentarzy oraz zapewnia szczegółowe kontrolki uprawnień. -Upewnij się, czy Twoje środowisko programistyczne obsługuje te wymagania i czy znasz podstawowe koncepcje programowania w Javie, w szczególności jeśli chodzi o pracę z bibliotekami i obsługę plików w Javie. +## Dlaczego warto używać GroupDocs Annotation Library Java? -## Konfigurowanie GroupDocs.Annotation dla Java -### Instalacja za pomocą Maven -Aby zintegrować GroupDocs.Annotation ze swoim projektem za pomocą Maven, dodaj następujące repozytorium i zależność do swojego `pom.xml` plik: +Możesz dodać bogate oznaczenia — w tym elipsy, notatki tekstowe, pieczęcie i znaki wodne — za pomocą kilku wywołań metod, a biblioteka przetwarza **PDF‑y wielostronicowe** bez ładowania całego pliku do pamięci. W porównaniu z niskopoziomowymi narzędziami takimi jak iText czy PDFBox, skraca czas programowania nawet o **70 %** i obsługuje złożone funkcje PDF (warstwy, formularze, podpisy cyfrowe) od razu. + +## Wymagania wstępne i konfiguracja +- **JDK 8+** (zalecany JDK 11) +- **Maven lub Gradle** do zarządzania zależnościami +- **IDE** według wyboru (IntelliJ IDEA, Eclipse, VS Code) +- Podstawowa znajomość Java I/O + +### Integracja z Maven + +Dodaj repozytorium i zależność do swojego `pom.xml`: ```xml @@ -48,31 +121,30 @@ Aby zintegrować GroupDocs.Annotation ze swoim projektem za pomocą Maven, dodaj ``` -### Nabycie licencji -Zanim zaczniesz, upewnij się, że masz licencję na GroupDocs.Annotation. Możesz uzyskać bezpłatną wersję próbną lub kupić pełną licencję na ich stronie internetowej. Zastosowanie licencji jest proste i zapewnia dostęp do wszystkich funkcji bez ograniczeń. +### Konfiguracja licencji -Oto jak ubiegać się o licencję: +Zastosuj licencję przed rozpoczęciem pracy z adnotacjami: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Przewodnik wdrażania -### Dodawanie adnotacji elipsy -Dodawanie adnotacji elipsy obejmuje inicjalizację biblioteki adnotacji, skonfigurowanie dokumentu i skonfigurowanie właściwości adnotacji. Oto, jak można to osiągnąć krok po kroku. +*Wskazówka:* Przechowuj plik licencji w `src/main/resources` i wczytuj go za pomocą `getClass().getResourceAsStream()` dla płynniejszych wdrożeń. + +## Kompletny przewodnik implementacji -#### Krok 1: Zainicjuj Adnotator z Dokumentem Wejściowym -Najpierw utwórz `Annotator` instancję, określając ścieżkę do pliku PDF: +### Krok 1: Inicjalizacja PDF Annotatora + +Klasa `Annotator` jest punktem wejścia dla wszystkich operacji adnotacji. Ładuje docelowy PDF, stosuje ustawienia zabezpieczeń i przygotowuje reprezentację w pamięci do edycji. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Inicjuje to środowisko dodawania adnotacji. +### Krok 2: Tworzenie interaktywnych komentarzy i odpowiedzi -#### Krok 2: Tworzenie i konfiguracja odpowiedzi -Adnotacje mogą zawierać odpowiedzi lub komentarze. Oto jak skonfigurować odpowiedzi: +`CommentAnnotation` pozwala osadzać tekst dowolnej formy, a obiekty `Reply` umożliwiają wątkowane dyskusje bezpośrednio na stronie PDF. ```java Reply reply1 = new Reply(); @@ -88,83 +160,235 @@ replies.add(reply1); replies.add(reply2); ``` -Odpowiedzi te zostaną dołączone do adnotacji elipsy. +### Krok 3: Konfiguracja adnotacji elipsy -#### Krok 3: Utwórz i skonfiguruj adnotację elipsy -Teraz utwórz `EllipseAnnotation` obiekt i skonfiguruj jego właściwości: +`EllipseAnnotation` rysuje skalowalny kształt owalu. Możesz ustawić kolor linii, kolor wypełnienia, przezroczystość i własną grubość obramowania, aby dopasować do wytycznych UI. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Żółty kolor tła -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Definiuje pozycję i rozmiar +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // Numer strony docelowej dla adnotacji -ellipse.setPenColor(65535); // Kolor pióra w formacie RGB -ellipse.setPenStyle(PenStyle.DOT); // Długopis w stylu kropki -ellipse.setPenWidth((byte) 3); // Szerokość pióra +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Ta konfiguracja definiuje wygląd i metadane Twojej adnotacji elipsy. +### Krok 4: Dodawanie i zapisywanie adnotacji -#### Krok 4: Dodaj adnotację do dokumentu -Dodaj skonfigurowaną adnotację elipsy do swojego dokumentu za pomocą: +Po skonfigurowaniu wszystkich obiektów adnotacji wywołaj `annotator.save()`, aby zapisać zmiany na dysku. Pamiętaj, aby wywołać `dispose()`, aby zwolnić zasoby natywne, szczególnie przy przetwarzaniu wielu plików w pętli. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); +``` + +> **Dlaczego wywoływać `dispose()`?** Zwalnia zasoby natywne, zapobiegając wyciekom pamięci — szczególnie ważne przy przetwarzaniu wielu PDF‑ów w pętli. + +## Typowe problemy i rozwiązania + +### Problem 1 – „Dokument nie znaleziony” + +*Przyczyna:* Nieprawidłowa ścieżka pliku lub katalog roboczy. +*Rozwiązanie:* Zweryfikuj ścieżkę bezwzględną lub wydrukuj `System.getProperty("user.dir")`, aby potwierdzić katalog bazowy. + +### Problem 2 – Adnotacje niewidoczne + +*Przyczyna:* Nieprawidłowy system współrzędnych lub indeks strony. +*Rozwiązanie:* Pamiętaj, że współrzędne PDF zaczynają się od lewego dolnego rogu, a strony są indeksowane od zera. + +### Problem 3 – OutOfMemoryError przy dużych PDF‑ach + +*Przyczyna:* Cały dokument został załadowany do pamięci. +*Rozwiązanie:* Zwiększ przydział pamięci JVM (`-Xmx2g`) lub przetwarzaj strony w partiach (zobacz przykład przetwarzania wsadowego poniżej). + +### Problem 4 – Błędy walidacji licencji + +*Przyczyna:* Brak pliku licencji lub niezgodny plik. +*Rozwiązanie:* Sprawdź ponownie ścieżkę pliku i upewnij się, że wersja licencji odpowiada wersji biblioteki. + +## Wskazówki optymalizacji wydajności + +### Najlepsze praktyki zarządzania pamięcią + +Unikaj utrzymywania referencji do dużych instancji `Annotator` dłużej niż to konieczne. Używaj try‑with‑resources lub wywołań `dispose()` po przetworzeniu każdego pliku. + +```java +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -#### Krok 5: Zapisz i usuń zasoby -Na koniec zapisz dokument z adnotacjami i udostępnij zasoby: +### Strategie przetwarzania wsadowego + +- **Małe PDF‑y (<10 MB):** Przetwarzaj indywidualnie. +- **Średnie PDF‑y (10‑50 MB):** Przetwarzaj w partiach po 5‑10. +- **Duże PDF‑y (>50 MB):** Użyj strumieniowania lub przetwarzania w kawałkach, aby uniknąć OOM. + +### Rozważania dotyczące buforowania + +Klasa `AnnotationAppearance` kapsułkuje właściwości wizualne, takie jak kolor i przezroczystość adnotacji. Buforuj wielokrotnie używane obiekty, takie jak `AnnotationAppearance` lub instancje `Color`, gdy adnotujesz wiele stron o identycznym stylu. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} +``` + +## Przykłady integracji w rzeczywistych zastosowaniach + +### Integracja aplikacji webowej + +Udostępnij endpoint REST, który przyjmuje strumień PDF, nakłada adnotację elipsy w współrzędnych podanych przez front‑end i zwraca oznaczony PDF jako tablicę bajtów. + +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` + +### Przetwarzanie dokumentów wsadowo + +Iteruj po katalogu umów, dodaj pieczęć „Reviewed” do każdej i przenieś przetworzone pliki do folderu archiwum. + +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` + +## Zaawansowane techniki adnotacji + +### Dynamiczne pozycjonowanie adnotacji + +Oblicz współrzędne adnotacji w locie na podstawie wykrytych lokalizacji tekstu przy użyciu OCR lub API do ekstrakcji tekstu PDF, a następnie umieść elipsy wokół słów kluczowych. + +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Warunkowe stylowanie adnotacji + +Zastosuj różne kolory lub poziomy przezroczystości w zależności od roli autora adnotacji (np. recenzent = niebieski, zatwierdzający = zielony). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); ``` -## Zastosowania praktyczne -- **Narzędzia edukacyjne**:Podświetlanie kluczowych pojęć w podręcznikach PDF. -- **Dokumenty prawne**:Adnotacje do sekcji w celu ich przejrzenia lub zatwierdzenia. -- **Dokumentacja medyczna**:Zaznaczanie ważnych obserwacji lub notatek. +## Praktyczne zastosowania i przypadki użycia + +- **Platformy edukacyjne:** Podświetlaj koncepcje, dodawaj komentarze nauczyciela, twórz interaktywne przewodniki nauki. +- **Przegląd dokumentów prawnych:** Oznaczaj klauzule, dodawaj poufne notatki, utrzymuj ścieżki audytu. +- **Rekordy medyczne:** Adnotuj obserwacje, podkreślaj krytyczne dane, umożliwiaj bezpieczną współpracę. +- **Procesy korporacyjne:** Usprawnij zatwierdzanie raportów, dodawaj pieczęcie recenzentów, śledź zmiany. + +## Kiedy używać różnych typów adnotacji + +Adnotacje elipsy są idealne, gdy potrzebujesz nie‑prostokątnego podświetlenia, takiego jak podkreślenie diagramów okrągłych, logotypów lub obszarów lepiej reprezentowanych przez owalny kształt. Dostarczają wyraźną wskazówkę wizualną przy zachowaniu czytelności, co czyni je odpowiednimi do przeglądów projektów, kontroli brandingu i wszelkich scenariuszy, w których preferowane jest okrągłe podkreślenie. + +Choć ten przewodnik koncentruje się na adnotacjach elipsy, GroupDocs Annotation Library Java oferuje również: +- **Adnotacje tekstowe** do szczegółowych komentarzy. +- **Adnotacje strzałek** wskazujące konkretne elementy. +- **Adnotacje prostokątne** do podświetlania obszarów. +- **Adnotacje znaków wodnych** do brandingu lub zabezpieczeń. +- **Adnotacje pieczęci** do zatwierdzeń. + +## Przewodnik rozwiązywania problemów + +### Problemy z wydajnością -GroupDocs.Annotation można zintegrować z systemami zarządzania dokumentami, rozszerzając ich możliwości adnotacji. +- **Objaw:** Wolne przetwarzanie. +- **Diagnoza:** Duży rozmiar pliku, wiele adnotacji, ograniczona pamięć RAM. +- **Rozwiązanie:** Optymalizuj właściwości adnotacji, przetwarzaj asynchronicznie lub paginuj duże PDF‑y. -## Rozważania dotyczące wydajności -Aby uzyskać optymalną wydajność: -- **Zarządzanie pamięcią**:Monitoruj i zarządzaj wykorzystaniem pamięci podczas obsługi dużych dokumentów. -- **Przetwarzanie wsadowe**:Jeśli dodajesz adnotacje do wielu plików PDF, rozważ ich przetwarzanie w partiach, aby zoptymalizować wykorzystanie zasobów. +### Problemy kompatybilności -Praktyki te zapewniają efektywne działanie aplikacji Java korzystającej z GroupDocs.Annotation. +- **Objaw:** Adnotacje wyglądają inaczej w różnych przeglądarkach. +- **Diagnoza:** Niestandardowe funkcje PDF. +- **Rozwiązanie:** Testuj w Adobe Acrobat, Chrome i Firefox; trzymaj się standardowych flag adnotacji PDF. -## Wniosek -Postępując zgodnie z tym samouczkiem, nauczyłeś się, jak dodawać adnotacje elipsy do plików PDF za pomocą GroupDocs.Annotation dla Java. Ta funkcja jest nieoceniona w przypadku aplikacji wymagających szczegółowych przeglądów dokumentów i edycji grupowej. +### Wyzwania integracyjne -Aby jeszcze bardziej rozwinąć swoje umiejętności, zapoznaj się z dodatkowymi typami adnotacji dostępnymi w bibliotece GroupDocs lub zintegruj tę funkcjonalność z większym projektem. +- **Objaw:** Konflikty zależności. +- **Diagnoza:** Niezgodności wersji z innymi bibliotekami. +- **Rozwiązanie:** Użyj `` w Mavenie, aby wymusić zgodne wersje, lub przejdź na REST API dla integracji niezależnej od języka. -## Sekcja FAQ -**P: Czy mogę za pomocą GroupDocs.Annotation dodawać adnotacje do innych typów dokumentów?** -O: Tak, GroupDocs obsługuje adnotacje w różnych formatach dokumentów innych niż PDF, w tym w plikach Word i Excel. +## Najczęściej zadawane pytania -**P: Jak mogę dynamicznie zmieniać kolor adnotacji w zależności od treści?** -A: Można programowo ustawić `penColor` właściwość na podstawie logiki przed dodaniem adnotacji. +**Q: Czy mogę dodawać adnotacje do PDF zabezpieczonych hasłem?** +A: Tak. Użyj przeciążenia `new Annotator(filePath, loadOptions)`, gdzie `loadOptions` zawiera hasło. -**P: Jaka jest maksymalna liczba obsługiwanych adnotacji?** -A: GroupDocs.Annotation pozwala na dużą liczbę adnotacji, ale zaleca się przetestowanie wydajności przy konkretnych rozmiarach i typach dokumentów. +**Q: Jak postępować z PDF‑ami większymi niż 100 MB?** +A: Przetwarzaj strony indywidualnie, zwiększ rozmiar stosu, lub skorzystaj z GroupDocs Annotation Cloud API przy dużych obciążeniach. + +**Q: Czy istnieje limit liczby adnotacji na dokument?** +A: Nie ma sztywnego limitu, ale wydajność może spadać po tysiącach adnotacji. Rozważ paginację lub grupowanie. + +**Q: Czy mogę wyodrębnić istniejące adnotacje?** +A: Oczywiście. Wywołaj `annotator.get()`, aby pobrać wszystkie adnotacje z PDF‑a. + +**Q: Jak zabezpieczyć adnotacje, aby tylko określone osoby mogły je edytować?** +A: Biblioteka oferuje ustawienia uprawnień oparte na użytkownikach; skonfiguruj je za pomocą API `AnnotationPermission`. + +## Podsumowanie + +**GroupDocs Annotation Library Java** zapewnia czysty, wysokowydajny sposób na osadzanie bogatych adnotacji PDF bezpośrednio z kodu Java. Postępując zgodnie z powyższymi krokami, możesz dodawać adnotacje elipsy, zarządzać komentarzami i skalować rozwiązanie do obciążeń na poziomie przedsiębiorstwa. + +**Kolejne kroki:** +1. Eksperymentuj z innymi typami adnotacji (tekst, pieczęć, znak wodny). +2. Zintegruj bibliotekę z istniejącym przepływem dokumentów lub usługą webową. +3. Poznaj REST API dla scenariuszy niezależnych od języka. + +--- -**P: Jak poradzić sobie z nakładającymi się adnotacjami?** -A: Dostosuj `box` wymiary i pozycje, aby zarządzać nakładaniem się lub nakładać wiele adnotacji, jeśli to konieczne. +**Ostatnia aktualizacja:** 2026-07-25 +**Testowano z:** GroupDocs.Annotation 25.2 for Java +**Autor:** GroupDocs -**P: Jakie są najlepsze praktyki korzystania z GroupDocs.Annotation w aplikacji internetowej?** -A: Wykorzystaj asynchroniczne przetwarzanie obszernych dokumentów, zapewnij bezpieczne przechowywanie plików z adnotacjami i zapewnij przyjazne dla użytkownika interfejsy do interakcji z adnotacjami. +**Podstawowe linki:** +- **Dokumentacja:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **Referencja API:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Pobierz:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Kup licencję:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Rozpocznij bezpłatny okres próbny:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **Poproś o tymczasową licencję:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **Forum wsparcia:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) -## Zasoby -- **Dokumentacja**: [Dokumentacja GroupDocs Annotation Java](https://docs.groupdocs.com/annotation/java/) -- **Odniesienie do API**: [Odwołanie do API GroupDocs](https://reference.groupdocs.com/annotation/java/) -- **Pobierać**: [Pobierz GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Zakup**: [Kup licencję GroupDocs](https://purchase.groupdocs.com/buy) -- **Bezpłatna wersja próbna**: [Rozpocznij bezpłatny okres próbny](https://releases.groupdocs.com/annotation/java/) -- **Licencja tymczasowa**: [Poproś o licencję tymczasową](https://purchase.groupdocs.com/temporary-license/) -- **Wsparcie**: [Forum wsparcia GroupDocs](https://forum.groupdocs.com/c/annotation/) +## Powiązane samouczki -Ten kompleksowy przewodnik powinien wyposażyć Cię w wiedzę, aby skutecznie dodawać adnotacje elipsy w aplikacjach Java przy użyciu GroupDocs.Annotation. Miłego kodowania! \ No newline at end of file +- [Jak dodać strzałkę do PDF w Javie – Kompletny samouczek i najlepsze praktyki](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Jak dodać obraz do PDF przy użyciu Javy i GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Kompletny przewodnik – Jak zapisać oznaczony PDF z GroupDocs.Annotation dla Javy](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/portuguese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/portuguese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 4e8859448..b4b2ea30e 100644 --- a/content/portuguese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/portuguese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,105 @@ --- -"date": "2025-05-06" -"description": "Aprenda a adicionar anotações de elipse a documentos PDF usando a poderosa biblioteca GroupDocs.Annotation em Java. Siga este guia passo a passo para aprimorar a colaboração em documentos." -"title": "Java - Adicionar anotações de elipse a PDFs usando GroupDocs.Annotation para Java" -"url": "/pt/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: Aprenda como anotar PDF com GroupDocs Annotation Library Java – step‑by‑step + guide, code snippets, performance tips e best practices. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Adicionar Anotações PDF em Java +og_description: Aprenda como anotar PDF com GroupDocs Annotation Library Java – um + guia que cobre ellipse annotations, comments, licensing e tips for Java developers. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Como Anotar PDF com GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: Como Anotar PDF com GroupDocs Annotation Library Java type: docs -"weight": 1 +url: /pt/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Como adicionar anotações de elipse a um PDF usando GroupDocs.Annotation para Java +# Como Anotar PDF com a Biblioteca GroupDocs Annotation Java -## Introdução -Adicionar anotações a PDFs pode melhorar significativamente a colaboração e a comunicação, especialmente ao lidar com documentos complexos. Se você deseja destacar ou anotar áreas específicas em seus PDFs programaticamente usando Java, este tutorial o guiará pelo processo de adição de anotações de elipse sem complicações. Aproveitando o poder do GroupDocs.Annotation para Java, os desenvolvedores podem incorporar facilmente recursos sofisticados de anotação em seus aplicativos. +Adicionar notas visuais, comentários ou carimbos a um PDF programaticamente pode acelerar drasticamente os ciclos de revisão, verificações de conformidade e fluxos de trabalho colaborativos. Neste tutorial você descobrirá **como anotar PDF** usando a GroupDocs Annotation Library para Java, cobrindo tudo, desde a configuração do projeto até anotações avançadas de elipse, licenciamento, otimização de desempenho e dicas de integração no mundo real. -Neste tutorial, abordaremos: -- Como configurar e integrar GroupDocs.Annotation em um projeto Java. -- Instruções passo a passo sobre como adicionar uma anotação de elipse a um documento PDF. -- Exemplos práticos demonstrando casos de uso do mundo real. +## Respostas Rápidas +- **Qual biblioteca adiciona anotações a PDFs em Java?** A GroupDocs Annotation Library para Java. +- **Preciso de uma licença?** Uma versão de avaliação funciona para testes; uma licença de produção é necessária para uso comercial. +- **Qual IDE funciona melhor?** Qualquer IDE Java (IntelliJ IDEA, Eclipse, VS Code) funciona bem. +- **Posso anotar PDFs protegidos por senha?** Sim—forneça a senha ao criar o `Annotator`. +- **O processamento em lote é suportado?** Absolutamente; veja o exemplo de processamento em lote mais adiante. -Vamos analisar os pré-requisitos necessários antes de começar! +## O que é a GroupDocs Annotation Library Java? -## Pré-requisitos -Para acompanhar este tutorial, você precisará: -- **Kit de Desenvolvimento Java (JDK)**: Certifique-se de ter o JDK instalado. Este exemplo usa Java 8 ou superior. -- **GroupDocs.Annotation para biblioteca Java**: Usaremos a versão 25.2 da biblioteca. -- **Configuração do Maven**: O Maven é necessário para gerenciar dependências facilmente. +A GroupDocs Annotation Library Java é uma API pronta‑para‑uso que permite aos desenvolvedores criar, editar, recuperar e excluir anotações de PDF totalmente em código Java. Ela suporta **mais de 50 formatos de documento**, oferece threads de comentários integrados e fornece controles de permissão granulares. -Certifique-se de que seu ambiente de desenvolvimento suporta esses requisitos e que você está confortável com os conceitos básicos de programação Java, especialmente trabalhando com bibliotecas e manipulando arquivos em Java. +## Por que usar a GroupDocs Annotation Library Java? -## Configurando GroupDocs.Annotation para Java -### Instalação via Maven -Para integrar GroupDocs.Annotation em seu projeto usando Maven, adicione o seguinte repositório e dependência ao seu `pom.xml` arquivo: +Você pode adicionar marcações avançadas—incluindo elipses, notas de texto, carimbos e marcas d'água—com apenas algumas chamadas de método, e a biblioteca processa **PDFs com centenas de páginas** sem carregar o arquivo inteiro na memória. Comparada com ferramentas de baixo nível como iText ou PDFBox, ela reduz o tempo de desenvolvimento em até **70 %** e lida com recursos complexos de PDF (camadas, formulários, assinaturas digitais) pronto‑para‑uso. + +## Pré‑requisitos e Configuração +- **JDK 8+** (JDK 11 recomendado) +- **Maven ou Gradle** para gerenciamento de dependências +- **IDE** de sua escolha (IntelliJ IDEA, Eclipse, VS Code) +- Familiaridade básica com I/O de arquivos Java + +### Integração Maven +Adicione o repositório e a dependência ao seu `pom.xml`: ```xml @@ -48,31 +118,27 @@ Para integrar GroupDocs.Annotation em seu projeto usando Maven, adicione o segui ``` -### Aquisição de Licença -Antes de começar, certifique-se de adquirir uma licença para o GroupDocs.Annotation. Você pode obter uma avaliação gratuita ou comprar uma licença completa no site. A solicitação da licença é simples e garante acesso a todos os recursos sem restrições. - -Veja como solicitar sua licença: +### Configuração de Licença +Aplique sua licença antes de qualquer trabalho de anotação: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Guia de Implementação -### Adicionando uma anotação de elipse -Adicionar anotações de elipse envolve inicializar a biblioteca de anotações, configurar o documento e configurar as propriedades da anotação. Veja como fazer isso passo a passo. +*Dica profissional:* Armazene o arquivo de licença em `src/main/resources` e carregue-o com `getClass().getResourceAsStream()` para implantações mais suaves. + +## Guia de Implementação Completa -#### Etapa 1: Inicializar o Annotator com o Documento de Entrada -Primeiro, crie um `Annotator` instância especificando o caminho para seu arquivo PDF: +### Etapa 1: Inicializar o PDF Annotator +A classe `Annotator` é o ponto de entrada para todas as operações de anotação. Ela carrega o PDF alvo, aplica configurações de segurança e prepara uma representação em memória para edição. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Isso inicializa o ambiente para adicionar anotações. - -#### Etapa 2: Criar e configurar respostas -As anotações podem incluir respostas ou comentários. Veja como configurar respostas: +### Etapa 2: Criar Comentários Interativos e Respostas +`CommentAnnotation` permite incorporar texto livre, enquanto objetos `Reply` habilitam discussões em thread diretamente na página do PDF. ```java Reply reply1 = new Reply(); @@ -88,83 +154,217 @@ replies.add(reply1); replies.add(reply2); ``` -Essas respostas serão anexadas à anotação da elipse. - -#### Etapa 3: Criar e configurar a anotação Ellipse -Agora, crie um `EllipseAnnotation` objeto e configurar suas propriedades: +### Etapa 3: Configurar sua Anotação de Elipse +`EllipseAnnotation` desenha uma forma oval escalável. Você pode definir a cor da linha, cor de preenchimento, opacidade e espessura de borda personalizada para corresponder às diretrizes da sua UI. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Cor de fundo amarela -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Define posição e tamanho +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // Número da página de destino da anotação -ellipse.setPenColor(65535); // Cor da caneta em formato RGB -ellipse.setPenStyle(PenStyle.DOT); // Caneta estilo ponto -ellipse.setPenWidth((byte) 3); // Largura da caneta +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Esta configuração define a aparência e os metadados da sua anotação de elipse. - -#### Etapa 4: Adicionar anotação ao documento -Adicione a anotação de elipse configurada ao seu documento usando: +### Etapa 4: Adicionar e Salvar suas Anotações +Após configurar todos os objetos de anotação, invoque `annotator.save()` para gravar as alterações no disco. Lembre‑se de chamar `dispose()` para liberar recursos nativos, especialmente ao processar muitos arquivos em um loop. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); +``` + +> **Por que chamar `dispose()`?** Ele libera recursos nativos, prevenindo vazamentos de memória—especialmente importante ao processar muitos PDFs em um loop. + +## Problemas Comuns e Soluções + +### Problema 1 – “Documento Não Encontrado” +*Causa:* Caminho de arquivo incorreto ou diretório de trabalho. +*Correção:* Verifique o caminho absoluto ou imprima `System.getProperty("user.dir")` para confirmar o diretório base. + +### Problema 2 – Anotações Não Visíveis +*Causa:* Sistema de coordenadas ou índice de página incorreto. +*Correção:* Lembre‑se de que as coordenadas do PDF começam no canto inferior esquerdo, e as páginas são indexadas a partir de zero. + +### Problema 3 – OutOfMemoryError em PDFs Grandes +*Causa:* Documento inteiro carregado na memória. +*Correção:* Aumente o heap da JVM (`-Xmx2g`) ou processe páginas em lotes (veja o exemplo de lote abaixo). + +### Problema 4 – Erros de Validação de Licença +*Causa:* Arquivo de licença ausente ou incompatível. +*Correção:* Verifique novamente o caminho do arquivo e assegure que a versão da licença corresponde à versão da biblioteca. + +## Dicas de Otimização de Desempenho + +### Melhores Práticas de Gerenciamento de Memória +Evite manter referências a instâncias grandes de `Annotator` por mais tempo do que o necessário. Use try‑with‑resources ou chamadas explícitas de `dispose()` após cada arquivo ser processado. + +```java +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -#### Etapa 5: salvar e descartar recursos -Por fim, salve o documento anotado e libere os recursos: +### Estratégias de Processamento em Lote +- **PDFs pequenos (<10 MB):** Processar individualmente. +- **PDFs médios (10‑50 MB):** Processar em lotes de 5‑10. +- **PDFs grandes (>50 MB):** Use streaming ou processamento em blocos para evitar OOM. + +### Considerações de Cache +A classe `AnnotationAppearance` encapsula propriedades visuais como cor e opacidade para anotações. Faça cache de objetos reutilizáveis como instâncias de `AnnotationAppearance` ou `Color` quando você anotar muitas páginas com o mesmo estilo. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} ``` -## Aplicações práticas -- **Ferramentas educacionais**: Destacando conceitos-chave em livros didáticos em PDF. -- **Documentos Legais**: Anotando seções para revisão ou aprovação. -- **Registros médicos**: Marcar observações ou notas importantes. +## Exemplos de Integração no Mundo Real -O GroupDocs.Annotation pode ser integrado a sistemas de gerenciamento de documentos, aprimorando seus recursos de anotação. +### Integração de Aplicação Web +Exponha um endpoint REST que aceita um fluxo de PDF, aplica uma anotação de elipse nas coordenadas fornecidas pelo front‑end e retorna o PDF anotado como um array de bytes. -## Considerações de desempenho -Para um desempenho ideal: -- **Gerenciamento de memória**Monitore e gerencie o uso de memória ao lidar com documentos grandes. -- **Processamento em lote**: Se estiver anotando vários PDFs, considere processá-los em lotes para otimizar o uso de recursos. +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` -Essas práticas garantem a operação eficiente do seu aplicativo Java usando GroupDocs.Annotation. +### Processamento de Documentos em Lote +Itere sobre um diretório de contratos, adicione um carimbo “Reviewed” a cada um e mova os arquivos processados para uma pasta de arquivo. -## Conclusão -Seguindo este tutorial, você aprendeu a adicionar anotações de elipse a PDFs usando o GroupDocs.Annotation para Java. Este recurso é essencial para aplicativos que exigem revisão detalhada de documentos e edição colaborativa. +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` + +## Técnicas Avançadas de Anotação + +### Posicionamento Dinâmico de Anotações +Calcule as coordenadas da anotação em tempo real com base nas localizações de texto detectadas usando OCR ou APIs de extração de texto PDF, então coloque elipses ao redor das palavras‑chave. + +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Estilização Condicional de Anotações +Aplique cores ou níveis de opacidade diferentes dependendo do papel do autor da anotação (ex.: revisor = azul, aprovador = verde). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` + +## Aplicações Práticas e Casos de Uso +- **Plataformas educacionais:** Destacar conceitos, adicionar comentários de professores, criar guias de estudo interativos. +- **Revisão de documentos legais:** Marcar cláusulas, adicionar notas confidenciais, manter trilhas de auditoria. +- **Registros médicos:** Anotar observações, destacar dados críticos, permitir colaboração segura. +- **Fluxos de trabalho corporativos:** Simplificar aprovações de relatórios, adicionar carimbos de revisores, rastrear alterações. + +## Quando Usar Diferentes Tipos de Anotação -Para aprimorar ainda mais suas habilidades, explore tipos adicionais de anotações disponíveis na biblioteca do GroupDocs ou integre a funcionalidade a um projeto maior. +Anotações de elipse são ideais quando você precisa de um destaque não retangular, como enfatizar diagramas circulares, logotipos ou áreas que são melhor representadas por uma forma oval. Elas fornecem um indicativo visual claro enquanto preservam a legibilidade, tornando‑as adequadas para revisões de design, verificações de branding e qualquer cenário onde um destaque arredondado seja preferido. -## Seção de perguntas frequentes -**P: Posso anotar outros tipos de documentos com o GroupDocs.Annotation?** -R: Sim, o GroupDocs suporta anotações em vários formatos de documentos além de PDFs, incluindo arquivos do Word e Excel. +Embora este guia se concentre em anotações de elipse, a GroupDocs Annotation Library Java também oferece: +- **Anotações de texto** para comentários detalhados. +- **Anotações de seta** para apontar a elementos específicos. +- **Anotações de retângulo** para destaque de áreas. +- **Anotações de marca d'água** para branding ou segurança. +- **Anotações de carimbo** para aprovações. -**P: Como posso alterar a cor da anotação dinamicamente com base no conteúdo?** -R: Você pode definir programaticamente o `penColor` propriedade com base na sua lógica antes de adicionar a anotação. +## Guia de Solução de Problemas -**P: Qual é o número máximo de anotações suportadas?** -R: O GroupDocs.Annotation permite um grande número de anotações, mas é aconselhável testar o desempenho com seus tamanhos e tipos de documentos específicos. +### Problemas de Desempenho +- **Sintoma:** Processamento lento. +- **Diagnóstico:** Tamanho grande de arquivo, muitas anotações, RAM limitada. +- **Solução:** Otimize propriedades de anotação, processe assincronamente ou pagine PDFs grandes. + +### Problemas de Compatibilidade +- **Sintoma:** Anotações parecem diferentes em visualizadores. +- **Diagnóstico:** Recursos PDF não‑padrão. +- **Solução:** Teste com Adobe Acrobat, Chrome e Firefox; mantenha-se nos flags de anotação padrão do PDF. + +### Desafios de Integração +- **Sintoma:** Conflitos de dependência. +- **Diagnóstico:** Incompatibilidade de versões com outras bibliotecas. +- **Solução:** Use `` do Maven para impor versões compatíveis ou troque para a API REST para integração agnóstica de linguagem. + +## Perguntas Frequentes + +**Q: Posso adicionar anotações a PDFs protegidos por senha?** +A: Sim. Use a sobrecarga `new Annotator(filePath, loadOptions)` onde `loadOptions` inclui a senha. + +**Q: Como devo lidar com PDFs maiores que 100 MB?** +A: Processar páginas individualmente, aumentar o tamanho do heap ou usar a GroupDocs Annotation Cloud API para cargas pesadas. + +**Q: Existe um limite para o número de anotações por documento?** +A: Não há limite rígido, mas o desempenho pode degradar após milhares de anotações. Considere paginação ou agrupamento. + +**Q: Posso extrair anotações existentes?** +A: Absolutamente. Chame `annotator.get()` para recuperar todas as anotações de um PDF. + +**Q: Como protejo as anotações para que apenas certos usuários possam editá‑las?** +A: A biblioteca fornece configurações de permissão baseadas em usuário; configure‑as via a API `AnnotationPermission`. + +## Conclusão +A **GroupDocs Annotation Library Java** oferece uma maneira limpa e de alto desempenho para incorporar anotações PDF avançadas diretamente a partir do código Java. Seguindo os passos acima, você pode adicionar anotações de elipse, gerenciar comentários e escalar para cargas de trabalho em nível empresarial. + +**Próximos passos:** +1. Experimente outros tipos de anotação (texto, carimbo, marca d'água). +2. Integre a biblioteca ao seu fluxo de trabalho de documentos existente ou serviço web. +3. Explore a API REST para cenários agnósticos de linguagem. + +--- -**P: Como lidar com anotações sobrepostas?** -A: Ajuste o `box` dimensões e posições para gerenciar sobreposições ou criar camadas de múltiplas anotações, conforme necessário. +**Última atualização:** 2026-07-25 +**Testado com:** GroupDocs.Annotation 25.2 for Java +**Autor:** GroupDocs -**P: Quais são algumas práticas recomendadas para usar GroupDocs.Annotation em um aplicativo web?** -R: Utilize processamento assíncrono para documentos grandes, garanta o armazenamento seguro de arquivos anotados e forneça interfaces fáceis de usar para interações de anotação. +**Links Essenciais:** +- **Documentação:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **Referência da API:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Compra:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Teste Gratuito:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **Licença Temporária:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **Suporte:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) -## Recursos -- **Documentação**: [Documentação Java de Anotação do GroupDocs](https://docs.groupdocs.com/annotation/java/) -- **Referência de API**: [Referência da API do GroupDocs](https://reference.groupdocs.com/annotation/java/) -- **Download**: [Baixar GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Comprar**: [Comprar licença do GroupDocs](https://purchase.groupdocs.com/buy) -- **Teste grátis**: [Comece um teste gratuito](https://releases.groupdocs.com/annotation/java/) -- **Licença Temporária**: [Solicitar uma Licença Temporária](https://purchase.groupdocs.com/temporary-license/) -- **Apoiar**: [Fórum de Suporte do GroupDocs](https://forum.groupdocs.com/c/annotation/) +## Tutoriais Relacionados -Este guia completo deve fornecer a você o conhecimento necessário para adicionar anotações de elipse com eficiência em seus aplicativos Java usando GroupDocs.Annotation. Boa programação! \ No newline at end of file +- [Como adicionar seta ao PDF com Java – Tutorial Completo e Melhores Práticas](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Como adicionar imagem ao PDF usando Java e GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Guia Completo - Como Salvar PDF Anotado com GroupDocs.Annotation para Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/russian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/russian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 3e6fbc82e..7213c820d 100644 --- a/content/russian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/russian/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,107 @@ --- -"date": "2025-05-06" -"description": "Узнайте, как добавлять аннотации с эллипсом в документы PDF с помощью мощной библиотеки GroupDocs.Annotation в Java. Следуйте этому пошаговому руководству, чтобы улучшить совместную работу с документами." -"title": "Java: Добавление аннотаций Ellipse в PDF-файлы с помощью GroupDocs.Annotation для Java" -"url": "/ru/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: Узнайте, как аннотировать PDF с помощью GroupDocs Annotation Library + Java – пошаговое руководство, примеры кода, советы по производительности и лучшие + практики. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Добавление аннотаций PDF в Java +og_description: Узнайте, как аннотировать PDF с помощью GroupDocs Annotation Library + Java – руководство, охватывающее ellipse annotations, comments, licensing и советы + для Java developers. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Как аннотировать PDF с помощью GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: Как аннотировать PDF с помощью GroupDocs Annotation Library Java type: docs -"weight": 1 +url: /ru/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Как добавить аннотации в виде эллипса в PDF-файл с помощью GroupDocs.Annotation для Java +# Как аннотировать PDF с помощью библиотеки GroupDocs Annotation для Java -## Введение -Добавление аннотаций в PDF-файлы может значительно улучшить совместную работу и коммуникацию, особенно при работе со сложными документами. Если вы хотите выделить или аннотировать определенные области в ваших PDF-файлах программным способом с помощью Java, это руководство проведет вас через процесс добавления аннотаций с многоточием без проблем. Используя возможности GroupDocs.Annotation для Java, разработчики могут легко включать сложные функции аннотаций в свои приложения. +Добавление визуальных заметок, комментариев или штампов в PDF программно может значительно ускорить циклы рецензирования, проверки соответствия и совместные рабочие процессы. В этом руководстве вы узнаете **как аннотировать PDF** файлы с помощью GroupDocs Annotation Library для Java, охватывая всё от настройки проекта до продвинутых эллипсных аннотаций, лицензирования, оптимизации производительности и практических советов по интеграции. -В этом уроке мы рассмотрим: -- Как настроить и интегрировать GroupDocs.Annotation в проект Java. -- Пошаговые инструкции по добавлению аннотации в виде эллипса в PDF-документ. -- Практические примеры, демонстрирующие реальные варианты использования. +## Быстрые ответы +- **Что за библиотека добавляет аннотации в PDF на Java?** GroupDocs Annotation Library for Java. +- **Нужна ли лицензия?** Пробная версия подходит для тестирования; для коммерческого использования требуется производственная лицензия. +- **Какая IDE лучше всего подходит?** Любая Java IDE (IntelliJ IDEA, Eclipse, VS Code) подходит. +- **Можно ли аннотировать PDF, защищённые паролем?** Да — укажите пароль при создании `Annotator`. +- **Поддерживается ли пакетная обработка?** Абсолютно; см. пример пакетной обработки ниже. -Давайте рассмотрим необходимые предварительные условия, прежде чем начать! +## Что такое GroupDocs Annotation Library Java? -## Предпосылки -Для прохождения этого урока вам понадобится: -- **Комплект разработчика Java (JDK)**: Убедитесь, что у вас установлен JDK. В этом примере используется Java 8 или выше. -- **GroupDocs.Аннотация для библиотеки Java**: Мы будем использовать версию библиотеки 25.2. -- **Настройка Maven**: Maven необходим для простого управления зависимостями. +GroupDocs Annotation Library Java — это готовый к использованию API, позволяющий разработчикам создавать, редактировать, получать и удалять PDF‑аннотации полностью на Java. Он поддерживает **более 50 форматов документов**, предлагает встроенные ветки комментариев и предоставляет детализированные настройки прав доступа. -Убедитесь, что ваша среда разработки поддерживает эти требования и что вы знакомы с основными концепциями программирования на Java, особенно с работой с библиотеками и обработкой файлов в Java. +## Почему использовать GroupDocs Annotation Library Java? -## Настройка GroupDocs.Annotation для Java -### Установка через Maven -Чтобы интегрировать GroupDocs.Annotation в ваш проект с помощью Maven, добавьте следующий репозиторий и зависимость в ваш проект `pom.xml` файл: +Вы можете добавить богатую разметку — включая эллипсы, текстовые заметки, штампы и водяные знаки — всего несколькими вызовами методов, а библиотека обрабатывает **многосотстраничные PDF** без загрузки всего файла в память. По сравнению с низкоуровневыми инструментами вроде iText или PDFBox, она сокращает время разработки до **70 %** и поддерживает сложные функции PDF (слои, формы, цифровые подписи) «из коробки». + +## Предварительные требования и настройка +- **JDK 8+** (рекомендован JDK 11) +- **Maven или Gradle** для управления зависимостями +- **IDE** по вашему выбору (IntelliJ IDEA, Eclipse, VS Code) +- Базовое знакомство с вводом‑выводом файлов в Java + +### Интеграция Maven +Добавьте репозиторий и зависимость в ваш `pom.xml`: ```xml @@ -48,31 +120,27 @@ type: docs ``` -### Приобретение лицензии -Прежде чем начать, убедитесь, что вы приобрели лицензию на GroupDocs.Annotation. Вы можете получить бесплатную пробную версию или купить полную лицензию на их веб-сайте. Применение лицензии простое и гарантирует вам доступ ко всем функциям без ограничений. - -Вот как подать заявку на получение лицензии: +### Конфигурация лицензии +Примените вашу лицензию перед любой работой с аннотациями: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Руководство по внедрению -### Добавление аннотации эллипса -Добавление аннотаций эллипса включает инициализацию библиотеки аннотаций, настройку документа и настройку свойств аннотаций. Вот как вы можете добиться этого шаг за шагом. +*Pro tip:* Сохраните файл лицензии в `src/main/resources` и загрузите его с помощью `getClass().getResourceAsStream()` для более удобного развертывания. + +## Полное руководство по реализации -#### Шаг 1: Инициализация аннотатора с входным документом -Сначала создайте `Annotator` например, указав путь к вашему PDF-файлу: +### Шаг 1: Инициализация PDF Annotator +Класс `Annotator` — точка входа для всех операций с аннотациями. Он загружает целевой PDF, применяет параметры безопасности и подготавливает представление в памяти для редактирования. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Это инициализирует среду для добавления аннотаций. - -#### Шаг 2: Создание и настройка ответов -Аннотации могут включать ответы или комментарии. Вот как настроить ответы: +### Шаг 2: Создание интерактивных комментариев и ответов +`CommentAnnotation` позволяет встраивать свободный текст, а объекты `Reply` обеспечивают ветвление обсуждений непосредственно на странице PDF. ```java Reply reply1 = new Reply(); @@ -88,83 +156,217 @@ replies.add(reply1); replies.add(reply2); ``` -Эти ответы будут прикреплены к аннотации с многоточием. - -#### Шаг 3: Создание и настройка аннотации эллипса -Теперь создайте `EllipseAnnotation` объект и настройте его свойства: +### Шаг 3: Настройка эллипсной аннотации +`EllipseAnnotation` рисует масштабируемую овальную форму. Вы можете задать цвет линии, цвет заливки, непрозрачность и толщину границы, чтобы соответствовать руководствам вашего UI. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Желтый цвет фона -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Определяет положение и размер +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // Целевой номер страницы для аннотации -ellipse.setPenColor(65535); // Цвет пера в формате RGB -ellipse.setPenStyle(PenStyle.DOT); // Ручка-точка -ellipse.setPenWidth((byte) 3); // Ширина пера +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Эта настройка определяет внешний вид и метаданные вашей аннотации эллипса. - -#### Шаг 4: Добавьте аннотацию к документу -Добавьте настроенную аннотацию в виде эллипса в документ, используя: +### Шаг 4: Добавление и сохранение аннотаций +После настройки всех объектов аннотации вызовите `annotator.save()`, чтобы записать изменения на диск. Не забудьте вызвать `dispose()`, чтобы освободить нативные ресурсы, особенно при обработке множества файлов в цикле. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); +``` + +> **Почему вызывают `dispose()`?** Он освобождает нативные ресурсы, предотвращая утечки памяти — особенно важно при обработке большого количества PDF в цикле. + +## Распространённые проблемы и решения + +### Проблема 1 – «Документ не найден» +*Cause:* Неправильный путь к файлу или рабочий каталог. +*Fix:* Проверьте абсолютный путь или выведите `System.getProperty("user.dir")`, чтобы убедиться в базовом каталоге. + +### Проблема 2 – Аннотации не видны +*Cause:* Неправильная система координат или индекс страницы. +*Fix:* Помните, что координаты PDF начинаются снизу‑слева, а нумерация страниц начинается с нуля. + +### Проблема 3 – OutOfMemoryError при больших PDF +*Cause:* Полная загрузка документа в память. +*Fix:* Увеличьте размер кучи JVM (`-Xmx2g`) или обрабатывайте страницы пакетами (см. пример ниже). + +### Проблема 4 – Ошибки проверки лицензии +*Cause:* Отсутствует или несовпадающий файл лицензии. +*Fix:* Дважды проверьте путь к файлу и убедитесь, что версия лицензии соответствует версии библиотеки. + +## Советы по оптимизации производительности + +### Лучшие практики управления памятью +Избегайте удержания ссылок на крупные экземпляры `Annotator` дольше, чем это необходимо. Используйте try‑with‑resources или явные вызовы `dispose()` после обработки каждого файла. + +```java +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -#### Шаг 5: Сохраните и утилизируйте ресурсы -Наконец, сохраните аннотированный документ и освободите ресурсы: +### Стратегии пакетной обработки +- **Маленькие PDF (<10 MB):** Обрабатывать по отдельности. +- **Средние PDF (10‑50 MB):** Обрабатывать пакетами по 5‑10 файлов. +- **Большие PDF (>50 MB):** Использовать потоковую или порционную обработку, чтобы избежать OOM. + +### Вопросы кэширования +Класс `AnnotationAppearance` инкапсулирует визуальные свойства аннотаций, такие как цвет и непрозрачность. Кешируйте переиспользуемые объекты, например `AnnotationAppearance` или экземпляры `Color`, когда аннотируете множество страниц с одинаковым оформлением. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} ``` -## Практические применения -- **Образовательные инструменты**: Выделение ключевых концепций в учебниках в формате PDF. -- **Юридические документы**: Аннотирование разделов для проверки или утверждения. -- **Медицинские записи**: Отметка важных наблюдений или заметок. +## Примеры интеграции в реальном мире -GroupDocs.Annotation может интегрироваться с системами управления документами, расширяя их возможности аннотирования. +### Интеграция в веб‑приложение +Создайте REST‑endpoint, принимающий поток PDF, применяющий эллипсную аннотацию в координатах, полученных от фронтенда, и возвращающий аннотированный PDF в виде массива байт. -## Соображения производительности -Для оптимальной производительности: -- **Управление памятью**Мониторинг и управление использованием памяти при обработке больших документов. -- **Пакетная обработка**: При аннотировании нескольких PDF-файлов рассмотрите возможность их пакетной обработки для оптимизации использования ресурсов. +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` -Эти методы обеспечивают эффективную работу вашего Java-приложения с использованием GroupDocs.Annotation. +### Пакетная обработка документов +Пройдитесь по каталогу с контрактами, добавьте к каждому штамп «Reviewed» и переместите обработанные файлы в архивную папку. -## Заключение -Следуя этому руководству, вы узнали, как добавлять аннотации с многоточием в PDF-файлы с помощью GroupDocs.Annotation для Java. Эта функция бесценна для приложений, требующих детального обзора документов и совместного редактирования. +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` + +## Продвинутые техники аннотирования + +### Динамическое позиционирование аннотаций +Вычисляйте координаты аннотации «на лету», основываясь на обнаруженных местах текста с помощью OCR или API извлечения текста из PDF, затем размещайте эллипсы вокруг ключевых слов. + +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Условное стилизование аннотаций +Применяйте разные цвета или уровни непрозрачности в зависимости от роли автора аннотации (например, reviewer = blue, approver = green). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` + +## Практические применения и случаи использования +- **Образовательные платформы:** Выделяйте концепции, добавляйте комментарии преподавателей, создавайте интерактивные учебные пособия. +- **Юридический обзор документов:** Помечайте пункты, добавляйте конфиденциальные заметки, ведите аудит‑журналы. +- **Медицинские записи:** Аннотируйте наблюдения, выделяйте критические данные, обеспечивайте безопасное сотрудничество. +- **Корпоративные рабочие процессы:** Упрощайте утверждение отчетов, добавляйте штампы рецензентов, отслеживайте изменения. + +## Когда использовать разные типы аннотаций -Чтобы еще больше улучшить свои навыки, изучите дополнительные типы аннотаций, доступные в библиотеке GroupDocs, или интегрируйте эту функциональность в более крупный проект. +Эллипсные аннотации идеальны, когда нужен не прямоугольный выделитель, например для подчёркивания круглых диаграмм, логотипов или областей, лучше представляемых овальной формой. Они дают чёткий визуальный сигнал, сохраняя читаемость, что делает их подходящими для дизайн‑ревью, проверок брендинга и любых сценариев, где предпочтительно круглое выделение. -## Раздел часто задаваемых вопросов -**В: Могу ли я аннотировать другие типы документов с помощью GroupDocs.Annotation?** -A: Да, GroupDocs поддерживает аннотации в различных форматах документов, помимо PDF, включая файлы Word и Excel. +Хотя данное руководство сосредоточено на эллипсных аннотациях, GroupDocs Annotation Library Java также предлагает: +- **Текстовые аннотации** для детальных комментариев. +- **Стрелочные аннотации** для указания на конкретные элементы. +- **Прямоугольные аннотации** для выделения областей. +- **Водяные знаки** для брендинга или защиты. +- **Штампы** для подтверждения. -**В: Как динамически менять цвет аннотации в зависимости от ее содержимого?** -A: Вы можете программно установить `penColor` свойство на основе вашей логики перед добавлением аннотации. +## Руководство по устранению неполадок -**В: Какое максимальное количество поддерживаемых аннотаций?** -A: GroupDocs.Annotation позволяет использовать большое количество аннотаций, но рекомендуется протестировать производительность с учетом конкретных размеров и типов документов. +### Проблемы с производительностью +- **Symptom:** Медленная обработка. +- **Diagnosis:** Большой размер файла, множество аннотаций, ограниченная ОЗУ. +- **Solution:** Оптимизировать свойства аннотаций, обрабатывать асинхронно или разбивать большие PDF на части. + +### Проблемы совместимости +- **Symptom:** Аннотации выглядят по‑разному в разных просмотрщиках. +- **Diagnosis:** Нестандартные функции PDF. +- **Solution:** Тестировать в Adobe Acrobat, Chrome и Firefox; придерживаться стандартных флагов аннотаций PDF. + +### Проблемы интеграции +- **Symptom:** Конфликты зависимостей. +- **Diagnosis:** Несоответствия версий с другими библиотеками. +- **Solution:** Использовать `` в Maven для принудительного указания совместимых версий или перейти на REST API для языконезависимой интеграции. + +## Часто задаваемые вопросы + +**Q: Можно ли добавить аннотации в PDF, защищённые паролем?** +A: Да. Используйте перегрузку `new Annotator(filePath, loadOptions)`, где `loadOptions` содержит пароль. + +**Q: Как обрабатывать PDF размером более 100 MB?** +A: Обрабатывайте страницы по отдельности, увеличьте размер кучи или используйте GroupDocs Annotation Cloud API для тяжёлых нагрузок. + +**Q: Есть ли ограничение на количество аннотаций в документе?** +A: Жёсткого ограничения нет, но производительность может падать после тысяч аннотаций. Рассмотрите пагинацию или группировку. + +**Q: Можно ли извлечь существующие аннотации?** +A: Абсолютно. Вызовите `annotator.get()`, чтобы получить все аннотации из PDF. + +**Q: Как защитить аннотации, чтобы их могли редактировать только определённые пользователи?** +A: Библиотека предоставляет настройки прав на основе пользователей; сконфигурируйте их через API `AnnotationPermission`. + +## Заключение +**GroupDocs Annotation Library Java** предоставляет чистый, высокопроизводительный способ внедрять богатые PDF‑аннотации напрямую из Java‑кода. Следуя описанным шагам, вы сможете добавлять эллипсные аннотации, управлять комментариями и масштабировать решение до уровня корпоративных нагрузок. + +**Следующие шаги:** +1. Поэкспериментируйте с другими типами аннотаций (текст, штамп, водяной знак). +2. Интегрируйте библиотеку в существующий документооборот или веб‑сервис. +3. Изучите REST API для сценариев, не зависящих от языка. + +--- -**В: Как обрабатывать перекрывающиеся аннотации?** -А: Отрегулируйте `box` размеры и положения для управления наложениями или наложения нескольких аннотаций по мере необходимости. +**Last Updated:** 2026-07-25 +**Tested With:** GroupDocs.Annotation 25.2 for Java +**Author:** GroupDocs -**В: Каковы наилучшие практики использования GroupDocs.Annotation в веб-приложении?** -A: Используйте асинхронную обработку для больших документов, обеспечьте безопасное хранение аннотированных файлов и предоставьте удобные интерфейсы для взаимодействия с аннотациями. +**Essential Links:** +- **Documentation:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **API Reference:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Purchase:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Free Trial:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **Temporary License:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) -## Ресурсы -- **Документация**: [GroupDocs Аннотация Java Документация](https://docs.groupdocs.com/annotation/java/) -- **Ссылка на API**: [Ссылка на API GroupDocs](https://reference.groupdocs.com/annotation/java/) -- **Скачать**: [Скачать GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Покупка**: [Купить лицензию GroupDocs](https://purchase.groupdocs.com/buy) -- **Бесплатная пробная версия**: [Начать бесплатную пробную версию](https://releases.groupdocs.com/annotation/java/) -- **Временная лицензия**: [Запросить временную лицензию](https://purchase.groupdocs.com/temporary-license/) -- **Поддерживать**: [Форум поддержки GroupDocs](https://forum.groupdocs.com/c/annotation/) +## Связанные руководства -Это всеобъемлющее руководство должно снабдить вас знаниями для эффективного добавления аннотаций эллипса в ваши приложения Java с помощью GroupDocs.Annotation. Удачного кодирования! \ No newline at end of file +- [How to add arrow to pdf with Java – Complete Tutorial & Best Practices](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [How to add image to PDF using Java and GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Complete Guide - How to Save Annotated PDF with GroupDocs.Annotation for Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/spanish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/spanish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index f1c85d03d..87db9efc6 100644 --- a/content/spanish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/spanish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,55 +1,106 @@ --- categories: - Java Development -date: '2026-02-03' -description: Aprende a agregar anotaciones a archivos PDF usando la biblioteca GroupDocs - Annotation para Java. Guía paso a paso, ejemplos de código, consejos de solución - de problemas y mejores prácticas. -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: Aprenda a anotar PDF con GroupDocs Annotation Library Java – guía paso + a paso, fragmentos de código, consejos de rendimiento y mejores prácticas. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Agregar anotaciones PDF en Java +og_description: Aprenda a anotar PDF con GroupDocs Annotation Library Java – una guía + que cubre anotaciones elípticas, comentarios, licencias y consejos para desarrolladores + Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Cómo anotar PDF con GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'Biblioteca de anotaciones GroupDocs Java: Añadir anotaciones PDF' +- document processing +- ellipse annotation +title: Cómo anotar PDF con GroupDocs Annotation Library Java type: docs url: /es/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java: Añadir anotaciones PDF +# Cómo anotar PDF con la biblioteca GroupDocs Annotation para Java -¿Alguna vez te has preguntado cómo añadir anotaciones a documentos PDF de forma programática en Java? Con la **groupdocs annotation library java**, puedes incrustar marcado enriquecido —como elipses, comentarios y sellos— directamente en PDFs. Ya sea que estés construyendo un sistema de revisión de documentos, una plataforma educativa o un espacio de trabajo colaborativo, este tutorial te muestra exactamente cómo comenzar. +Agregar notas visuales, comentarios o sellos a un PDF de forma programática puede acelerar drásticamente los ciclos de revisión, las verificaciones de cumplimiento y los flujos de trabajo colaborativos. En este tutorial descubrirás **cómo anotar PDF** usando la GroupDocs Annotation Library para Java, cubriendo todo desde la configuración del proyecto hasta anotaciones avanzadas de elipse, licencias, optimización de rendimiento y consejos de integración del mundo real. ## Respuestas rápidas -- **¿Qué biblioteca añade anotaciones a PDFs en Java?** The groupdocs annotation library java. -- **¿Necesito una licencia?** Una prueba funciona para pruebas; se requiere una licencia de producción para uso comercial. +- **¿Qué biblioteca agrega anotaciones a PDFs en Java?** The GroupDocs Annotation Library for Java. +- **¿Necesito una licencia?** Una versión de prueba funciona para pruebas; se requiere una licencia de producción para uso comercial. - **¿Qué IDE funciona mejor?** Cualquier IDE de Java (IntelliJ IDEA, Eclipse, VS Code) funciona bien. - **¿Puedo anotar PDFs protegidos con contraseña?** Sí—proporcione la contraseña al crear el `Annotator`. - **¿Se admite el procesamiento por lotes?** Absolutamente; vea el ejemplo de procesamiento por lotes más adelante. -## ¿Qué es GroupDocs Annotation Library Java? -La groupdocs annotation library java es una API Java potente y preparada para la empresa que le permite crear, editar y recuperar anotaciones PDF de forma programática. Soporta más de 50 formatos de documento y proporciona funciones de colaboración como respuestas y hilos de comentarios. +## ¿Qué es la GroupDocs Annotation Library para Java? -## ¿Por qué usar GroupDocs Annotation Library Java? -- **Tipos de anotación ricos** – shapes, text, stamps, watermarks, and more. -- **Listo para colaboración** – built‑in replies and comment threads. -- **Optimizado para rendimiento** – handles large PDFs efficiently. -- **API simple** – reduces development time compared with lower‑level libraries like iText or PDFBox. +La GroupDocs Annotation Library Java es una API lista para usar que permite a los desarrolladores crear, editar, recuperar y eliminar anotaciones PDF completamente en código Java. Soporta **más de 50 formatos de documento**, ofrece hilos de comentarios integrados y proporciona controles de permisos granulares. + +## ¿Por qué usar la GroupDocs Annotation Library para Java? + +Puede agregar marcas enriquecidas—incluyendo elipses, notas de texto, sellos y marcas de agua—con solo unas pocas llamadas a métodos, y la biblioteca procesa **PDFs de cientos de páginas** sin cargar todo el archivo en memoria. En comparación con herramientas de bajo nivel como iText o PDFBox, reduce el tiempo de desarrollo hasta en **un 70 %** y maneja características complejas de PDF (capas, formularios, firmas digitales) de forma nativa. ## Requisitos previos y configuración -- **JDK 8+** (JDK 11 recomendado) +- **JDK 8+** (JDK 11 recomendado) - **Maven o Gradle** para la gestión de dependencias -- **IDE** de tu elección (IntelliJ IDEA, Eclipse, etc.) +- **IDE** de su elección (IntelliJ IDEA, Eclipse, VS Code) - Familiaridad básica con Java file I/O -## Configuración de GroupDocs Annotation Library Java - ### Integración con Maven -Añade el repositorio y la dependencia a tu `pom.xml`: +Agregue el repositorio y la dependencia a su `pom.xml`: ```xml @@ -69,23 +120,27 @@ Añade el repositorio y la dependencia a tu `pom.xml`: ``` ### Configuración de licencia -Aplica tu licencia antes de cualquier trabajo de anotación: +Aplique su licencia antes de cualquier trabajo de anotación: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -*Consejo profesional:* Almacena el archivo de licencia en `src/main/resources` y cárgalo con `getClass().getResourceAsStream()` para implementaciones más fluidas. +*Consejo profesional:* Guarde el archivo de licencia en `src/main/resources` y cárguelo con `getClass().getResourceAsStream()` para implementaciones más fluidas. ## Guía completa de implementación ### Paso 1: Inicializar el anotador PDF +La clase `Annotator` es el punto de entrada para todas las operaciones de anotación. Carga el PDF objetivo, aplica configuraciones de seguridad y prepara una representación en memoria para la edición. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### Paso 2: Crear comentarios interactivos y respuestas +`CommentAnnotation` le permite incrustar texto libre, mientras que los objetos `Reply` habilitan discusiones en hilo directamente en la página del PDF. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -100,7 +155,9 @@ replies.add(reply1); replies.add(reply2); ``` -### Paso 3: Configurar tu anotación de elipse +### Paso 3: Configurar su anotación de elipse +`EllipseAnnotation` dibuja una forma ovalada escalable. Puede establecer el color de línea, color de relleno, opacidad y grosor de borde personalizado para que coincida con las directrices de su UI. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -114,7 +171,9 @@ ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -### Paso 4: Añadir y guardar tus anotaciones +### Paso 4: Añadir y guardar sus anotaciones +Después de configurar todos los objetos de anotación, invoque `annotator.save()` para escribir los cambios en disco. Recuerde llamar a `dispose()` para liberar recursos nativos, especialmente al procesar muchos archivos en un bucle. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); @@ -127,23 +186,25 @@ annotator.dispose(); ### Problema 1 – “Documento no encontrado” *Causa:* Ruta de archivo incorrecta o directorio de trabajo. -*Solución:* Verifica la ruta absoluta o imprime `System.getProperty("user.dir")` para confirmar el directorio base. +*Solución:* Verifique la ruta absoluta o imprima `System.getProperty("user.dir")` para confirmar el directorio base. ### Problema 2 – Anotaciones no visibles -*Causa:* Sistema de coordenadas o índice de página incorrecto. -*Solución:* Recuerda que las coordenadas PDF comienzan en la esquina inferior‑izquierda, y las páginas se indexan desde cero. +*Causa:* Sistema de coordenadas o índice de página incorrectos. +*Solución:* Recuerde que las coordenadas PDF comienzan en la esquina inferior izquierda, y las páginas se indexan desde cero. ### Problema 3 – OutOfMemoryError en PDFs grandes *Causa:* Documento completo cargado en memoria. -*Solución:* Incrementa el heap de JVM (`-Xmx2g`) o procesa páginas en lotes (ver el ejemplo de lote a continuación). +*Solución:* Aumente el heap de JVM (`-Xmx2g`) o procese páginas en lotes (vea el ejemplo de lote a continuación). ### Problema 4 – Errores de validación de licencia -*Causa:* Archivo de licencia ausente o no coincidente. -*Solución:* Verifica nuevamente la ruta del archivo y asegura que la versión de la licencia coincida con la versión de la biblioteca. +*Causa:* Archivo de licencia faltante o no coincidente. +*Solución:* Verifique la ruta del archivo y asegúrese de que la versión de la licencia coincida con la versión de la biblioteca. ## Consejos de optimización de rendimiento ### Mejores prácticas de gestión de memoria +Evite mantener referencias a instancias grandes de `Annotator` más tiempo del necesario. Use try‑with‑resources o llamadas explícitas a `dispose()` después de procesar cada archivo. + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -155,11 +216,13 @@ for (String documentPath : documentPaths) { ``` ### Estrategias de procesamiento por lotes -- **PDFs pequeños (<10 MB):** Process individually. -- **PDFs medianos (10‑50 MB):** Process in batches of 5‑10. -- **PDFs grandes (>50 MB):** Use streaming or chunked processing to avoid OOM. +- **PDFs pequeños (<10 MB):** Procesar individualmente. +- **PDFs medianos (10‑50 MB):** Procesar en lotes de 5‑10. +- **PDFs grandes (>50 MB):** Use streaming o procesamiento por fragmentos para evitar OOM. ### Consideraciones de caché +La clase `AnnotationAppearance` encapsula propiedades visuales como color y opacidad para las anotaciones. Cache objetos reutilizables como instancias de `AnnotationAppearance` o `Color` cuando anote muchas páginas con el mismo estilo. + ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -169,9 +232,11 @@ private static EllipseAnnotation createStandardEllipse() { } ``` -## Ejemplos de integración en el mundo real +## Ejemplos de integración del mundo real ### Integración de aplicación web +Exponer un endpoint REST que acepte un flujo PDF, aplique una anotación de elipse en las coordenadas suministradas por el front‑end, y devuelva el PDF anotado como un arreglo de bytes. + ```java @RestController @RequestMapping("/api/documents") @@ -189,6 +254,8 @@ public class DocumentAnnotationController { ``` ### Procesamiento por lotes de documentos +Iterar sobre un directorio de contratos, añadir un sello “Reviewed” a cada uno, y mover los archivos procesados a una carpeta de archivo. + ```java public class BatchAnnotationProcessor { @@ -206,6 +273,8 @@ public class BatchAnnotationProcessor { ## Técnicas avanzadas de anotación ### Posicionamiento dinámico de anotaciones +Calcule las coordenadas de la anotación al vuelo basándose en ubicaciones de texto detectadas usando OCR o APIs de extracción de texto PDF, luego coloque elipses alrededor de palabras clave. + ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); @@ -213,6 +282,8 @@ ellipse.setBox(dynamicPosition); ``` ### Estilizado condicional de anotaciones +Aplique diferentes colores o niveles de opacidad según el rol del autor de la anotación (p. ej., revisor = azul, aprobador = verde). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow @@ -220,74 +291,81 @@ ellipse.setBackgroundColor(color); ``` ## Aplicaciones prácticas y casos de uso -- **Plataformas educativas:** Highlight concepts, add teacher comments, create interactive study guides. -- **Revisión de documentos legales:** Mark clauses, add confidential notes, maintain audit trails. -- **Registros médicos:** Annotate observations, highlight critical data, enable secure collaboration. -- **Flujos de trabajo corporativos:** Streamline report approvals, add reviewer stamps, track changes. +- **Plataformas educativas:** Resaltar conceptos, añadir comentarios de profesores, crear guías de estudio interactivas. +- **Revisión de documentos legales:** Marcar cláusulas, añadir notas confidenciales, mantener registros de auditoría. +- **Registros médicos:** Anotar observaciones, resaltar datos críticos, habilitar colaboración segura. +- **Flujos de trabajo corporativos:** Agilizar aprobaciones de informes, añadir sellos de revisores, rastrear cambios. ## Cuándo usar diferentes tipos de anotación -Si bien esta guía se centra en anotaciones de elipse, la groupdocs annotation library java también ofrece: -- **Text annotations** for detailed comments. -- **Arrow annotations** to point at specific elements. -- **Rectangle annotations** for area highlighting. -- **Watermark annotations** for branding or security. -- **Stamp annotations** for approvals. -Elige elipses cuando necesites un resaltado no rectangular y visualmente distintivo—perfecto para llamar la atención sobre diagramas circulares o áreas de logotipos. +Las anotaciones de elipse son ideales cuando necesita un resaltado no rectangular, como enfatizar diagramas circulares, logotipos o áreas que se representan mejor con una forma ovalada. Proporcionan una pista visual clara mientras preservan la legibilidad, lo que las hace adecuadas para revisiones de diseño, verificaciones de marca y cualquier escenario donde se prefiera un énfasis redondo. + +Aunque esta guía se centra en anotaciones de elipse, la GroupDocs Annotation Library Java también ofrece: +- **Anotaciones de texto** para comentarios detallados. +- **Anotaciones de flecha** para señalar elementos específicos. +- **Anotaciones de rectángulo** para resaltar áreas. +- **Anotaciones de marca de agua** para branding o seguridad. +- **Anotaciones de sello** para aprobaciones. ## Guía de solución de problemas ### Problemas de rendimiento -- **Síntoma:** Slow processing. -- **Diagnóstico:** Large file size, many annotations, limited RAM. -- **Solución:** Optimize annotation properties, process asynchronously, or paginate large PDFs. +- **Síntoma:** Procesamiento lento. +- **Diagnóstico:** Tamaño de archivo grande, muchas anotaciones, RAM limitada. +- **Solución:** Optimizar propiedades de anotación, procesar de forma asíncrona o paginar PDFs grandes. ### Problemas de compatibilidad -- **Síntoma:** Annotations look different across viewers. -- **Diagnóstico:** Non‑standard PDF features. -- **Solución:** Test with Adobe Acrobat, Chrome, and Firefox; stick to PDF‑standard annotation flags. +- **Síntoma:** Las anotaciones se ven diferentes en distintos visores. +- **Diagnóstico:** Características PDF no estándar. +- **Solución:** Probar con Adobe Acrobat, Chrome y Firefox; ceñirse a los indicadores de anotación estándar de PDF. ### Desafíos de integración -- **Síntoma:** Dependency conflicts. -- **Diagnóstico:** Version mismatches with other libraries. -- **Solución:** Use Maven’s `` to enforce compatible versions or switch to the REST API for language‑agnostic integration. +- **Síntoma:** Conflictos de dependencias. +- **Diagnóstico:** Incompatibilidades de versiones con otras bibliotecas. +- **Solución:** Use `` de Maven para imponer versiones compatibles o cambie a la API REST para integración independiente del lenguaje. ## Preguntas frecuentes -**Q: ¿Puedo añadir anotaciones a PDFs protegidos con contraseña?** -A: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` includes the password. +**P: ¿Puedo añadir anotaciones a PDFs protegidos con contraseña?** +R: Sí. Use la sobrecarga `new Annotator(filePath, loadOptions)` donde `loadOptions` incluye la contraseña. -**Q: ¿Cómo debo manejar PDFs de más de 100 MB?** -A: Process pages individually, increase heap size, or leverage the GroupDocs Annotation Cloud API for heavy workloads. +**P: ¿Cómo debo manejar PDFs mayores de 100 MB?** +R: Procese páginas individualmente, aumente el tamaño del heap, o aproveche la GroupDocs Annotation Cloud API para cargas de trabajo intensivas. -**Q: ¿Existe un límite al número de anotaciones por documento?** -A: No hard limit, but performance may degrade after thousands of annotations. Consider pagination or grouping. +**P: ¿Existe un límite al número de anotaciones por documento?** +R: No hay un límite estricto, pero el rendimiento puede degradarse después de miles de anotaciones. Considere paginación o agrupamiento. -**Q: ¿Puedo extraer anotaciones existentes?** -A: Absolutely. Call `annotator.get()` to retrieve all annotations from a PDF. +**P: ¿Puedo extraer anotaciones existentes?** +R: Absolutamente. Llame a `annotator.get()` para recuperar todas las anotaciones de un PDF. -**Q: ¿Cómo aseguro las anotaciones para que solo ciertos usuarios puedan editarlas?** -A: The library provides user‑based permission settings; configure them via the `AnnotationPermission` API. +**P: ¿Cómo aseguro las anotaciones para que solo ciertos usuarios puedan editarlas?** +R: La biblioteca proporciona configuraciones de permisos basadas en usuarios; configúrelas mediante la API `AnnotationPermission`. ## Conclusión -La **groupdocs annotation library java** le brinda una forma limpia y de alto rendimiento para incrustar anotaciones PDF enriquecidas directamente desde código Java. Siguiendo los pasos anteriores, puede añadir anotaciones de elipse, gestionar comentarios y escalar a cargas de trabajo a nivel empresarial. +La **GroupDocs Annotation Library Java** le brinda una forma limpia y de alto rendimiento de incrustar anotaciones PDF enriquecidas directamente desde código Java. Siguiendo los pasos anteriores, puede añadir anotaciones de elipse, gestionar comentarios y escalar a cargas de trabajo a nivel empresarial. **Próximos pasos:** -1. Experimentar con otros tipos de anotación (text, stamp, watermark). -2. Integrar la biblioteca en su flujo de trabajo de documentos existente o servicio web. -3. Explorar la REST API para escenarios independientes del lenguaje. +1. Experimente con otros tipos de anotación (texto, sello, marca de agua). +2. Integre la biblioteca en su flujo de trabajo documental existente o servicio web. +3. Explore la API REST para escenarios independientes del lenguaje. --- -**Última actualización:** 2026-02-03 -**Probado con:** GroupDocs.Annotation 25.2 for Java +**Última actualización:** 2026-07-25 +**Probado con:** GroupDocs.Annotation 25.2 para Java **Autor:** GroupDocs **Enlaces esenciales:** - **Documentación:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) -- **Referencia de API:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) -- **Descarga:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Compra:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Referencia API:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Descargar:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Comprar:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) - **Prueba gratuita:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) - **Licencia temporal:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Soporte:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **Soporte:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## Tutoriales relacionados + +- [Cómo añadir una flecha a PDF con Java – Tutorial completo y mejores prácticas](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Cómo añadir una imagen a PDF usando Java y GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Guía completa - Cómo guardar PDF anotado con GroupDocs.Annotation para Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/swedish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/swedish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 1e176820c..a607d9984 100644 --- a/content/swedish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/swedish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,106 @@ --- -"date": "2025-05-06" -"description": "Lär dig hur du lägger till ellipsanteckningar i PDF-dokument med hjälp av det kraftfulla GroupDocs.Annotation-biblioteket i Java. Följ den här steg-för-steg-guiden för att förbättra dokumentsamarbetet." -"title": "Lägg till ellipsannoteringar i PDF-filer i Java med GroupDocs.Annotation för Java" -"url": "/sv/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: Lär dig hur du annoterar PDF med GroupDocs Annotation Library Java – + steg‑för‑steg‑guide, kodexempel, prestandatips och bästa praxis. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Lägg till PDF-annotationer i Java +og_description: Lär dig hur du annoterar PDF med GroupDocs Annotation Library Java + – en guide som täcker ellips-annotationer, kommentarer, licensiering och tips för + Java‑utvecklare. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Hur man annoterar PDF med GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: Hur man annoterar PDF med GroupDocs Annotation Library Java type: docs -"weight": 1 +url: /sv/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Hur man lägger till ellipsannoteringar i en PDF med GroupDocs.Annotation för Java +# Hur man annoterar PDF med GroupDocs Annotation Library Java -## Introduktion -Att lägga till annoteringar i PDF-filer kan avsevärt förbättra samarbete och kommunikation, särskilt när man hanterar komplexa dokument. Om du vill markera eller annotera specifika områden i dina PDF-filer programmatiskt med hjälp av Java, kommer den här handledningen att guida dig genom processen att lägga till ellipsannoteringar sömlöst. Genom att utnyttja kraften i GroupDocs.Annotation för Java kan utvecklare enkelt integrera sofistikerade annoteringsfunktioner i sina applikationer. +Att lägga till visuella anteckningar, kommentarer eller stämplar i en PDF programmässigt kan avsevärt snabba upp granskningscykler, efterlevnadskontroller och samarbetesarbetsflöden. I den här handledningen kommer du att upptäcka **hur man annoterar PDF**‑filer med hjälp av GroupDocs Annotation Library för Java, och täcker allt från projektuppsättning till avancerade ellips‑annotationer, licensiering, prestandaoptimering och praktiska integrations‑tips. -I den här handledningen kommer vi att gå igenom: -- Hur man konfigurerar och integrerar GroupDocs.Annotation i ett Java-projekt. -- Steg-för-steg-instruktioner om hur man lägger till en ellipsanteckning i ett PDF-dokument. -- Praktiska exempel som demonstrerar verkliga användningsområden. +## Snabba svar +- **Vilket bibliotek lägger till annotationer i PDF:er i Java?** GroupDocs Annotation Library for Java. +- **Behöver jag en licens?** En provversion fungerar för testning; en produktionslicens krävs för kommersiell användning. +- **Vilken IDE fungerar bäst?** Alla Java‑IDE:er (IntelliJ IDEA, Eclipse, VS Code) fungerar bra. +- **Kan jag annotera lösenordsskyddade PDF:er?** Ja—ange lösenordet när du skapar `Annotator`. +- **Stöds batch‑behandling?** Absolut; se batch‑behandlingsexemplet senare. -Låt oss gå igenom de förkunskapskrav du behöver innan du börjar! +## Vad är GroupDocs Annotation Library Java? -## Förkunskapskrav -För att följa den här handledningen behöver du: -- **Java-utvecklingspaket (JDK)**Se till att du har JDK installerat. Det här exemplet använder Java 8 eller senare. -- **GroupDocs.Annotation för Java-biblioteket**Vi kommer att använda version 25.2 av biblioteket. -- **Maven-inställningar**Maven krävs för att enkelt hantera beroenden. +GroupDocs Annotation Library Java är ett färdigt API som gör det möjligt för utvecklare att skapa, redigera, hämta och ta bort PDF‑annotationer helt i Java‑kod. Det stöder **över 50 dokumentformat**, erbjuder inbyggda kommentars‑trådar och ger fin‑granulerade behörighetskontroller. -Se till att din utvecklingsmiljö stöder dessa krav och att du är bekväm med grundläggande Java-programmeringskoncept, särskilt att arbeta med bibliotek och hantera filer i Java. +## Varför använda GroupDocs Annotation Library Java? -## Konfigurera GroupDocs.Annotation för Java -### Installation via Maven -För att integrera GroupDocs.Annotation i ditt projekt med Maven, lägg till följande repository och beroende till din `pom.xml` fil: +Du kan lägga till rik markup—inklusive ellipser, textanteckningar, stämplar och vattenstämplar—med bara några metodanrop, och biblioteket bearbetar **PDF‑filer med hundratals sidor** utan att ladda hela filen i minnet. Jämfört med lågnivåverktyg som iText eller PDFBox minskar det utvecklingstiden med upp till **70 %** och hanterar komplexa PDF‑funktioner (lager, formulär, digitala signaturer) direkt ur lådan. + +## Förutsättningar och installation +- **JDK 8+** (JDK 11 rekommenderas) +- **Maven eller Gradle** för beroendehantering +- **IDE** du föredrar (IntelliJ IDEA, Eclipse, VS Code) +- Grundläggande kunskap om Java fil‑I/O + +### Maven‑integration +Lägg till repository och beroende i din `pom.xml`: ```xml @@ -48,31 +119,27 @@ För att integrera GroupDocs.Annotation i ditt projekt med Maven, lägg till fö ``` -### Licensförvärv -Innan du börjar, se till att skaffa en licens för GroupDocs.Annotation. Du kan få en gratis provperiod eller köpa en fullständig licens från deras webbplats. Att ansöka om licensen är enkelt och säkerställer att du har tillgång till alla funktioner utan begränsningar. - -Så här ansöker du om din licens: +### Licenskonfiguration +Applicera din licens innan någon annoteringsarbete: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Implementeringsguide -### Lägga till en ellipsannotering -Att lägga till ellipsannoteringar innebär att man initierar annoteringsbiblioteket, konfigurerar dokumentet och konfigurerar annoteringsegenskaperna. Så här gör du steg för steg. +*Pro‑tips:* Spara licensfilen i `src/main/resources` och ladda den med `getClass().getResourceAsStream()` för smidigare distributioner. + +## Komplett implementationsguide -#### Steg 1: Initiera annotatorn med inmatningsdokumentet -Skapa först en `Annotator` exempel genom att ange sökvägen till din PDF-fil: +### Steg 1: Initiera PDF‑annotatorn +`Annotator`‑klassen är ingångspunkten för alla annoteringsoperationer. Den laddar mål‑PDF‑filen, tillämpar säkerhetsinställningar och förbereder en in‑memory‑representation för redigering. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Detta initierar miljön för att lägga till anteckningar. - -#### Steg 2: Skapa och konfigurera svar -Annoteringar kan innehålla svar eller kommentarer. Så här konfigurerar du svar: +### Steg 2: Skapa interaktiva kommentarer och svar +`CommentAnnotation` låter dig bädda in fri‑form text, medan `Reply`‑objekt möjliggör trådade diskussioner direkt på PDF‑sidan. ```java Reply reply1 = new Reply(); @@ -88,83 +155,219 @@ replies.add(reply1); replies.add(reply2); ``` -Dessa svar kommer att bifogas ellipsannoteringen. - -#### Steg 3: Skapa och konfigurera ellipsannotering -Skapa nu en `EllipseAnnotation` objekt och konfigurera dess egenskaper: +### Steg 3: Konfigurera din ellips‑annotation +`EllipseAnnotation` ritar en skalbar oval form. Du kan sätta linjefärg, fyllningsfärg, opacitet och anpassad kanttjocklek för att matcha dina UI‑riktlinjer. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Gul bakgrundsfärg -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Definierar position och storlek +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // Målsidnummer för anteckningen -ellipse.setPenColor(65535); // Pennfärg i RGB-format -ellipse.setPenStyle(PenStyle.DOT); // Prickig penna -ellipse.setPenWidth((byte) 3); // Pennbredd +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Den här inställningen definierar utseendet och metadataen för din ellipsannotering. - -#### Steg 4: Lägg till anteckning i dokumentet -Lägg till den konfigurerade ellipsannoteringen i ditt dokument med hjälp av: +### Steg 4: Lägg till och spara dina annotationer +Efter att ha konfigurerat alla annoteringsobjekt, anropa `annotator.save()` för att skriva tillbaka ändringarna till disk. Kom ihåg att anropa `dispose()` för att frigöra inhemska resurser, särskilt när du bearbetar många filer i en loop. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); ``` -#### Steg 5: Spara och kassera resurser -Slutligen, spara det kommenterade dokumentet och frigör resurser: +> **Varför anropa `dispose()`?** Det frigör inhemska resurser och förhindrar minnesläckor—särskilt viktigt när man bearbetar många PDF‑filer i en loop. + +## Vanliga problem och lösningar + +### Problem 1 – “Document Not Found” +*Orsak:* Felaktig filsökväg eller arbetskatalog. +*Lösning:* Verifiera den absoluta sökvägen eller skriv ut `System.getProperty("user.dir")` för att bekräfta baskatalogen. + +### Problem 2 – Annotations Not Visible +*Orsak:* Fel koordinatsystem eller sidindex. +*Lösning:* Kom ihåg att PDF‑koordinater startar längst ner till vänster, och sidor är noll‑baserade. + +### Problem 3 – OutOfMemoryError on Large PDFs +*Orsak:* Hela dokumentet laddas in i minnet. +*Lösning:* Öka JVM‑heap (`-Xmx2g`) eller bearbeta sidor i batcher (se batch‑exemplet nedan). + +### Problem 4 – License Validation Errors +*Orsak:* Saknad eller felaktig licensfil. +*Lösning:* Dubbelkolla filsökvägen och säkerställ att licensversionen matchar biblioteksversionen. + +## Tips för prestandaoptimering + +### Bästa praxis för minneshantering +Undvik att hålla referenser till stora `Annotator`‑instanser längre än nödvändigt. Använd try‑with‑resources eller explicita `dispose()`‑anrop efter att varje fil har bearbetats. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -## Praktiska tillämpningar -- **Utbildningsverktyg**Markering av viktiga begrepp i PDF-läroböcker. -- **Juridiska dokument**Annotering av avsnitt för granskning eller godkännande. -- **Medicinska journaler**Markering av viktiga observationer eller anteckningar. +### Strategier för batch‑bearbetning +- **Små PDF‑filer (<10 MB):** Bearbeta individuellt. +- **Mellanstora PDF‑filer (10‑50 MB):** Bearbeta i batcher om 5‑10. +- **Stora PDF‑filer (>50 MB):** Använd streaming eller chunk‑bearbetning för att undvika OOM. -GroupDocs.Annotation kan integreras med dokumenthanteringssystem, vilket förbättrar deras annoteringsmöjligheter. +### Överväganden kring cachning +`AnnotationAppearance`‑klassen kapslar in visuella egenskaper som färg och opacitet för annotationer. Cacha återanvändbara objekt som `AnnotationAppearance` eller `Color`‑instanser när du annoterar många sidor med identisk stil. -## Prestandaöverväganden -För optimal prestanda: -- **Minneshantering**Övervaka och hantera minnesanvändning vid hantering av stora dokument. -- **Batchbearbetning**Om du antecknar flera PDF-filer bör du överväga att bearbeta dem i omgångar för att optimera resursanvändningen. +```java +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} +``` -Dessa metoder säkerställer effektiv drift av din Java-applikation med GroupDocs.Annotation. +## Exempel på integration i verkliga världen -## Slutsats -Genom att följa den här handledningen har du lärt dig hur du lägger till ellipsannoteringar i PDF-filer med GroupDocs.Annotation för Java. Den här funktionen är ovärderlig för program som kräver detaljerade dokumentgranskningar och gemensam redigering. +### Integration av webbapplikation +Exponera en REST‑endpoint som tar emot en PDF‑ström, applicerar en ellips‑annotation på koordinater som levereras av front‑end, och returnerar den annoterade PDF‑filen som en byte‑array. + +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` + +### Batch‑dokumentbearbetning +Iterera över en katalog med kontrakt, lägg till en “Reviewed”‑stämpel på varje, och flytta de bearbetade filerna till en arkivmapp. + +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` + +## Avancerade annoteringstekniker + +### Dynamisk placering av annotationer +Beräkna annoteringskoordinater i farten baserat på upptäckta textpositioner med OCR eller PDF‑textextraktions‑API:er, och placera sedan ellipser runt nyckelord. + +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Villkorlig stil för annotationer +Applicera olika färger eller opacitetsnivåer beroende på annoteringens författarroll (t.ex. granskare = blå, godkännare = grön). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` + +## Praktiska tillämpningar och användningsfall + +- **Utbildningsplattformar:** Markera koncept, lägg till lärarkommentarer, skapa interaktiva studieguides. +- **Juridisk dokumentgranskning:** Markera klausuler, lägg till konfidentiella anteckningar, upprätthåll revisionsspår. +- **Medicinska journaler:** Annotera observationer, markera kritisk data, möjliggör säker samarbete. +- **Företagsarbetsflöden:** Effektivisera rapportgodkännanden, lägg till granskningsstämplar, spåra ändringar. + +## När man ska använda olika annoteringstyper + +Ellips‑annotationer är idealiska när du behöver en icke‑rektangulär markering, såsom att framhäva cirkulära diagram, logotyper eller områden som bättre representeras av en oval form. De ger en tydlig visuell ledtråd samtidigt som de bevarar läsbarheten, vilket gör dem lämpliga för designgranskningar, varumärkeskontroller och alla scenarier där en rund betoning föredras. -För att ytterligare förbättra dina färdigheter kan du utforska ytterligare anteckningstyper som finns i GroupDocs-biblioteket eller integrera funktionaliteten i ett större projekt. +Även om den här guiden fokuserar på ellips‑annotationer, erbjuder GroupDocs Annotation Library Java också: +- **Textannotationer** för detaljerade kommentarer. +- **Pilannotationer** för att peka på specifika element. +- **Rektangelannotationer** för område‑markering. +- **Vattenstämplings‑annotationer** för varumärkes‑ eller säkerhetsändamål. +- **Stämpelannotationer** för godkännanden. -## FAQ-sektion -**F: Kan jag kommentera andra typer av dokument med GroupDocs.Annotation?** -A: Ja, GroupDocs stöder anteckningar i olika dokumentformat utöver PDF-filer, inklusive Word- och Excel-filer. +## Felsökningsguide -**F: Hur ändrar jag annoteringsfärgen dynamiskt baserat på innehåll?** -A: Du kan programmatiskt ställa in `penColor` egenskapen baserat på din logik innan du lägger till annoteringen. +### Prestandaproblem +- **Symptom:** Långsam bearbetning. +- **Diagnos:** Stor filstorlek, många annotationer, begränsat RAM. +- **Lösning:** Optimera annoterings‑egenskaper, bearbeta asynkront, eller paginera stora PDF‑filer. -**F: Vilket är det maximala antalet annoteringar som stöds?** -A: GroupDocs.Annotation tillåter ett stort antal anteckningar, men det är lämpligt att testa prestandan med dina specifika dokumentstorlekar och -typer. +### Kompatibilitetsproblem +- **Symptom:** Annotationer ser olika ut i olika visare. +- **Diagnos:** Icke‑standard PDF‑funktioner. +- **Lösning:** Testa med Adobe Acrobat, Chrome och Firefox; håll dig till PDF‑standardens annoteringsflaggor. + +### Integrationsutmaningar +- **Symptom:** Beroendekonflikter. +- **Diagnos:** Versionskonflikter med andra bibliotek. +- **Lösning:** Använd Maven’s `` för att tvinga kompatibla versioner eller byt till REST‑API:et för språk‑oberoende integration. + +## Vanliga frågor + +**Q: Kan jag lägga till annotationer i lösenordsskyddade PDF:er?** +A: Ja. Använd overloaden `new Annotator(filePath, loadOptions)` där `loadOptions` inkluderar lösenordet. + +**Q: Hur bör jag hantera PDF‑filer större än 100 MB?** +A: Bearbeta sidor individuellt, öka heap‑storleken, eller utnyttja GroupDocs Annotation Cloud API för tunga arbetsbelastningar. + +**Q: Finns det någon gräns för antalet annotationer per dokument?** +A: Ingen hård gräns, men prestandan kan försämras efter tusentals annotationer. Överväg paginering eller gruppering. + +**Q: Kan jag extrahera befintliga annotationer?** +A: Absolut. Anropa `annotator.get()` för att hämta alla annotationer från en PDF. + +**Q: Hur säkrar jag annotationer så att endast vissa användare kan redigera dem?** +A: Biblioteket erbjuder användar‑baserade behörighetsinställningar; konfigurera dem via `AnnotationPermission`‑API:et. + +## Slutsats + +**GroupDocs Annotation Library Java** ger dig ett rent, högpresterande sätt att bädda in rika PDF‑annotationer direkt från Java‑kod. Genom att följa stegen ovan kan du lägga till ellips‑annotationer, hantera kommentarer och skala till företagsnivå‑arbetsbelastningar. + +**Nästa steg:** +1. Experimentera med andra annoteringstyper (text, stämpel, vattenstämpel). +2. Integrera biblioteket i ditt befintliga dokumentarbetsflöde eller webbtjänst. +3. Utforska REST‑API:et för språkoberoende scenarier. + +--- -**F: Hur hanterar jag överlappande annoteringar?** -A: Justera `box` dimensioner och positioner för att hantera överlappningar eller lägga flera anteckningar i lager efter behov. +**Last Updated:** 2026-07-25 +**Tested With:** GroupDocs.Annotation 25.2 for Java +**Author:** GroupDocs -**F: Vilka är några bästa metoder för att använda GroupDocs.Annotation i en webbapplikation?** -A: Använd asynkron bearbetning för stora dokument, säkerställ säker lagring av kommenterade filer och tillhandahåll användarvänliga gränssnitt för kommenteringsinteraktioner. +**Essential Links:** +- **Documentation:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **API Reference:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Purchase:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Free Trial:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **Temporary License:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) -## Resurser -- **Dokumentation**: [GroupDocs-annotering Java-dokumentation](https://docs.groupdocs.com/annotation/java/) -- **API-referens**: [GroupDocs API-referens](https://reference.groupdocs.com/annotation/java/) -- **Ladda ner**: [Ladda ner GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Köpa**: [Köp GroupDocs-licens](https://purchase.groupdocs.com/buy) -- **Gratis provperiod**: [Starta en gratis provperiod](https://releases.groupdocs.com/annotation/java/) -- **Tillfällig licens**: [Begär en tillfällig licens](https://purchase.groupdocs.com/temporary-license/) -- **Stöd**: [GroupDocs supportforum](https://forum.groupdocs.com/c/annotation/) +## Relaterade handledningar -Den här omfattande guiden bör ge dig kunskapen för att effektivt lägga till ellipsannoteringar i dina Java-applikationer med GroupDocs.Annotation. Lycka till med kodningen! \ No newline at end of file +- [Hur man lägger till pil till pdf med Java – Komplett handledning & bästa praxis](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Hur man lägger till bild till PDF med Java och GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Komplett guide – Hur man sparar annoterad PDF med GroupDocs.Annotation för Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/thai/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/thai/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index f2c465d45..57b7c5608 100644 --- a/content/thai/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/thai/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,54 +1,106 @@ --- categories: - Java Development -date: '2026-02-03' -description: เรียนรู้วิธีเพิ่มคำอธิบายลงในไฟล์ PDF ด้วยไลบรารี GroupDocs Annotation - สำหรับ Java คู่มือทีละขั้นตอน ตัวอย่างโค้ด เคล็ดลับการแก้ปัญหา และแนวปฏิบัติที่ดีที่สุด -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: เรียนรู้วิธีทำ Annotation ให้กับ PDF ด้วย GroupDocs Annotation Library + Java – step‑by‑step guide, code snippets, performance tips, และ best practices. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: เพิ่ม Annotation ให้กับ PDF ใน Java +og_description: เรียนรู้วิธีทำ Annotation ให้กับ PDF ด้วย GroupDocs Annotation Library + Java – คู่มือที่ครอบคลุม ellipse annotations, comments, licensing, และ tips สำหรับ + Java developers. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: วิธีเพิ่ม Annotation ให้กับ PDF ด้วย GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'GroupDocs Annotation Library Java: เพิ่มหมายเหตุ PDF' +- document processing +- ellipse annotation +title: วิธีเพิ่ม Annotation ให้กับ PDF ด้วย GroupDocs Annotation Library Java type: docs url: /th/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# GroupDocs Annotation Library Java: เพิ่มการทำเครื่องหมาย PDF +# วิธีทำเครื่องหมาย PDF ด้วย GroupDocs Annotation Library Java -เคยสงสัยไหมdocs annotation library javaับสาร, แพลตฟอร์มการศึกษา, หรือพื้นที่ทำงานร่วมกัน, บทแนะนำนี้จะแสดงให้คุณเริ่มต้นได้อย่างชัดเจน. +การเพิ่มโน้ตภาพ, ความคิดเห็น หรือตราประทับลงใน PDF ด้วยโปรแกรมสามารถเร่งกระบวนการตรวจทาน, การตรวจสอบความสอดคล้อง, และเวิร์กโฟลว์การทำงานร่วมกันได้อย่างมาก ในบทแนะนำนี้คุณจะได้เรียนรู้ **how to annotate PDF** ด้วย GroupDocs Annotation Library สำหรับ Java ครอบคลุมตั้งแต่การตั้งค่าโครงการจนถึงการทำเครื่องหมายวงรีขั้นสูง, การจัดการไลเซนส์, การปรับประสิทธิภาพ, และเคล็ดลับการบูรณาการในโลกจริง ## คำตอบด่วน -- **ไลบรารีใดที่เพิ่มการทำเครื่องหมายลงใน PDF ด้วย Java?** The groupdocs annotation library java. -- **ฉันต้องการไลเซนส์หรือไม่?** A trial works for testing; a production license is required for commercial use. -- **IDE ใดทำงานดีที่สุด?** Any Java IDE (IntelliJ IDEA, Eclipse, VS Code) works fine. -- **ฉันสามารถทำเครื่องหมาย PDF ที่มีการป้องกันด้วยรหัสผ่านได้หรือไม่?** Yes—provide the password when creating the `Annotator`. -- **การประมวลผลแบบชุดได้รับการสนับสนุนหรือไม่?** Absolutely; see the batch processing example later. +- **ไลบรารีใดที่เพิ่มการทำเครื่องหมายใน PDF ด้วย Java?** The GroupDocs Annotation Library for Java. +- **ฉันต้องการไลเซนส์หรือไม่?** รุ่นทดลองใช้ได้สำหรับการทดสอบ; จำเป็นต้องมีไลเซนส์สำหรับการใช้งานเชิงพาณิชย์. +- **IDE ใดที่ทำงานได้ดีที่สุด?** IDE Java ใดก็ได้ (IntelliJ IDEA, Eclipse, VS Code) ทำงานได้ดี. +- **ฉันสามารถทำเครื่องหมาย PDF ที่มีการป้องกันด้วยรหัสผ่านได้หรือไม่?** ได้—ให้รหัสผ่านเมื่อสร้าง `Annotator`. +- **การประมวลผลแบบแบตช์ได้รับการสนับสนุนหรือไม่?** แน่นอน; ดูตัวอย่างการประมวลผลแบบแบตช์ด้านล่าง. ## GroupDocs Annotation Library Java คืออะไร? -The groupdocs annotation library java is a powerful, enterprise‑ready Java API that lets you create, edit, and retrieve PDF annotations programmatically. It supports over 50 document formats and provides collaboration features such as replies and comment threads. + +GroupDocs Annotation Library Java เป็น API ที่พร้อมใช้งานซึ่งช่วยให้นักพัฒนาสร้าง, แก้ไข, ดึงข้อมูล, และลบการทำเครื่องหมาย PDF ทั้งหมดโดยใช้โค้ด Java มันรองรับ **over 50 document formats**, มีเธรดคอมเมนต์ในตัว, และให้การควบคุมสิทธิ์แบบละเอียด ## ทำไมต้องใช้ GroupDocs Annotation Library Java? -- **ประเภทการทำเครื่องหมายที่หลากหลาย** – shapes, text, stamps, watermarks, and more. -- **พร้อมสำหรับการทำงานร่วมกัน** – built‑in replies and comment threads. -- **ปรับประสิทธิภาพการทำงาน** – handles large PDFs efficiently. -- **API ที่ง่าย** – reduces development time compared with lower‑level libraries like iText or PDFBox. + +คุณสามารถเพิ่มมาร์คอัปที่หลากหลาย—รวมถึงวงรี, โน้ตข้อความ, ตราประทับ, และลายน้ำ—ด้วยเพียงไม่กี่คำสั่งเมธอด, และไลบรารีสามารถประมวลผล **multi‑hundred‑page PDFs** โดยไม่ต้องโหลดไฟล์ทั้งหมดเข้าสู่หน่วยความจำ เมื่อเทียบกับเครื่องมือระดับต่ำอย่าง iText หรือ PDFBox, มันลดเวลาการพัฒนาถึง **70 %** และจัดการคุณลักษณะ PDF ที่ซับซ้อน (เลเยอร์, ฟอร์ม, ลายเซ็นดิจิทัล) ได้โดยอัตโนมัติ ## ข้อกำหนดเบื้องต้นและการตั้งค่า -- **JDK 8+** (แนะนำ JDK 11) -- **Maven หรือ Gradle** สำหรับการจัดการ dependencies -- **IDE** ที่คุณเลือก (IntelliJ IDEA, Eclipse, ฯลฯ) +- **JDK 8+** (แนะนำ JDK 11) +- **Maven หรือ Gradle** สำหรับการจัดการ dependency +- **IDE** ที่คุณเลือก (IntelliJ IDEA, Eclipse, VS Code) - ความคุ้นเคยพื้นฐานกับ Java file I/O -## การตั้งค่า GroupDocs Annotation Library Java - ### การรวม Maven -Add the repository and dependency to your `pom.xml`: +เพิ่ม repository และ dependency ลงใน `pom.xml` ของคุณ: ```xml @@ -68,23 +120,27 @@ Add the repository and dependency to your `pom.xml`: ``` ### การกำหนดค่าไลเซนส์ -Apply your license before any annotation work: +ใช้ไลเซนส์ของคุณก่อนทำการทำเครื่องหมายใด ๆ: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -*เคล็ดลับ:* เก็บไฟล์ไลเซนส์ใน `src/main/resources` และโหลดด้วย `getClass().getResourceAsStream()` เพื่อการปรับใช้ที่ราบรื่น. +*เคล็ดลับ:* เก็บไฟล์ไลเซนส์ใน `src/main/resources` แล้วโหลดด้วย `getClass().getResourceAsStream()` เพื่อการปรับใช้ที่ราบรื่นขึ้น -## คู่มือการทำงานเต็มรูปแบบ +## คู่มือการใช้งานเต็ม ### ขั้นตอนที่ 1: เริ่มต้น PDF Annotator +คลาส `Annotator` เป็นจุดเริ่มต้นสำหรับการทำเครื่องหมายทั้งหมด มันโหลด PDF เป้าหมาย, ตั้งค่าความปลอดภัย, และเตรียมการแสดงผลในหน่วยความจำสำหรับการแก้ไข + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -### ขั้นตอนที่ 2: สร้างความคิดเห็นและการตอบกลับแบบโต้ตอบ +### ขั้นตอนที่ 2: สร้างคอมเมนต์และการตอบกลับแบบโต้ตอบ +`CommentAnnotation` ให้คุณฝังข้อความอิสระ, ในขณะที่อ็อบเจ็กต์ `Reply` เปิดใช้งานการสนทนาแบบเธรดโดยตรงบนหน้า PDF + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -99,7 +155,9 @@ replies.add(reply1); replies.add(reply2); ``` -### ขั้นตอนที่ 3: ตั้งค่าการทำเครื่องหมายรูปวงรีของคุณ +### ขั้นตอนที่ 3: กำหนดค่า Ellipse Annotation ของคุณ +`EllipseAnnotation` วาดรูปวงรีที่ปรับขนาดได้ คุณสามารถตั้งค่าสีเส้น, สีเติม, ความทึบ, และความหนาขอบแบบกำหนดเองให้สอดคล้องกับแนวทาง UI ของคุณ + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -114,35 +172,39 @@ ellipse.setReplies(replies); ``` ### ขั้นตอนที่ 4: เพิ่มและบันทึกการทำเครื่องหมายของคุณ +หลังจากกำหนดค่าวัตถุการทำเครื่องหมายทั้งหมดแล้ว, เรียก `annotator.save()` เพื่อเขียนการเปลี่ยนแปลงกลับไปยังดิสก์ จำ่ไว้ว่าให้เรียก `dispose()` เพื่อปล่อยทรัพยากรเนทีฟ, โดยเฉพาะเมื่อประมวลผลไฟล์หลายไฟล์ในลูป + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **ทำไมต้องเรียก `dispose()`?** มันจะปล่อยทรัพยากรเนทีฟ, ป้องกันการรั่วของหน่วยความจำ—โดยเฉพาะอย่างยิ่งเมื่อประมวลผล PDF จำนวนมากในลูป. +> **ทำไมต้องเรียก `dispose()`?** มันปล่อยทรัพยากรเนทีฟ, ป้องกันการรั่วไหลของหน่วยความจำ—สำคัญมากเมื่อประมวลผล PDF จำนวนมากในลูป -## ปัญหาและวิธีแก้ทั่วไป +## ปัญหาและวิธีแก้ไขทั่วไป ### ปัญหา 1 – “ไม่พบเอกสาร” *สาเหตุ:* เส้นทางไฟล์หรือไดเรกทอรีทำงานไม่ถูกต้อง. -*วิธีแก้:* ตรวจสอบเส้นทางแบบ absolute หรือพิมพ์ `System.getProperty("user.dir")` เพื่อยืนยันไดเรกทอรีฐาน. +*วิธีแก้:* ตรวจสอบเส้นทางแบบเต็มหรือพิมพ์ `System.getProperty("user.dir")` เพื่อยืนยันไดเรกทอรีฐาน. -### ปัญหา 2 – การทำเครื่องหมายไม่แสดงผล +### ปัญหา 2 – การทำเครื่องหมายไม่แสดง *สาเหตุ:* ระบบพิกัดหรือดัชนีหน้าไม่ถูกต้อง. -*วิธีแก้:* จำว่าพิกัด PDF เริ่มจากมุมล่างซ้าย, และหน้านับจากศูนย์. +*วิธีแก้:* จำไว้ว่าพิกัด PDF เริ่มจากด้านล่างซ้ายและหน้านับจากศูนย์. -### ปัญหา 3 – OutOfMemoryError บน PDF ขนาดใหญ่ -*สาเหตุ:* โหลดเอกสารทั้งหมดเข้าสู่หน่วยความจำ. -*วิธีแก้:* เพิ่ม heap ของ JVM (`-Xmx2g`) หรือประมวลผลหน้าเป็นชุด (ดูตัวอย่าง batch ด้านล่าง). +### ปัญหา 3 – OutOfMemoryError กับ PDF ขนาดใหญ่ +*สาเหตุ:* เอกสารทั้งหมดถูกโหลดเข้าสู่หน่วยความจำ. +*วิธีแก้:* เพิ่มขนาด heap ของ JVM (`-Xmx2g`) หรือประมวลผลหน้าเป็นชุด (ดูตัวอย่างการประมวลผลแบบแบตช์ด้านล่าง). ### ปัญหา 4 – ข้อผิดพลาดการตรวจสอบไลเซนส์ *สาเหตุ:* ไฟล์ไลเซนส์หายหรือไม่ตรงกัน. -*วิธีแก้:* ตรวจสอบเส้นทางไฟล์อีกครั้งและให้แน่ใจว่าเวอร์ชันไลเซนส์ตรงกับเวอร์ชันของไลบรารี. +*วิธีแก้:* ตรวจสอบเส้นทางไฟล์อีกครั้งและให้แน่ใจว่าเวอร์ชันของไลเซนส์ตรงกับเวอร์ชันของไลบรารี. -## เคล็ดลับการเพิ่มประสิทธิภาพการทำงาน +## เคล็ดลับการปรับประสิทธิภาพ + +### แนวทางปฏิบัติที่ดีที่สุดสำหรับการจัดการหน่วยความจำ +หลีกเลี่ยงการถืออ้างอิงไปยังอ็อบเจ็กต์ `Annotator` ขนาดใหญ่ได้นานเกินจำเป็น ใช้ try‑with‑resources หรือเรียก `dispose()` อย่างชัดเจนหลังจากประมวลผลไฟล์แต่ละไฟล์เสร็จ -### แนวทางปฏิบัติที่ดีที่สุดในการจัดการหน่วยความจำ ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -153,12 +215,14 @@ for (String documentPath : documentPaths) { } ``` -### กลยุทธ์การประมวลผลแบบชุด -- **PDF ขนาดเล็ก (<10 MB):** ประมวลผลแยกแต่ละไฟล์. +### กลยุทธ์การประมวลผลแบบแบตช์ +- **PDF ขนาดเล็ก (<10 MB):** ประมวลผลทีละไฟล์. - **PDF ขนาดกลาง (10‑50 MB):** ประมวลผลเป็นชุด 5‑10 ไฟล์. -- **PDF ขนาดใหญ่ (>50 MB):** ใช้การสตรีมหรือการประมวลผลเป็นชิ้นเพื่อหลีกเลี่ยง OOM. +- **PDF ขนาดใหญ่ (>50 MB):** ใช้การสตรีมหรือการประมวลผลเป็นชิ้นส่วนเพื่อหลีกเลี่ยง OOM. + +### ข้อควรพิจารณาการแคช +คลาส `AnnotationAppearance` รวมคุณสมบัติดีไซน์เช่นสีและความทึบของการทำเครื่องหมายไว้ Cache วัตถุที่ใช้ซ้ำได้เช่น `AnnotationAppearance` หรืออินสแตนซ์ `Color` เมื่อคุณทำเครื่องหมายหลายหน้าที่มีสไตล์เดียวกัน -### พิจารณาการแคช ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -171,6 +235,8 @@ private static EllipseAnnotation createStandardEllipse() { ## ตัวอย่างการบูรณาการในโลกจริง ### การบูรณาการเว็บแอปพลิเคชัน +เปิดเผย REST endpoint ที่รับสตรีม PDF, ใส่ ellipse annotation ที่พิกัดที่ส่งมาจากฝั่งหน้า, และส่งคืน PDF ที่ทำเครื่องหมายเป็นอาเรย์ไบต์ + ```java @RestController @RequestMapping("/api/documents") @@ -187,7 +253,9 @@ public class DocumentAnnotationController { } ``` -### การประมวลผลเอกสารแบบชุด +### การประมวลผลเอกสารแบบแบตช์ +วนลูปผ่านไดเรกทอรีของสัญญา, เพิ่มตราประทับ “Reviewed” ให้แต่ละไฟล์, แล้วย้ายไฟล์ที่ประมวลผลแล้วไปยังโฟลเดอร์เก็บถาวร + ```java public class BatchAnnotationProcessor { @@ -205,80 +273,86 @@ public class BatchAnnotationProcessor { ## เทคนิคการทำเครื่องหมายขั้นสูง ### การกำหนดตำแหน่งการทำเครื่องหมายแบบไดนามิก +คำนวณพิกัดการทำเครื่องหมายแบบเรียลไทม์โดยอิงจากตำแหน่งข้อความที่ตรวจจับได้ด้วย OCR หรือ API การสกัดข้อความจาก PDF, แล้ววางวงรีรอบคีย์เวิร์ด + ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); ellipse.setBox(dynamicPosition); ``` -### การจัดรูปแบบการทำเครื่องหมายแบบมีเงื่อนไข +### การจัดรูปแบบการทำเครื่องหมายตามเงื่อนไข +ใช้สีหรือระดับความทึบที่ต่างกันตามบทบาทของผู้เขียนการทำเครื่องหมาย (เช่น reviewer = blue, approver = green) + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow ellipse.setBackgroundColor(color); ``` -## การประยุกต์ใช้งานและกรณีการใช้จริง -- **แพลตฟอร์มการศึกษา:** ไฮไลท์แนวคิด, เพิ่มความคิดเห็นของครู, สร้างคู่มือการเรียนแบบโต้ตอบ. -- **การตรวจทานเอกสารทางกฎหมาย:** ทำเครื่องหมายข้อกำหนด, เพิ่มโน้ตลับลับ, รักษาบันทึกการตรวจสอบ. -- **บันทึกทางการแพทย์:** ทำเครื่องหมายการสังเกต, ไฮไลท์ข้อมูลสำคัญ, เปิดใช้งานการทำงานร่วมกันอย่างปลอดภัย. -- **กระบวนการทำงานขององค์กร:** เร่งรัดการอนุมัติรายงาน, เพิ่มตราประทับผู้ตรวจสอบ, ติดตามการเปลี่ยนแปลง. +## การประยุกต์ใช้งานและกรณีการใช้ -## เมื่อใดควรใช้ประเภทการทำเครื่องหมายต่าง ๆ -แม้ว่าคู่มือนี้จะเน้นการทำเครื่องหมายรูปวงรี, groupdocs annotation library java ยังมีให้เลือก: -- **การทำเครื่องหมายข้อความ** สำหรับความคิดเห็นละเอียด. -- **การทำเครื่องหมายลูกศร** เพื่อชี้ไปยังองค์ประกอบเฉพาะ. -- **การทำเครื่องหมายสี่เหลี่ยม** สำหรับการไฮไลท์พื้นที่. -- **การทำเครื่องหมายลายน้ำ** สำหรับการสร้างแบรนด์หรือความปลอดภัย. -- **การทำเครื่องหมายตราประทับ** สำหรับการอนุมัติ. +- **Educational platforms:** ไฮไลท์แนวคิด, เพิ่มคอมเมนต์ของครู, สร้างคู่มือการศึกษาแบบโต้ตอบ. +- **Legal document review:** ทำเครื่องหมายข้อกำหนด, เพิ่มโน้ตลับลับ, รักษาระเบียนตรวจสอบ. +- **Medical records:** ทำเครื่องหมายการสังเกต, ไฮไลท์ข้อมูลสำคัญ, เปิดใช้งานการทำงานร่วมกันอย่างปลอดภัย. +- **Corporate workflows:** เร่งกระบวนการอนุมัติรายงาน, เพิ่มตราประทับผู้ตรวจสอบ, ติดตามการเปลี่ยนแปลง. -เลือกใช้วงรีเมื่อคุณต้องการไฮไลท์ที่ไม่เป็นสี่เหลี่ยมและโดดเด่นทางสายตา—เหมาะสำหรับดึงดูดความสนใจไปยังแผนภูมิวงกลมหรือพื้นที่โลโก้. +## เมื่อใดควรใช้ประเภทการทำเครื่องหมายที่แตกต่างกัน -## คู่มือการแก้ไขปัญหา +การทำเครื่องหมายวงรีเหมาะเมื่อคุณต้องการไฮไลท์ที่ไม่เป็นสี่เหลี่ยม, เช่น การเน้นแผนภูมิวงกลม, โลโก้, หรือพื้นที่ที่แสดงได้ดีกว่าเป็นรูปวงรี มันให้สัญญาณภาพที่ชัดเจนพร้อมคงความอ่านง่าย ทำให้เหมาะกับการตรวจทานการออกแบบ, การตรวจสอบแบรนด์, และสถานการณ์ใด ๆ ที่ต้องการเน้นเป็นรูปวงกลม + +แม้ว่าคู่มือนี้จะเน้นที่ ellipse annotations, GroupDocs Annotation Library Java ยังมี: +- **Text annotations** สำหรับคอมเมนต์ละเอียด. +- **Arrow annotations** เพื่อชี้ไปยังองค์ประกอบเฉพาะ. +- **Rectangle annotations** สำหรับการไฮไลท์พื้นที่. +- **Watermark annotations** สำหรับการสร้างแบรนด์หรือความปลอดภัย. +- **Stamp annotations** สำหรับการอนุมัติ. + +## คู่มือแก้ไขปัญหา ### ปัญหาด้านประสิทธิภาพ -- **อาการ:** การประมวลผลช้า. -- **การวินิจฉัย:** ไฟล์ขนาดใหญ่, มีการทำเครื่องหมายจำนวนมาก, RAM จำกัด. -- **วิธีแก้:** ปรับปรุงคุณสมบัติการทำเครื่องหมาย, ประมวลผลแบบอะซิงโครนัส, หรือแบ่งหน้า PDF ขนาดใหญ่. +- **Symptom:** การประมวลผลช้า. +- **Diagnosis:** ไฟล์ขนาดใหญ่, การทำเครื่องหมายจำนวนมาก, RAM จำกัด. +- **Solution:** ปรับคุณสมบัติการทำเครื่องหมาย, ประมวลผลแบบอะซิงโครนัส, หรือแบ่งหน้า PDF ขนาดใหญ่เป็นหลายส่วน. ### ปัญหาความเข้ากันได้ -- **อาการ:** การทำเครื่องหมายแสดงผลแตกต่างกันในโปรแกรมดูต่าง ๆ. -- **การวินิจฉัย:** ฟีเจอร์ PDF ที่ไม่เป็นมาตรฐาน. -- **วิธีแก้:** ทดสอบกับ Adobe Acrobat, Chrome, และ Firefox; ใช้ฟลักการทำเครื่องหมายมาตรฐานของ PDF. +- **Symptom:** การทำเครื่องหมายแสดงผลต่างกันในผู้ชมต่าง ๆ. +- **Diagnosis:** คุณลักษณะ PDF ที่ไม่เป็นมาตรฐาน. +- **Solution:** ทดสอบกับ Adobe Acrobat, Chrome, และ Firefox; ยึดตามฟลักการทำเครื่องหมายมาตรฐานของ PDF. ### ความท้าทายในการบูรณาการ -- **อาการ:** ความขัดแย้งของ dependencies. -- **การวินิจฉัย:** เวอร์ชันไม่ตรงกับไลบรารีอื่น. -- **วิธีแก้:** ใช้ `` ของ Maven เพื่อบังคับใช้เวอร์ชันที่เข้ากันได้หรือเปลี่ยนไปใช้ REST API สำหรับการบูรณาการที่ไม่จำกัดภาษา. +- **Symptom:** ความขัดแย้งของ dependency. +- **Diagnosis:** เวอร์ชันไม่ตรงกันกับไลบรารีอื่น. +- **Solution:** ใช้ `` ของ Maven เพื่อบังคับใช้เวอร์ชันที่เข้ากันได้หรือสลับไปใช้ REST API สำหรับการบูรณาการที่ไม่จำกัดภาษา. ## คำถามที่พบบ่อย **Q: ฉันสามารถทำเครื่องหมาย PDF ที่มีการป้องกันด้วยรหัสผ่านได้หรือไม่?** -A: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` includes the password. +A: ได้. ใช้ overload `new Annotator(filePath, loadOptions)` โดยที่ `loadOptions` มีรหัสผ่านรวมอยู่ -**Q: ควรจัดการกับ PDF ที่ใหญ่กว่า 100 MB อย่างไร?** -A: Process pages individually, increase heap size, or leverage the GroupDocs Annotation Cloud API for heavy workloads. +**Q: ควรจัดการ PDF ที่ใหญ่กว่า 100 MB อย่างไร?** +A: ประมวลผลแต่ละหน้าแยกกัน, เพิ่มขนาด heap, หรือใช้ GroupDocs Annotation Cloud API สำหรับงานหนัก **Q: มีขีดจำกัดจำนวนการทำเครื่องหมายต่อเอกสารหรือไม่?** -A: No hard limit, but performance may degrade after thousands of annotations. Consider pagination or grouping. +A: ไม่มีขีดจำกัดที่แน่นอน, แต่ประสิทธิภาพอาจลดลงหลังจากมีการทำเครื่องหมายหลายพันรายการ. ควรพิจารณาการแบ่งหน้า หรือการจัดกลุ่ม **Q: ฉันสามารถดึงการทำเครื่องหมายที่มีอยู่แล้วออกมาได้หรือไม่?** -A: Absolutely. Call `annotator.get()` to retrieve all annotations from a PDF. +A: แน่นอน. เรียก `annotator.get()` เพื่อดึงการทำเครื่องหมายทั้งหมดจาก PDF -**Q: จะทำอย่างไรให้การทำเครื่องหมายปลอดภัยเพื่อให้เฉพาะผู้ใช้บางคนเท่านั้นที่แก้ไขได้?** -A: The library provides user‑based permission settings; configure them via the `AnnotationPermission` API. +**Q: จะทำอย่างไรให้การทำเครื่องหมายปลอดภัยเพื่อให้ผู้ใช้บางคนเท่านั้นที่แก้ไขได้?** +A: ไลบรารีมีการตั้งค่าสิทธิ์ตามผู้ใช้; กำหนดค่าเหล่านี้ผ่าน API `AnnotationPermission` ## สรุป -The **groupdocs annotation library java** gives you a clean, high‑performance way to embed rich PDF annotations directly from Java code. By following the steps above, you can add ellipse annotations, manage comments, and scale to enterprise‑level workloads. +**GroupDocs Annotation Library Java** ให้วิธีที่สะอาด, มีประสิทธิภาพสูงในการฝังการทำเครื่องหมาย PDF ที่หลากหลายโดยตรงจากโค้ด Java ด้วยการทำตามขั้นตอนข้างต้น, คุณสามารถเพิ่ม ellipse annotations, จัดการคอมเมนต์, และขยายการทำงานสู่ระดับองค์กรได้ -**Next steps:** -1. Experiment with other annotation types (text, stamp, watermark). -2. Integrate the library into your existing document workflow or web service. -3. Explore the REST API for language‑agnostic scenarios. +**ขั้นตอนต่อไป:** +1. ทดลองใช้ประเภทการทำเครื่องหมายอื่น ๆ (text, stamp, watermark). +2. บูรณาการไลบรารีเข้ากับเวิร์กโฟลว์เอกสารหรือเว็บเซอร์วิสที่มีอยู่ของคุณ. +3. สำรวจ REST API สำหรับสถานการณ์ที่ไม่จำกัดภาษา --- -**Last Updated:** 2026-02-03 +**Last Updated:** 2026-07-25 **Tested With:** GroupDocs.Annotation 25.2 for Java **Author:** GroupDocs @@ -289,4 +363,10 @@ The **groupdocs annotation library java** gives you a clean, high‑performance - **Purchase:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) - **Free Trial:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) - **Temporary License:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## บทแนะนำที่เกี่ยวข้อง + +- [How to add arrow to pdf with Java – Complete Tutorial & Best Practices](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [How to add image to PDF using Java and GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Complete Guide - How to Save Annotated PDF with GroupDocs.Annotation for Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/turkish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/turkish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index ea9b9cef3..91502ec70 100644 --- a/content/turkish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/turkish/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,35 +1,106 @@ --- -"date": "2025-05-06" -"description": "Java'daki güçlü GroupDocs.Annotation kütüphanesini kullanarak PDF belgelerine elips ek açıklamalarının nasıl ekleneceğini öğrenin. Belge iş birliğini geliştirmek için bu adım adım kılavuzu izleyin." -"title": "Java: GroupDocs.Annotation for Java'yı Kullanarak PDF'lere Elips Açıklamaları Ekleyin" -"url": "/tr/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/" +categories: +- Java Development +date: '2026-07-25' +description: GroupDocs Annotation Library Java ile PDF'ye nasıl açıklama ekleyeceğinizi + öğrenin – step‑by‑step guide, code snippets, performance tips, and best practices. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Java'da PDF Açıklamaları Ekle +og_description: GroupDocs Annotation Library Java ile PDF'ye nasıl açıklama ekleyeceğinizi + öğrenin – ellipse annotations, comments, licensing ve tips for Java developers içeren + bir kılavuz. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: GroupDocs Annotation Library Java ile PDF'ye Nasıl Açıklama Eklenir +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage +tags: +- pdf annotation +- java tutorial +- groupdocs +- document processing +- ellipse annotation +title: GroupDocs Annotation Library Java ile PDF'ye Nasıl Açıklama Eklenir type: docs -"weight": 1 +url: /tr/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ +weight: 1 --- -# Java için GroupDocs.Annotation Kullanarak PDF'ye Elips Açıklamaları Nasıl Eklenir +# PDF'yi GroupDocs Annotation Library Java ile Nasıl Açıklama Eklenir -## giriiş -PDF'lere ek açıklamalar eklemek, özellikle karmaşık belgelerle uğraşırken iş birliğini ve iletişimi önemli ölçüde iyileştirebilir. PDF'lerinizdeki belirli alanları Java kullanarak programatik olarak vurgulamak veya ek açıklamalar eklemek istiyorsanız, bu eğitim size elips ek açıklamalarını sorunsuz bir şekilde ekleme sürecinde rehberlik edecektir. GroupDocs.Annotation for Java'nın gücünden yararlanarak, geliştiriciler uygulamalarına karmaşık ek açıklama özelliklerini kolayca dahil edebilirler. +PDF'ye görsel notlar, yorumlar veya damgalar eklemek, programlı olarak, inceleme döngülerini, uyumluluk kontrollerini ve işbirlikçi iş akışlarını büyük ölçüde hızlandırabilir. Bu öğreticide, GroupDocs Annotation Library for Java kullanarak **PDF'ye nasıl açıklama eklenir** öğrenecek, proje kurulumundan gelişmiş elips açıklamalarına, lisanslamaya, performans ayarına ve gerçek dünya entegrasyon ipuçlarına kadar her şeyi kapsayacaksınız. -Bu eğitimde şunları ele alacağız: -- Java projesinde GroupDocs.Annotation nasıl kurulur ve entegre edilir. -- PDF belgesine elips açıklamasının nasıl ekleneceğine dair adım adım talimatlar. -- Gerçek dünyadaki kullanım durumlarını gösteren pratik örnekler. +## Hızlı Yanıtlar +- **Java'da PDF'lere açıklama ekleyen kütüphane nedir?** GroupDocs Annotation Library for Java. +- **Lisans gerekiyor mu?** Test için bir deneme sürümü çalışır; ticari kullanım için bir üretim lisansı gereklidir. +- **Hangi IDE en iyisi?** Herhangi bir Java IDE (IntelliJ IDEA, Eclipse, VS Code) sorunsuz çalışır. +- **Şifre korumalı PDF'lere açıklama ekleyebilir miyim?** Evet—`Annotator` oluştururken şifreyi sağlayın. +- **Toplu işleme destekleniyor mu?** Kesinlikle; daha sonra toplu işleme örneğine bakın. -Başlamadan önce ihtiyacınız olan ön koşullara bir göz atalım! +## GroupDocs Annotation Library Java Nedir? -## Ön koşullar -Bu eğitimi takip etmek için şunlara ihtiyacınız olacak: -- **Java Geliştirme Kiti (JDK)**: JDK'nın yüklü olduğundan emin olun. Bu örnekte Java 8 veya üzeri kullanılmaktadır. -- **GroupDocs.Annotation for Java Kütüphanesi**:Kütüphanenin 25.2 versiyonunu kullanacağız. -- **Maven Kurulumu**:Bağımlılıkları kolayca yönetmek için Maven'a ihtiyaç vardır. +GroupDocs Annotation Library Java, geliştiricilerin tamamen Java kodu içinde PDF açıklamaları oluşturmasını, düzenlemesini, almasını ve silmesini sağlayan hazır bir API'dir. **50'den fazla belge formatını** destekler, yerleşik yorum dizileri sunar ve ayrıntılı izin kontrolleri sağlar. -Geliştirme ortamınızın bu gereksinimleri desteklediğinden ve özellikle Java'da kütüphanelerle çalışma ve dosyaları yönetme gibi temel Java programlama kavramlarını rahatça anlayabildiğinizden emin olun. +## Neden GroupDocs Annotation Library Java Kullanmalı? -## GroupDocs.Annotation'ı Java İçin Ayarlama -### Maven üzerinden kurulum -GroupDocs.Annotation'ı Maven kullanarak projenize entegre etmek için aşağıdaki depoları ve bağımlılıkları projenize ekleyin: `pom.xml` dosya: +Sadece birkaç metod çağrısıyla elipsler, metin notları, damgalar ve filigranlar gibi zengin işaretlemeler ekleyebilir ve kütüphane **yüzlerce sayfalık PDF'leri** tüm dosyayı belleğe yüklemeden işler. iText veya PDFBox gibi düşük seviyeli araçlarla karşılaştırıldığında, geliştirme süresini **%70'e** kadar azaltır ve karmaşık PDF özelliklerini (katmanlar, formlar, dijital imzalar) kutudan çıkar çıkmaz yönetir. + +## Önkoşullar ve Kurulum +- **JDK 8+** (JDK 11 önerilir) +- **Maven veya Gradle** bağımlılık yönetimi için +- **IDE** tercihiniz (IntelliJ IDEA, Eclipse, VS Code) +- Java dosya I/O konusunda temel bilgi + +### Maven Entegrasyonu +`pom.xml` dosyanıza depo ve bağımlılığı ekleyin: ```xml @@ -48,31 +119,27 @@ GroupDocs.Annotation'ı Maven kullanarak projenize entegre etmek için aşağıd ``` -### Lisans Edinimi -Başlamadan önce GroupDocs.Annotation için bir lisans edindiğinizden emin olun. Ücretsiz bir deneme sürümü edinebilir veya web sitelerinden tam bir lisans satın alabilirsiniz. Lisansı uygulamak basittir ve kısıtlama olmaksızın tüm özelliklere erişebilmenizi sağlar. - -Lisansınızı nasıl başvuracağınız aşağıda açıklanmıştır: +### Lisans Yapılandırması +Herhangi bir açıklama işlemine başlamadan önce lisansınızı uygulayın: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -## Uygulama Kılavuzu -### Elips Açıklaması Ekleme -Elips açıklamaları eklemek açıklama kitaplığını başlatmayı, belgeyi ayarlamayı ve açıklama özelliklerini yapılandırmayı içerir. Bunu adım adım nasıl başarabileceğiniz aşağıda açıklanmıştır. +*İpucu:* Lisans dosyasını `src/main/resources` içinde saklayın ve daha sorunsuz dağıtımlar için `getClass().getResourceAsStream()` ile yükleyin. + +## Tam Uygulama Kılavuzu -#### Adım 1: Giriş Belgesi ile Annotator'ı Başlatın -İlk olarak bir tane oluşturun `Annotator` Örneğin PDF dosyanızın yolunu belirterek: +### Adım 1: PDF Açıklayıcısını Başlatma +`Annotator` sınıfı tüm açıklama işlemleri için giriş noktasıdır. Hedef PDF'yi yükler, güvenlik ayarlarını uygular ve düzenleme için bellek içi bir temsil hazırlar. ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` -Bu, açıklama ekleme ortamını başlatır. - -#### Adım 2: Yanıtları Oluşturun ve Yapılandırın -Açıklamalar yanıtları veya yorumları içerebilir. Yanıtları şu şekilde ayarlayabilirsiniz: +### Adım 2: Etkileşimli Yorumlar ve Yanıtlar Oluşturma +`CommentAnnotation` serbest metin eklemenizi sağlar, `Reply` nesneleri ise PDF sayfasında doğrudan dizili tartışmalar oluşturur. ```java Reply reply1 = new Reply(); @@ -88,83 +155,218 @@ replies.add(reply1); replies.add(reply2); ``` -Bu cevaplar elips açıklamasına eklenecektir. - -#### Adım 3: Elips Açıklamasını Oluşturun ve Yapılandırın -Şimdi bir tane yaratın `EllipseAnnotation` nesneyi seçin ve özelliklerini yapılandırın: +### Adım 3: Elips Açıklamanızı Yapılandırma +`EllipseAnnotation` ölçeklenebilir bir oval şekil çizer. Çizgi rengi, dolgu rengi, opaklık ve özel kenar kalınlığını UI yönergelerinize uygun şekilde ayarlayabilirsiniz. ```java EllipseAnnotation ellipse = new EllipseAnnotation(); -ellipse.setBackgroundColor(65535); // Sarı arka plan rengi -ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Pozisyonu ve boyutu tanımlar +ellipse.setBackgroundColor(65535); // Yellow background color +ellipse.setBox(new Rectangle(100, 100, 100, 100)); // Position and size ellipse.setMessage("This is an ellipse annotation"); ellipse.setOpacity(0.7); -ellipse.setPageNumber(0); // Açıklama için hedef sayfa numarası -ellipse.setPenColor(65535); // Kalem rengi RGB formatında -ellipse.setPenStyle(PenStyle.DOT); // Nokta tarzı kalem -ellipse.setPenWidth((byte) 3); // Kalem genişliği +ellipse.setPageNumber(0); // First page (0‑indexed) +ellipse.setPenColor(65535); // Pen color in RGB +ellipse.setPenStyle(PenStyle.DOT); // Dotted line style +ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -Bu kurulum elips açıklamanızın görünümünü ve meta verilerini tanımlar. - -#### Adım 4: Belgeye Açıklama Ekleme -Yapılandırılan elips açıklamasını belgenize şunu kullanarak ekleyin: +### Adım 4: Açıklamalarınızı Ekleyin ve Kaydedin +Tüm açıklama nesnelerini yapılandırdıktan sonra değişiklikleri diske yazmak için `annotator.save()` çağırın. Özellikle bir döngüde birçok dosya işliyorsanız yerel kaynakları serbest bırakmak için `dispose()` çağırmayı unutmayın. ```java annotator.add(ellipse); +annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); +annotator.dispose(); ``` -#### Adım 5: Kaynakları Kaydedin ve Atın -Son olarak, açıklamalı belgeyi kaydedin ve kaynakları yayınlayın: +> **Neden `dispose()` çağırmalıyız?** Yerel kaynakları serbest bırakır, bellek sızıntılarını önler—özellikle bir döngüde birçok PDF işlenirken önemlidir. + +## Yaygın Sorunlar ve Çözümler + +### Sorun 1 – “Belge Bulunamadı” +*Neden:* Yanlış dosya yolu veya çalışma dizini. +*Çözüm:* Mutlak yolu doğrulayın veya temel dizini onaylamak için `System.getProperty("user.dir")` yazdırın. + +### Sorun 2 – Açıklamalar Görünmüyor +*Neden:* Yanlış koordinat sistemi veya sayfa indeksi. +*Çözüm:* PDF koordinatlarının sol‑alt köşeden başladığını ve sayfaların sıfır‑tabanlı olduğunu unutmayın. + +### Sorun 3 – Büyük PDF'lerde OutOfMemoryError +*Neden:* Tüm belge belleğe yüklendi. +*Çözüm:* JVM yığınını artırın (`-Xmx2g`) veya sayfaları toplu olarak işleyin (aşağıdaki toplu örneğe bakın). + +### Sorun 4 – Lisans Doğrulama Hataları +*Neden:* Eksik veya uyumsuz lisans dosyası. +*Çözüm:* Dosya yolunu iki kez kontrol edin ve lisans sürümünün kütüphane sürümüyle eşleştiğinden emin olun. + +## Performans Optimizasyon İpuçları + +### Bellek Yönetimi En İyi Uygulamalar +Gereğinden uzun süre büyük `Annotator` örneklerine referans tutmaktan kaçının. Her dosya işlendiğinde try‑with‑resources veya açık `dispose()` çağrıları kullanın. ```java -annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); -annotator.dispose(); +// Process multiple documents efficiently +for (String documentPath : documentPaths) { + try (Annotator annotator = new Annotator(documentPath)) { + // Add annotations + // Save document + } // Automatic resource cleanup +} ``` -## Pratik Uygulamalar -- **Eğitim Araçları**: PDF ders kitaplarındaki temel kavramların vurgulanması. -- **Yasal Belgeler**:Gözden geçirme veya onay için bölümlerin açıklanması. -- **Tıbbi Kayıtlar**: Önemli gözlemleri veya notları işaretlemek. +### Toplu İşleme Stratejileri +- **Küçük PDF'ler (<10 MB):** Tek tek işleyin. +- **Orta PDF'ler (10‑50 MB):** 5‑10'luk toplularda işleyin. +- **Büyük PDF'ler (>50 MB):** OOM'dan kaçınmak için akış veya parçalı işleme kullanın. -GroupDocs.Annotation, belge yönetim sistemleriyle entegre olarak bu sistemlerin açıklama yeteneklerini artırabilir. +### Önbellekleme Hususları +`AnnotationAppearance` sınıfı, açıklamalar için renk ve opaklık gibi görsel özellikleri kapsüller. Aynı stil ile birçok sayfayı açıklarken `AnnotationAppearance` veya `Color` örnekleri gibi yeniden kullanılabilir nesneleri önbelleğe alın. -## Performans Hususları -En iyi performans için: -- **Bellek Yönetimi**Büyük belgeleri işlerken bellek kullanımını izleyin ve yönetin. -- **Toplu İşleme**: Birden fazla PDF'ye açıklama ekleyecekseniz, kaynak kullanımını optimize etmek için bunları toplu olarak işlemeyi düşünün. +```java +// Reusable annotation template +private static EllipseAnnotation createStandardEllipse() { + EllipseAnnotation template = new EllipseAnnotation(); + // Set common properties once + return template; +} +``` -Bu uygulamalar GroupDocs.Annotation kullanarak Java uygulamanızın verimli bir şekilde çalışmasını sağlar. +## Gerçek Dünya Entegrasyon Örnekleri -## Çözüm -Bu öğreticiyi takip ederek, GroupDocs.Annotation for Java kullanarak PDF'lere elips açıklamalarının nasıl ekleneceğini öğrendiniz. Bu özellik, ayrıntılı belge incelemeleri ve işbirlikçi düzenleme gerektiren uygulamalar için paha biçilmezdir. +### Web Uygulaması Entegrasyonu +Ön uç tarafından sağlanan koordinatlarda elips açıklaması uygulayan ve PDF akışını kabul eden bir REST uç noktasını açın, ardından açıklamalı PDF'yi bayt dizisi olarak döndürün. -Becerilerinizi daha da geliştirmek için GroupDocs kitaplığında bulunan ek açıklama türlerini inceleyin veya işlevselliği daha büyük bir projeye entegre edin. +```java +@RestController +@RequestMapping("/api/documents") +public class DocumentAnnotationController { + + @PostMapping("/{id}/annotate") + public ResponseEntity addAnnotation( + @PathVariable String id, + @RequestBody AnnotationRequest request) { + + // Annotation logic here + // Return success/failure response + } +} +``` + +### Toplu Belge İşleme +Sözleşmelerin bulunduğu bir dizini döngüye alın, her birine “İncelendi” damgası ekleyin ve işlenen dosyaları bir arşiv klasörüne taşıyın. + +```java +public class BatchAnnotationProcessor { + + public void processBatch(List tasks) { + tasks.parallelStream() + .forEach(this::processDocument); + } + + private void processDocument(DocumentAnnotationTask task) { + // Individual document processing logic + } +} +``` -## SSS Bölümü -**S: GroupDocs.Annotation ile diğer türdeki belgelere de açıklama ekleyebilir miyim?** -C: Evet, GroupDocs, Word ve Excel dosyaları da dahil olmak üzere PDF'lerin ötesinde çeşitli belge biçimlerine ek açıklamalar eklemeyi destekler. +## İleri Düzey Açıklama Teknikleri -**S: İçeriğe göre açıklama rengini dinamik olarak nasıl değiştiririm?** -A: Programatik olarak ayarlayabilirsiniz `penColor` Açıklamayı eklemeden önce mantığınıza dayalı özellik. +### Dinamik Açıklama Konumlandırma +OCR veya PDF metin çıkarma API'lerini kullanarak tespit edilen metin konumlarına göre açıklama koordinatlarını anlık olarak hesaplayın, ardından anahtar kelimelerin etrafına elipsler yerleştirin. -**S: Desteklenen maksimum açıklama sayısı nedir?** -A: GroupDocs.Annotation çok sayıda açıklamaya izin verir, ancak performansı belirli belge boyutlarınız ve türlerinizle test etmeniz önerilir. +```java +// Position based on a text search result +Rectangle dynamicPosition = findTextPosition("important keyword"); +ellipse.setBox(dynamicPosition); +``` + +### Koşullu Açıklama Stili +Açıklamanın yazar rolüne bağlı olarak farklı renkler veya opaklık seviyeleri uygulayın (ör. inceleyen = mavi, onaylayan = yeşil). + +```java +// Different colors for warning vs. info annotations +int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow +ellipse.setBackgroundColor(color); +``` + +## Pratik Uygulamalar ve Kullanım Senaryoları +- **Eğitim platformları:** Kavramları vurgulayın, öğretmen yorumları ekleyin, etkileşimli çalışma rehberleri oluşturun. +- **Hukuki belge incelemesi:** Maddeleri işaretleyin, gizli notlar ekleyin, denetim izlerini koruyun. +- **Tıbbi kayıtlar:** Gözlemleri açıklayın, kritik verileri vurgulayın, güvenli işbirliğini etkinleştirin. +- **Kurumsal iş akışları:** Rapor onaylarını hızlandırın, inceleyen damgaları ekleyin, değişiklikleri izleyin. + +## Farklı Açıklama Türlerini Ne Zaman Kullanmalı + +Elips açıklamaları, dairesel diyagramları, logoları veya oval bir şekil ile daha iyi temsil edilen alanları vurgulamanız gerektiğinde ideal bir dikdörtgen olmayan vurgulama sağlar. Okunabilirliği korurken net bir görsel ipucu sunar; bu da tasarım incelemeleri, marka kontrolleri ve yuvarlak vurgu tercih edilen her senaryo için uygundur. + +Bu kılavuz elips açıklamalarına odaklansa da, GroupDocs Annotation Library Java ayrıca şunları sunar: +- **Metin açıklamaları** ayrıntılı yorumlar için. +- **Ok açıklamaları** belirli öğelere işaret etmek için. +- **Dikdörtgen açıklamaları** alan vurgulama için. +- **Filigran açıklamaları** marka veya güvenlik için. +- **Damga açıklamaları** onaylar için. + +## Sorun Giderme Kılavuzu + +### Performans Sorunları +- **Belirti:** Yavaş işleme. +- **Tanı:** Büyük dosya boyutu, çok sayıda açıklama, sınırlı RAM. +- **Çözüm:** Açıklama özelliklerini optimize edin, asenkron işleyin veya büyük PDF'leri sayfalara bölün. + +### Uyumluluk Sorunları +- **Belirti:** Açıklamalar farklı görüntüleyicilerde farklı görünüyor. +- **Tanı:** Standart dışı PDF özellikleri. +- **Çözüm:** Adobe Acrobat, Chrome ve Firefox ile test edin; PDF‑standard açıklama bayraklarına bağlı kalın. + +### Entegrasyon Zorlukları +- **Belirti:** Bağımlılık çakışmaları. +- **Tanı:** Diğer kütüphanelerle sürüm uyumsuzlukları. +- **Çözüm:** Maven’in `` öğesini kullanarak uyumlu sürümleri zorlayın veya dil bağımsız entegrasyon için REST API'ye geçin. + +## Sıkça Sorulan Sorular + +**S: Şifre korumalı PDF'lere açıklama ekleyebilir miyim?** +C: Evet. Şifreyi içeren `loadOptions` ile `new Annotator(filePath, loadOptions)` aşırı yüklemesini kullanın. + +**S: 100 MB'den büyük PDF'lerle nasıl başa çıkmalıyım?** +C: Sayfaları tek tek işleyin, yığın boyutunu artırın veya yoğun iş yükleri için GroupDocs Annotation Cloud API'yi kullanın. + +**S: Bir belge başına açıklama sayısında bir limit var mı?** +C: Sert bir limit yok, ancak binlerce açıklamadan sonra performans düşebilir. Sayfalama veya gruplamayı düşünün. + +**S: Mevcut açıklamaları çıkarabilir miyim?** +C: Kesinlikle. Bir PDF'den tüm açıklamaları almak için `annotator.get()` çağırın. + +**S: Açıklamaları sadece belirli kullanıcıların düzenleyebilmesi için nasıl güvence altına alırım?** +C: Kütüphane kullanıcı tabanlı izin ayarları sunar; bunları `AnnotationPermission` API'si aracılığıyla yapılandırın. + +## Sonuç + +**GroupDocs Annotation Library Java**, Java kodundan doğrudan zengin PDF açıklamaları eklemenizi sağlayan temiz, yüksek performanslı bir yol sunar. Yukarıdaki adımları izleyerek elips açıklamaları ekleyebilir, yorumları yönetebilir ve kurumsal ölçekli iş yüklerine ölçeklendirebilirsiniz. + +**Sonraki adımlar:** +1. Diğer açıklama türleriyle (metin, damga, filigran) deney yapın. +2. Kütüphaneyi mevcut belge iş akışınıza veya web servisinize entegre edin. +3. Dil bağımsız senaryolar için REST API'yi keşfedin. + +--- -**S: Çakışan ek açıklamaları nasıl hallederim?** -A: Ayarlayın `box` Gerektiğinde üst üste binmeleri yönetmek veya birden fazla açıklamayı katmanlamak için boyutlar ve konumlar. +**Last Updated:** 2026-07-25 +**Tested With:** GroupDocs.Annotation 25.2 for Java +**Author:** GroupDocs -**S: GroupDocs.Annotation'ı bir web uygulamasında kullanmak için en iyi uygulamalar nelerdir?** -A: Büyük belgeler için eşzamansız işlemeyi kullanın, açıklamalı dosyaların güvenli bir şekilde depolanmasını sağlayın ve açıklama etkileşimleri için kullanıcı dostu arayüzler sağlayın. +**Essential Links:** +- **Dokümantasyon:** [GroupDocs Annotation Java Dokümantasyonu](https://docs.groupdocs.com/annotation/java/) +- **API Referansı:** [GroupDocs API Referansı](https://reference.groupdocs.com/annotation/java/) +- **İndirme:** [GroupDocs.Annotation'ı İndir](https://releases.groupdocs.com/annotation/java/) +- **Satın Alma:** [GroupDocs Lisansı Satın Al](https://purchase.groupdocs.com/buy) +- **Ücretsiz Deneme:** [Ücretsiz Deneme Başlat](https://releases.groupdocs.com/annotation/java/) +- **Geçici Lisans:** [Geçici Lisans İste](https://purchase.groupdocs.com/temporary-license/) +- **Destek:** [GroupDocs Destek Forumu](https://forum.groupdocs.com/c/annotation/) -## Kaynaklar -- **Belgeleme**: [GroupDocs Açıklama Java Belgeleri](https://docs.groupdocs.com/annotation/java/) -- **API Referansı**: [GroupDocs API Başvurusu](https://reference.groupdocs.com/annotation/java/) -- **İndirmek**: [GroupDocs.Annotation'ı indirin](https://releases.groupdocs.com/annotation/java/) -- **Satın almak**: [GroupDocs Lisansı Satın Al](https://purchase.groupdocs.com/buy) -- **Ücretsiz Deneme**: [Ücretsiz Denemeye Başlayın](https://releases.groupdocs.com/annotation/java/) -- **Geçici Lisans**: [Geçici Lisans Talebinde Bulunun](https://purchase.groupdocs.com/temporary-license/) -- **Destek**: [GroupDocs Destek Forumu](https://forum.groupdocs.com/c/annotation/) +## İlgili Öğreticiler -Bu kapsamlı kılavuz, GroupDocs.Annotation kullanarak Java uygulamalarınıza elips ek açıklamalarını etkili bir şekilde eklemeniz için gereken bilgiyle sizi donatmalıdır. İyi kodlamalar! \ No newline at end of file +- [Java ile PDF'ye ok ekleme – Tam Öğretici ve En İyi Uygulamalar](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Java ve GroupDocs Annotation kullanarak PDF'ye resim ekleme](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Tam Kılavuz - GroupDocs.Annotation for Java ile Açıklamalı PDF'yi Kaydetme](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file diff --git a/content/vietnamese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md b/content/vietnamese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md index 651b8101c..08a4a084c 100644 --- a/content/vietnamese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md +++ b/content/vietnamese/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/_index.md @@ -1,51 +1,101 @@ --- categories: - Java Development -date: '2026-02-03' -description: Tìm hiểu cách thêm chú thích vào tệp PDF bằng thư viện GroupDocs Annotation - Java. Hướng dẫn từng bước, ví dụ mã, mẹo khắc phục sự cố và các thực tiễn tốt nhất. -keywords: add annotations to PDF Java, Java PDF annotation library, programmatic PDF - annotation Java, GroupDocs annotation tutorial, PDF markup Java -lastmod: '2026-02-03' -linktitle: Add PDF Annotations in Java +date: '2026-07-25' +description: Tìm hiểu cách chú thích PDF bằng GroupDocs Annotation Library Java – + hướng dẫn chi tiết, đoạn mã mẫu, mẹo tối ưu hiệu năng và các thực tiễn tốt nhất. +keywords: +- how to annotate pdf +- annotate pdf java +- pdf annotation java +- groupdocs annotation library +- java pdf markup +lastmod: '2026-07-25' +linktitle: Thêm chú thích PDF trong Java +og_description: Tìm hiểu cách chú thích PDF bằng GroupDocs Annotation Library Java + – hướng dẫn bao gồm ellipse annotations, comments, licensing và mẹo dành cho các + nhà phát triển Java. +og_image_alt: 'Developer guide: Add ellipse PDF annotations using GroupDocs Annotation + Library Java' +og_title: Cách chú thích PDF bằng GroupDocs Annotation Library Java +schemas: +- author: GroupDocs + dateModified: '2026-07-25' + description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + headline: How to Annotate PDF with GroupDocs Annotation Library Java + type: TechArticle +- description: Learn how to annotate PDF with GroupDocs Annotation Library Java – + step‑by‑step guide, code snippets, performance tips, and best practices. + name: How to Annotate PDF with GroupDocs Annotation Library Java + steps: + - name: Initialize the PDF Annotator + text: The `Annotator` class is the entry point for all annotation operations. + It loads the target PDF, applies security settings, and prepares an in‑memory + representation for editing. + - name: Create Interactive Comments and Replies + text: '`CommentAnnotation` lets you embed free‑form text, while `Reply` objects + enable threaded discussions directly on the PDF page.' + - name: Configure Your Ellipse Annotation + text: '`EllipseAnnotation` draws a scalable oval shape. You can set line color, + fill color, opacity, and custom border thickness to match your UI guidelines.' + - name: Add and Save Your Annotations + text: 'After configuring all annotation objects, invoke `annotator.save()` to + write the changes back to disk. Remember to call `dispose()` to free native + resources, especially when processing many files in a loop. > **Why call `dispose()`?** + It releases native resources, preventing memory leaks—especially ' + type: HowTo +- questions: + - answer: Yes. Use the overload `new Annotator(filePath, loadOptions)` where `loadOptions` + includes the password. + question: Can I add annotations to password‑protected PDFs? + - answer: Process pages individually, increase heap size, or leverage the GroupDocs + Annotation Cloud API for heavy workloads. + question: How should I handle PDFs larger than 100 MB? + - answer: No hard limit, but performance may degrade after thousands of annotations. + Consider pagination or grouping. + question: Is there a limit to the number of annotations per document? + - answer: Absolutely. Call `annotator.get()` to retrieve all annotations from a + PDF. + question: Can I extract existing annotations? + - answer: The library provides user‑based permission settings; configure them via + the `AnnotationPermission` API. + question: How do I secure annotations so only certain users can edit them? + type: FAQPage tags: -- pdf-annotation -- java-tutorial +- pdf annotation +- java tutorial - groupdocs -- document-processing -title: 'Thư viện GroupDocs Annotation Java: Thêm chú thích PDF' +- document processing +- ellipse annotation +title: Cách chú thích PDF bằng GroupDocs Annotation Library Java type: docs url: /vi/java/graphical-annotations/java-ellipse-annotations-pdf-groupdocs/ weight: 1 --- -# Thư viện GroupDocs Annotation Java: Thêm chú thích PDF +# Cách chú thích PDF với Thư viện GroupDocs Annotation cho Java -Bạn đã bao giờ tự hỏi làm sao để thêm chú thích vào tài liệu PDF một cách lập trình bằng Java chưa? Với **groupdocs annotation library java**, bạn có thể nhúng các đánh dấu phong phú—như hình bầu dục, bình luận và dấu tem—trực tiếp vào PDF. Dù bạn đang xây dựng hệ thống duyệt tài liệu, nền tảng giáo dục, hay không gian làm việc cộng tác, hướng dẫn này sẽ chỉ cho bạn cách bắt đầu. +Thêm ghi chú trực quan, bình luận hoặc dấu vào PDF một cách lập trình có thể tăng tốc đáng kể các vòng xét duyệt, kiểm tra tuân thủ và quy trình làm việc cộng tác. Trong hướng dẫn này, bạn sẽ khám phá **cách chú thích PDF** bằng Thư viện GroupDocs Annotation cho Java, bao gồm mọi thứ từ thiết lập dự án đến các chú thích hình ellipse nâng cao, cấp phép, tối ưu hiệu năng và các mẹo tích hợp thực tế. ## Câu trả lời nhanh -- **Thư viện nào thêm chú thích vào PDF trong Java?** groupdocs annotation library java. -- **Có cần giấy phép không?** Bản dùng thử đủ cho việc thử nghiệm; giấy phép sản xuất bắt buộc đối với sử dụng thương mại. -- **IDE nào phù hợp nhất?** Bất kỳ IDE Java nào (IntelliJ IDEA, Eclipse, VS Code) đều hoạt động tốt. -- **Có thể chú thích PDF được bảo vệ bằng mật khẩu không?** Có—cung cấp mật khẩu khi tạo `Annotator`. -- **Có hỗ trợ xử lý hàng loạt không?** Chắc chắn; xem ví dụ xử lý hàng loạt phía dưới. +- **Thư viện nào thêm chú thích vào PDF trong Java?** Thư viện GroupDocs Annotation cho Java. +- **Tôi có cần giấy phép không?** Bản dùng thử hoạt động cho việc thử nghiệm; giấy phép sản xuất là bắt buộc cho việc sử dụng thương mại. +- **IDE nào hoạt động tốt nhất?** Bất kỳ IDE Java nào (IntelliJ IDEA, Eclipse, VS Code) đều hoạt động tốt. +- **Tôi có thể chú thích PDF được bảo vệ bằng mật khẩu không?** Có — cung cấp mật khẩu khi tạo `Annotator`. +- **Có hỗ trợ xử lý hàng loạt không?** Chắc chắn; xem ví dụ xử lý hàng loạt phía sau. -## Thư viện GroupDocs Annotation Java là gì? -groupdocs annotation library java là một API Java mạnh mẽ, sẵn sàng cho doanh nghiệp, cho phép bạn tạo, chỉnh sửa và truy xuất các chú thích PDF một cách lập trình. Nó hỗ trợ hơn 50 định dạng tài liệu và cung cấp các tính năng cộng tác như trả lời và chuỗi bình luận. +## Thư viện GroupDocs Annotation cho Java là gì? +Thư viện GroupDocs Annotation Java là một API sẵn sàng sử dụng cho phép các nhà phát triển tạo, chỉnh sửa, truy xuất và xóa các chú thích PDF hoàn toàn bằng mã Java. Nó hỗ trợ **hơn 50 định dạng tài liệu**, cung cấp các chuỗi bình luận tích hợp và cho phép kiểm soát quyền chi tiết. -## Vì sao nên dùng GroupDocs Annotation Java? -- **Các loại chú thích phong phú** – hình dạng, văn bản, dấu tem, watermark và nhiều hơn nữa. -- **Sẵn sàng cho cộng tác** – tích hợp trả lời và chuỗi bình luận. -- **Tối ưu hiệu năng** – xử lý các PDF lớn một cách hiệu quả. -- **API đơn giản** – giảm thời gian phát triển so với các thư viện cấp thấp như iText hoặc PDFBox. +## Tại sao nên sử dụng Thư viện GroupDocs Annotation cho Java? +Bạn có thể thêm các đánh dấu phong phú — bao gồm ellipses, ghi chú văn bản, dấu và watermark — chỉ với vài lời gọi phương thức, và thư viện xử lý **các PDF hàng trăm trang** mà không cần tải toàn bộ tệp vào bộ nhớ. So với các công cụ cấp thấp như iText hoặc PDFBox, nó giảm thời gian phát triển tới **70 %** và xử lý các tính năng PDF phức tạp (lớp, biểu mẫu, chữ ký số) ngay từ đầu. -## Điều kiện tiên quyết và cài đặt -- **JDK 8+** (khuyến nghị JDK 11) -- **Maven hoặc Gradle** để quản lý phụ thuộc -- **IDE** mà bạn thích (IntelliJ IDEA, Eclipse, v.v.) -- Kiến thức cơ bản về I/O file trong Java - -## Cài đặt GroupDocs Annotation Java +## Yêu cầu trước và Cài đặt +- **JDK 8+** (JDK 11 được khuyến nghị) +- **Maven or Gradle** for dependency management +- **IDE** of your choice (IntelliJ IDEA, Eclipse, VS Code) +- Basic familiarity with Java file I/O ### Tích hợp Maven Thêm kho và phụ thuộc vào `pom.xml` của bạn: @@ -68,23 +118,27 @@ Thêm kho và phụ thuộc vào `pom.xml` của bạn: ``` ### Cấu hình giấy phép -Áp dụng giấy phép trước khi thực hiện bất kỳ thao tác chú thích nào: +Apply your license before any annotation work: ```java License license = new License(); license.setLicense("path/to/your/license/file"); ``` -*Tip chuyên nghiệp:* Lưu file giấy phép trong `src/main/resources` và tải nó bằng `getClass().getResourceAsStream()` để triển khai dễ dàng hơn. +*Mẹo chuyên nghiệp:* Lưu tệp giấy phép trong `src/main/resources` và tải nó bằng `getClass().getResourceAsStream()` để triển khai mượt mà hơn. ## Hướng dẫn triển khai đầy đủ ### Bước 1: Khởi tạo PDF Annotator +Lớp `Annotator` là điểm vào cho tất cả các thao tác chú thích. Nó tải PDF mục tiêu, áp dụng cài đặt bảo mật và chuẩn bị một biểu diễn trong bộ nhớ để chỉnh sửa. + ```java final Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input_document.pdf"); ``` ### Bước 2: Tạo bình luận tương tác và trả lời +`CommentAnnotation` cho phép bạn nhúng văn bản tự do, trong khi các đối tượng `Reply` cho phép thảo luận dạng chuỗi trực tiếp trên trang PDF. + ```java Reply reply1 = new Reply(); reply1.setComment("First comment"); @@ -99,7 +153,9 @@ replies.add(reply1); replies.add(reply2); ``` -### Bước 3: Cấu hình chú thích hình bầu dục +### Bước 3: Cấu hình chú thích Ellipse của bạn +`EllipseAnnotation` vẽ một hình bầu dục có thể mở rộng. Bạn có thể đặt màu đường viền, màu nền, độ trong suốt và độ dày viền tùy chỉnh để phù hợp với hướng dẫn UI của bạn. + ```java EllipseAnnotation ellipse = new EllipseAnnotation(); ellipse.setBackgroundColor(65535); // Yellow background color @@ -113,36 +169,40 @@ ellipse.setPenWidth((byte) 3); // Line thickness ellipse.setReplies(replies); ``` -### Bước 4: Thêm và lưu các chú thích +### Bước 4: Thêm và lưu các chú thích của bạn +Sau khi cấu hình tất cả các đối tượng chú thích, gọi `annotator.save()` để ghi các thay đổi trở lại đĩa. Hãy nhớ gọi `dispose()` để giải phóng tài nguyên gốc, đặc biệt khi xử lý nhiều PDF trong một vòng lặp. + ```java annotator.add(ellipse); annotator.save("YOUR_OUTPUT_DIRECTORY/annotated_document.pdf"); annotator.dispose(); ``` -> **Tại sao gọi `dispose()`?** Nó giải phóng tài nguyên gốc, ngăn ngừa rò rỉ bộ nhớ—đặc biệt quan trọng khi xử lý nhiều PDF trong một vòng lặp. +> **Tại sao gọi `dispose()`?** Nó giải phóng tài nguyên gốc, ngăn chặn rò rỉ bộ nhớ — đặc biệt quan trọng khi xử lý nhiều PDF trong một vòng lặp. ## Các vấn đề thường gặp và giải pháp -### Vấn đề 1 – “Document Not Found” -*Nguyên nhân:* Đường dẫn tệp không đúng hoặc thư mục làm việc sai. -*Khắc phục:* Kiểm tra đường dẫn tuyệt đối hoặc in ra `System.getProperty("user.dir")` để xác nhận thư mục gốc. +### Vấn đề 1 – “Không tìm thấy tài liệu” +*Nguyên nhân:* Đường dẫn tệp không đúng hoặc thư mục làm việc. +*Giải pháp:* Xác minh đường dẫn tuyệt đối hoặc in `System.getProperty("user.dir")` để xác nhận thư mục gốc. ### Vấn đề 2 – Chú thích không hiển thị *Nguyên nhân:* Hệ thống tọa độ hoặc chỉ số trang sai. -*Khắc phục:* Nhớ rằng tọa độ PDF bắt đầu từ góc dưới‑trái, và các trang được đánh số bắt đầu từ 0. +*Giải pháp:* Nhớ rằng tọa độ PDF bắt đầu từ góc dưới‑trái, và các trang được đánh số bắt đầu từ 0. ### Vấn đề 3 – OutOfMemoryError trên PDF lớn *Nguyên nhân:* Toàn bộ tài liệu được tải vào bộ nhớ. -*Khắc phục:* Tăng heap JVM (`-Xmx2g`) hoặc xử lý các trang theo lô (xem ví dụ batch phía dưới). +*Giải pháp:* Tăng heap JVM (`-Xmx2g`) hoặc xử lý các trang theo lô (xem ví dụ batch bên dưới). ### Vấn đề 4 – Lỗi xác thực giấy phép -*Nguyên nhân:* File giấy phép thiếu hoặc không khớp. -*Khắc phục:* Kiểm tra lại đường dẫn file và đảm bảo phiên bản giấy phép tương thích với phiên bản thư viện. +*Nguyên nhân:* Thiếu hoặc không khớp tệp giấy phép. +*Giải pháp:* Kiểm tra lại đường dẫn tệp và đảm bảo phiên bản giấy phép khớp với phiên bản thư viện. ## Mẹo tối ưu hiệu năng -### Thực hành quản lý bộ nhớ +### Thực hành tốt quản lý bộ nhớ +Tránh giữ tham chiếu tới các đối tượng `Annotator` lớn lâu hơn mức cần thiết. Sử dụng try‑with‑resources hoặc gọi `dispose()` một cách rõ ràng sau khi mỗi tệp được xử lý. + ```java // Process multiple documents efficiently for (String documentPath : documentPaths) { @@ -154,11 +214,13 @@ for (String documentPath : documentPaths) { ``` ### Chiến lược xử lý hàng loạt -- **PDF nhỏ (<10 MB):** Xử lý từng tệp một. -- **PDF trung bình (10‑50 MB):** Xử lý theo lô 5‑10 tệp. -- **PDF lớn (>50 MB):** Sử dụng streaming hoặc xử lý theo khối để tránh OOM. +- **PDF nhỏ (<10 MB):** Xử lý từng tệp. +- **PDF trung bình (10‑50 MB):** Xử lý theo lô 5‑10. +- **PDF lớn (>50 MB):** Sử dụng streaming hoặc xử lý chia khối để tránh OOM. + +### Lưu ý về bộ nhớ đệm +Lớp `AnnotationAppearance` bao bọc các thuộc tính hình ảnh như màu và độ trong suốt cho các chú thích. Lưu vào bộ nhớ đệm các đối tượng có thể tái sử dụng như `AnnotationAppearance` hoặc các thể hiện `Color` khi bạn chú thích nhiều trang với cùng một kiểu dáng. -### Lưu ý về caching ```java // Reusable annotation template private static EllipseAnnotation createStandardEllipse() { @@ -170,7 +232,9 @@ private static EllipseAnnotation createStandardEllipse() { ## Ví dụ tích hợp thực tế -### Tích hợp vào ứng dụng web +### Tích hợp ứng dụng web +Cung cấp một endpoint REST nhận luồng PDF, áp dụng chú thích ellipse tại tọa độ do front‑end cung cấp, và trả về PDF đã chú thích dưới dạng mảng byte. + ```java @RestController @RequestMapping("/api/documents") @@ -188,6 +252,8 @@ public class DocumentAnnotationController { ``` ### Xử lý tài liệu hàng loạt +Duyệt qua một thư mục chứa các hợp đồng, thêm dấu “Reviewed” vào mỗi tệp, và di chuyển các tệp đã xử lý vào thư mục lưu trữ. + ```java public class BatchAnnotationProcessor { @@ -205,6 +271,8 @@ public class BatchAnnotationProcessor { ## Kỹ thuật chú thích nâng cao ### Định vị chú thích động +Tính toán tọa độ chú thích ngay lập tức dựa trên vị trí văn bản được phát hiện bằng OCR hoặc API trích xuất văn bản PDF, sau đó đặt các ellipse quanh các từ khóa. + ```java // Position based on a text search result Rectangle dynamicPosition = findTextPosition("important keyword"); @@ -212,77 +280,89 @@ ellipse.setBox(dynamicPosition); ``` ### Định dạng chú thích có điều kiện +Áp dụng các màu hoặc mức độ trong suốt khác nhau tùy thuộc vào vai trò của tác giả chú thích (ví dụ, reviewer = xanh dương, approver = xanh lá). + ```java // Different colors for warning vs. info annotations int color = annotationType.equals("warning") ? 16711680 : 65535; // Red : Yellow ellipse.setBackgroundColor(color); ``` -## Ứng dụng thực tiễn và trường hợp sử dụng -- **Nền tảng giáo dục:** Tô sáng khái niệm, thêm bình luận của giáo viên, tạo hướng dẫn học tương tác. -- **Đánh giá tài liệu pháp lý:** Đánh dấu điều khoản, thêm ghi chú bảo mật, duy trì lịch sử audit. -- **Hồ sơ y tế:** Chú thích quan sát, làm nổi bật dữ liệu quan trọng, cho phép cộng tác an toàn. -- **Quy trình doanh nghiệp:** Tinh giản phê duyệt báo cáo, thêm dấu tem người duyệt, theo dõi thay đổi. +## Ứng dụng thực tiễn và các trường hợp sử dụng +- **Nền tảng giáo dục:** Làm nổi bật khái niệm, thêm bình luận của giáo viên, tạo hướng dẫn học tương tác. +- **Xem xét tài liệu pháp lý:** Đánh dấu các điều khoản, thêm ghi chú bảo mật, duy trì nhật ký kiểm tra. +- **Hồ sơ y tế:** Chú thích quan sát, làm nổi bật dữ liệu quan trọng, cho phép hợp tác bảo mật. +- **Quy trình doanh nghiệp:** Tinh giản việc phê duyệt báo cáo, thêm dấu người xem xét, theo dõi thay đổi. -## Khi nào nên dùng các loại chú thích khác nhau -Mặc dù hướng dẫn này tập trung vào chú thích hình bầu dục, groupdocs annotation library java còn cung cấp: +## Khi nào nên sử dụng các loại chú thích khác nhau +Chú thích ellipse là lý tưởng khi bạn cần một vùng làm nổi bật không hình chữ nhật, chẳng hạn như nhấn mạnh các sơ đồ vòng tròn, logo, hoặc các khu vực phù hợp hơn với hình bầu dục. Chúng cung cấp một dấu hiệu trực quan rõ ràng đồng thời giữ được khả năng đọc, phù hợp cho việc đánh giá thiết kế, kiểm tra thương hiệu và bất kỳ trường hợp nào cần nhấn mạnh dạng tròn. + +Mặc dù hướng dẫn này tập trung vào chú thích ellipse, Thư viện GroupDocs Annotation Java cũng cung cấp: - **Chú thích văn bản** cho các bình luận chi tiết. - **Chú thích mũi tên** để chỉ vào các yếu tố cụ thể. -- **Chú thích hình chữ nhật** để làm nổi bật khu vực. -- **Chú thích watermark** để gắn thương hiệu hoặc bảo mật. -- **Chú thích dấu tem** cho việc phê duyệt. - -Chọn hình bầu dục khi bạn cần một vùng nổi bật không hình chữ nhật, trực quan—hoàn hảo để thu hút sự chú ý tới các sơ đồ tròn hoặc khu vực logo. +- **Chú thích hình chữ nhật** cho việc làm nổi bật khu vực. +- **Chú thích watermark** cho thương hiệu hoặc bảo mật. +- **Chú thích dấu** cho việc phê duyệt. ## Hướng dẫn khắc phục sự cố ### Vấn đề hiệu năng - **Triệu chứng:** Xử lý chậm. -- **Chẩn đoán:** Tập tin lớn, nhiều chú thích, RAM hạn chế. +- **Chẩn đoán:** Kích thước tệp lớn, nhiều chú thích, RAM hạn chế. - **Giải pháp:** Tối ưu thuộc tính chú thích, xử lý bất đồng bộ, hoặc phân trang các PDF lớn. ### Vấn đề tương thích - trên các trình xem. -- **Chẩn đoán:** Sử dụng tính năng PDF không chuẩn. -- **Giải pháp:** Kiểm tra với Adobe Acrobat, Chrome và Firefox; tuân thủ các### Thách thức tích hợp -- **Triệu chứng:** Xung Phiên bản không khớp với cáckhông‑ràng buộc. +- **Triệu chứng:** Chú thích hiển thị khác nhau trên các trình xem. +- **Chẩn đoán:** Các tính năng PDF không chuẩn. +- **Giải pháp:** Kiểm tra với Adobe Acrobat, Chrome và Firefox; tuân thủ các cờ chú thích tiêu chuẩn PDF. + +### Thách thức tích hợp +- **Triệu chứng:** Xung đột phụ thuộc. +- **Chẩn đoán:** Phiên bản không khớp với các thư viện khác. +- **Giải pháp:** Sử dụng `` của Maven để ép buộc các phiên bản tương thích hoặc chuyển sang REST API cho tích hợp không phụ thuộc ngôn ngữ. ## Câu hỏi thường gặp -**H: Có thể thêm chú thích vào PDF được bảo vệ bằng mật khẩu không?** -Đ: Có. Dùng overload `new Annotator(filePath, loadOptions)` trong đó `loadOptions` chứa mật khẩu. +**Q: Tôi có thể thêm chú thích vào PDF được bảo vệ bằng mật khẩu không?** +A: Có. Sử dụng overload `new Annotator(filePath, loadOptions)` trong đó `loadOptions` bao gồm mật khẩu. -**H: Nên xử lý các PDF lớn hơn 100 MB như thế nào?** -Đ: Xử lý từng trang riêng lẻ, tăng kích thước heap, hoặc sử dụng GroupDocs Annotation Cloud API cho khối lượng công việc nặng. +**Q: Tôi nên xử lý PDF lớn hơn 100 MB như thế nào?** +A: Xử lý từng trang riêng lẻ, tăng kích thước heap, hoặc tận dụng GroupDocs Annotation Cloud API cho khối lượng công việc nặng. -**H: Có giới hạn số lượng chú thích trên một tài liệu không?** -Đ: Không có giới hạn cứng, nhưng hiệu năng có thể giảm sau hàng ngàn chú thích. Cân nhắc phân trang hoặc nhóm chúng lại. +**Q: Có giới hạn số lượng chú thích trên mỗi tài liệu không?** +A: Không có giới hạn cứng, nhưng hiệu năng có thể giảm sau hàng nghìn chú thích. Hãy cân nhắc phân trang hoặc nhóm chúng. -**H: Có thể trích xuất các chú thích đã tồn tại không?** -Đ: Chắc chắn. Gọi `annotator.get()` để lấy tất cả chú thích từ PDF. +**Q: Tôi có thể trích xuất các chú thích hiện có không?** +A: Chắc chắn. Gọi `annotator.get()` để lấy tất cả các chú thích từ một PDF. -**H: Làm sao bảo mật chú thích để chỉ người dùng nhất định có thể chỉnh sửa?** -Đ: Thư viện cung cấp cài đặt quyền dựa trên người dùng; cấu hình qua API `AnnotationPermission`. +**Q: Làm sao để bảo mật các chú thích sao cho chỉ một số người dùng nhất định có thể chỉnh sửa?** +A: Thư viện cung cấp cài đặt quyền dựa trên người dùng; cấu hình chúng qua API `AnnotationPermission`. ## Kết luận -**groupdocs annotation library java** cung cấp cách sạch sẽ, hiệu năng cao để nhúng các chú thích PDF phong phú trực tiếp từ mã Java. Thực hiện các bước trên, bạn có thể thêm chú thích hình bầu dục, quản lý bình luận và mở rộng quy mô lên mức doanh nghiệp. +**Thư viện GroupDocs Annotation Java** cung cấp cho bạn một cách sạch sẽ, hiệu suất cao để nhúng các chú thích PDF phong phú trực tiếp từ mã Java. Bằng cách làm theo các bước trên, bạn có thể thêm chú thích ellipse, quản lý bình luận và mở rộng quy mô lên mức doanh nghiệp. -**Bước tiếp theo:** -1. Thử nghiệm các loại chú thích khác (văn bản, dấu tem, watermark). -2. Tích hợp thư viện vào quy trình tài liệu hoặc dịch vụ web hiện có. -3. Khám phá REST API cho các kịch bản ngôn ngữ‑không‑ràng buộc. +**Các bước tiếp theo:** +1. Thử nghiệm các loại chú thích khác (văn bản, dấu, watermark). +2. Tích hợp thư viện vào quy trình tài liệu hiện có hoặc dịch vụ web của bạn. +3. Khám phá REST API cho các kịch bản không phụ thuộc ngôn ngữ. --- -**Cập nhật lần cuối:** 2026-02-03 -**Đã kiểm tra với:** GroupDocs.Annotation 25.2 for Java +**Cập nhật lần cuối:** 2026-07-25 +**Được kiểm tra với:** GroupDocs.Annotation 25.2 for Java **Tác giả:** GroupDocs **Liên kết quan trọng:** -- **Tài liệu:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) -- **Tham chiếu API:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) -- **Tải xuống:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) -- **Mua bản quyền:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) -- **Dùng thử miễn phí:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) -- **Giấy phép tạm thời:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) -- **Hỗ trợ:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) \ No newline at end of file +- **Documentation:** [GroupDocs Annotation Java Documentation](https://docs.groupdocs.com/annotation/java/) +- **API Reference:** [GroupDocs API Reference](https://reference.groupdocs.com/annotation/java/) +- **Download:** [Download GroupDocs.Annotation](https://releases.groupdocs.com/annotation/java/) +- **Purchase:** [Buy GroupDocs License](https://purchase.groupdocs.com/buy) +- **Free Trial:** [Start a Free Trial](https://releases.groupdocs.com/annotation/java/) +- **Temporary License:** [Request a Temporary License](https://purchase.groupdocs.com/temporary-license/) +- **Support:** [GroupDocs Support Forum](https://forum.groupdocs.com/c/annotation/) + +## Hướng dẫn liên quan + +- [Cách thêm mũi tên vào PDF bằng Java – Hướng dẫn đầy đủ & Thực tiễn tốt nhất](/annotation/java/graphical-annotations/add-arrow-annotations-java-groupdocs/) +- [Cách thêm hình ảnh vào PDF bằng Java và GroupDocs Annotation](/annotation/java/image-annotations/annotate-pdfs-java-groupdocs-image-annotations/) +- [Hướng dẫn đầy đủ - Cách lưu PDF đã chú thích với GroupDocs.Annotation cho Java](/annotation/java/annotation-management/annotations-groupdocs-annotation-java-tutorial/) \ No newline at end of file