Biblioteca Java para renderização de PDF (Tutorial para desenvolvedores)

Instalando o IronPDF em um projeto Maven

O Maven é uma ferramenta popular de automação de compilação e gerenciamento de dependências para projetos Java. Para instalar o IronPDF em seu projeto Maven, você precisará adicionar as dependências necessárias ao seu arquivo pom.xml.

Veja como adicionar o IronPDF e sua dependência de registro (logger) necessária, o SLF4J, ao seu projeto Maven:

1. Abra o arquivo pom.xml do seu projeto.
2. Localize a seção dependencies. Se não existir, crie um.

3. Adicione as seguintes entradas de dependência para IronPDF e SLF4J:

   <dependencies>
   
       <dependency>
           <groupId>com.ironsoftware</groupId>
           <artifactId>ironpdf</artifactId>
           <version>2023.10.1</version>
       </dependency>
   
       <dependency>
           <groupId>org.slf4j</groupId>
           <artifactId>slf4j-api</artifactId>
           <version>2.0.7</version>
       </dependency>
   </dependencies>

   <dependencies>
   
       <dependency>
           <groupId>com.ironsoftware</groupId>
           <artifactId>ironpdf</artifactId>
           <version>2023.10.1</version>
       </dependency>
   
       <dependency>
           <groupId>org.slf4j</groupId>
           <artifactId>slf4j-api</artifactId>
           <version>2.0.7</version>
       </dependency>
   </dependencies>

   XML
4. Salve o arquivo pom.xml.
5. Execute seu projeto Maven, seja através de sua IDE ou executando o comando mvn install no diretório raiz do seu projeto. O Maven fará o download e adicionará automaticamente as dependências IronPDF e SLF4J ao seu projeto.

Agora que você adicionou o IronPDF ao seu projeto Maven com sucesso, pode começar a usar esta poderosa biblioteca Java para PDF para criar, editar e manipular documentos PDF em seus aplicativos Java. Não se esqueça de consultar a documentação do IronPDF para obter mais exemplos e informações detalhadas sobre os recursos e capacidades da biblioteca. Vamos explorar algumas funcionalidades aqui.

Convertendo HTML para PDF

Uma das tarefas mais comuns ao trabalhar com PDFs é converter HTML em PDF usando o IronPDF . O IronPDF torna isso muito fácil com apenas algumas linhas de código. Aqui está um exemplo que demonstra como converter uma string HTML simples em um documento PDF:

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

public class HtmlToPdfExample {
    public static void main(String[] args) {
        try {
            // Apply your license key
            License.setLicenseKey("YOUR-LICENSE-KEY");

            // Set a log path
            Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

            // Render the HTML as a PDF, stored in myPdf as type PdfDocument
            PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1>Hello World</h1> Made with IronPDF!");

            // Save the PdfDocument to a file
            myPdf.saveAs(Paths.get("html_saved.pdf"));
        } catch (IOException e) {
            System.out.println("An error occurred: " + e.getMessage());
        }
    }
}

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

public class HtmlToPdfExample {
    public static void main(String[] args) {
        try {
            // Apply your license key
            License.setLicenseKey("YOUR-LICENSE-KEY");

            // Set a log path
            Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

            // Render the HTML as a PDF, stored in myPdf as type PdfDocument
            PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1>Hello World</h1> Made with IronPDF!");

            // Save the PdfDocument to a file
            myPdf.saveAs(Paths.get("html_saved.pdf"));
        } catch (IOException e) {
            System.out.println("An error occurred: " + e.getMessage());
        }
    }
}

Este trecho de código importa as classes IronPDF necessárias e aplica uma chave de licença. Em seguida, define um caminho de registro para fins de depuração. O método renderHtmlAsPdf recebe uma string HTML como entrada e a converte em um documento PDF, que você pode então salvar em um arquivo.

O arquivo PDF de saída

Converter arquivos HTML para PDF

O IronPDF também suporta a conversão de arquivos HTML em documentos PDF . O processo é bastante semelhante ao exemplo anterior, com uma pequena alteração no método utilizado:

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

