HTML JPG PDF XML DOCX
Product Family
PDF

Adicionar anotações de texto a documentos PDF via SDK Java

API para adicionar anotações de texto a documentos PDF usando o Aspose.PDF Cloud SDK Java.

Get Started
 

Aspose.PDF Cloud SDK para Java Aspose.PDF Cloud SDK para Java

Overview

GitHub Learn Buy
NET PHP PYTHON GO NODEJS

Como anexar anotações de texto a documentos PDF usando o Aspose.PDF Cloud SDK Java

Para adicionar anotações a documentos PDF via SDK Java da Nuvem, usaremos Aspose.PDF Cloud Java SDK Este SDK de Nuvem permite que você crie facilmente aplicativos criadores, editores e conversores de PDF baseados na nuvem em linguagem Java para várias plataformas de nuvem. Abrir Repository gerenciador de pacotes, procure por Aspose.PDF Cloud e instale. Você também pode usar o seguinte comando no Console do Gerenciador de Pacotes para instalá-lo usando o Maven.

Adicionar repositório Aspose Cloud ao seu arquivo pom.xml

Adicionar repositório Aspose Cloud


    <repositories>
        <repository>
            <id>aspose-cloud</id>
            <name>Aspose Cloud Repository</name>
            <url>https://releases.aspose.cloud/java/repo/</url>
        </repository>
    </repositories>

Para instalar a biblioteca cliente da API no seu repositório Maven local, basta executar:

Instalação a partir do Github


    mvn clean install

Para implantá‑lo em um repositório Maven remoto, configure as definições do repositório e execute:

Implantar repositório Maven


    mvn clean deploy

Etapas para adicionar anotações de texto usando o SDK Java

Desenvolvedores do Aspose.PDF Cloud podem facilmente carregar e anexar anotações a documentos PDF em apenas poucas linhas de código.

  1. Carrega o PDF.
  2. Cria uma caixa de texto formatada (com fontes, cores, alinhamento).
  3. Envia a anotação para a página especificada.
  4. Baixa o documento modificado para uso local.
 

