Cómo utilizar IronPdfEngine

Darrius Serrant
Darrius Serrant
22 de febrero, 2024
Actualizado 20 de octubre, 2024
Compartir:
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. Así que cuando llames a cualquier método en IronPdf for Java, la magia ocurrirá 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

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

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

Pros

  • 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
ironpdf y ironpdf-engine-xxx-xxx la versión de la dependencia debe ser la misma.

La versión de dependencia ironpdf-engine-xxx-xxx no se refiere a la versión de IronPdfEngine interna.

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.

Pros

  • 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 IronPdf for Java versión 2024.2.2 requiere IronPdfEngine versión 2024.2.2, no utilices IronPdfEngine versión 2024.2.1. Utiliza el método getIronPdfEngineVersion para verificar la versión necesaria.

String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
JAVA

Cómo conectar

Suponga que IronPdfEngine está en funcionamiento de forma remota en 123.456.7.8:33350

Consulte las instrucciones sobre cómo extraer y ejecutar IronPdfEngine

Solo necesitas decirle a IronPdf dónde se encuentra IronPdfEngine (asegúrate de que esa dirección sea accesible y no esté bloqueada por el firewall). Agregue este código en la etapa inicial de su aplicación (o justo antes de llamar a cualquier método de IronPdf).

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

¡Así de simple! ¡Después de esto, su aplicación estará conectada al Remote IronPdfEngine!

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

Darrius Serrant
Ingeniero de Software Full Stack (WebOps)

Darrius Serrant tiene una licenciatura en Informática de la Universidad de Miami y trabaja como Ingeniero de Marketing WebOps Full Stack en Iron Software. Atraído por la programación desde una edad temprana, veía la computación como algo misterioso y accesible, lo que la convertía en el medio perfecto para la creatividad y la resolución de problemas.

En Iron Software, Darrius disfruta creando cosas nuevas y simplificando conceptos complejos para hacerlos más comprensibles. Como uno de nuestros desarrolladores residentes, también se ha ofrecido como voluntario para enseñar a los estudiantes, compartiendo su experiencia con la próxima generación.

Para Darrius, su trabajo es gratificante porque es valorado y tiene un impacto real.