在linux环境下使用itext生成pdf

转载请注明出处 https://www.cnblogs.com/majianming/p/9537173.html 项目中需要对订单生成pdf文件，在不断的尝试之后，终于生成了比较满意的pdf文档。简单介绍一下背景：项目是一个erp项目，docker容器化CentOS 7运行环境，应用打包方式jar,使用itext生成pdf

我们从后面的三个背景来分析

首先是使用itext库，需要明确的是itext是默认不支持中文显示的，这个问题很容易找到的方法是添加itext-asin库，一个解决中日韩文字问题的拓展，而在这个拓展自然也是需要另外添加中文字体支持的，所以我们为了支持中文，在itext的基础上需要itext-asin库和字体文件。
第二个背景，也就是jar打包方式，许多博客在介绍这一段时，会把字体文件添加到项目文件下，这样本地开发是没有问题的，但是一旦部署到了linux(CentOS)环境下，就会有中文字无法显示的问题（这时候如果你将应用的jar包在windows环境下跑，一般是可以正常显示的，为什么？等会看看第三个背景你就会明白了），这是因为在itext中，并不是用文件流（fileinputstream）的形式去读取字体，自然无法读取到jar包中的文件，那么我们换一个思路，把字体文件移动到项目外的一个路径下，然后指定itext去读取这个路径。
第三个背景CentOS，一般的服务器环境自然不会带中文字体的，那么我们需要将添加字体到哪里？随便加一个地方？且慢，我们先看一个地方在com.itextpdf.text.FontFactoryImp#registerDirectories()下，我们发现了这样一段代码

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);

也就是说，itext已经把背景分析2中的指定字体路径的事情做了，只是我们还没有字体在对应的路径上然后我们再看看其中的这个代码

String windir = System.getenv("windir");
String fileseparator = System.getProperty("file.separator");
if (windir != null && fileSeparator != null) {
fontResolver.addFontDirectory(windir + fileseparator + "fonts", BaseFont.NOT_EMBEDDED);
}

windir? 比较熟悉windows下变量的人可以知道，这个是获取windows系统根路径的一个环境变量，我是win 10的电脑，获取的就是C:\Windows。我们打开C:\Windows\fonts路径，会发现都是相关字体文件，也就是解释了为什么在linux中文无法显示的jar包在Windows下可以正常显示了——并不是在windows下可以读取到jar包的字体文件，而是在windows下可以读取到系统中的字体文件。因为这个原因，自然可以显示中文字体；所以，如果要显示任何自定义的字体，在windows下，我们可以将可以添加到C:\Windows\fonts下；在liunx环境下，添加到对应的路径下即可。我们理论上可以使用任何一个系统中已经定义的字体。在这里，我们选择了/usr/share/fonts这个路径，当然这个路径在CentOS中是不存在的，所以要手动创建，然后将需要的中文字体复制进去

因为公司的环境是k8s的docker容器，为了平时的docker容器部署方便，我们依然把字体文件放在工程下（与dockerfile同一级），然后使用docker的命令将字体复制到指定路径下