Este código de exemplo mostra como adicionar anotações de texto a um documento PDF


    package com.aspose.asposecloudpdfusecases.annotations;

    import java.io.File;
    import java.nio.file.Path;
    import java.nio.file.StandardCopyOption;
    import java.util.ArrayList;
    import java.util.List;
    import com.aspose.asposecloudpdf.api.PdfApi;
    import com.aspose.asposecloudpdf.model.AsposeResponse;
    import com.aspose.asposecloudpdf.model.Color;
    import com.aspose.asposecloudpdf.model.FreeTextAnnotation;
    import com.aspose.asposecloudpdf.model.FreeTextIntent;
    import com.aspose.asposecloudpdf.model.HorizontalAlignment;
    import com.aspose.asposecloudpdf.model.Justification;
    import com.aspose.asposecloudpdf.model.Rectangle;
    import com.aspose.asposecloudpdf.model.TextStyle;

    public class AnnotationAddText {
        public static void Create() {
            String REMOTE_FOLDER   = "Your_Temp_Pdf_Cloud";
            String LOCAL_FOLDER    = "c:\\Samples";
            String PDF_DOCUMENT    = "sample.pdf";
            String PDF_OUTPUT      = "annotation_add_freetext_output.pdf";
            Integer PAGE_NUMBER = 1;

            String NEW_UL_ANNOTATION_TEXT        = "NEW FREE TEXT ANNOTATION";
            String NEW_UL_ANNOTATION_DESCRIPTION = "This is a sample free text annotation";
            String NEW_UL_ANNOTATION_SUBJECT     = "Free Text Box Subject";
            String NEW_UL_ANNOTATION_CONTENTS    = "Free text annotation sample contents";

            try {
                PdfApi pdfApi = new PdfApi(API_KEY, API_SECRET);

                // upload local PDF file to remote storage
                File file = new File(Path.of(LOCAL_FOLDER, PDF_DOCUMENT).toString());
                pdfApi.uploadFile(Path.of(REMOTE_FOLDER , PDF_DOCUMENT).toString(), file, null);
                System.out.println(String.format("File '%s' successfully uploaded!", Path.of(LOCAL_FOLDER, PDF_DOCUMENT).toString()));

                TextStyle textStyle = new TextStyle();
                textStyle.setFontSize(20.);
                textStyle.setForegroundColor(new Color().A(255).G(255));
                textStyle.setBackgroundColor(new Color().A(255).R(255));

                FreeTextAnnotation annotation = new FreeTextAnnotation();
                annotation.setName("Free_Text_Annotation");
                annotation.setRect(new Rectangle().LLX(100.).LLY(350.).URX(450.).URY(400.));
                annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);
                annotation.setIntent(FreeTextIntent.FREETEXTTYPEWRITER);
                annotation.setRichText(NEW_UL_ANNOTATION_TEXT);
                annotation.setSubject(NEW_UL_ANNOTATION_SUBJECT);
                annotation.setContents(NEW_UL_ANNOTATION_CONTENTS);
                annotation.setTitle(NEW_UL_ANNOTATION_DESCRIPTION);
                annotation.setZindex(1);
                annotation.setJustification(Justification.CENTER);
                annotation.setTextStyle(textStyle);

                annotation.setModified("11/20/2025 00:00:00.000 AM");

                List<FreeTextAnnotation> annotations = new ArrayList<>();
                annotations.add(annotation);

                AsposeResponse response = pdfApi.postPageFreeTextAnnotations(PDF_DOCUMENT, PAGE_NUMBER, annotations, null, REMOTE_FOLDER);
                if (response.getCode() != 200)
                    System.err.println("Error: unexpected error when adding annotation! '" + response.getStatus() + "'");
                else{
                    // download changed PDF file from remote folder...
                    File f = pdfApi.downloadFile(Path.of(REMOTE_FOLDER , PDF_DOCUMENT).toString(), null, null);
                    java.nio.file.Files.copy(Path.of(f.getPath()), Path.of(LOCAL_FOLDER, PDF_OUTPUT), StandardCopyOption.REPLACE_EXISTING);
                    System.out.println(String.format("File '%s' successfully dowloaded!", Path.of(LOCAL_FOLDER, PDF_OUTPUT).toString()));                
                    System.out.println("Successfully added annotation in document ! '" + PDF_OUTPUT + "'");
                }
            }
            catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
 

Trabalhar com as anotações em PDF via SDK Java

Adicionar anotações a um PDF atende a muitas finalidades importantes em diferentes casos de uso. Uma das razões mais comuns é a revisão e o feedback. As anotações permitem que os usuários destaquem partes específicas de um documento, deixem comentários, façam perguntas ou sugiram alterações. Isso torna o processo de revisão mais eficiente e organizado, especialmente quando vários colaboradores estão envolvidos. Adicione as Anotações em documentos PDF com o Aspose.PDF Cloud Java SDK.

Com o nosso SDK Java você pode

  • Adicionar cabeçalho e rodapé de documentos PDF em formato de texto ou imagem.
  • Adicionar tabelas e carimbos de texto ou imagem a documentos PDF.
  • Anexar múltiplos documentos PDF a um arquivo existente.
  • Trabalhar com anexos PDF, anotações e campos de formulário.
  • Aplicar criptografia ou descriptografia a documentos PDF e definir uma senha.
  • Excluir todos os carimbos e tabelas de uma página ou de todo o documento PDF.
  • Exclua um selo ou tabela específica do documento PDF pelo seu ID.
  • Substitua uma ou várias ocorrências de texto em uma página PDF ou em todo o documento.
  • Suporte extensivo para converter documentos PDF em vários outros formatos de arquivo.
  • Extraia diversos elementos de arquivos PDF e otimize documentos PDF.
  • Você pode experimentar nosso aplicativo gratuito para adicionar anotações em arquivos PDF online e testar a funcionalidade.

    •