Начало работы с iText 7 Java

iText 7 доступен под двумя лицензиями:

Нажмите стрелку, чтобы развернуть информацию о наших библиотеках.

Инструкции по загрузке являются одинаковыми для обоих и полностью объяснены ниже.


Матрица совместимости



7.0.0 7.0.1 7.0.2 7.0.3 7.0.4 7.0.5 7.0.6 7.0.7 7.1.0 7.1.1 7.1.2
pdfSweep 1.0.0 1.0.1 1.0.1 1.0.1-1.0.2 1.0.2 1.1.0 1.1.0 1.1.1 2.0.0+ 2.0.0+ 2.0.1+
pdfInvoice 1.0.0 1.0.1+ 1.0.1+ 1.0.1+ 1.0.1+ 1.0.1+ 1.0.1+ 1.0.1+ 2.0.0+ 2.0.0+ 2.0.0+
pdfDebug - 1.0.1 1.0.1 1.0.1 1.0.1 1.0.1 1.0.1 1.0.1 2.0.0+ 2.0.0+ 2.0.0+
pdfCalligraph 1.0.0 1.0.1 1.0.2 1.0.2-1.0.3 1.0.3 1.0.3 1.0.3 1.0.3 2.0.0+ 2.0.0+ 2.0.0+
pdfXFA 1.0.0+ 1.0.0+ 1.0.0+ 1.0.0+ 1.0.0+ 1.0.0+ 1.0.0+ 1.0.0+ 2.0.0+ 2.0.0+ 2.0.0+
pdfHTML - - 1.0.0 1.0.0 1.0.1 1.0.2 1.0.3 1.0.4 2.0.0+ 2.0.1+ 2.0.2+
pdf2Data - - - 1.0.8-1.1.3 1.0.8-1.1.3 1.0.8-1.1.3 1.0.8-1.1.3 1.0.8-1.1.3 2.0.0+ 2.0.0+ 2.0.1+


Как загрузить iText 7 Community и надстройки с открытым исходным кодом?

Автоматическое управление зависимостями для iText 7 Community Java

Если вы используете Maven в качестве инструмента построения Java, добавьте следующий фрагмент кода XML в ваш pom.xml. Вам всегда будут нужны kernel, io и layout. Если вам не нужны некоторые функции в iText 7 Community, вы можете добавить только те модули, которые вам нужны.

<dependencies>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>kernel</artifactId>
        <version>${itext.version}</version>
    </dependency>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>io</artifactId>
        <version>${itext.version}</version>
    </dependency>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>layout</artifactId>
        <version>${itext.version}</version>
    </dependency>

    <!-- only needed for forms -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>forms</artifactId>
        <version>${itext.version}</version>
    </dependency>

    <!-- only needed for PDF/A -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>pdfa</artifactId>
        <version>${itext.version}</version>
    </dependency>

    <!-- only needed for digital signatures -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>sign</artifactId>
        <version>${itext.version}</version>
    </dependency>

    <!-- only needed for barcodes -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>barcodes</artifactId>
        <version>${itext.version}</version>
    </dependency>

    <!-- only needed for Asian fonts -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>font-asian</artifactId>
        <version>${itext.version}</version>
    </dependency>

    <!-- only needed for hyphenation -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>hyph</artifactId>
        <version>${itext.version}</version>
    </dependency>

</dependencies>

Если вам нужны все модули iText 7 Community, не нужно добавлять отдельные модули, вы можете просто добавить это в ваш pom.xml . Затем Maven сделает за вас все остальное, загрузив необходимые модули из центрального репозитория .

<dependencies>

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

</dependencies>

iText 7 Community Java на GitHub

Исходный код доступен на GitHub.

  • Вы можете загрузить модули (.jar) iText 7 Community в файлах ZIP из центрального репозитория Maven: iText 7 Community.
  • Разработчики могут клонировать следующие проекты git для доступа к исходному коду iText 7 Community.
  • Загрузить pdfHTML: pdfHTML.
  • Загрузить pdfSweep: pdfSweep.
  • Загрузить pdfInvoice: pdfInvoice.
  • Загрузить pdfDebug: pdfDebug.


Как загрузить iText 7 Core и надстройки?

Лицензионный ключ и библиотека

Если вы приобрели коммерческую лицензию на iText 7 и/или его надстройки, у вас есть лицензионный ключ. Чтобы правильно его использовать, вам нужно будет загрузить соответствующую библиотеку лицензионных ключей. Узнайте подробнее о библиотеках лицензионных ключей. ЧаВо о лицензионном ключе можно найти здесь.

С использованием центрального репозитория

iText 7 Core для Java доступен в центральном репозитории Maven.

