解决iText 5.X以上,加入iTextAsian.jar 出现异常 Font 'STSong-Light' with 'UniGB-UCS2-H找不到的'的异常

本文解决了使用iText5.4.2时加入iTextAsian.jar导致的DocumentException错误。原因是iText5更新了命名空间,而iTextAsian未同步更新。通过修改iTextAsian.jar内的命名空间可以解决该问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

      使用的是iText 5.4.2 加入了iTextAsian.jar就报错.

  com.itextpdf.text.DocumentException: Font 'STSongStd-Light' with 'UniGB-UCS2-H' is not recognized.

  找的原因和解决方法:

  原因:iText5以上就改了命名空间了.是 com/itextpdf/text/pdf/fonts/

  但是iTextAsian还没有改.他的命名空间是 com/lowagie /text/pdf/fonts/

  所以报错..

  解决方法.:

  1.用winrar解压iTextAsian.jar

  2. 将com文件夹下面的lowagie 修改为itextpdf .

  3.进入cmd . 切换到iTextAsian目录.

  4.执行命令 jar cvf iTextAsian.jar com/itextpdf/text/pdf/fonts/*

  5.将生成的iTextAsian.jar文件替换原来的.

  问题解决.

### 使用 `BaseFont.createFont` 方法加载 `STSong-Light` 字体 在 Java 中,使用 iText 库可以通过 `BaseFont.createFont` 方法来创建自定义字体对象。对于中文支持,通常会使用 `STSong-Light` 字体及其编码方式 `UniGB-UCS2-H` 来处理汉字显示问题。 以下是基于引用内容和实际应用的一个完整示例: ```java import com.itextpdf.text.Document; import com.itextpdf.text.Paragraph; import com.itextpdf.text.pdf.BaseFont; import com.itextpdf.text.Font; public class ChinesePdfExample { public static void main(String[] args) { Document document = new Document(); try { // 创建 PDF 文档并指定文件名 java.io.FileOutputStream fos = new java.io.FileOutputStream("example_with_chinese.pdf"); // 打开文档 com.itextpdf.text.pdf.PdfWriter.getInstance(document, fos); document.open(); // 加载中文字体 BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED)[^1]; // 设置字体样式 Font fontChinese = new Font(bfChinese, 12, Font.NORMAL); // 添加带有中文的段落到文档 Paragraph paragraph = new Paragraph("你好,这是一个测试!", fontChinese); document.add(paragraph); } catch (Exception e) { e.printStackTrace(); } finally { // 关闭文档 document.close(); } } } ``` #### 解决方案说明 1. **字体加载** 上述代码通过调用 `BaseFont.createFont` 方法指定了字体名称 `"STSong-Light"` 和编码方式 `"UniGB-UCS2-H"`,同时设置了参数 `NOT_EMBEDDED` 表明不会嵌入字体到最终生成的 PDF 文件中。 2. **字体实例化** 将加载好的基础字体传递给 `com.itextpdf.text.Font` 类以构建具体的字体对象,并可以进一步调整其大小和其他属性。 3. **段落配置** 利用 `Paragraph` 对象将带有所需样式的文本加入到 PDF 页面之中[^2]。 --- #### 版本兼容注意事项 如果运行过程中遇到错误提示类似于 “Font 'STSong-Light' with 'UniGB-UCS2-H' is not recognized”,则可能是由于使用的 iText 版本较低或者缺少必要的依赖项[^3]。建议升级至更高版本的 iText 及其亚洲语言扩展库(如 `itext-asian`),具体 Maven 配置可参考以下片段[^4]: ```xml <dependency> <groupId>com.itextpdf</groupId> <artifactId>itextpdf</artifactId> <version>5.5.13</version> </dependency> <dependency> <groupId>com.itextpdf.tool</groupId> <artifactId>xmlworker</artifactId> <version>5.5.13</version> </dependency> <dependency> <groupId>com.itextpdf</groupId> <artifactId>itext-asian</artifactId> <version>5.2.0</version> </dependency> ``` --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值