itext Samouczek
Rozpoczęcie pracy z itext

Uwagi

Wersje

Instalacja lub konfiguracja

iText dla Java

Importowanie słoików iText z centralnego repozytorium Maven jest najlepszym sposobem na zainstalowanie iText 7. Te proste filmy wyjaśniają, jak to zrobić przy użyciu różnych IDE:

• Jak zaimportować iText 7 do Eclipse, aby utworzyć plik PDF Hello World?
• Jak zaimportować iText 7 do Netbeans, aby utworzyć plik PDF Hello World?
• Jak zaimportować iText 7 do IntelliJ IDEA, aby utworzyć plik PDF Hello World?

W tych samouczkach definiujemy tylko kernel i projekty layout jako zależności. Maven automatycznie importuje również słoik io ponieważ pakiety kernel zależą od pakietów io .

Oto podstawowa lista zależności dla standardowego użytkowania iText 7:

<dependencies>
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>kernel</artifactId>
        <version>7.0.0</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>io</artifactId>
        <version>7.0.0</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>layout</artifactId>
        <version>7.0.0</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>forms</artifactId>
        <version>7.0.0</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>pdfa</artifactId>
        <version>7.0.0</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>pdftest</artifactId>
        <version>7.0.0</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>1.7.18</version>
    </dependency>
</dependencies>

Każda zależność odpowiada jarowi w Javie i DLL w języku C #.

• kernel i io : zawierają funkcjonalność niskiego poziomu.
• layout : zawiera funkcje wysokiego poziomu.
• forms : potrzebne dla wszystkich przykładów AcroForm.
• pdfa : potrzebne do funkcjonalności specyficznej dla PDF / A.
• pdftest : potrzebny do przykładów, które są również testem.

Do bardziej szczegółowego wykorzystania iText 7 mogą być potrzebne dodatkowe słoiki:

• barcodes : użyj tego, jeśli chcesz tworzyć kody kreskowe.
• hyph : użyj tego, jeśli chcesz, aby tekst był dzielony.
• font-asian : użyj tego, potrzebujesz funkcji CJK (chiński / japoński / koreański)
• sign : użyj tego, jeśli potrzebujesz wsparcia dla podpisów cyfrowych.

Wszystkie wymienione powyżej słoiki są dostępne na licencji AGPL. Możesz również pobrać te słoiki w pliku ZIP hostowanym na Github: https://github.com/itext/itext7/releases

Jeśli chcesz użyć tych słoików, musisz dodać je do swojej CLASSPATH, tak jak do każdego innego słoika.

Dodatkowa funkcjonalność iText 7 jest dostępna za pośrednictwem dodatków, które są dostarczane jako słoiki na podstawie licencji komercyjnej. Jeśli chcesz korzystać z któregokolwiek z tych dodatków lub chcesz używać iText 7 z własnym kodem, musisz uzyskać komercyjny klucz licencyjny do iText 7 (patrz dział prawny na stronie iText ).

Możesz zaimportować taki klucz licencyjny za pomocą modułu klucza licencyjnego. Możesz pobrać słoik z kluczem licencyjnym w następujący sposób:

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext-licensekey</artifactId>
    <version>2.0.0</version>
    <scope>compile</scope>
</dependency>

Niektóre funkcje w iText są zamkniętym źródłem. Na przykład, jeśli chcesz użyć PdfCalligraph , potrzebujesz modułu typography . Ten moduł nie będzie działać bez oficjalnego klucza licencyjnego.

iText dla C #

Możesz pobrać plik ZIP zawierający wszystkie biblioteki DLL dostępne na AGPL. Aby uzyskać więcej informacji o tych bibliotekach DLL, przeczytaj dokumentację Java.

Witaj świecie

Jest to bardzo prosty program do tworzenia plików PDF za pomocą iText 7 / Java:

//Initialize writer
PdfWriter writer = new PdfWriter(dest);

//Initialize document
PdfDocument pdfDoc = new PdfDocument(writer);
Document doc = new Document(pdfDoc);

//Add paragraph to the document
doc.add(new Paragraph("Hello World!"));

//Close document
doc.close();

( Listing_01_01_HelloWorld.java )

Możesz przejść do wielu innych przykładów z tej strony.

Jest to bardzo prosty program do tworzenia plików PDF za pomocą prekursora iText 5.5.x / Java:

// step 1
Document document = new Document();
// step 2
PdfWriter.getInstance(document, new FileOutputStream(filename));
// step 3
document.open();
// step 4
document.add(new Paragraph("Hello World!"));
// step 5
document.close();

( HelloWorld.java )

Istnieje również wiele innych przykładów nawigacji z tej strony.

Te dwa przykłady wyglądają bardzo podobnie. Zalety przeprojektowanego interfejsu API iText 7 staną się jednak widoczne, gdy tylko zaczniemy przyglądać się mniej trywialnym przykładom. Dlatego po prostu nawiguj po przykładowym kodzie źródłowym z powyższych linków i porównaj.