Noções básicas da API DOM do Aspose.PDF
Introdução à API DOM
Document Object Model (DOM) é uma forma de representação de documentos estruturados como um modelo orientado a objetos. DOM é o padrão oficial do World Wide Web Consortium (W3C) para representar documentos estruturados de maneira neutra em relação a plataforma e linguagem.
Em palavras simples, DOM é uma árvore de objetos que representam a estrutura de algum documento. Aspose.PDF for Android via Java também usa a ideia de DOM para representar a estrutura de um documento PDF em termos de objetos. No entanto, os aspectos do DOM (como seus Elements) são manipulados dentro da sintaxe da linguagem de programação em uso. A interface pública de um DOM é especificada em sua interface de programação de aplicações (API).
Introdução ao Documento PDF
Portable Document Format (PDF) é um padrão aberto para troca de documentos. Um documento PDF é uma combinação de texto e dados binários. Se você abri-lo em um editor de texto, verá os objetos brutos que definem a estrutura e o conteúdo do documento.
A estrutura lógica de um arquivo PDF é hierárquica e determina a sequência pela qual um aplicativo de visualização desenha as páginas do documento e seus conteúdos. Um PDF é composto por quatro componentes: objetos, estrutura de arquivo, estrutura de documento e fluxos de conteúdo.
Estrutura do Documento PDF
Como a estrutura de um arquivo PDF é hierárquica, Aspose.PDF for Java também acessa os elementos da mesma forma. A hierarquia a seguir mostra como o documento PDF é estruturado logicamente e como a API DOM do Aspose.PDF for Java o constrói.
Acessando Elementos do Documento PDF
O objeto Document está no nível raiz do modelo de objetos. A Aspose.PDF for Android via Java DOM API permite que você crie um objeto Document e, em seguida, acesse todos os outros objetos na hierarquia. Você pode acessar qualquer uma das coleções, como Pages, ou um elemento individual, como Page, etc. A DOM API fornece pontos únicos de entrada e saída para manipular o documento PDF, conforme mostrado abaixo:
- Abrir documento PDF
- Acessar a estrutura do documento PDF em estilo DOM
- Atualizar dados no documento PDF
- Validar documento PDF
- Exportar documento PDF para diferentes formatos
- Finalmente, salve o documento PDF atualizado
Como usar o novo Aspose.PDF for Android via Java API
Este tópico explicará o novo Aspose.PDF for Android via Java API e o guiará a começar rápida e facilmente. Observe que os detalhes relativos ao uso dos recursos específicos não fazem parte deste artigo.
O Aspose.PDF for Android via Java é composto por duas partes:
- Aspose.PDF for Android via Java DOM API
- Aspose.PDF.Facades
Você encontrará os detalhes de cada uma dessas áreas abaixo.
Aspose.PDF for Android via Java DOM API
O novo Aspose.PDF for Android via Java DOM API corresponde à estrutura de documentos PDF, o que ajuda você a trabalhar com documentos PDF não apenas no nível de arquivo e documento, mas também no nível de objeto. Oferecemos mais flexibilidade aos desenvolvedores para acessar todos os elementos e objetos do documento PDF. Usando as classes da Aspose.PDF DOM API, você pode obter acesso programático aos elementos e à formatação do documento. Esta nova API DOM é composta por vários namespaces conforme listado abaixo:
com.aspose.pdf
Esse namespace fornece a classe Document, que permite abrir e salvar um documento PDF. A classe License também faz parte desse namespace. Ele também fornece classes relacionadas a páginas PDF, anexos e marcadores, como com.aspose.pdf.Page, com.aspose.pdf.PageCollection, com.aspose.pdf.FileSpecification, com.aspose.pdf.EmbeddedFileCollection, com.aspose.pdf.OutlineItemCollection e com.aspose.pdf.OutlineCollection, etc.
com.aspose.pdf.text
Este namespace fornece classes que ajudam você a trabalhar com o texto e seus vários aspectos, por exemplo com.aspose.pdf.Font, com.aspose.pdf.FontCollection, com.aspose.pdf.FontRepository, com.aspose.pdf.FontStyles, com.aspose.pdf.TextAbsorber, com.aspose.pdf.TextFragment, com.aspose.pdf.TextFragmentAbsorber, com.aspose.pdf.TextFragmentCollection, com.aspose.pdf.TextFragmentState, com.aspose.pdf.TextSegment e com.aspose.pdf.TextSegmentCollection etc.
com.aspose.pdf.TextOptions
Este namespace fornece classes que permitem definir diferentes opções para pesquisar, editar ou substituir texto, por exemplo com.aspose.pdf.TextEditOptions, com.aspose.pdf.TextReplaceOptions e com.aspose.pdf.TextSearchOptions.
com.aspose.pdf.PdfAction
Este namespace contém classes que ajudam você a trabalhar com os recursos interativos do documento PDF, por exemplo trabalhando com o documento e outras ações. Este namespace contém classes como com.aspose.pdf.GoToAction, com.aspose.pdf.GoToRemoteAction e com.aspose.pdf.GoToURIAction etc.
com.aspose.pdf.Annotation
Anotações são parte dos recursos interativos de um documento PDF. Criamos um namespace dedicado às anotações. Esse namespace contém classes que ajudam a trabalhar com as anotações, por exemplo, com.aspose.pdf.Annotation, com.aspose.pdf.AnnotationCollection, com.aspose.pdf.CircleAnnotation e com.aspose.pdf.LinkAnnotation etc.
com.aspose.pdf.Form
Este namespace contém classes que ajudam a trabalhar com formulários PDF e campos de formulário, por exemplo com.aspose.pdf.Form, com.aspose.pdf.Field, com.aspose.pdf.TextBoxField e com.aspose.pdf.OptionCollection etc.
com.aspose.pdf.devices
Podemos executar várias operações nos documentos PDF, como converter um documento PDF para vários formatos de imagem. No entanto, essas operações não pertencem ao objeto Document e não podemos estender a classe Document para tais operações. Por isso introduzimos o conceito de Device na nova API DOM.
com.aspose.pdf.facades
Antes do Aspose.PDF for Java t.o.o, era necessário o Aspose.PDF.Kit for Java para manipular arquivos PDF existentes. Para executar código antigo do Aspose.PDF.Kit, pode usar o namespace com.aspose.pdf.facades.