Java根据pdf模板生成荣誉证书PDF文件

1.前言

最近博主在开发一个大学生学分管理系统，按照对方用户的要求，他们需要一个生成PDF荣誉证书的功能。
于是Java根据pdf模板生成荣誉证书PDF文件，这个任务就交给了我。

鉴于网上大多数都是生成pdf表格数据，没有做证书的这种教程。
于是我记录一下，供其他朋友学习。

先看看最终的效果：
这里写图片描述

2.环境准备

做证书的生成，首先是需要一个PDF模板的，而制作PDF模板，是需要使用到一些工具的，文章最后都有提供下载地址。

一个证书的word模板、
软件Adobe Acrobat
操作PDF文件的itext相关jar包

3.制作PDF模板

1.首先打开或者自己制作一个证书样式的word模板。
内容仅供参考，本文中多图的内容是不一致的，但是无妨。
最后效果如图：
这里写图片描述

然后另存为PDF文件。（这都不会的话就不用看了）

2.用软件adobe acrobat打开
在电脑上安装完adobe acrobat以后，打开刚保存的PDF文件。
打开以后，选择在软件界面右边找到准备表单，或者是直接按左边的文件>>创建>>创建表单。
然后选择我们的PDF文件，打开。
步骤：
这里写图片描述

adobe acrobat软件会自动定位到动态表单项：
这里写图片描述

如图中所示，你可以双击编辑里面的文字字段，在这里我修改为name+time，因为证书只需要动态的填写名字和日期两个变量。

上面的工作做完以后，我们ctrl+s 保存pdf文件，这样就制作完成了一个证书的PDF模板。

4.生成PDF的证书文件

PDF证书模板制作完成以后，我们就可以开始编写java代码来实现动态填入数据了。

打开eclipse等IDE，创建一个java项目/web项目/maven项目都可以。
我创建了一个pdfshengc的java项目，新建了一个com.zout包，新建一个ITextDemo.java类。
ITextDemo.java代码：

package com.zout;

import java.io.ByteArrayOutputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.pdf.AcroFields;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.PdfContentByte;
import com.itextpdf.text.pdf.PdfReader;
import com.itextpdf.text.pdf.PdfStamper;

/**
 * @Title: Test.java
 * @Package:com.zout
 * @Description:(证书生成可行版-java版) 
 * @author:Zoutao
 * @date:2018年7月22日
 * @version:V1.0
 */

public class ITextDemo {

    public static void main(String[] args) throws Exception {
        System.out.println("==========证书生成start==========");
        test();
        System.out.println("==========证书生成end============");
    }

    public static void test() throws IOException, DocumentException {

        /* 导入PDF模板 */
        String fileName = "D:/testPDF/zhengshu.pdf"; 
        /* 生成的新文件路径 */
        String newPDFPath = "D:/testPDF/Test.pdf";

        try {
            PdfReader reader = new PdfReader(fileName);
            ByteArrayOutputStream bos = new ByteArrayOutputStream();

            /* 2.读取PDF模板内容 */
            PdfStamper ps = new PdfStamper(reader, bos);
            PdfContentByte under = ps.getUnderContent(1);
            System.out.println("采用PDF模板:" + fileName);

            /* 3.法1:设置使用itext-asian.jar的中文字体 */
            BaseFont bf = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);

            /*法2:使用项目下的自定义的中文字体
            bfChinese = BaseFont.createFont("static/font/SIMSUN.TTC,1", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);*/

            /*法3:使用windows系统下的字体库
            bfChinese = BaseFont.createFont("c://windows//fonts//simsun.ttc,1",BaseFont.IDENTITY_H, false);*/

            ArrayList<BaseFont> fontList = new ArrayList<BaseFont>();
            fontList.add(bf);

            /* 4.获取模板中的所有字段 */
            AcroFields fields = ps.getAcroFields();
            fields.setSubstitutionFonts(fontList);

            fillData(fields, data());           //调用方法执行写入

            /* 必须要调用这个，否则文档不会生成的 */
            ps.setFormFlattening(true);
            ps.close();

            /* 5.将要生成的目标PDF文件名称 */
            OutputStream fos = new FileOutputStream(newPDFPath);
            fos.write(bos.toByteArray());
            System.out.println("新证书已生成:" + newPDFPath);
            fos.flush();
            fos.close();
            bos.close();
        } catch (IOException e) {
            System.out.println("证书生成失败,原因:" + e.getLocalizedMessage());
        } catch (DocumentException e) {
            System.out.println("证书生成失败,原因:" + e.getLocalizedMessage());
        }
    }

    // 获取pdf模板中有哪些字段key+赋值的值value
    public static void fillData(AcroFields fields, Map<String, String> data) throws IOException, DocumentException {
        for (String key : data.keySet()) {
            String value = data.get(key); // 调用data方法获取值
            System.out.println(key + "字段:" + value);
            fields.setField(key, value); // 为字段赋值,注意字段名称是区分大小写的
        }
    }

    // 为需要填入的数据value赋值
    public static Map<String, String> data() {
        Map<String, String> data = new HashMap<String, String>();
        data.put("name", "邹tao畀瘬2"); // 字段需要对应pdf模板里面的名称
        data.put("time", "2018年7月22日");
        return data;
    }
}

这个时候你发现代码一堆报错的，不要急，需要使用到专用的jar包了。

经过博主多次试验，关于Itext-Asian.jar和Itextpdf.jar之间，是有兼容性问题的，不同版本之间搭配容易出现问题，特别是什么中文字符不显示，乱码，不支持中文等问题。
采用博主的这个jar就不会出现上述问题。

如果你是maven项目，那么可以在pom中加入：

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