Itext给PDF添加页码

关注

原创最新推荐文章于 2026-03-16 01:32:16 发布 4.5k 阅读 AI 写同款· GEO 优化 ›

★itext-为pdf文件添加页眉页脚 | 3步完成 | 　　由于上一篇自定义生成pdf的功能需求又增加了，需要加上页码。所以本博客诞生了~ 　　1. 通过继承PdfPageEventHelper类，实现需要实现的方法　　 import com.lowagie.text.Document; import com.lowagie.text.Element; import com.lowagie.text.Phrase; impo... 阅读详情

        <dependency>
            <groupId>com.itextpdf</groupId>
            <artifactId>itext-asian</artifactId>
            <version>5.2.0</version>
        </dependency>

import com.itextpdf.text.Document;
import com.itextpdf.text.Element;
import com.itextpdf.text.Font;
import com.itextpdf.text.Phrase;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.ColumnText;
import com.itextpdf.text.pdf.PdfContentByte;
import com.itextpdf.text.pdf.PdfPageEventHelper;
import com.itextpdf.text.pdf.PdfWriter;

public class PageNumPdfPageEvent  extends PdfPageEventHelper{

    @Override
    public void onEndPage(PdfWriter writer, Document document) {

        try {
            // PDF文档内容
            PdfContentByte pdfContent = writer.getDirectContent();

            pdfContent.saveState();
            pdfContent.beginText();

            int footerFontSize = 11 ;

            // 解决页码中文无法显示 或者 显示为乱码的问题
            // 但是必须引入jar包 itext-asian-5.2.0.jar
            BaseFont baseFont = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", false);
            Font fontDetail = new Font(baseFont, footerFontSize, Font.NORMAL);

            pdfContent.setFontAndSize(baseFont, footerFontSize);

            // 页脚的页码 展示
            String footerNum = String.format("%d", writer.getPageNumber());
            Phrase phrase = new Phrase(footerNum, fontDetail);

            // 页码的 横轴 坐标 居中
            float x = ( document.left() + document.right() ) / 2 ;
            // 页码的 纵轴 坐标
            float y = document.bottom(-10) ;
            // 添加文本内容，进行展示页码
            ColumnText.showTextAligned(pdfContent, Element.ALIGN_CENTER, phrase, x, y, 0);

            pdfContent.endText();
            pdfContent.restoreState();
        } catch (Exception e) {
            e.printStackTrace();
        }

    }
}

import java.io.FileOutputStream;

import com.itextpdf.text.Document;
import com.itextpdf.text.PageSize;
import com.itextpdf.text.pdf.*;

public class PdfUtils {
    
    public static String addPageNum (String orgPdfPath, String outputPdfPath) {

        try (
                // 输出文件 流
                FileOutputStream fos = new FileOutputStream(outputPdfPath) ;){

            // 新建文档，默认A4大小
            Document document = new Document(PageSize.A4);
            PdfWriter writer = PdfWriter.getInstance(document, fos);
            // 设置页面监听事件，必须在open方法前
            writer.setPageEvent(new PageNumPdfPageEvent());
            document.open();

            // PDF内容体
            PdfContentByte pdfContent = writer.getDirectContent();
            // 读取 源PDF文件，进行一页一页复制，才能触发 添加页码的  页面监听事件
            PdfReader reader = new PdfReader(orgPdfPath);
            // 获取 源文件总页数
            int num = reader.getNumberOfPages();
            System.out.println("总页数：" + num);
            // 页面数是从1开始的
            for (int i = 1; i <= num; i++) {
                document.newPage();
                // 设置空页码进行展示
                writer.setPageEmpty(false);
                PdfImportedPage page = writer.getImportedPage(reader, i);
                // 复制好的页面，添加到内容去，触发事件监听
                pdfContent.addTemplate(page, 0, 0);
            }

            document.close();
            reader.close();
        } catch (Exception e) {
            e.printStackTrace();
        }

        return outputPdfPath ;
    }
}

public class PdfUtilsTest {
    public static void main(String[] args){
        String orgPdfPath = "D:\\yourPdfName.pdf" ;
        String outputPdfPath = "D:\\newPdfName.pdf" ;
        PdfUtils.addPageNum(orgPdfPath, outputPdfPath);
    }
}