java pdf转中文编码

### 解决Java中PDF文件转换时的中文编码问题

在处理Java应用程序中的PDF文件转换时，如果遇到中文字符显示为乱码的情况，通常是因为缺少合适的字体支持或未正确设置编码方式。以下是几种常见的解决方案：

#### 使用iText库配置自定义字体
为了确保PDF文档能够正确渲染中文字符，可以使用iText库并加载特定的中文字体。通过创建`BaseFont`对象来引入外部字体文件，并将其应用于整个文档。

import com.itextpdf.text.Document;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.PdfWriter;

public class PdfWithChinese {
    public static void main(String[] args) throws Exception {
        Document document = new Document();
        PdfWriter.getInstance(document, new FileOutputStream("chinese_example.pdf"));

        // 加载中文字体
        BaseFont bfChinese = BaseFont.createFont("C:/Windows/Fonts/simsun.ttc,0", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);

        document.open();

        Paragraph paragraph = new Paragraph("你好世界！", FontFactory.getFont(FontFactory.HELVETICA, "UTF-8"));
        paragraph.setFont(new Font(bfChinese, 12));
        document.add(paragraph);
        
        document.close();
    }
}

这段代码展示了如何指定一个位于操作系统默认位置（如 Windows 的 Fonts 文件夹）内的 TrueType 字体文件作为 PDF 文档的基础字体[^5]。

#### 设置HTTP响应头以防止下载时乱码
当服务器端生成带有中文名称的PDF文件供客户端下载时，还需要注意调整 HTTP 响应头部的信息，以便浏览器能识别正确的文件名编码格式。

protected void setFileDownloadHeader(HttpServletResponse response, String filename, String extName){
    try{
        String encodedFilename = URLEncoder.encode(filename + extName , "UTF-8");
        response.setHeader("Content-Disposition","attachment;filename="+encodedFilename);
        response.setContentType("application/pdf;charset=UTF-8");
    }catch(UnsupportedEncodingException e){
        logger.error(e.getMessage(),e);
    }
}

此函数用于准备发送给用户的HTTP响应，在其中设置了适当的内容类型以及经过URL编码后的附件名字串[^3]。

#### FOP框架下的解决办法
Apache FOP (Formatting Objects Processor) 是另一个流行的XSL-FO处理器工具包，它也可以用来生成高质量的PDF文档。针对FOP产生的PDF存在中文乱码现象，则可以通过修改配置文件的方式加入所需的字体描述信息。

<fop version="1.0">
  <!-- 定义全局使用的字体 -->
  <font kerning="yes" embed-url="./fonts/msyh.ttf">SimHei</font>
  
  ...
</fop>

上述XML片段来自FOP配置文件的一部分，这里指定了要嵌入到最终输出中的黑体字形资源路径[^4]。