itext解决中文字体

最近需要写一个抽取表结构的工具，类似于powerdesigner中的表图，其中有一步用到了itext这个第三方jar包来生成pdf文件，碰到了一个问题，记录于此。

 

问题描述：

工程使用maven构建，pom.xml中对于jar包的定义如下：

 "font-family:'Microsoft YaHei';font-size:14px;">
    com.lowagie
    itext
    2.1.7


    com.itextpdf
    itext-asian
    5.2.0

执行BaseFont bfChinesebfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);时报错：

"Font 'STSong-Light' with 'UniGB-UCS2-H' is not recognized."

 

解决

1. 首先尝试替换itext的包版本，他在maven中央库的位置是/maven2/com/lowagie/itext/，最高版本是4.2.2，但尝试后发现问题依旧。

2. 注意到itext-asian的包路径是com.itextpdf，于是继续找，发现/maven2/com/itextpdf/itextpdf中有itextpdf的各个版本，从5.0.6到5.5.6。

3. 搜索一些帖子，发现itext从5.x版本开始，改名为itextpdf，符合上面(1)和(2)对应的版本号。

4. 问题可以确定了，就是上面itext-asian和itext的版本不对应，改为：

 "font-family:'Microsoft YaHei';font-size:14px;">
     com.itextpdf
     itextpdf
     5.4.3

再次运行，ok了。

有些文章提到了itextasian包名未更新也会导致这个问题，但我用的5.2.0这个包，解压后看到包名是正确的，也许新版本已经改了，这点不深究了。

摘要：

 "font-family:'Microsoft YaHei';font-size:14px;">找到CJKFont类, 从中看到
    InputStream is = getResourceStream(RESOURCE_PATH + "cjkfonts.properties");
    cjkFonts.load(is);
    is.close();
    is = getResourceStream(RESOURCE_PATH + "cjkencodings.properties");
    cjkEncodings.load(is);
    is.close();

 "font-family:'Microsoft YaHei';font-size:14px;">他的font和encoding文件都是从String RESOURCE_PATH = "com/itextpdf/text/pdf/fonts/"; 这里加载的,而老itextasian.jar的包名是com.lowagie.text.pdf.fonts, 应该是包名重新命名了, 而没有及时更新itextasian.jar, 改了一下itextasian.jar包路径, 重新运行程序, OK,搞定.

 ×××××××××××××××××××××××××××××××××××××××××××

 更改iTextAsian.jar包名的方法如下
 1)使用winrar解压缩程序将原来的iTextAsian.jar解压，目录结构如下
   iTextAsian
       --com
          --lowagie
            --text
              --pdf
                --fonts
                  --...(字体属性文件)
 2)将加压后com目录下的包名lowagie更改为itextpdf
 3)在命令行转至iTextAsian目录，重新打包为iTextAsian.jar文件
   命令如下：
   jar cvf iTextAsian.jar com/itextpdf/text/pdf/fonts/*
   执行后，将新的iTextAsian.jar加入到classpath路径

 

参考：

http://endual.iteye.com/blog/1623327

http://blog.csdn.net/wang12/article/details/5661106

http://bbs.csdn.net/topics/390283201

 package oliver.itext.demo;
 import java.io.File;
 import java.io.FileOutputStream;
 import java.io.IOException;
 import java.io.OutputStream;
 import com.itextpdf.text.Document;
 import com.itextpdf.text.DocumentException;
 import com.itextpdf.text.Font;
 import com.itextpdf.text.Paragraph;
 import com.itextpdf.text.pdf.BaseFont;
 import com.itextpdf.text.pdf.PdfWriter;
 /**
  * PDF2Chinese。
  * 详细说明：
  *
  * 三种方法解决iText中文问题。
  * 修改列表：
  *
  * 序号作者修改日期修改内容
  *
  * 1Oliver2010-10-8 上午09:40:44建立类型
  *
  *
  * @version 1.0
  * @author Oliver
  * @since 1.0
  */
 public class PDF2Chinese
 {
     public static void main(String[] args) throws DocumentException, IOException
     {
         Document document = new Document();
         OutputStream os = new FileOutputStream(new File("chinese.pdf"));
         PdfWriter.getInstance(document,os);
         document.open();
         //方法一：使用Windows系统字体(TrueType)
         BaseFont baseFont = BaseFont.createFont("C:/Windows/Fonts/SIMYOU.TTF",BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED);

         //方法二：使用iTextAsian.jar中的字体
         //BaseFont baseFont = BaseFont.createFont("STSong-Light",BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED);

         //方法三：使用资源字体(ClassPath)
         ////BaseFont baseFont = BaseFont.createFont("/SIMYOU.TTF",BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED);

         Font font = new Font(baseFont);
         document.add(new Paragraph("解决中文问题了！",font));
         document.close();
     }
 }