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를 위한 자동 종속성 관리

Java 언어 환경을 위해 Maven을 빌드툴로 사용하고 있다면 다음 XML 스니펫을 추가하십시오. pom.xml. 또한 커널, io 그리고 레이아웃이 필요합니다. 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>

GitHub의 iText 7 Community Java

소스 코드는 GitHub에서 확인할 수 있습니다.

  • Maven Central에서 iText 7 Community의 (.jar) 모듈을 ZIP 파일로 다운로드할 수 있습니다. iText 7 Community.
  • 개발자는 소스 코드에 액세스하기 위해 다음 git 프로젝트들을 복제할 수 있습니다. iText 7 Community.
  • pdfHTML 다운로드: pdfHTML.
  • pdfSweep 다운로드: pdfSweep.
  • pdfInvoice 다운로드: pdfInvoice.
  • pdfDebug 다운로드: pdfDebug.


iText 7 Core 및 애드온을 다운로드하려면?

라이센스 키 및 라이브러리

만약 iText 7 및/또는 애드온에 대한 상용 라이센스 를 구입했다면 라이센스 키가 있을 것입니다. 이를 적절하게 사용하기 위해서는 적절한 라이센스 키 라이브러리를 다운로드해야 합니다. 라이센스 키 라이브러리에 대해 자세히 읽어보십시오. 라이센스 키에 대한 FAQ는 여기에서 확인할 수 있습니다.

중앙 저장소 사용

Java용 iText 7 Core는 Maven의 중앙 저장소에서 이용할 수 있습니다.

애드온의 경우 Maven의 중앙 저장소에서 오픈 소스 애드온(pdfHTML, pdfSweep, pdfInvoice, pdfDebug)만 다운로드할 수 있습니다. 클로즈드 소스 애드온은 iText 서버에서만 다운로드할 수 있으며 자세한 사항은 하단을 참조해주십시오.

pom.xml에 iText 7 Core를 종속성으로 추가하기만 하면 됩니다.

<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 문서에 기술되어 있다시피, 이 서버를 pom.xml 또는 settings.xmlrepositories에 추가적인 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>

주의사항 SDK를 먼저 설치한 후 pdf2Data를 설치해야 하며, 또한 pdf2Data 템플릿 에디터(웹 애플리케이션)도 설치할 필요가 있습니다 - 설치에 관한 설명은 다음에서 확인할 수 있습니다. 설치 알아보기.


라이센스 키 라이브러리

라이센스 키 라이브러리(itext-licensekey-x.y.z.jar)는 클래스 경로에 있어야 합니다. 저장소에서 다운로드할 수 있습니다.
참고:

  • 라이센스 키를 사용할 때에는 최신 버전으로 사용하십시오. 최신 버전의 넘버는 3.0.0입니다. iText 5의 경우 버전 1을 사용하십시오.

  • 라이센스 키 라이브러리 3.0.0 버전과 함께 볼륨 기반 카운팅 메커니즘도 출시되었습니다. 이 메커니즘은 이벤트 시스템에서 작동합니다. iText 및 애드온은 이 이벤트 시스템을 통해 이벤트를 전송하게 됩니다. 볼륨 라이센스 키 파일이 로드되면 사용량과 관련된 통계가 서버로 전송됩니다. 이는 애플리케이션을 실행하는 기기가 인터넷 연결을 활성화해야 한다는 것을 의미합니다. 여기를 클릭해서 볼륨 라이센스(Capacity Rental License)의 자동화 모니터링을 사용하는 방법을 설명하는 가이드를 읽어보십시오.

이 종속성을 해결하기 위해 Maven을 사용할 수 있습니다. 그렇게 하기 위해서는 Maven 문서에 기술되어 있다시피, iText Artifactory 서버https://repo.itextsupport.com/releases를 'pom.xml'의 'repositories'에 추가적인 저장소로 추가할 수 있습니다. 그런 다음 다음과 같은 종속성을 종속성 리스트에 추가할 수 있습니다.

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

라이센스 키(대표적으로 itextkey.xml)는 사유 코드를 호출하기 전 로드해야 합니다. 이는 LicenseKey클래스의 static 메소드 loadLicenseFile()를 사용해 이루어집니다. LicenseKey.LoadLicenseFile(“path/to/itextkey.xml”). 또한 라이센스 파일에 이 메소드와 InputStream를 함께 사용할 수 있습니다.


iText 7 Community 또는 Core를 제거하려면?

Java 버전 - Maven


다음을 따라 iText 7를 설치하십시오.

  1. 프로젝트로부터 iText 코드를 제외합니다.
  2. Maven 명령어를 실행합니다. mvn dependency:purge-local-repository -DreResolve=false
  3. pom.xml로부터 iText 종속성을 제외합니다.
참조: http://maven.apache.org/plugins/maven-dependency-plugin/purge-local-repository-mojo.html