1. itext7史上最全实战总结

1.1. 前言

最近有个需求需要我用Java手动写一份PDF报告，经过考察几种pdf开源代码，最终选取了itext7，此版本为7.1.11，由于发现网上关于该工具的博文比较少，特别是实战博文几乎没有，在我踩完各种坑，最终把PDF成型后，打算把经验分享出来，本文通过摘录解释来说明，内容来自本人GitHub itext-pdf

1.2. 配置文件

项目采用了Spring Cloud config所以配置在git上，仅仅研究itext7不需要用到数据库等功能，请直接运行PdfMain类的main方法，即可生成模拟的PDF报告

1.3. 版本POM

itext7相关pom

7.1.11

com.itextpdf

kernel

${itext.version}

com.itextpdf

io

${itext.version}

com.itextpdf

layout

${itext.version}

com.itextpdf

forms

${itext.version}

com.itextpdf

pdfa

${itext.version}

com.itextpdf

pdftest

${itext.version}

com.itextpdf

font-asian

${itext.version}

org.slf4j

slf4j-log4j12

1.7.18

com.itextpdf

html2pdf

3.0.0

1.4. 干货

itext7语义本身和前端css很像，所以有点前端基础还是比较容易掌握的

1.4.1. 添加图片

读取项目中图片文件

设置边距

设置宽高扩大缩小

Image indexImage = new Image(ImageDataFactory.create(GenoReportBuilder.class.getClassLoader().getResource("image/gene.png")));

indexImage.setMargins(-50, -60, -60, -60);

indexImage.scale(1, 1.05f);

1.4.2. 添加指定空白页

添加第2页为空白页，立即刷新后再继续添加

pdf.addNewPage(2).flush();

1.4.3. Div、Paragraph

Div div = new Div();

div.setWidth(UnitValue.createPercentValue(100));

div.setHeight(UnitValue.createPercentValue(100));

div.setHorizontalAlignment(HorizontalAlignment.CENTER);

Paragraph p1 = new Paragraph();

p1.setHorizontalAlignment(HorizontalAlignment.CENTER);

p1.setMaxWidth(UnitValue.createPercentValue(75));

p1.setMarginTop(180f);

p1.setCharacterSpacing(0.4f);

Style large = new Style();

large.setFontSize(22);

large.setFontColor(GenoColor.getThemeColor());

p1.add(new Text("尊敬的 ").addStyle(large));

...

Paragraph p2 = new Paragraph();

...

div.add(p1);

div.add(p2);

整块的内容用Div包裹，这里整块包裹的好处是什么？一方面排版分明成体系，另一方面若需求是整块的内容必须在同一个版面，你可以对Div设置div.setKeepTogether(true);，尽量保证若整块的内容超出了一页，那这块内容会自动整块出现在下一页，上一页剩下的就留白了

可以看到Div，Paragraph可以设置很多属性，实际上我们常用的组件除了这两种，还有Table，Cell，List，他们大部分的属性都是一样的，只是部分属性只在部分组件起效果，所以当你设置某个属性没起效果也不用奇怪

Paragraph需要特别注意的一点，想要段落文字居中，不要用setHorizontalAlignment(HorizontalAlignment.CENTER);这是组件的居中对段落无效，甚至对段落里你放Text也无效，需要改用setTextAlignment(TextAlignment.CENTER);

Paragraph段落的行距也是个高频问题，这里给出官方我看到的解释，参考https://itextpdf.com/en/resources/books/itext-7-building-blocks/chapter-4-adding-abstractelement-objects-part-1，搜关键字setFixedLeading，我的理解该方法设值行高绝对值，官方解释是两行文字中间基线之间的距离

如果想了解详细的什么属性哪里能起作用哪里不行，请访问该地址

1.4.4. Table

useAllAvailableWidth表示页面有多宽，我就有多宽

table.startNewRow();表示新起一行，table每画一行都要新起一行

同样table内容需要居中，和段落一样，请设置new Cell().setTextAlignment(TextAlignment.CENTER)

每个table中cell都有默认高度，会比实际输入字体高些，此时设置setHeight，若更大没有问题，若高度小于或接近字体大小文字可能就消失了，若想让Cell高度更接近文字高度，请设置Cell的padding，即cell.setPadding(-2)，设置负值即可

