Cómo utilizar IronPdfEngine

IronPdfEngine es un servidor gRPC diseñado para gestionar varias operaciones de IronPDF, incluyendo la creación, escritura, edición y lectura de PDFs.

Biblioteca Java Maven para PDF

Instalar con Maven

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>2024.3.1</version>
</dependency>
o
Java PDF JAR

Descargar JAR

  Descargar JAR

Instalar manualmente en su proyecto

IronPdf .NET e IronPdfEngine

IronPdf para Java requiere IronPdfEngine para funcionar. El código Java es sólo una máscara API sobre IronPdfEngine gRPC. Así que cuando llames a cualquier método en IronPdf para Java la magia ocurrirá dentro de IronPdfEngine!

Por defecto IronPdf para Java generará IronPdfEngine como un subproceso y hablará con él hasta que su aplicación se cierre.

Tenga en cuenta
Cada versión de IronPdf para Java requiere una versión específica de IronPdfEngine. No se admiten versiones cruzadas.

IronPdf para Java con IronPdfEngine local

Opción 1 descargar IronPdfEngine en tiempo de ejecución

Por defecto, después de instalar IronPdf en su proyecto Java, en la primera ejecución, IronPdf detectará su plataforma (por ejemplo, Windows x64) y descargar los binarios correctos de IronPdfEngine de Internet.

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

Profesionales

  • Su expediente de candidatura será pequeño.
  • Puede implantarse en muchas plataformas

Contras

  • Se necesita acceso a Internet en las primeras carreras
  • Puesta en marcha lenta

Opción 2 (recomendada) instalar IronPdfEngine como dependencia

IronPdf Java le permite añadir IronPdfEngine como dependencia. Estas dependencias de IronPdfEngine agrupan IronPdfEngine en un archivo .zip y se extraerán y utilizarán automáticamente.

Puede elegir instalar una o varias de estas dependencias de IronPdfEngine.

Tenga en cuenta
La versión de dependencia de ironpdf y ironpdf-engine-xxx-xxx debe ser la misma.

La versión de la dependencia ironpdf-engine-xxx-xxx no hace referencia a la versión de IronPdfEngine que contiene.

Para Windows x64

 <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>
XML

Para Linux x64

<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>
XML

Para macOS arm

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

Tenga en cuenta
Cada dependencia es bastante grande, no es buena idea instalarlas todas.

Profesionales

  • Arranque más rápido.
  • El acceso a Internet no es necesario una vez instalada la dependencia.

Contras

  • Su expediente de candidatura será voluminoso.
  • Es necesario especificar las plataformas de destino.

IronPdf para Java con IronPdfEngine remoto

Para utilizar IronPdfEngine remoto se necesita una versión específica de IronPdfEngine. Por ejemplo, si el IronPdf para Java versión 2024.2.2 requiere IronPdfEngine versión 2024.2.2. No utilice IronPdfEngine versión 2024.2.1. Utilice el método getIronPdfEngineVersion para comprobar la versión necesaria.

string ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
JAVA

Cómo conectarse

Supongamos que IronPdfEngine está funcionando remotamente en 123.456.7.8:33350.

Tenga en cuenta
Para ejecutar IronPdfEngine de forma remota, consulte "Cómo extraer y ejecutar IronPdfEngine."

Sólo tienes que decirle a IronPdf dónde está IronPdfEngine (asegúrese de que la dirección es accesible y no está bloqueada por un cortafuegos).

Añada este código en la fase inicial de su aplicación (o justo antes de llamar a cualquier método IronPdf).

com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
JAVA

Así de sencillo! Después de esto su aplicación se conectará al IronPdfEngine remoto!

Para IronPdfEngine remoto, no es necesario instalar IronPdfEngine como dependencia. Puede saltarse la sección titulada "Opción 2 (recomendada) instalar IronPdfEngine como dependencia."