在spring boot 中使用itext和itextrender生成pdf文件
转载请注明出处 https://www.cnblogs.com/majianming/p/9539376.html
项目中需要对订单生成pdf文件,在第一版本其实已经有了比较满意的pdf文档,但是还是存在问题的,主要是itext的css支持能力实在是太差,测试过程中发现margin都不支持,和我对接pdf的html模板的伙伴也是一直在改,凭着不想一直被打的希望,终于找到了下面好一点的方案。总的来说,就是加了itextrender这个支持常见的css2.1的封装。
首选介绍一下这次使用的环境设置
- spring boot 2.0
- itext 5.5.13
- xmlworker 5.5.13
- itext-asin asian 5.2.0
- flying-saucer-pdf-itext5 9.1.12
在maven pom文件添加
<!-- https://mvnrepository.com/artifact/com.itextpdf/itextpdf -->
<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>itextpdf</artifactId>
<version>5.5.13</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.itextpdf/itext-asian -->
<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>itext-asian</artifactId>
<version>5.2.0</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.itextpdf.tool/xmlworker -->
<dependency>
<groupId>com.itextpdf.tool</groupId>
<artifactId>xmlworker</artifactId>
<version>5.5.13</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.xhtmlrenderer/flying-saucer-pdf-itext5 -->
<dependency>
<groupId>org.xhtmlrenderer</groupId>
<artifactId>flying-saucer-pdf-itext5</artifactId>
<version>9.1.12</version>
</dependency>
在代码中默认使用
ITextRenderer iTextRenderer = new ITextRenderer();
iTextRenderer.setPDFVersion(PdfWriter.VERSION_1_7);
iTextRenderer.setDocumentFromString(html);//pdf的内容,有其他生成模式,方法名类似
iTextRenderer.layout();
try (ServletOutputStream outputStream = response.getOutputStream()) {
iTextRenderer.createPDF(outputStream);
} catch (IOException e) {
logger.error("输出pdf错误" + e.getMessage(), e);
} catch (DocumentException e) {
logger.error("生成pdf错误" + e.getMessage(), e);
}
好了,启动跑一下。中文文字一个都没有显示。按照之前的想法,那设置一下字体文件路径就好了吧,下面的借鉴于itext的com.itextpdf.text.FontFactoryImp#registerDirectories(), 用于向itextRender注册默认的字体路径,
ITextRenderer iTextRenderer = new ITextRenderer();
try {
ITextFontResolver fontResolver = iTextRenderer.getFontResolver();
String windir = System.getenv("windir");
String fileSeparator = System.getProperty("file.separator");
if (windir != null && fileSeparator != null) {
fontResolver.addFontDirectory(windir + fileSeparator + "fonts", BaseFont.NOT_EMBEDDED);
}
fontResolver.addFontDirectory("/usr/share/X11/fonts", BaseFont.EMBEDDED);
fontResolver.addFontDirectory("/usr/X/lib/X11/fonts", BaseFont.EMBEDDED);
fontResolver.addFontDirectory("/usr/openwin/lib/X11/fonts", BaseFont.EMBEDDED);
fontResolver.addFontDirectory("/usr/share/fonts", BaseFont.EMBEDDED);
fontResolver.addFontDirectory("/usr/X11R6/lib/X11/fonts", BaseFont.EMBEDDED);
fontResolver.addFontDirectory("/Library/Fonts", BaseFont.EMBEDDED);
fontResolver.addFontDirectory("/System/Library/Fonts", BaseFont.EMBEDDED);
} catch (IOException e) {
logger.error("字体路径读取异常", e);
//相关处理
return;
} catch (DocumentException e) {
logger.error("字体解析异常", e);
//相关处理
return;
}
iTextRenderer.setPDFVersion(PdfWriter.VERSION_1_7);
iTextRenderer.setDocumentFromString(html);
iTextRenderer.layout();
try (ServletOutputStream outputStream = response.getOutputStream()) {
iTextRenderer.createPDF(outputStream);
} catch (IOException e) {
logger.error("输出pdf错误" + e.getMessage(), e);
} catch (DocumentException e) {
logger.error("生成pdf错误" + e.getMessage(), e);
}
开心的运行起来,哈哈哈哈,要好了!
欸?还是一样,是我的问题?肯定是我的问题!那就继续看吧
看了许多的博客(忘记记录下来了,( ̄_, ̄ ))
看到许多添加字体文件的都是类似于fontResolver.addFont("simsun.ttc",BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
,向解析器注册宋体字体;第三个参数是字体的嵌入行为,有嵌入和不嵌入两种。那第二个参数是什么,查看命名,也就是encoding,字体的编码方式,看看ITextFontResolver#addFontDirectory(Sting path,boolean embedded)这个方法中,调用了addFont(String path, boolean embedded),在这个方法中找到了问题的根源,上面调用fontResolver.addFontDirectory
这个方法设置字体的默认编码为Cp1252,这个编码并不支持中文,也就很好的说明了为什么pdf上的中文字符都没有显示,那么我们设置为Identity-H,这个时候将上面的代码加以修改
首先修改默认的addFontDirectory方法
/**
* 因为默认设置的字体编码为西文,需要重写改为<code>BaseFont.IDENTITY_H</code>
*
* @param dir
* @param embedded
* @param fontResolver
* @throws DocumentException
* @throws IOException
*/
private void addFontDirectory(String dir, boolean embedded, ITextFontResolver fontResolver)
throws DocumentException, IOException {
File f = new File(dir);
if (f.isDirectory()) {
File[] files = f.listFiles((dir1, name) -> {
String lower = name.toLowerCase();
return lower.endsWith(".otf") || lower.endsWith(".ttf") || lower.endsWith(".ttc");
});
for (int i = 0; i < files.length; i++) {
fontResolver.addFont(files[i].getAbsolutePath(), BaseFont.IDENTITY_H, embedded);
}
}
}
所以生成的代码改为
ITextRenderer iTextRenderer = new ITextRenderer();
try {
ITextFontResolver fontResolver = iTextRenderer.getFontResolver();
String windir = System.getenv("windir");
String fileSeparator = System.getProperty("file.separator");
if (windir != null && fileSeparator != null) {
addFontDirectory(windir + fileSeparator + "fonts", BaseFont.NOT_EMBEDDED, fontResolver);
}
addFontDirectory("/usr/share/X11/fonts", BaseFont.EMBEDDED, fontResolver);
addFontDirectory("/usr/X/lib/X11/fonts", BaseFont.EMBEDDED, fontResolver);
addFontDirectory("/usr/openwin/lib/X11/fonts", BaseFont.EMBEDDED, fontResolver);
addFontDirectory("/usr/share/fonts", BaseFont.EMBEDDED, fontResolver);
addFontDirectory("/usr/X11R6/lib/X11/fonts", BaseFont.EMBEDDED, fontResolver);
addFontDirectory("/Library/Fonts", BaseFont.EMBEDDED, fontResolver);
addFontDirectory("/System/Library/Fonts", BaseFont.EMBEDDED, fontResolver);
} catch (IOException e) {
logger.error("字体路径读取异常", e);
//相关处理
return;
} catch (DocumentException e) {
logger.error("字体解析异常", e);
//相关处理
return;
}
iTextRenderer.setPDFVersion(PdfWriter.VERSION_1_7);
iTextRenderer.setDocumentFromString(html);
iTextRenderer.layout();
try (ServletOutputStream outputStream = response.getOutputStream()) {
iTextRenderer.createPDF(outputStream);
} catch (IOException e) {
logger.error("输出pdf错误" + e.getMessage(), e);
} catch (DocumentException e) {
logger.error("生成pdf错误" + e.getMessage(), e);
}
运行,ok了