public class HtmlFileToPdfExample {
    public static void main(String[] args) {
        try {
            // Apply your license key
            License.setLicenseKey("YOUR-LICENSE-KEY");

            // Set a log path
            Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

            // Render the HTML file as a PDF, stored in myPdf as type PdfDocument
            PdfDocument myPdf = PdfDocument.renderHtmlFileAsPdf("example.html");

            // Save the PdfDocument to a file
            myPdf.saveAs(Paths.get("html_file_saved.pdf"));
        } catch (IOException e) {
            System.out.println("An error occurred: " + e.getMessage());
        }
    }
}

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

public class HtmlFileToPdfExample {
    public static void main(String[] args) {
        try {
            // Apply your license key
            License.setLicenseKey("YOUR-LICENSE-KEY");

            // Set a log path
            Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

            // Render the HTML file as a PDF, stored in myPdf as type PdfDocument
            PdfDocument myPdf = PdfDocument.renderHtmlFileAsPdf("example.html");

            // Save the PdfDocument to a file
            myPdf.saveAs(Paths.get("html_file_saved.pdf"));
        } catch (IOException e) {
            System.out.println("An error occurred: " + e.getMessage());
        }
    }
}

Neste caso, o método renderHtmlFileAsPdf é usado em vez de renderHtmlAsPdf, recebendo o caminho para o arquivo HTML como entrada e criando documentos PDF.

Converter URLs em PDFs

O IronPDF é capaz de converter páginas da web em documentos PDF . Isso é particularmente útil quando você deseja gerar um relatório em PDF a partir de uma página da web dinâmica. O seguinte trecho de código demonstra como fazer isso:

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

public class UrlToPdfExample {
    public static void main(String[] args) {
        try {
            // Apply your license key
            License.setLicenseKey("YOUR-LICENSE-KEY");

            // Set a log path
            Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

            // Render the URL as a PDF, stored in myPdf as type PdfDocument
            PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");

            // Save the PdfDocument to a file
            myPdf.saveAs(Paths.get("url.pdf"));
        } catch (IOException e) {
            System.out.println("An error occurred: " + e.getMessage());
        }
    }
}

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

public class UrlToPdfExample {
    public static void main(String[] args) {
        try {
            // Apply your license key
            License.setLicenseKey("YOUR-LICENSE-KEY");

            // Set a log path
            Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

            // Render the URL as a PDF, stored in myPdf as type PdfDocument
            PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");

            // Save the PdfDocument to a file
            myPdf.saveAs(Paths.get("url.pdf"));
        } catch (IOException e) {
            System.out.println("An error occurred: " + e.getMessage());
        }
    }
}

O método renderUrlAsPdf recebe uma URL como entrada e cria arquivos PDF a partir do conteúdo da página da web. Este método consegue lidar com páginas complexas, incluindo aquelas com JavaScript e CSS.

O arquivo PDF gerado a partir de uma URL

Extraindo texto de PDFs

Além de criar PDFs, o IronPDF também oferece funcionalidades para extrair texto de documentos PDF existentes. Essa funcionalidade pode ser útil quando você precisa pesquisar, indexar ou analisar o conteúdo de um arquivo PDF. O trecho de código a seguir mostra como extrair texto de um documento PDF:

import com.ironsoftware.ironpdf.*;

public class ExtractTextFromPdfExample {
    public static void main(String[] args) {
        // Render PDF from a URL
        PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://unsplash.com/");

        // Extract all text from the PDF document
        String text = pdf.extractAllText();

        // Output the extracted text
        System.out.println("Text extracted from the PDF: " + text);
    }
}

import com.ironsoftware.ironpdf.*;

public class ExtractTextFromPdfExample {
    public static void main(String[] args) {
        // Render PDF from a URL
        PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://unsplash.com/");

        // Extract all text from the PDF document
        String text = pdf.extractAllText();

        // Output the extracted text
        System.out.println("Text extracted from the PDF: " + text);
    }
}

Neste exemplo, um PDF é gerado a partir de uma URL e o método extractAllText é usado para obter o conteúdo de texto do documento PDF. O texto extraído pode então ser impresso no console ou manipulado conforme necessário.