1. IronPDF
  2. Comenzar
  3. Usar IronPdfEngine

Cómo usar IronPdfEngine

Curtis Chau
Curtis Chau
Actualizado:
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 diversas operaciones de IronPDF, incluyendo crear, escribir, editar y leer PDFs.

Cómo utilizar IronPdfEngine como servidor remoto

  1. Instalar la biblioteca de Java para utilizar IronPdfEngine
  2. Incluye la biblioteca en el archivo pom.xml
  3. Utilize the `setIronPdfEngineHost` method to configure the host
  4. Utilize the `setIronPdfEnginePort` method to configure the port
  5. Utilice IronPdfEngine para convertir HTML en PDF con un renderizador idéntico al de Chrome

Enlace para descargar IronPDF para Java en IronPDF.com

IronPDF for Java y IronPdfEngine

IronPdf para Java requiere IronPdfEngine para ejecutarse. El código Java sirve como una máscara de API sobre IronPdfEngine gRPC. Cuando invocas cualquier método en IronPdf para Java, ¡el procesamiento real ocurre dentro de IronPdfEngine!

Por defecto, IronPdf para Java lanzará IronPdfEngine como un subproceso e interactuará con él hasta que tu aplicación se cierre.

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

IronPDF for Java con IronPdfEngine local

Opción 1: Descargar IronPdfEngine en tiempo de ejecución Por defecto, después de instalar IronPdf en tu proyecto Java, en la ejecución inicial, IronPdf detectará tu plataforma (por ejemplo, Windows x64) y descargará los binarios apropiados de IronPdfEngine de 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

Pros

  • El paquete de tu aplicación será pequeño.
  • Puede desplegarse en muchas plataformas.

Cons

  • Se necesita acceso a internet en las primeras ejecuciones.
  • Tiempo de inicio lento.

Opción 2 (recomendada): Instalar IronPdfEngine como una dependencia IronPDF for Java te permite agregar IronPdfEngine directamente como una dependencia. Estas dependencias envuelven IronPdfEngine en un archivo .zip, extrayendo y usándolo automáticamente.

Puedes elegir instalar una o más de estas dependencias de IronPdfEngine.

Por favor notaironpdf y ironpdf-engine-xxx-xxx deben coincidir. ironpdf-engine-xxx-xxx no se refiere a la versión interna de 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

Por favor notaCada dependencia es bastante grande, por lo que no es aconsejable instalarlas todas.

Pros

  • Tiempo de inicio más rápido.
  • No se necesita acceso a internet después de instalar la dependencia.

Cons

  • El paquete de tu aplicación será grande.
  • Necesidad de especificar plataformas objetivo.

IronPDF for Java con IronPdfEngine remoto

Para usar un IronPdfEngine remoto, se necesita una versión específica. Por ejemplo, si IronPdf para Java versión 2024.2.2 requiere la versión 2024.2.2 de IronPdfEngine, no uses la versión 2024.2.1. Usa el método getIronPdfEngineVersion para verificar la versión requerida.

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

Cómo conectarse

Supón que IronPdfEngine está ejecutándose remotamente en 123.456.7.8:33350.

Para conectar, especifica la ubicación de IronPdfEngine (asegúrate de que la dirección sea accesible y no esté bloqueada por firewalls). Agrega este código durante la etapa inicial de tu aplicación (o justo antes de invocar cualquier método 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

¡Simple como eso! ¡Después de ejecutar este código, tu aplicación se conecta al IronPdfEngine remoto!

Para IronPdfEngine remoto, no es necesario instalar IronPdfEngine como una dependencia.

Preguntas Frecuentes

¿Qué es IronPdfEngine y cómo se relaciona con las operaciones de PDF en Java?

IronPdfEngine es un servidor gRPC que maneja operaciones de PDF como creación, edición y lectura. En Java, funciona como el backend de IronPDF, que actúa como una máscara de API sobre IronPdfEngine.

¿Cómo puedo renderizar HTML a PDF en Java usando IronPdfEngine?

Puedes usar la biblioteca IronPDF en Java para renderizar HTML en PDFs. El proceso involucra configurar IronPdfEngine y usar sus métodos, como RenderHtmlAsPdf, para convertir contenido HTML a formato PDF.

¿Por qué las operaciones de PDF en Java requieren compatibilidad de versión con IronPdfEngine?

La compatibilidad de versión es crucial ya que cada versión de IronPDF para Java está diseñada para trabajar con una versión específica de IronPdfEngine, asegurando operaciones fluidas y previniendo problemas de compatibilidad.

¿Cuáles son las ventajas de usar IronPdfEngine localmente en proyectos Java?

Usar IronPdfEngine localmente puede llevar a tiempos de inicio más rápidos y eliminar la necesidad de acceso a internet después de la instalación. Permite un procesamiento de PDF más eficiente directamente dentro de la aplicación Java.

¿Cómo configuro IronPdfEngine para su uso en un servidor remoto en Java?

Para configurar IronPdfEngine para uso remoto, establece el host y puerto del servidor usando los métodos setIronPdfEngineHost y setIronPdfEnginePort en tu aplicación Java, asegurando que el servidor sea accesible.

¿Qué debo considerar al decidir descargar binarios de IronPdfEngine en tiempo de ejecución?

Descargar binarios en tiempo de ejecución resulta en un paquete de aplicación más pequeño y flexibilidad en el despliegue multiplataforma. Sin embargo, requiere acceso a internet inicialmente y puede resultar en tiempos de inicio más lentos.

¿Puede utilizarse IronPdfEngine sin instalarlo como dependencia?

Sí, IronPdfEngine puede usarse sin instalación como dependencia descargando los binarios necesarios en tiempo de ejecución. Este enfoque es adecuado para entornos dinámicos donde el tamaño de la aplicación es una preocupación.

¿Cómo aseguro que mi biblioteca Java de PDF está usando la versión correcta de IronPdfEngine?

Puedes verificar la versión de IronPdfEngine requerida para tu biblioteca Java de PDF usando el método getIronPdfEngineVersion, asegurando compatibilidad y funcionalidad adecuada.

¿Cuáles son los pasos para instalar IronPdfEngine en un proyecto de Java?

Para instalar IronPdfEngine, incluye la biblioteca Java de IronPDF en tu proyecto, configura el host y puerto del servidor, y conéctate a IronPdfEngine usando los ajustes apropiados en el código de tu aplicación.

¿Es necesario tener acceso a internet al usar IronPdfEngine en Java?

El acceso a internet es necesario cuando se elige descargar binarios de IronPdfEngine en tiempo de ejecución. Sin embargo, si IronPdfEngine se instala como una dependencia, no se requiere acceso a internet después de la configuración inicial.

¿IronPDF es compatible con .NET 10 y qué beneficios aporta?

Sí. IronPDF es compatible con .NET 10 sin necesidad de soluciones alternativas, lo que proporciona un mejor rendimiento, mayor estabilidad en tiempo de ejecución y compatibilidad con las nuevas funciones del lenguaje. Funciona a la perfección con todas las versiones modernas de .NET, incluidas .NET 8, 9 y 10.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Versión: 2025.12 recién lanzado