À propos de l'API GroupDocs.Annotation pour Java

L’API GroupDocs.Annotation for Java est une bibliothèque qui vous permet d’ajouter des annotations aux documents PDF, Word et autres sur Mac, Windows ou Ubuntu. GroupDocs.Annotation for Java est une API Java native pour la gestion des annotations avec une prise en charge complète pour la création, l’ajout, la modification, la suppression, l’extraction et l’exportation d’annotations à partir d’images et de divers autres documents. La liste complète des formats de documents pris en charge que vous pouvez voir sur cette page. Cette bibliothèque vous permet de travailler non seulement avec le document HTML mais également avec de nombreux autres types de documents tels que Word, Excel, PowerPoint, les e-mails Outlook, Visio, Adobe, OpenDocument, OpenOffice, Photoshop, AutoCad et bien d’autres. L’API GroupDocs.Annotation pour Java vous permet de créer et d’ajouter de nouvelles notes, de modifier des annotations, d’extraire des commentaires, des annotations et de les supprimer des documents. La bibliothèque prend en charge 13 types d’annotations différents, notamment Texte, Polyligne, Zone, Souligné, Point, Filigrane, Flèche, Ellipse, Remplacement de texte, Distance, Champ de texte, Rédaction de ressources en PDF, HTML, documents Microsoft Word, feuilles de calcul, diagrammes, présentations, dessins, images et de nombreux autres formats de fichiers. L’exemple (voir ci-dessous) montre comment travailler avec le document HTML, dans cet exemple, vous pouvez voir les principales étapes de la façon de travailler avec GroupDocs.Annotation : configurer une licence, ouvrir un document avec lequel vous souhaitez travailler, créer un annotation, en ajoutant des objets de données pour définir les propriétés d’annotation en fonction de vos besoins et en enregistrant le résultat à l’endroit requis. Vous pouvez également consulter plus en détail les fonctionnalités prises en charge sur notre page github, ou dans notre produit documentation.

Étapes pour ajouter des annotations à HTML en Java

GroupDocs.Annotation permet aux développeurs Java d’ajouter facilement divers types d’annotations aux fichiers HTML dans n’importe quelle application Java en implémentant quelques étapes simples.

Créez des objets de réponse avec un commentaire et une date.
Créez un objet AreaAnnotation, définissez les options de zone et ajoutez des réponses.
Créez un objet Annotator et ajoutez une annotation de zone.
Enregistrez le fichier de sortie.

Configuration requise

Les API GroupDocs.Annotation pour Java sont prises en charge sur toutes les principales plates-formes et systèmes d’exploitation. Avant d’exécuter le code ci-dessous, assurez-vous que les prérequis suivants sont installés sur votre système.

Systèmes d’exploitation : Microsoft Windows, Linux, MacOS
Environnement de développement : NetBeans, Intellij IDEA, Eclipse, etc.
Environnement d’exécution Java : Java 7 (1.7) et supérieur
Obtenez la dernière version de GroupDocs.Annotation pour Java à partir de GroupDocs Artifact Repository

Aperçu des annotations et exemple de code

// Create an instance of Reply class and add comments
Reply firstReply = new Reply();
firstReply.setComment("First comment");
firstReply.setRepliedOn(Calendar.getInstance().getTime());

Reply secondReply = new Reply();
secondReply.setComment("Second comment");
secondReply.setRepliedOn(Calendar.getInstance().getTime());

List<Reply> replies = new ArrayList<Reply>();
replies.add(firstReply);
replies.add(secondReply);

// Create an instance of AreaAnnotation class and set options
AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);

// Create an instance of Annotator class
Annotator annotator = new Annotator("input.bmp");

// Add annotation
annotator.add(area);

// Save to file
annotator.save("output.bmp");
annotator.dispose();

Annotation preview image

Étapes pour modifier les annotations de HTML en Java

GroupDocs.Annotation permet aux développeurs Java de mettre à jour plus facilement diverses propriétés d’annotation à partir de fichiers HTML dans n’importe quelle application Java en implémentant quelques étapes simples.

