iText生成PDF文件

一、导语

常见生成PDF文件的有两种方法，一是先生成 word文档，然后将word转换成PDF文件；另一种则是直接生成PDF文件。

1.1.word转换PDF

1.1.1.技术介绍

生成Word文件并将其转换为PDF文件，可以使用多种Java库和JAR包。以下是一些常用的库和JAR包：

Apache POI：这是一个用于操作Microsoft Office格式文件的Java库。你可以使用它来创建和编辑Word文档（.doc或.docx）。
Spire.Doc for Java：这是一个功能强大的Java库，用于创建、编辑、转换和打印Word文档。它支持将Word文档转换为PDF格式。Spire.Doc for Java的JAR包可以直接添加到你的Java项目中。
Aspose.Words for Java：Aspose.Words是一个用于处理Word文档的Java库，它提供了丰富的API来创建、编辑和转换Word文档。这个库也支持将Word文档转换为PDF。
iText：虽然iText主要用于处理PDF文件，但它也可以与其他库（如Apache POI或Spire.Doc）结合使用，以实现从Word到PDF的转换。iText的JAR包可用于在Java项目中添加PDF处理功能。

而Word到PDF转换的步骤如下所示：

生成Word文件并保存：使用Apache POI或Spire.Doc的API创建或编辑Word文档。将编辑后的Word文档保存到磁盘上的某个位置。
转换Word为PDF并保存：使用Spire.Doc或Aspose.Words的API将Word文档转换为PDF格式。这通常涉及读取Word文档、创建一个PDF文档，然后将Word文档的内容复制到PDF文档中。将转换后的PDF文档保存到磁盘上的指定位置。

1.1.2.补充说明

由上述说明可知，生成一次PDF文件需要保存两次，这极大的浪费了系统的内存；同时，word转换PDF有限制，只能转换少量页数，当大文件转换时，就需要进入收费阶段了。种种限制，让这种方法变得并不实用。

1.2.iText7 生成PDF

iText是一个开源库，用于创建和操作PDF文件。本文则主要用 iText 7 进行测试与文件生成。pom核心jar文件：

<!--  核心jar，用于生成PDF文件 ---><dependency><groupId>com.itextpdf</groupId><artifactId>itext7-core</artifactId><version>7.1.16</version><type>pom</type></dependency><!--  用于日志打印，可用可不用---><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.20</version><scope>compile</scope></dependency><!--  用于数据库连接，可用可不用---><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>1.1.1</version></dependency>

二、工具类

2.1.代码示例

import com.itextpdf.io.font.PdfEncodings;
import com.itextpdf.kernel.font.PdfFont;
import com.itextpdf.kernel.font.PdfFontFactory;
import com.itextpdf.kernel.geom.PageSize;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.*;
import com.itextpdf.layout.property.HorizontalAlignment;
import com.itextpdf.layout.property.TextAlignment;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;import java.io.IOException;
import java.util.List;@Slf4j
@Component
public class PdfGenerator {public void createPdf(String fileName, String title, String titleRow, String[] headerText, List<String[]> data) throws IOException {PdfDocument pdfDoc = new PdfDocument(new PdfWriter(fileName));Document doc = new Document(pdfDoc, PageSize.A4);// 设置字体  simhei.ttf黑体  SimSun宋体PdfFont font = PdfFontFactory.createFont("simhei.ttf", PdfEncodings.IDENTITY_H, true);
//        PdfFont font = PdfFontFactory.createFont("SimSun", "UniGB-UCS2-H", false);//        String text = "文章内容";
//        if (null != text){
//            txtSet(doc,text,font);
//        }// 设置标题if (null != title){titleSet(doc,title,font);}// 创建表格int numColumns = (null == headerText) ? data.get(0).length : headerText.length;Table table = new Table(numColumns);if (!(null == titleRow)){titleCell(table,titleRow,headerText.length,font);     // 添加标题行}// 添加表头for (int i = 0; i < headerText.length; i++) {headerCell(table,headerText[i],font);}//添加内容for (int i = 0; i < data.size(); i++) {for (int j = 0; j < data.get(i).length; j++) {contextCell(table,data.get(i)[j],font);}}// 使用Div容器来居中表格Div div = new Div();div.setHorizontalAlignment(HorizontalAlignment.CENTER); // 设置Div水平居中div.add(table); // 将表格添加到Div中// 将Div添加到文档中doc.add(div);// 关闭文档doc.close();log.info(fileName+"Pdf文件创建成功!");}//设置文本public void txtSet(Document doc,String data,PdfFont font){Paragraph titleText = new Paragraph(data).setTextAlignment(TextAlignment.CENTER).setFont(font).setFontSize(12);doc.add(titleText);}//设置标题public void titleSet(Document doc,String data,PdfFont font){Paragraph titleText = new Paragraph(data).setTextAlignment(TextAlignment.CENTER).setFont(font).setFontSize(20);doc.add(titleText);}//设置标题行public void titleCell(Table table,String data,int col,PdfFont font){Cell headerCell = new Cell(1,col).add(new Paragraph(data).setTextAlignment(TextAlignment.CENTER).setFont(font).setFontSize(14));table.addCell(headerCell);}//设置表头public void headerCell(Table table,String data,PdfFont font){Cell cell = new Cell().add(new Paragraph(data).setTextAlignment(TextAlignment.CENTER).setFont(font).setFontSize(12));table.addCell(cell);}//设置内容public void contextCell(Table table,String data,PdfFont font){Cell cell = new Cell().add(new Paragraph(data).setTextAlignment(TextAlignment.CENTER).setFont(font).setFontSize(10));table.addCell(cell);}}

2.2.示例解释

2.2.1.字体

PdfFont font = PdfFontFactory.createFont("simhei.ttf", PdfEncodings.IDENTITY_H, false);

这行代码的主要目的是加载一个名为“simhei.ttf”的字体文件，并使用Unicode编码方式，但不将其嵌入到生成的PDF文档中。

        PdfFontFactory.createFont(): PdfFontFactory是iText库中的一个工具类，用于创建PdfFont对象。它的createFont()方法是创建新字体的主要方法。
        "simhei.ttf": 这是字体文件的路径或名称。在这个例子中，它指的是“黑体”字体的TrueType字体文件（.ttf）。你需要确保这个字体文件在你的项目路径下是可用的，或者提供完整的文件路径。
        PdfEncodings.IDENTITY_H: 这是字体的编码方式。PdfEncodings.IDENTITY_H通常用于Unicode字体，确保在PDF文档中正确地表示和显示字符。
        false: 这个布尔值参数通常用于指示字体是否应该被嵌入到生成的PDF文档中。设置为false意味着字体不会被嵌入，这通常在你确定阅读PDF的客户端已经安装了该字体时是可行的。但是，为了确保最大的兼容性，通常建议将字体嵌入到PDF中，因此你可能会将这个值设置为true。