bootpdf下载 spring_史上最全的springboot导出pdf文件

最近项目有一个导出报表文件的需求，我脑中闪过第一念头就是导出pdf(产品经理没有硬性规定导出excel还是pdf文件)，于是赶紧上网查看相关的资料，直到踩了无数的坑把功能做出来了才知道其实导出excel的api更方便，网上的相关博客也更多，不过坑也踩完了，这一次就来把代码和收获整理和分享一下。

导出pdf模板的局限性

在看到需求之前，我先去网上去搜了一波，发现网上很大一部分博客都是将如何导出pdf模板的，就是先制作一张pdf模板，把固定不变的地方先写好，把需要改变的地方留白并设置参数，然后在代码里为参数赋值就行了，这种方式很简单，代码量也很少，但是！！！这种方式只适合导出格式和内容是固定的文件，而我们的需求是导出一张以产品名称为列，产品属性为行的报表，产品数量不定，这很显然就不能用模板的方式，只好老老实实把报表的数据从头到尾一一导出来。

使用iText导出pdf表格

iText是一种生成PDF报表的Java组件，先把jar包下下来，maven依赖如下：

com.itextpdf

itextpdf

5.0.6

按照惯例，先来生一个“Hello World”的文件，代码如下

public classTestPdf {public static void main(String[] args) throwsException {

TestPdf pdf= newTestPdf();

String filename= "D:/Program Files/pdfTest/testTable3.pdf";

pdf.createPDF(filename);

System.out.println("打印完成");

}public void createPDF(String filename) throwsIOException {

Document document= newDocument(PageSize.A4);try{

PdfWriter.getInstance(document,newFileOutputStream(filename));

document.addTitle("example of PDF");

document.open();

document.add(new Paragraph("Hello World!"));

}catch(FileNotFoundException e) {

e.printStackTrace();

}catch(DocumentException e) {

e.printStackTrace();

}finally{

document.close();

}

}

}

这个没什么可说的，照着写就行了，不过我们导出的pdf大多数是以表格的形式，所以我就直接切入主题了，这里要用到一个很关键的类com.itextpdf.text.pdf.PDFPTable，先导出一张两行两列的表格