В отношении надстроек имейте в виду, что из центрального репозитория Maven можно загрузить только надстройки с открытым исходным кодом (pdfHTML, pdfSweep, pdfInvoice и pdfDebug). Надстройки с закрытым исходным кодом можно загрузить только с серверов iText (см. ниже).

Просто добавьте iText 7 Core в качестве зависимости в ваш pom.xml:

<dependencies>

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

</dependencies>

С использованием сервера iText Artifactory

Поскольку надстройки pdfCalligraph, pdfXFA и pdf2Data и библиотека лицензионных ключей имеют закрытый исходный код, они недоступны в центральном репозитории. Вы можете получить их с сервера iText Artifactory. Там же доступен и iText 7 Core.

Вы можете добавить этот сервер в качестве дополнительного репозитория Maven в разделе repositories вашего pom.xml или settings.xml, как описано в документации Maven. Затем Maven автоматически направит в этот репозиторий запрос файлов .jar надстроек.

Вы также можете перейти на сервер iText Artifactory и загрузить файлы jar вручную.

1. Добавьте репозиторий в файл проекта .pom

<!-- All add-ons and iText 7 core-->
<repositories>
  <repository>
    <id>itext</id>
    <name>iText Repository - releases</name>
    <url>https://repo.itextsupport.com/releases</url>
  </repository>
</repositories>

<!-- pdf2Data-->
<repository>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>false</enabled>
  </snapshots>
  <id>pdf2data-releases</id>
  <name>iText pdf2Data Repository - releases</name>
  <url>https://repo.itextsupport.com/pdf2data</url>
</repository>

2. Добавьте зависимости в файл проекта .pom:

<dependencies>

  <!-- pdfSweep -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>cleanup</artifactId>
    <version>${itext.pdfsweep.version}</version>
  </dependency>

  <!-- pdfCalligraph -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>typography</artifactId>
    <version>${itext.pdfcalligraph.version}</version>
  </dependency>

  <!-- pdfInvoice -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>zugferd</artifactId>
    <version>${itext.pfdinvoice.version}</version>
  </dependency>

  <!-- pdfHTML -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>html2pdf</artifactId>
    <version>${itext.pdfhtml.version}</version>
  </dependency>

  <!-- pdfXFA -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>pdfxfa</artifactId>
    <version>${itext.pdfxfa.version}</version>
  </dependency>

  <!-- pdf2Data -->
<dependency>
  <groupId>com.duallab.pdf2data</groupId>
  <artifactId>pdf2data</artifactId>
  <version>${project.version}</version>
</dependency>

</dependencies>

Имейте в виду, что для pdf2Data после SDK (описано выше) также необходимо установить редактор шаблонов pdf2Data (веб-приложение) – инструкции по установке доступны здесь.


Библиотеки лицензионных ключей

Библиотека лицензионных ключей (itext-licensekey-xyzjar) должна быть указана в пути к классам. Ее можно загрузить из нашего репозитория.
ПРИМЕЧАНИЕ.

  • При использовании лицензионного ключа используйте последнюю версию библиотеки лицензионных ключей. Последняя версия – 3.0.0. Для iText 5 используйте версию 1.

  • С вводом библиотеки лицензионных ключей версии 3.0.0 мы также выпустили механизм подсчета корпоративных лицензий. Этот механизм работает с системой событий. iText и его надстройки отправляют события через систему событий. При загрузке файла корпоративного лицензионного ключа статистика об использовании отправляется ​​на наши серверы. Это означает, что на компьютере, на котором выполняется ваше приложение, требуется активное подключение к Интернету. Нажмите здесь, чтобы ознакомиться с нашим руководством, показывающим, как включить автоматический мониторинг корпоративных лицензий (лицензия на аренду мощностей).

Вы также можете использовать Maven для разрешения этой зависимости. Для этого добавьте сервер iText Artifactory https://repo.itextsupport.com/releases в качестве дополнительного репозитория в разделе "repositories" файла "pom.xml", как описано в документации Maven. Затем вы можете добавить следующую зависимость к вашим зависимостям:

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

Перед вызовом проприетарного кода необходимо загрузить файл лицензии (обычно itextkey.xml). Это делается с использованием статического метода loadLicenseFile () класса LicenseKey: LicenseKey.loadLicenseFile ("путь/к/itextkey.xml"). Вы также можете использовать этот метод с помощью InputStream для файла лицензии.


Как удалить iText 7 Community или Core?

Версия Java – Maven


Чтобы установить iText 7, выполните следующие действия:

  1. Удалите код iText из вашего проекта.
  2. Запустите команду Maven mvn dependency:purge-local-repository -DreResolve=false.
  3. Удалите зависимости iText из вашего pom.xml.
Ссылка: http://maven.apache.org/plugins/maven-dependency-plugin/purge-local-repository-mojo.html