groupdocs viewer maven: Converta arquivos TXT para HTML, JPG, PNG e PDF usando GroupDocs.Viewer para Java

Em aplicações Java modernas, groupdocs viewer maven facilita a transformação de documentos de texto simples (TXT) em HTML pronto para a web, imagens de alta resolução ou arquivos PDF portáteis. Seja construindo um portal de documentos, um serviço de arquivamento ou um recurso de pré‑visualização, converter arquivos TXT com GroupDocs.Viewer economiza tempo e elimina a necessidade de analisadores personalizados. Neste guia, percorreremos a configuração completa e mostraremos como convert txt files java para HTML (de página única e multipágina), JPG, PNG e PDF.

Converta arquivos TXT para HTML, JPG, PNG e PDF com GroupDocs.Viewer para Java

Respostas rápidas

Qual artefato Maven eu preciso? com.groupdocs:groupdocs-viewer (see Maven snippet below).
Posso renderizar HTML multipágina? Yes – use HtmlViewOptions.forEmbeddedResources without the single‑page flag.
É necessária licença para produção? A trial works for evaluation; a permanent license is needed for commercial use.
Qual versão do Java é suportada? Java 8 or newer (Java 11+ recommended).
Preciso de bibliotecas adicionais para saída de imagem? No, the Viewer library includes JPG and PNG support out‑of‑the‑box.

O que é groupdocs viewer maven?

groupdocs viewer maven é a distribuição baseada em Maven da biblioteca GroupDocs.Viewer para Java. Ela fornece uma API simples para renderizar mais de 100 formatos de documento — incluindo texto simples — em HTML, imagens ou PDF sem exigir Microsoft Office ou outras ferramentas de terceiros.

Por que converter txt files java?

Pré‑visualização multiplataforma – HTML e imagens podem ser exibidos em navegadores ou aplicativos móveis.
Arquivamento padronizado – PDF preserva a formatação e é universalmente legível.
Amigável à automação – Integre a conversão em jobs em lote, serviços de nuvem ou pipelines de CI.

Pré-requisitos

GroupDocs.Viewer for Java versão 25.2 ou posterior (disponível via Maven).
JDK 8 + (Java 11 + recomendado).
Uma IDE como IntelliJ IDEA, Eclipse ou NetBeans.
Conhecimento básico de Java e Maven.

Configurando o GroupDocs.Viewer para Java

Adicione o repositório e a dependência ao seu pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Etapas de aquisição de licença

Comece com um teste gratuito ou obtenha uma licença temporária para explorar todos os recursos.
Para produção, compre uma licença através da página oficial de compra.

Inicialização e configuração básicas

Adicione a dependência Maven mostrada acima.
Certifique‑se de que seu JDK e IDE estejam configurados corretamente.

Agora vamos mergulhar nos cenários concretos de conversão.

Guia de implementação

Recurso 1: Renderizar TXT para HTML multipágina (multi page html java)

Visão geral

Este exemplo converte um documento TXT em um arquivo HTML multipágina, preservando quebras de linha em páginas web separadas.

Importar Bibliotecas Necessárias

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

Configurar Caminhos e Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Render the document to HTML using these options
    viewer.view(options);
}

Explicação: HtmlViewOptions.forEmbeddedResources agrupa CSS, fontes e imagens diretamente na saída HTML, tornando‑a portátil.

Recurso 2: Renderizar TXT para HTML de página única (convert txt to html java)

Visão geral

Condense todo o arquivo de texto em uma única página HTML — perfeito para pré‑visualizações rápidas.

Importar Bibliotecas Necessárias

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

Configurar Caminhos e Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result_single_page.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_2_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Set the option to render as a single page HTML
    options.setRenderToSinglePage(true);
    
    // Render the document using these options
    viewer.view(options);
}

Explicação: setRenderToSinglePage(true) mescla todas as páginas em um único arquivo HTML.

Recurso 3: Renderizar TXT para JPG

Visão geral

Converta um arquivo TXT em uma imagem JPEG de alta qualidade, útil para compartilhamento em plataformas que aceitam apenas imagens.