1.4.5. Tab，\t

itext7中如果要表示段落前的空格，不能使用\t，但换行可以使用\n

若要实现Tab效果可以有多个方法

\u00a0符号，大概7、8个该符号可表示tab，可能不是很准确

p1.add(new Text("\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0壹基因衷心祝愿您身体健康、享受品质生活！"));

p1.setFirstLineIndent(24)，表示段落前留多少空，需要知道一个字多大，设置成两倍就行

Tab也是集成AbstractElement的组件，通过以下方式也可实现相同的效果

p2.add(new Tab());

p2.addTabStops(new TabStop(20, TabAlignment.LEFT));

1.4.6. 换页

我常用的换页方法为如下，该方法可保证立即换页

doc.add(new AreaBreak(AreaBreakType.NEXT_PAGE));

当然PdfDocument有addNewPage其实也可以用，但有时候你没把握好刷新时间可能导致某些混乱

1.4.7. 画图或画文字

能画出多么复杂的图形看是谁画了，在我的PDF中，我画的最复杂的图形如下

该图形由多个弧形区域加线段加文字组成，包括数字上的小箭头也是画出来的，画这个的代码过多，想要了解详细的可以自行下载研究，这里介绍API功能

lineTo画线段

roundRectangle可用来画角是弧形的方形，也可以用来画圆

showText用来画文字

以上几种结合填充即可把三角形，多边形画出来了

PdfPage page = pdf.getPage(pdf.getNumberOfPages());

pageSize = pdf.getDefaultPageSize();

PdfCanvas pdfCanvas = new PdfCanvas(page);

pdfCanvas.saveState().moveTo(pageSize.getWidth() / 2 - 100 + i * 40, yOffset - 203)

.lineTo(pageSize.getWidth() / 2 - 100 + i * 40, yOffset - 208)

.stroke().restoreState();

pdfCanvas.setLineWidth(2);

pdfCanvas.setStrokeColor(color);

pdfCanvas.roundRectangle(pageSize.getWidth() / 2 - 3 + posXOffset, yOffset - 188, 6, 6, 3)

.stroke();

pdfCanvas.beginText()

.setFontAndSize(font, 12)

.moveText(pageSize.getWidth() / 2 - text.length() * 12 / 2, yOffset - 45);

pdfCanvas.showText(text);

pdfCanvas.endText();

1.4.8. Html段落转Pdf段落

我们可能遇到把一段Html文本转换成itext7的段落放进来，此时需要用到它的htmlToPdf模块，该模块对应POM

com.itextpdf

html2pdf

3.0.0

至于使用，设置好配置属性，使用也很简单，通常我们需要支持中文，所有配置如下，字体可以自己换

ConverterProperties proper = new ConverterProperties();

//字体设置，解决中文不显示问题

FontSet fontSet = new FontSet();

fontSet.addFont(GenoReportBuilder.class.getClassLoader().getResource("font/SourceHanSansCN-Regular.ttf").getPath(), PdfEncodings.IDENTITY_H);

FontProvider fontProvider = new FontProvider(fontSet);

proper.setFontProvider(fontProvider);

String content = "html内容";

List elements = HtmlConverter.convertToElements(content, proper);

转换的内容是IElement集合，而IElement是什么呢？给张图就了解了

也就是说只要你的html内容是

如下是我的处理例子供参考，我把输入html内容样式进行了一定修改后转成itext7组件，这里特别提心，html转过来的itext7组件可能会不支持部分样式的修改，所以需要在html中进行css样式的添加，这里我就把字体和高度统一用css设值了

Div overall = new Div();

java.util.List iElements = getFixContent(value);

for (IElement iElement : iElements) {

Style style = new Style();

style.setFontSize(10);

style.setCharacterSpacing(0.7f);

if (iElement instanceof Div) {

Div div = (Div) iElement;

java.util.List children = div.getChildren();

// 全部段落改成相同样式

this.addParagraphStyleCircle(style, children);

overall.add(div);

} else if (iElement instanceof Paragraph) {

Paragraph element = (Paragraph) iElement;

overall.add(element.addStyle(style));

}

}

doc.add(overall);

getFixContent

private java.util.List getFixContent(String content) {

if (content.startsWith("