API de Código Alto de Anotador de Documentos Java

GroupDocs.Annotation para Java é uma robusta API local projetada para desenvolvedores Java anotarem, marcarem com marca d’água e gerenciarem documentos em vários formatos, como PDF, Word®, Excel®, PowerPoint® e imagens. Ele oferece recursos avançados, incluindo anotações de texto, área e imagem, suporte a OLE, gerenciamento de metadados e compatibilidade multiplataforma.

Funcionalidades da API Local de Anotação de Documentos Java

Suporte a Documentos e Formatos

• Suporte a Múltiplos Formatos de Documento: Anote vários formatos de documento, incluindo PDF, Word®, Excel®, PowerPoint®, Visio® e imagens (JPG, PNG, BMP, etc.).
• Anotações Específicas para PDF: Suporte para notas adesivas, campos de texto e outros tipos de anotações específicas para PDF.
• Suporte a Formatos de Imagem: Anote formatos de imagem populares, incluindo JPG, PNG, BMP e mais.
• Formatos de Exportação de Anotações: Exporte anotações em diferentes formatos para interoperabilidade.
• Suporte a OLE: Suporte a objetos OLE dentro de documentos anotados.
• Compatibilidade com Outras APIs do GroupDocs: Integração perfeita com outros produtos do GroupDocs para funcionalidades estendidas.

Tipos de Anotação e Ferramentas

• Anotações de Texto: Adicione anotações de texto, como destaques, sublinhados e tachados.
• Anotações de Área: Destaque e comente em áreas específicas usando anotações de retângulo, polígono e ponto.
• Anotações de Marcação: Aplique anotações de marcação, como redação, para ocultar conteúdo sensível.
• Medição de Distância: Meça distâncias dentro dos documentos, útil para desenhos técnicos e arquivos CAD.
• Marca d’água: Adicione marcas d’água de texto e imagem para fins de marcação ou segurança.
• Anotações de Imagem: Anote arquivos de imagem, com suporte para vários formatos de imagem.

Gestão de Anotações

• Respostas às Anotações: Permita que vários usuários respondam às anotações, possibilitando revisões colaborativas de documentos.
• Aparência Personalizada de Anotação: Personalize a aparência da anotação, incluindo configurações de cor, fonte e opacidade.
• Exportar/Importar Anotações: Exporte anotações para arquivos externos e importe-as de volta para compartilhamento ou colaboração.
• Camadas de Anotação: Controle as camadas de anotações, permitindo que se sobreponham ou permaneçam separadas.
• Manipulação de Anotações: Capacidade de criar, editar e excluir anotações programaticamente.
• Metadados de Anotação: Anote documentos enquanto preserva a integridade dos metadados.
• Suporte a Desfazer/Refazer: Implemente a funcionalidade de desfazer/refazer para operações de anotação.

Colaboração e Revisão

• Funcionalidades Colaborativas: Permita que vários usuários anotem, comentem e colaborem no mesmo documento.
• Comparação de Documentos: Compare documentos ou imagens lado a lado para destacar diferenças.
• Respostas às Anotações: Permita que vários usuários respondam às anotações, possibilitando revisões colaborativas de documentos.

Segurança e Integridade de Documentos

• Segurança de Documentos: Aplique anotações que possam obscurecer informações sensíveis, como redações.
• Gestão de Metadados: Gerencie e preserve metadados dentro dos documentos anotados.

Pesquisa e Navegação

• Capacidades Avançadas de Pesquisa: Pesquise dentro de documentos anotados, incluindo a capacidade de pesquisar dentro das anotações.

Desempenho e Escalabilidade

• Processamento em Lote: Manipule anotações em vários documentos ao mesmo tempo para maior eficiência.
• Escalabilidade: Projetado para lidar com grandes volumes de documentos e anotações de forma eficiente.
• Alto Desempenho: Otimizado para rápido processamento de anotações e manipulação de documentos.

Compatibilidade e Integração Multiplataforma

• Compatibilidade Multiplataforma: Use em vários sistemas operacionais, incluindo Windows, macOS e Linux.
• Integração Flexível: Integre facilmente em aplicativos Java com um rico conjunto de funcionalidades de API.

Saída e Apresentação

• Impressão e Salvamento de Anotações: Inclua ou exclua anotações ao imprimir ou salvar documentos.

Formatos de Documentos Suportados

Para alguns tipos de arquivo, o GroupDocs.Annotation salva o resultado em um formato diferente. Neste caso, o tipo de arquivo de saída é especificado após *. Se nenhum símbolo desse tipo for especificado, o GroupDocs.Annotation salva o resultado no formato original do arquivo.

Tipos de Anotação Suportados

Anotações Gráficas

• Área: Marca uma área com um retângulo e adiciona notas a ela.
• Seta: Desenha uma seta em um documento.
• Distância: Mede a distância entre objetos em um documento.
• Elipse: Desenha uma anotação elíptica em um documento.
• Ponto: Cola comentários em qualquer ponto de um documento.
• Polilinha: Desenha formas e linhas à mão livre.
• Redação: Preenche um retângulo preto com uma posição fixa (usado para ocultar texto).
• Campo de Texto: Adiciona um retângulo com texto dentro.

Anotações de Texto

• Destaque: Destaca e comenta o texto selecionado.
• Substituição: Substitui o texto original pelo texto do usuário.
• Riscado: Marca o texto com um estilo de tachado.
• Sublinhado: Marca o texto com um estilo sublinhado.

Anotações de Marca d’água

• Marca d’água Horizontal: Adiciona uma marca d’água de texto horizontal.
• Marca d’água Diagonal: Adiciona uma marca d’água de texto diagonal.