Importar Bibliotecas Necessárias

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

Configurar Caminhos e Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.jpg");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a JPEG image
    JpgViewOptions options = new JpgViewOptions(pageFileFullPath);
    
    // Render the document as a JPG using these options
    viewer.view(options);
}

Explicação: JpgViewOptions permite controlar a qualidade da imagem, DPI e caminho de saída.

Recurso 4: Renderizar TXT para PNG

Visão geral

Gere imagens PNG sem perdas a partir de arquivos de texto — ideal quando você precisa de gráficos nítidos e escaláveis.

Importar Bibliotecas Necessárias

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

Configurar Caminhos e Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.png");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PNG image
    PngViewOptions options = new PngViewOptions(pageFileFullPath);
    
    // Render the document as a PNG using these options
    viewer.view(options);
}

Explicação: PNG oferece compressão sem perdas, preservando a aparência exata do texto original.

Recurso 5: Renderizar TXT para PDF (txt to pdf java / convert txt to pdf java)

Visão geral

Crie um arquivo PDF a partir de um documento TXT — ótimo para arquivamento, impressão ou envio a clientes.

Importar Bibliotecas Necessárias

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

Configurar Caminhos e Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.pdf");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PDF
    PdfViewOptions options = new PdfViewOptions(pageFileFullPath);
    
    // Render the document as a PDF using these options
    viewer.view(options);
}

Explicação: PdfViewOptions gerencia o layout de página, fontes e incorporação de recursos automaticamente.

Aplicações práticas

Sistemas de Gerenciamento de Documentos: Automatize a conversão de documentos TXT legados para HTML para portais intranet.
Plataformas de Publicação: Converta manuscritos TXT enviados por autores em HTML para integração perfeita com CMS.
Soluções de Arquivamento: Preserve arquivos de texto antigos como PDF ou PNG para armazenamento de longo prazo.
Integração com Armazenamento em Nuvem: Converta em tempo real e armazene os arquivos renderizados no AWS S3, Azure Blob ou Google Cloud.

Problemas comuns e soluções

Problema	Causa	Correção
Saída está em branco	Caminho do arquivo incorreto ou permissões de leitura ausentes.	Verifique se `YOUR_DOCUMENT_DIRECTORY` aponta para o arquivo TXT real e se o processo tem permissões de leitura.
Imagens de baixa qualidade	DPI padrão está baixo.	Use `JpgViewOptions.setResolution(int dpi)` ou `PngViewOptions.setResolution(int dpi)` para aumentar o DPI (ex.: 300).
HTML contém links quebrados	Recursos não incorporados.	Use `HtmlViewOptions.forEmbeddedResources` ou forneça uma pasta de recursos personalizada.
Exceção de licença	Nenhuma licença válida definida.	Carregue seu arquivo de licença com `License license = new License(); license.setLicense("path/to/license.file");` antes de criar o `Viewer`.

Perguntas frequentes

Q: Posso converter arquivos TXT grandes (centenas de MB) com o GroupDocs.Viewer?
A: Sim. A biblioteca faz streaming do arquivo fonte, mas pode ser necessário aumentar o tamanho do heap da JVM para documentos muito grandes.

Q: Preciso de dependências adicionais para gerar JPG ou PNG?
A: Não. O pacote Viewer inclui todas as bibliotecas de processamento de imagem necessárias.

Q: É possível personalizar o tamanho da página PDF?
A: Absolutamente. Use PdfViewOptions.setPageSize(PageSize.A4) ou qualquer outro PageSize antes da renderização.

Q: Como lidar com arquivos TXT protegidos por senha?
A: Arquivos TXT não suportam senhas. Se o arquivo estiver criptografado, descriptografe‑o primeiro antes de passá‑lo ao Viewer.

Q: Posso executar esta conversão em um contêiner Docker?
A: Sim. Basta incluir o JDK, copiar seu pom.xml com a dependência GroupDocs e executar a aplicação Java dentro do contêiner.

Última atualização: 2026-02-21
Testado com: GroupDocs.Viewer 25.2 for Java
Autor: GroupDocs