Cómo utilizar IronPdfEngine

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

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

{Enlace para descargar IronPDF for Java en ironpdf.com}

IronPDF for Java e IronPdfEngine

IronPDF for Java requiere IronPdfEngine para ejecutarse. El código Java es sólo una máscara de API sobre IronPdfEngine gRPC. Cuando llame a cualquier método de IronPDF for Java, la magia se producirá dentro de IronPdfEngine!

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

Atención
Cada versión de IronPDF for Java requiere una versión específica de IronPdfEngine. No se admite la compatibilidad entre versiones.

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

Professionales

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

Contras

  • Se necesita acceso a Internet en las primeras carreras
  • Tiempo de arranque lento

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.

Atención
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

Atención
Cada dependencia es bastante grande, por lo que no es aconsejable instalarlas todas.

Professionales

  • Tiempo de arranque más rápido.
  • No se necesita acceso a Internet 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 a distancia, se necesita una versión específica de IronPdfEngine. Por ejemplo, si la versión 2024.2.2 de IronPDF for Java requiere la versión 2024.2.2 de IronPdfEngine, no utilice la versión 2024.2.1 de IronPdfEngine. Utilice el método getIronPdfEngineVersion para comprobar la versión necesaria.

String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
JAVA

Cómo conectar

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

Consulte las instrucciones sobre cómo extraer y ejecutar IronPdfEngine

Sólo tienes que decirle a IronPdf dónde está IronPdfEngine(por favor, asegúrese de que la dirección es accesible, no bloqueada por el 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."