Requisitos do Sistema

GroupDocs.Annotation para Java suporta os seguintes sistemas operacionais, frameworks e gerenciadores de pacotes:

GroupDocs.Annotation para Java não requer nenhum software externo ou ferramenta de terceiros para ser instalado. Basta seguir uma das maneiras descritas em Instalação e Configuração.

Primeiros Passos

O GroupDocs hospeda todas as APIs Java no Repositório GroupDocs. Você pode usar facilmente a API GroupDocs.Annotation para Java diretamente em seus projetos Maven com configurações simples.

Etapa 1: Especificar a Configuração do Repositório GroupDocs

Para começar, você precisa especificar a configuração do repositório GroupDocs em seu arquivo Maven pom.xml como segue:

<repositories>
    <repository>
        <id>Repositório de Artefatos GroupDocs</id>
        <name>Repositório de Artefatos GroupDocs</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

Etapa 2: Definir a Dependência da API GroupDocs.Annotation para Java

Em seguida, defina a dependência da API GroupDocs.Annotation para Java em seu arquivo pom.xml como segue:

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-annotation</artifactId>
        <version>23.10</version> 
    </dependency>
</dependencies>

Exemplos de Código

Exemplo de Código 1: Adicionando uma Anotação de Texto a um Documento PDF

Este trecho de código demonstra como usar o GroupDocs.Annotation para Java para adicionar uma anotação de texto a um documento PDF. A anotação de texto inclui um comentário ou nota que aparece como um pop-up quando o usuário passa o mouse sobre a área anotada. Este recurso é particularmente útil para revisar e comentar documentos PDF.

// Importar classes necessárias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.Annotation;
import com.groupdocs.annotation.models.annotationtypes.TextAnnotation;
import com.groupdocs.annotation.options.export.AnnotationOptions;

import java.awt.Color;
import java.nio.file.Paths;

public class AddTextAnnotationToPDF {
    public static void main(String[] args) {
        // Caminho para o documento PDF de entrada
        String inputFilePath = "input.pdf";
        
        // Caminho para o documento PDF de saída
        String outputFilePath = "output.pdf";
        
        // Inicializar o objeto Annot

ator para o documento PDF
        Annotator annotator = new Annotator(inputFilePath);
        
        // Criar uma nova anotação de texto
        TextAnnotation textAnnotation = new TextAnnotation();
        textAnnotation.setPageNumber(1); // Definir número da página
        textAnnotation.setMessage("Esta é uma anotação de texto"); // Definir mensagem de anotação
        textAnnotation.setBox(new Rectangle(100, 100, 200, 50)); // Definir posição e tamanho da anotação
        textAnnotation.setBackgroundColor(Color.yellow); // Definir cor de fundo da anotação
        textAnnotation.setFontColor(Color.black); // Definir cor da fonte para o texto da anotação
        
        // Adicionar a anotação de texto ao documento
        annotator.add(textAnnotation);
        
        // Salvar o documento PDF anotado
        annotator.save(outputFilePath, new AnnotationOptions());
        
        // Fechar o annotator
        annotator.dispose();
        
        System.out.println("Anotação de texto adicionada com sucesso ao documento PDF.");
    }
}

Exemplo de Código 2: Removendo Anotações de um Documento Word

Este trecho de código ilustra como remover todas as anotações de um documento Microsoft Word (DOCX) usando o GroupDocs.Annotation para Java. Isso é especialmente útil quando você precisa limpar um documento removendo comentários, notas ou outros tipos de anotações.

// Importar classes necessárias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.options.remove.RemoveOptions;

public class RemoveAnnotationsFromWordDocument {
    public static void main(String[] args) {
        // Caminho para o documento Word de entrada
        String inputFilePath = "input.docx";
        
        // Caminho para o documento Word de saída
        String outputFilePath = "output.docx";
        
        // Inicializar o objeto Annotator para o documento Word
        Annotator annotator = new Annotator(inputFilePath);
        
        // Definir opções de remoção para remover todas as anotações
        RemoveOptions removeOptions = new RemoveOptions();
        
        // Remover todas as anotações do documento
        annotator.remove(removeOptions);
        
        // Salvar o documento Word limpo
        annotator.save(outputFilePath);
        
        // Fechar o annotator
        annotator.dispose();
        
        System.out.println("Todas as anotações removidas com sucesso do documento Word.");
    }
}

Exemplo de Código 3: Extraindo Comentários de uma Planilha Excel

Este trecho de código mostra como extrair comentários e anotações de uma planilha Excel (XLSX) usando o GroupDocs.Annotation para Java. Este recurso é benéfico para revisar e resumir feedback ou notas deixadas em um documento Excel.

// Importar classes necessárias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.AnnotationBase;
import com.groupdocs.annotation.options.export.AnnotationOptions;

import java.util.List;

public class ExtractCommentsFromExcel {
    public static void main(String[] args) {
        // Caminho para o documento Excel de entrada
        String inputFilePath = "input.xlsx";
        
        // Inicializar o objeto Annotator para o documento Excel
        Annotator annotator = new Annotator(inputFilePath);
        
        // Extrair todas as anotações do documento
        List<AnnotationBase> annotations = annotator.get();
        
        // Iterar pelas anotações extraídas e imprimir suas mensagens
        for (AnnotationBase annotation : annotations) {
            System.out.println("Tipo de Anotação: " + annotation.getAnnotationType());
            System.out.println("Mensagem da Anotação: " + annotation.getMessage());
        }
        
        // Fechar o annotator
        annotator.dispose();
        
        System.out.println("Comentários extraídos com sucesso da planilha Excel.");
    }
}