1. IronPDF
  2. Comece agora
  3. Use o IronPDFEngine

Como usar o IronPdfEngine

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

O IronPdfEngine é um servidor gRPC projetado para gerenciar várias operações do IronPDF , incluindo a criação, escrita, edição e leitura de PDFs.

Como usar o IronPdfEngine como um servidor remoto

  1. Instale a biblioteca Java para utilizar o IronPdfEngine.
  2. Inclua a biblioteca no arquivo pom.xml
  3. Utilize the `setIronPdfEngineHost` method to configure the host
  4. Utilize the `setIronPdfEnginePort` method to configure the port
  5. Use o IronPdfEngine para renderizar HTML em PDF com um mecanismo de renderização idêntico ao do Chrome.

Link para baixar o IronPDF for Java em IronPDF

IronPDF for Java e IronPdfEngine

O IronPDF for Java requer o IronPdfEngine para funcionar. O código Java serve como uma máscara de API sobre o gRPC do IronPdfEngine. Ao invocar qualquer método no IronPDF for Java, o processamento real ocorre dentro do IronPdfEngine!

Por padrão, o IronPDF for Java criará o IronPdfEngine como um subprocesso e interagirá com ele até que seu aplicativo seja encerrado.

ObserveCada versão do IronPDF for Java requer uma versão específica do IronPdfEngine. A compatibilidade entre versões não é suportada.

IronPDF for Java com IronPdfEngine local

Opção 1: Baixar o IronPdfEngine em tempo de execução Por padrão, após instalar o IronPDF em seu projeto Java, na primeira execução, o IronPDF detectará sua plataforma (por exemplo, Windows x64) e baixará os binários apropriados do IronPdfEngine da internet.

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>
XML

Prós

  • Seu pacote de inscrição será pequeno.
  • Pode ser implementado em diversas plataformas.

Contras

  • É necessário acesso à internet nas primeiras execuções.
  • Tempo de inicialização lento.

Opção 2 (recomendada): Instale o IronPdfEngine como uma dependência. O IronPDF Java permite adicionar o IronPdfEngine diretamente como uma dependência. Essas dependências empacotam o IronPdfEngine em um arquivo .zip, extraindo-o e utilizando-o automaticamente.

Você pode optar por instalar uma ou mais dessas dependências do IronPdfEngine.

Observeironpdf e ironpdf-engine-xxx-xxx a versão da dependência deve ser a mesma. ironpdf-engine-xxx-xxx não se refere à versão interna do IronPdfEngine.

Para Windows x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Para Windows x86

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Para Linux x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Para macOS x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Para macOS arm

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

ObserveCada dependência é bastante grande, portanto, instalar todas elas não é recomendável.

Prós

  • Tempo de inicialização mais rápido.
  • Não é necessário acesso à internet após a instalação da dependência.

Contras

  • Seu pacote de inscrição será extenso.
  • É necessário especificar as plataformas de destino.

IronPDF for Java com IronPdfEngine remoto

Para usar um IronPdfEngine remoto, é necessária uma versão específica. Por exemplo, se o IronPDF for Java versão 2024.2.2 requer o IronPdfEngine versão 2024.2.2, não use a versão 2024.2.1. Use o método getIronPdfEngineVersion para verificar a versão necessária.

// Get the version of the IronPdfEngine needed for the current Java version
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
// Get the version of the IronPdfEngine needed for the current Java version
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
JAVA

Como conectar

Suponha que o IronPdfEngine esteja sendo executado remotamente em 123.456.7.8:33350.

Para conectar, especifique a localização do IronPdfEngine (certifique-se de que o endereço esteja acessível e não esteja bloqueado por firewalls). Adicione este código durante a fase inicial da sua aplicação (ou imediatamente antes de invocar qualquer método do IronPDF ).

// Set the host and port for a remote IronPdfEngine connection
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
// Set the host and port for a remote IronPdfEngine connection
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
JAVA

Simples assim! Após executar este código, seu aplicativo se conecta ao IronPdfEngine remoto!

Para o IronPdfEngine remoto, não é necessário instalar o IronPdfEngine como uma dependência.

Perguntas frequentes

O que é o IronPDFEngine e como ele se relaciona com as operações de PDF em Java?

IronPDFEngine é um servidor gRPC que lida com operações em PDF, como criação, edição e leitura. Em Java, ele funciona como o backend do IronPDF, que serve como uma interface de API para o IronPDFEngine.

Como posso renderizar HTML para PDF em Java usando IronPDFEngine?

Você pode usar a biblioteca IronPDF em Java para renderizar HTML em PDFs. O processo envolve configurar o IronPDFEngine e usar seus métodos, como RenderHtmlAsPdf , para converter o conteúdo HTML para o formato PDF.

Por que as operações em Java com PDFs exigem compatibilidade de versão com o IronPDFEngine?

A compatibilidade de versões é crucial, pois cada versão do IronPDF for Java é projetada para funcionar com uma versão específica do IronPDFEngine, garantindo operações perfeitas e evitando problemas de compatibilidade.

Quais são as vantagens de usar o IronPDFEngine localmente em projetos Java?

Utilizar o IronPDFEngine localmente pode resultar em tempos de inicialização mais rápidos e eliminar a necessidade de acesso à internet após a instalação. Isso permite um processamento de PDF mais eficiente diretamente dentro da aplicação Java.

Como configuro o IronPDFEngine para uso em servidor remoto em Java?

Para configurar o IronPDFEngine para uso remoto, defina o host e a porta do servidor usando os métodos setIronPDFEngineHost e setIronPDFEnginePort em sua aplicação Java, garantindo que o servidor esteja acessível.

O que devo levar em consideração ao decidir baixar os binários do IronPDFEngine em tempo de execução?

O download de binários em tempo de execução resulta em um pacote de aplicativo menor e maior flexibilidade de implantação multiplataforma. No entanto, requer acesso à internet inicialmente e pode resultar em tempos de inicialização mais lentos.

É possível usar o IronPDFEngine sem instalá-lo como uma dependência?

Sim, o IronPDFEngine pode ser usado como uma dependência sem instalação, baixando os binários necessários em tempo de execução. Essa abordagem é adequada para ambientes dinâmicos onde o tamanho do aplicativo é uma preocupação.

Como posso garantir que minha biblioteca Java PDF esteja usando a versão correta do IronPDFEngine?

Você pode verificar a versão do IronPDFEngine necessária para sua biblioteca Java PDF usando o método getIronPDFEngineVersion , garantindo compatibilidade e funcionalidade adequada.

Quais são os passos para instalar o IronPDFEngine em um projeto Java?

Para instalar o IronPDFEngine, inclua a biblioteca Java IronPDF em seu projeto, configure o host e a porta do servidor e conecte-se ao IronPDFEngine usando as configurações apropriadas no código do seu aplicativo.

É necessário ter acesso à internet ao usar o IronPDFEngine em Java?

O acesso à internet é necessário ao optar por baixar os binários do IronPDFEngine em tempo de execução. No entanto, se o IronPDFEngine for instalado como uma dependência, o acesso à internet não será necessário após a configuração inicial.

O IronPDF é compatível com o .NET 10 e quais são os benefícios disso?

Sim. O IronPDF é compatível com o .NET 10 sem a necessidade de soluções alternativas, proporcionando melhor desempenho, maior estabilidade em tempo de execução e compatibilidade com novos recursos da linguagem. Ele funciona perfeitamente com todas as versões modernas do .NET, incluindo .NET 8, 9 e 10.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas?
executar um exemplo Veja seu HTML se transformar em um PDF.