public static PdfPTable createTable(PdfWriter writer) throwsDocumentException, IOException{

PdfPTable table= new PdfPTable(2);//生成一个两列的表格

PdfPCell cell;int size = 15;

cell= new PdfPCell(new Phrase("one"));

cell.setFixedHeight(size);//设置高度

table.addCell(cell);

cell= new PdfPCell(new Phrase("two"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("three"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("four"));

cell.setFixedHeight(size);

table.addCell(cell);returntable;

}public void createPDF(String filename) throwsIOException {

Document document= newDocument(PageSize.A4);try{

PdfWriter writer= PdfWriter.getInstance(document, newFileOutputStream(filename));

document.addTitle("example of PDF");

document.open();

PdfPTable table=createTable(writer);

document.add(table);

}catch(FileNotFoundException e) {

e.printStackTrace();

}catch(DocumentException e) {

e.printStackTrace();

}finally{

document.close();

}

}

效果如下图

现在把我们的需求变得更苛刻一点，再增加一行，格子数为1，文字水平和垂直居中对齐，占两行高度，先贴代码再做解释

public static PdfPTable createTable(PdfWriter writer) throwsDocumentException, IOException{

PdfPTable table= new PdfPTable(2);//生成一个两列的表格

PdfPCell cell;int size = 15;

cell= new PdfPCell(new Phrase("one"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("two"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("three"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("four"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("five"));

cell.setColspan(2);//设置所占列数

cell.setFixedHeight(size*2);//设置高度

cell.setHorizontalAlignment(Element.ALIGN_CENTER);//设置水平居中

cell.setVerticalAlignment(Element.ALIGN_MIDDLE);//设置垂直居中

table.addCell(cell);returntable;

}

这里有一个很坑的地方，就是每一行的长度要和初始化表格的长度相等，即要把整行给占满，否则后面的都不会打印出来，所以要用到setColspan()方法来合并列，接下来还有一个就是合并行的的方法setRowspan()。我们在导出pdf报表的实际操作中经常会有这样的需求

所以合并行的方法显得尤为重要，那就尝试一下用这个方法来合并行，

public static PdfPTable createTable(PdfWriter writer) throwsDocumentException, IOException{

PdfPTable table= new PdfPTable(2);//生成一个两列的表格

PdfPCell cell;int size = 20;

cell= new PdfPCell(new Phrase("one"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("two"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("three"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("four"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("five"));

cell.setColspan(1);//设置所占列数

cell.setRowspan(2);//合并行

cell.setFixedHeight(size*2);//设置高度

cell.setHorizontalAlignment(Element.ALIGN_CENTER);//设置水平居中

cell.setVerticalAlignment(Element.ALIGN_MIDDLE);//设置垂直居中

table.addCell(cell);

cell= new PdfPCell(new Phrase("six"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("seven"));

cell.setFixedHeight(size);

table.addCell(cell);returntable;

}

效果如下

事实上很简单，在原来的代码上将“five”这一行长度由2变为1，加上setRowspan(2)方法，再加上两行长度为1的cell就是上面的效果了。看起来也没有多复杂是吧，现在我们在jar包上用了较新的版本itextpdf-5.0.6.jar，然而在这之前还有一种老版本的jar包itext-2.1.7.jar，依赖如下：

com.lowagie

itext

2.1.7

用了这个jar包后发现效果是一样的，那我为什么要提这个版本呢，在后面我们会讲打到。事实上，在实现行合并的还有一种方法就是table中再套一个table，代码如下：

public static PdfPTable createTable(PdfWriter writer) throwsDocumentException, IOException{

PdfPTable table= new PdfPTable(2);//生成一个两列的表格

PdfPCell cell;int size = 20;

cell= new PdfPCell(new Phrase("one"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("two"));

cell.setFixedHeight(size);

cell.setColspan(2);

table.addCell(cell);

cell= new PdfPCell(new Phrase("three"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("four"));

cell.setFixedHeight(size);

cell.setColspan(2);

table.addCell(cell);

cell= new PdfPCell(new Phrase("five"));

cell.setColspan(1);//设置所占列数//cell.setRowspan(2);//合并行

cell.setFixedHeight(size*2);//设置高度

cell.setHorizontalAlignment(Element.ALIGN_CENTER);//设置水平居中

cell.setVerticalAlignment(Element.ALIGN_MIDDLE);//设置垂直居中

table.addCell(cell);

PdfPTable table2= new PdfPTable(1);//新建一个table

cell = new PdfPCell(new Phrase("six"));

cell.setFixedHeight(size);

table2.addCell(cell);

cell= new PdfPCell(new Phrase("seven"));

cell.setFixedHeight(size);

table2.addCell(cell);

cell= new PdfPCell(table2);//将table放到cell中

table.addCell(cell);//将cell放到外层的table中去

returntable;

}

效果和刚才是完全一样的，这种方法的关键就是将新建的table放到cell中，然后把cell放到外层table中去。这种方法明显比刚才的麻烦很多，我之所以拿出来是因为我在用老版本的jar包中的合并行的方法突然不起作用了，然后临时想了这个办法出来，至于为什么方法失效报错我到现在还没弄明白。。。

在表格中加入单选框/复选框

之所以提这个，在我自己项目中就有这样的需求，而且在网上这种资料非常少，我这也是在官网上看到的，遂记录一下，先看一下单选框怎么加，代码如下

public static PdfPTable createTable(PdfWriter writer) throwsDocumentException, IOException{

PdfPTable table= new PdfPTable(2);//生成一个两列的表格

PdfPCell cell;int size = 20;

cell= new PdfPCell(new Phrase("one"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("two"));

cell.setFixedHeight(size);

cell.setColspan(2);

table.addCell(cell);

cell= new PdfPCell(new Phrase("three"));

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase("four"));

cell.setFixedHeight(size);

cell.setColspan(2);

table.addCell(cell);

cell= new PdfPCell(new Phrase("five"));

cell.setColspan(1);//设置所占列数//cell.setRowspan(2);//合并行

cell.setFixedHeight(size*2);//设置高度

cell.setHorizontalAlignment(Element.ALIGN_CENTER);//设置水平居中

cell.setVerticalAlignment(Element.ALIGN_MIDDLE);//设置垂直居中

table.addCell(cell);

PdfPTable table2= new PdfPTable(1);//新建一个table

cell = new PdfPCell(new Phrase("six"));

cell.setFixedHeight(size);

table2.addCell(cell);

cell= new PdfPCell(new Phrase("seven"));

cell.setFixedHeight(size);

table2.addCell(cell);

cell= new PdfPCell(table2);//将table放到cell中

table.addCell(cell);//将cell放到外面的table中去

Phrase phrase1 = newPhrase();

Chunk chunk1= new Chunk(" YES");

Chunk chunk2= new Chunk(" NO");

phrase1.add(chunk1);

phrase1.add(chunk2);

cell= newPdfPCell(phrase1);

cell.setColspan(2);

table.addCell(cell);//增加两个单选框

PdfFormField radiogroup=PdfFormField.createRadioButton(writer, true);

radiogroup.setFieldName("salesModel");

Rectangle rect1= new Rectangle(110, 722, 120, 712);

Rectangle rect2= new Rectangle(165, 722, 175, 712);

RadioCheckField radio1= new RadioCheckField(writer, rect1, null, "self-support") ;

RadioCheckField radio2= new RadioCheckField(writer, rect2, null, "cooprate") ;

radio2.setChecked(true);

PdfFormField radiofield1=radio1.getRadioField();

PdfFormField radiofield2=radio2.getRadioField();

radiogroup.addKid(radiofield1);

radiogroup.addKid(radiofield2);

writer.addAnnotation(radiogroup);returntable;

}

效果如图

这个最烦的地方就是自己要去一点点试单选框的参数来调整位置，就是Rectangle rect1 = new Rectangle()里面的参数，然后想让哪个radio被选中就用setChecked(true)方法就OK了

解决中文字体的问题

在之前的例子中我用的都是英文字，但是中文字体是一个不得不解决的问题，根据我去网上搜集到的资料大抵有以下几个方法：

使用windows系统自带的字体，这种事最省事，也是最简单的，代码如下

public static PdfPTable createTable(PdfWriter writer) throwsDocumentException, IOException{

PdfPTable table= new PdfPTable(2);//生成一个两列的表格

PdfPCell cell;int size = 20;

Font font= new Font(BaseFont.createFont("C:/Windows/Fonts/SIMYOU.TTF",BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED));

cell= new PdfPCell(new Phrase("显示中文",font));

cell.setFixedHeight(size);

cell.setColspan(2);

table.addCell(cell);returntable;

}

使用itext-asian.jar中的中文字体，代码如下：

Font font = new Font(BaseFont.createFont( "STSongStd-Light" ,"UniGB-UCS2-H",BaseFont.NOT_EMBEDDED));

在这里可能会报Font 'STSongStd-Light' with 'UniGB-UCS2-H' is not recognized.的错，网上都说是语言包中的包名有问题，但是我把itexitextpdf包的版本从5.0.6改成5.4.3就解决了，我把语言包解压后发现路径是对的，应该是后面的版本已经把语言包中的包名解决了，那为什么5.0.6的版本不行呢，反正我到现在还没找到原因，如果有谁知道的话欢迎留言告知。

3.使用自己下载的资源字体。这种方法可以说是最麻烦的，但是也是最有效的。麻烦是因为自己要去下载字体文件，但是效果确是最好的，能够应对各种系统，各种状况，下面会提到，先看一下我的文件路径

然后是代码

Font font = new Font(BaseFont.createFont( "/simsun.ttf",BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED));

其实跟第一个是差不多的，只是一个是读系统的文件，一个是读项目自己的文件。

在springboot中导出pdf文件

前面做了这么多铺垫，终于来到我们最关键的地方了，前面的东西都是放到java项目中去跑的，没有太多实际用处，在web项目中用到才算真正的应用，假设我们有一个产品类，我们的需求就是把产品数据导成pdf文件，代码如下：

产品Product类

public classProduct {privateString productName;privateString productCode;private floatprice;publicString getProductName() {returnproductName;

}public voidsetProductName(String productName) {this.productName =productName;

}publicString getProductCode() {returnproductCode;

}public voidsetProductCode(String productCode) {this.productCode =productCode;

}public floatgetPrice() {returnprice;

}public void setPrice(floatprice) {this.price =price;

}public Product(String productName, String productCode, floatprice) {super();this.productName =productName;this.productCode =productCode;this.price =price;

}

}

接下来是controller

//打印pdf

@RequestMapping("printPdf")public ModelAndView printPdf() throwsException{

Product product1= new Product("产品一","cp01",120);

Product product2= new Product("产品一","cp01",120);

Product product3= new Product("产品一","cp01",120);

Listproducts = new ArrayList<>();

products.add(product1);

products.add(product2);

products.add(product3);

Map model = new HashMap<>();

model.put("sheet", products);return new ModelAndView(newViewPDF(), model);

}

然后是ViewPDF类

public class ViewPDF extendsAbstractPdfView {

@Overrideprotected void buildPdfDocument(Mapmodel, Document document, PdfWriter writer,

HttpServletRequest request, HttpServletResponse response)throwsException {

String fileName= new Date().getTime()+"_quotation.pdf"; //设置response方式,使执行此controller时候自动出现下载页面,而非直接使用excel打开

response.setCharacterEncoding("UTF-8");

response.setContentType("application/pdf");

response.setHeader("Content-Disposition","filename=" + new String(fileName.getBytes(), "iso8859-1"));

List products = (List) model.get("sheet");

PdfUtil pdfUtil= newPdfUtil();

pdfUtil.createPDF(document, writer, products);

}

}

在这里有两个值得注意的地方：

1. 仔细观察这个类，看父类的bulidPdfDocument()，发现其中的document要求的是这个com.lowagie.text.Document版本的，这就非常坑了，意味着之前的itextpdf-5.0.6.jar不能再用了，只能用老版本的(改名之前的)itext-2.1.7.jar了。

2. 如果不想要这种直接在浏览器中预览的效果，而是直接下载文件的话就把response.setHeader()方法里面的参数改成下面的，相当于加了一个attachment，以附件形式下载

response.setHeader("Content-Disposition","attachment;filename=" + new String(fileName.getBytes(), "iso8859-1"));

最后是PdfUtil类

public classPdfUtil {public void createPDF(Document document,PdfWriter writer, List products) throwsIOException {//Document document = new Document(PageSize.A4);

try{

document.addTitle("sheet of product");

document.addAuthor("scurry");

document.addSubject("product sheet.");

document.addKeywords("product.");

document.open();

PdfPTable table=createTable(writer,products);

document.add(table);

}catch(FileNotFoundException e) {

e.printStackTrace();

}catch(DocumentException e) {

e.printStackTrace();

}finally{

document.close();

}

}public static PdfPTable createTable(PdfWriter writer,List products) throwsIOException, DocumentException {

PdfPTable table= new PdfPTable(3);//生成一个两列的表格

PdfPCell cell;int size = 20;

Font font= new Font(BaseFont.createFont("C://Windows//Fonts//simfang.ttf", BaseFont.IDENTITY_H,

BaseFont.NOT_EMBEDDED));for(int i = 0;i

cell= new PdfPCell(new Phrase(products.get(i).getProductCode(),font));//产品编号

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase(products.get(i).getProductName(),font));//产品名称

cell.setFixedHeight(size);

table.addCell(cell);

cell= new PdfPCell(new Phrase(products.get(i).getPrice()+"",font));//产品价格

cell.setFixedHeight(size);

table.addCell(cell);

}returntable;

}

}

这同时也意味着如果项目要打包部署到linux服务器上去的话，前两种的中文解决办法都不好使了，只能下载中文字体资源文件，然而这其中又有一个坑，打包后文件路径读取不到。

所以要以加载资源文件的形式读取文件，代码如下

BaseFont baseFont = BaseFont.createFont(new ClassPathResource("/simsun.ttf").getPath(), BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED);

效果如下图：

在这里既可以下载也可以打印。

到这里我这踩了一路的坑都已经说完了，如果之后遇到新的问题我也持续更新这篇博客的。总的来说导出pdf真的是一件很繁琐的事情，还是那句话如果能导excel的话就尽量导excel吧。。。