Instanciez l’objet Annotator avec le chemin d’accès au document d’entrée ou le flux avec LoadOptions instancié avec ImportAnnotations = true.
Créez une implémentation AnnotationBase et définissez l’ID de l’annotation existante (si l’annotation avec cet ID n’est pas trouvée, rien ne sera modifié) ou la liste des chemins d’annotations (toutes les annotations existantes seront supprimées).
Appelez la méthode de mise à jour de l’objet Annotator avec les annotations transmises.
Appelez la méthode save avec le chemin ou le flux de document résultant et l’objet SaveOptions.

String outputPath = "UpdateAnnotation.bmp";

// Create an instance of Annotator class
Annotator annotator = new Annotator("input.bmp");

// Create an instance of Reply class for first example and add comments
Reply reply1 = new Reply();
reply1.setComment("Original first comment");
reply1.setRepliedOn(Calendar.getInstance().getTime());

Reply reply2 = new Reply();
reply2.setComment("Original second comment");
reply2.setRepliedOn(Calendar.getInstance().getTime());

java.util.List replies = new ArrayList();
replies.add(reply1);
replies.add(reply2);

// Create an instance of AreaAnnotation class and set options
AreaAnnotation original = new AreaAnnotation();
original.setId(1);
original.setBackgroundColor(65535);
original.setBox(new Rectangle(100, 100, 100, 100));
original.setCreatedOn(Calendar.getInstance().getTime());
original.setMessage("This is original annotation");
original.setReplies(replies);

// Add original annotation
annotator.add(original);
annotator.save(outputPath);
annotator.dispose();

LoadOptions loadOptions = new LoadOptions();

// Open annotated document
Annotator annotator1 = new Annotator(outputPath, loadOptions);

// Create an instance of Reply class for update first example
Reply reply3 = new Reply();
reply3.setComment("Updated first comment");
reply3.setRepliedOn(Calendar.getInstance().getTime());

Reply reply4 = new Reply();
reply4.setComment("Updated second comment");
reply4.setRepliedOn(Calendar.getInstance().getTime());

java.util.List replies1 = new ArrayList();
replies1.add(reply3);
replies1.add(reply4);

// Suggest we want change some properties of existed annotation
AreaAnnotation updated = new AreaAnnotation();
updated.setId(1);
updated.setBackgroundColor(255);
updated.setBox(new Rectangle(0, 0, 50, 200));
updated.setCreatedOn(Calendar.getInstance().getTime());
updated.setMessage("This is updated annotation");
updated.setReplies(replies1);

// Update and save annotation
annotator1.update(updated);
annotator1.save(outputPath);
annotator1.dispose();

Étapes pour extraire les annotations de HTML en Java

GroupDocs.Annotation permet aux développeurs Java d’annoter facilement des documents et d’extraire des informations d’annotation à partir de fichiers HTML dans n’importe quelle application Java en implémentant quelques étapes simples.

Créez des objets de réponse avec un commentaire et une date.
Instanciez l’objet LoadOptions et appelez SetImportAnnotations avec l’argument true.
Définissez une variable de type Liste.
Appelez la méthode get et renvoyez le résultat à la variable ci-dessus.

À propos du format de fichier HTML

HTML (Hyper Text Markup Language) est l’extension des pages Web créées pour être affichées dans les navigateurs. Connu sous le nom de langage du Web, HTML a évolué avec les exigences de nouvelles exigences d’information à afficher dans le cadre des pages Web. La dernière variante est connue sous le nom de HTML 5 qui offre une grande flexibilité pour travailler avec le langage. Les pages HTML sont soit reçues du serveur, où elles sont hébergées, soit peuvent également être chargées à partir du système local. Chaque page HTML est composée d’éléments HTML tels que des formulaires, du texte, des images, des animations, des liens, etc. Ces éléments sont représentés par des balises telles que img, a, p et plusieurs autres où chaque balise a un début et une fin. Il peut également intégrer des applications écrites dans des langages de script tels que JavaScript et les feuilles de style (CSS) pour la représentation globale de la mise en page.

En savoir plus À propos du format de fichier HTML

Travailler avec d'autres formats de documents courants

Mettez à jour les propriétés d’annotation de certains des formats de fichiers populaires, comme indiqué ci-dessous.

Annoter HTML à partir de Java