重要声明：本文章仅仅代表了作者个人对此观点的理解和表述。读者请查阅时持自己的意见进行讨论。

前言

有时候，业务系统要求提供一个PDF文件导出的功能，这时候我们就需要将数据库的对应数据查询出来，然后生成PDF并提供下载，这其中比较陌生的部分相信就是如何使用这些数据生成一个PDF文件了，本文讲述了使用 Itext 在Java后端生成PDF的方法，不妨来看看一吧。

一、加入依赖

首要第一步则是加入Itext的依赖，然后才可以使用相关的操作类。Itext 的依赖不是都在一个包里，它分了许许多多模块，但基本的生成PDF的依赖包只需要引入2个即可。

首先是核心包：

com.itextpdf

itextpdf

5.5.13

然后需要引入对中文支持的包，毕竟大部分文档中都会有中文内容的。

com.itextpdf

itext-asian

5.2.0

只需要引入这两个包，就可以完成基本的生成PDF操作了。

二、开始使用

Itext 的用法十分简单，大致可以分为下面几步：

构建文档

打开文档编辑功能

插入文档内容

关闭文档编辑功能

1、构建文档

Itext 构建文档是通过 Document 类进行构建，不过要注意，大多数项目里面应该存在许多个 Document 类了，这里一定要使用 com.itextpdf.text 包下面的 Document 类。这个类包含一个无参构造函数，意味着可以十分方便的 new 一个空文档出来：

Document document = new Document();

默认创建的是 A4 纸大小、内边距 36 的PDF文档。如果你希望创建不同大小以及不同边距的文档，你可以使用带参构造函数：

Document documentA8 = new Document(PageSize.A8);

Document documentA8_2 = new Document(PageSize.A8, 10, 10, 10,10);

这里构建了 2 个文档，第一个文档设定了大小为 A8 纸张大小， 第二个文档设定了边距为 10，这些边距值分别对应左, 右, 上, 下。构建好了文档，就可以开始进行文档编辑了。

2、 打开文档编辑功能

在编辑之前，需要先认识一个类 PdfWriter,这个类帮助我们打开文档的编辑功能，同时能指定将pdf文件输出到对应的输出流里面，意味着我们如果使用文件输出流，它就可以将pdf文件输出到文件中。

Document document = new Document();

PdfWriter.getInstance(document, new FileOutputStream("D:/test.pdf"));

document.open();

使用 PdfWriter.getInstance 方法可以将文件到指定输出流，传入文件输出流可实现输出到文件。然后调用 document.open 方法打开编辑功能，只有调用了此方法之后，才可以对 document 进行编辑。

3、 插入内容及中文

现在，可以放心的向文档中插入内容了，不如先插入一个段落在文档中试一试, 使用 com.itextpdf.text.Paragraph 类可以实现对段落的构建，先来看个效果：

Document document = new Document();

PdfWriter.getInstance(document, new FileOutputStream("D:/test.pdf"));

document.open();

// 新建一个段落，内容 Hello Pdf.

Paragraph p1 = new Paragraph("Hello Pdf.");

document.add(p1);

document.close();

最后不要忘了执行关闭。打开D盘，发现文件test.pdf，效果如图:

似乎非常完美，但当我把 “Hello” 改成 “你好”后，再一次生成文档：

Document document = new Document();

PdfWriter.getInstance(document, new FileOutputStream("D:/test.pdf"));

document.open();

Paragraph p1 = new Paragraph("你好 Pdf.");

document.add(p1);

document.close();

再次运行，得到效果：

发现中文并没有被显示出来，这时候就需要用到刚才添加的第二个依赖了。要让中文显示正常，需要借助中文字体来实现这个需求，itext-asian 包内置了一个中文字体提供使用。建立使用 itext-asian 内置中文支持：

BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);

Font mfont = new Font(bfChinese, 15, Font.NORMAL, BaseColor.BLACK);

首先使用内置字体建立基本字体类型，然后建立段落可以使用的字体对象，最后，mfont 对象就可以传递给 Paragraph，从而实现中文支持。代码如下：

BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);

Font mfont = new Font(bfChinese, 15, Font.NORMAL, BaseColor.BLACK);

Document document = new Document();

PdfWriter.getInstance(document, new FileOutputStream("D:/test.pdf"));

document.open();

Paragraph p1 = new Paragraph("你好 Pdf.", mfont);

document.add(p1);

document.close();

运行效果图如下：

.

有时候这个字体并不能满足需求，你可以自己使用自己的字体文件来实现个性化字体：

// 使用window内置的等线字体

BaseFont.createFont("C:/Windows/Fonts/Deng.ttf", BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED);

// 使用自己的字体文件

BaseFont.createFont("D:/思源黑体正常字体.ttf", BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED);

三、Itext 提供的各种文档组件

上面简单的介绍了段落使用方法，其实Itext除了段落组件，还提供了许多其他的组件封装，比较常用的组件见下表：

类介绍

com.itextpdf.text.Anchor功能类似锚点、超链接

com.itextpdf.text.Chapter章节

com.itextpdf.text.Chunk能添加到文档里的最小文本块

com.itextpdf.text.Header这个信息不会显示到pdf，常常是编辑者自己定义的一些文档先关信息

com.itextpdf.text.Image图片

com.itextpdf.text.JpegJpeg的图片，其实它继承自Image

com.itextpdf.text.List列表，这里面放 ListItem

com.itextpdf.text.ListItem列表条目

com.itextpdf.text.Meta这个和Header类似，但这是固定的一些文档信息，字段名只允许:subject,title,keywords,author,creationdate,producer

com.itextpdf.text.Paragraph文本段落

com.itextpdf.text.Phrase文本，这就好像html里面的span，它可以设定自己的样式。

四、导出PDF

当你把你的各个数据全部写入到了 document 里面后，就可以将这个 document 导出给请求端了，如果我们把这个文档像这样进行构建写操作：

PdfWriter.getInstance(document, new FileOutputStream("D:/test.pdf"));

那么我们的pdf文件就会被保存到服务器里面，而我们的目标是导出给请求端，所以，只需要把 第二个参数从文件输出流变成响应输出流即可：

// ... 更多代码

PdfWriter.getInstance(document, response.getOutputStream());

// ... 跟多代码