Primeros pasos con iText 7 Java

iText 7 está disponible con dos licencias:

Haz clic en la flecha para ampliar la información sobre nuestras bibliotecas.

Las instrucciones de descarga son idénticas para ambos, y se explican con detalle a continuación.


Matriz de compatibilidad

iText 7 Core7.0.07.0.17.0.27.0.37.0.47.0.57.1.0

Clave de licencia

3.0.0

pdf2Data

1.2.0

-

-

pdfCalligraph

2.0.0

-

-

-

-

-

-

pdfDebug

2.0.0

-

pdfHTML

2.0.0

-

-

-

-

-

-

pdfInvoice

2.0.0

-

pdfSweep

2.0.0

-

-

-

-

-

pdfXFA

2.0.0


¿Cómo se descargan iText 7 Community y los complementos de código abierto?

Gestión de dependencias automatizada para iText 7 Community Java

Si utilizas Maven como herramienta de compilación para Java, añade el siguiente fragmento XML a tu pom.xml. Siempre necesitarás kernel, io y layout. Si no necesitas algunas de las funciones de iText 7 Community, puedes añadir solo los módulos que necesites.

<dependencies>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>kernel</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>io</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>layout</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for forms -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>forms</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for PDF/A -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>pdfa</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for digital signatures -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>sign</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for barcodes -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>barcodes</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for Asian fonts -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>font-asian</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for hyphenation -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>hyph</artifactId>
        <version>7.1.0</version>
    </dependency>

</dependencies>

Si necesitas todos los módulos de iText 7 Community, no es necesario que añadas los módulos individuales y simplemente puedes añadir esto en tu pom.xml. Maven te quitará todo el trabajo pesado y descargará los módulos necesarios del repositorio central.

<dependencies>

    <!-- add all iText 7 Community modules -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itext7-core</artifactId>
        <version>7.1.0</version>
        <type>pom</type>
    </dependency>

</dependencies>

iText 7 Community Java en GitHub

El código fuente está disponible en GitHub. La versión más reciente es iText 7.1.0, que se lanzó el 6 de diciembre de 2017.


¿Cómo se descargan iText 7 Core y los complementos?

Clave de licencia y biblioteca

Si has comprado una licencia comercial de iText 7 o sus complementos, tienes una clave de licencia. Para utilizarla correctamente, debes descargar la biblioteca de claves de licencia correspondiente. Leer más sobre las bibliotecas de claves de licencia. Aquí encontrarás las preguntas más frecuentes sobre las claves de licencia.

Uso del repositorio central

iText 7 Core para Java está disponible a través de Maven en el repositorio central. Solo los complementos de código abierto se pueden descargar desde el repositorio central de Maven. Los complementos de código cerrado únicamente se pueden descargar desde los servidores de iText (ver a continuación).
Solo tienes que añadir iText 7 Core como dependencia a pom.xml:

<dependencies>

    <!-- add all iText 7 Core modules -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itext7-core</artifactId>
        <version>7.1.0</version>
        <type>pom</type>
    </dependency>

</dependencies>

Uso del servidor iText Artifactory

Dado que los complementos pdfCalligraph, pdfXFA y pdf2Data, así como la biblioteca de claves de licencia, son de código cerrado, no están disponibles en el repositorio central.

Puedes obtenerlos en el servidor de iText Artifactory. iText 7 Core también está disponible en dicho servidor.

Puedes añadir este servidor como repositorio adicional de Maven en la sección repositories de pom.xml o settings.xml, como se describe en la documentación de Maven. Maven consultará automáticamente en este repositorio los archivos .jar adicionales.

También puedes examinar el servidor iText Artifactory y descargar manualmente los archivos .jar.

<repositories>
  <repository>
    <id>itext</id>
    <name>iText Repository - releases</name>
    <url>https://repo.itextsupport.com/releases</url>
  </repository>
</repositories>

2. Add the dependencies to .pom project file:

<dependencies>

  <!-- pdfSweep -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>cleanup</artifactId>
    <version>2.0.0</version>
  </dependency>

  <!-- pdfCalligraph -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>typography</artifactId>
    <version>2.0.0</version>
  </dependency>

  <!-- pdfInvoice -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>zugferd</artifactId>
    <version>2.0.0</version>
  </dependency>

  <!-- pdfHTML -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>html2pdf</artifactId>
    <version>2.0.0</version>
  </dependency>

  <!-- pdfXFA -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>pdfxfa</artifactId>
    <version>2.0.0</version>
  </dependency>

</dependencies>

Bibliotecas de claves de licencia

La biblioteca de claves de licencia (itext-licensekey-x.y.z.jar) debe estar en classpath. Puedes descargarla de nuestro repositorio.
NOTA: Utiliza la versión más reciente de la biblioteca de claves de licencia cuando utilices tu clave de licencia. La versión más reciente es la 3.0.0. Para iText 5, usa la versión 1.

También puedes usar Maven para resolver esta dependencia. Para ello, añade el servidor de iText Artifactory, https://repo.itextsupport.com/releases, como repositorio adicional en la sección repositories de pom.xml, como se describe en la documentación de Maven. A continuación, puedes añadir la siguiente dependencia a tus dependencias:

<dependencies>
  <!-- iText 7 License Key Library -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext-licensekey</artifactId>
    <version>3.0.0</version>
  </dependency>
</dependencies>

Es necesario cargar el archivo de licencia (normalmente itextkey.xml) antes de llamar al código propietario. Para ello, se utiliza el método estático loadLicenseFile() de la clase LicenseKey: LicenseKey.loadLicenseFile("path/to/itextkey.xml"). También puedes utilizar este método con un InputStream en el archivo de licencia.


¿Cómo se desinstalan iText 7 Community o Core?

Versión Java - Maven


Para instalar iText 7, sigue este procedimiento:

  1. Extrae el código de iText del proyecto.
  2. Ejecuta el comando Maven mvn dependency:purge-local-repository -DreResolve=false.
  3. Extrae las dependencias de iText de pom.xml.
Referencia: http://maven.apache.org/plugins/maven-dependency-plugin/purge-local-repository-mojo.html