Java從零開始創(chuàng)建功能豐富的PDF文檔

更新時間：2025年01月23日 10:04:23 作者：一名技術極客

隨著數(shù)字化辦公的普及,PDF格式因其跨平臺兼容性和安全性而被廣泛應用于各種場景中,本文將詳細介紹如何使用Java來實現(xiàn)PDF文檔的一鍵生成,有需要的可以了解下

引言

隨著數(shù)字化辦公的普及，PDF格式因其跨平臺兼容性和安全性而被廣泛應用于各種場景中。對于開發(fā)者來說，能夠通過編程方式操作PDF文檔是一項非常有用的技術。本文將詳細介紹如何使用Java來實現(xiàn)PDF文檔的一鍵生成、文字插入、表單字段添加、電子簽名以及公章蓋章等高級功能。我們將主要使用開源庫 iText 來完成這些任務。

環(huán)境準備

依賴引入

為了簡化開發(fā)過程并確保代碼的可維護性，推薦使用Maven作為構建工具，并在pom.xml中添加iText庫的依賴：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext7-core</artifactId>
    <version>7.2.3</version> <!-- 請根據(jù)實際情況選擇最新版本 -->
</dependency>

此外，如果需要處理圖像（例如公章），可能還需要額外引入圖像處理庫。

創(chuàng)建PDF文檔

一鍵生成空白PDF

讓我們從最基礎的功能開始——創(chuàng)建一個簡單的空白PDF文件：

import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.kernel.pdf.PdfDocument;

public class PdfCreationExample {
    public static void main(String[] args) throws Exception {
        String dest = "output/generated_pdf.pdf";
        PdfWriter writer = new PdfWriter(dest);
        PdfDocument pdfDoc = new PdfDocument(writer);
        Document document = new Document(pdfDoc);

        // 添加頁面內容...
        document.close();
        System.out.println("PDF created at: " + dest);
    }
}

這段代碼會生成一個名為generated_pdf.pdf的空白PDF文件。

接下來，我們來看如何向PDF中添加文本內容：

import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;

public class AddTextToPdf {
    public static void main(String[] args) throws Exception {
        String dest = "output/pdf_with_text.pdf";
        PdfWriter writer = new PdfWriter(dest);
        PdfDocument pdfDoc = new PdfDocument(writer);
        Document document = new Document(pdfDoc);

        // 添加段落
        document.add(new Paragraph("Hello World! This is a sample text."));
        
        // 更多功能可以繼續(xù)添加...

        document.close();
        System.out.println("Text added to PDF at: " + dest);
    }
}

這里使用了Paragraph類來創(chuàng)建段落對象，并將其添加到文檔中。

添加表單字段（選項）

iText 支持創(chuàng)建交互式表單字段，比如文本框、復選框等。這允許用戶與PDF進行互動。

import com.itextpdf.forms.PdfAcroForm;
import com.itextpdf.forms.fields.PdfFormField;
import com.itextpdf.forms.fields.PdfTextField;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.layout.Document;

public class AddFormFields {
    public static void main(String[] args) throws Exception {
        String dest = "output/pdf_with_form_fields.pdf";
        PdfWriter writer = new PdfWriter(dest);
        PdfDocument pdfDoc = new PdfDocument(writer);
        Document document = new Document(pdfDoc);

        // 創(chuàng)建表單
        PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);

        // 添加文本字段
        PdfTextField textField = new PdfTextField(pdfDoc, new Rectangle(50, 750, 400, 15), "textField", "Enter your name here");
        form.addField(textField.getPdfObject(), pdfDoc.getFirstPage());

        // 可以繼續(xù)添加更多類型的字段...

        document.close();
        System.out.println("Form fields added to PDF at: " + dest);
    }
}

在這個例子中，我們創(chuàng)建了一個名為textField的文本框，并將其放置在PDF的第一頁上。

添加電子簽名

為PDF添加數(shù)字簽名不僅增加了文檔的安全性，也提高了其可信度。下面是如何在PDF中嵌入簽名的示例：

import com.itextpdf.signatures.*;
import com.itextpdf.kernel.pdf.PdfReader;
import com.itextpdf.kernel.pdf.StampingProperties;
import com.itextpdf.kernel.pdf.x509.CertificateUtil;
import org.bouncycastle.jce.provider.BouncyCastleProvider;

import java.security.KeyStore;
import java.security.PrivateKey;
import java.security.cert.X509Certificate;
import java.util.Calendar;

public class SignPdf {
    static {
        Security.addProvider(new BouncyCastleProvider());
    }

    public static void signPdf(String src, String dest, String keystorePath, String password) throws Exception {
        KeyStore ks = KeyStore.getInstance("PKCS12");
        try (InputStream inputStream = new FileInputStream(keystorePath)) {
            ks.load(inputStream, password.toCharArray());
        }

        String alias = ks.aliases().nextElement();
        PrivateKey pk = (PrivateKey) ks.getKey(alias, password.toCharArray());
        X509Certificate cert = (X509Certificate) ks.getCertificate(alias);

        PdfReader reader = new PdfReader(src);
        PdfSigner signer = new PdfSigner(reader, new FileOutputStream(dest), new StampingProperties());

        PdfSignatureAppearance appearance = signer.getSignatureAppearance()
                .setReason("Test Reason")
                .setLocation("Test Location")
                .setReuseAppearance(false);

        ExternalDigest digest = new BouncyCastleDigest();
        ExternalSignature signature = new PrivateKeySignature(pk, DigestAlgorithms.SHA256, "BC");

        signer.signDetached(digest, signature, CertificateUtil.collectCertificatesFromChain(cert), null, null, null, 0, PdfSigner.CryptoStandard.CMS);

        System.out.println("PDF signed and saved at: " + dest);
    }

    public static void main(String[] args) throws Exception {
        signPdf("input/unsigned_pdf.pdf", "output/signed_pdf.pdf", "path/to/your/keystore.p12", "password");
    }
}

請注意，此代碼片段假設你已經有了包含私鑰和證書的密鑰庫文件（如.p12）。你需要根據(jù)實際情況調整路徑和其他參數(shù)。

添加公章圖像

最后，我們來看看如何在PDF中嵌入公章圖像。這通常涉及到讀取圖像文件并將它放置在特定位置。

import com.itextpdf.io.image.ImageDataFactory;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Image;

import java.io.File;

public class AddStampImage {
    public static void main(String[] args) throws Exception {
        String dest = "output/pdf_with_stamp.pdf";
        PdfWriter writer = new PdfWriter(dest);
        PdfDocument pdfDoc = new PdfDocument(writer);
        Document document = new Document(pdfDoc);

        // 添加公章圖片
        Image img = new Image(ImageDataFactory.create("path/to/stamp_image.png"));
        img.setAutoScale(true); // 自動縮放以適應頁面
        img.setFixedPosition(400, 50); // 設置固定位置
        
        document.add(img);

        document.close();
        System.out.println("Stamp image added to PDF at: " + dest);
    }
}

這段代碼展示了如何加載圖像文件并將其作為固定位置的元素添加到PDF中。