flying saucer 使用中的一些有关问题 (java导出pdf)

2012-10-27

flying saucer 使用中的一些问题 (java导出pdf)flying saucer（源代码托管在github https://github.com/fly

flying saucer 使用中的一些问题 (java导出pdf)
flying saucer（源代码托管在github https://github.com/flyingsaucerproject/flyingsaucer）是java导出pdf的一种解决方案，最早是从downpour老大的文章里看到它： http://www.iteye.com/topic/509417 ，感觉比之前的iText好用许多，它可以解析css，即我将页面先设置好，然后传递给它，它既可以给我生成一个pdf出来，跟页面一样，当时感觉很酷，于是就研究了一下，现在项目中也用到了，效果还不错。

     优点很明显，之前也提到了，可以解析css，这样很方便，大大的减少了工作量。pdf加水印也变得很简单——只需为body设置一个background-image即可。
     说说使用中需要注意的一些问题吧：
[list=1]
中文换行问题
   老外做的东西，没有考虑到中文问题。默认提供的包里，中文不会换行，有人修改了源代码，解决了这个问题，重新编译好的包在附件里，可以下载。需要注意的是，在官网提供的jar包里，有两个包，一个是core-renderer.jar，另一个是core-renderer-minimal.jar。引用时，只需引用前者就行。有人曾经说用这个重新编译后的包替换了原来的包之后，不起作用，原因就在此。

   另外，想要中文换行，如果是table，那么table 的style必须加上这句话

style="table-layout:fixed; word-break:break-strict;"

css路径问题
在一个java project里，使用相对css路径是可以的，效果也都不错。但在java web project里，使用css相对路径是不可以的(最起码这里困扰了我很久，差点就放弃flying saucer了)。例如，我有一个模板叫addOne.jsp，里面引用到了某个css，就应该这样写(windows)

<link href="file:///D|/project/WebContent/commons/css/module-pdf.css" rel="stylesheet" type="text/css" />

只有这样写了之后，它才能找到这个css，很诡异。每次换了机器之后都要改路径，很麻烦。
中文字体问题
downpour老大在它那篇文章里提到了怎样处理中文字体的，他可能高估了许多人的水平。其实说起来，很简单，就两点：一是在java代码里引用字体，二是在页面上引用字体。
引用字体：

// 解决中文支持问题          ITextFontResolver fontResolver = renderer.getFontResolver();         fontResolver.addFont(&quot;C:/Windows/Fonts/arialuni.ttf&quot;, BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);

这里引用了arialuni.ttf字体，它位于C盘windows/fonts文件夹下，将它引用后，还需要在页面上使用这个字体

   <body style="font-family:'Arial Unicode MS'">

这里的Arial Unicode MS 即刚才的arialuni.ttf字体的名字，换了其它字体后要注意修改这里的名称。这样才可以在pdf中显示中文。
许多人有这样一个问题——按照以上两个步骤做了之后，页面中还是没有中文，这时，请检查你引用的css文件，其中一定设置了其它字体，只需将它去掉即可
[/list]
缺点：
我在使用中发现，flying saucer不支持富文本，如果用到了KindEditor此类富文本编辑器，
还要将其中的内容转化成pdf，那对flying saucer来说就是个灾难。会报一堆错误，目前我还没有找到解决方案。还好这次项目中不是必须使用富文本编辑器，对于有此类需求的同学来说，请慎重选择flying saucer。另外，flying saucer严格遵守html规则，一个小小的错误，都会导致它报错。诸如

<td colspan="2""2">

此类的html代码在jsp中是不会有问题的，可是flying saucer却会报错，曾经这个问题导致我花了一小时时间来寻找问题所在。不过很难说这到底是缺点还是优点

    最后贴一个较完整的例子：
    我使用spring mvc，在controller里

               @RequestMapping("/pdf/{projectId}")public ModelAndView generatePdf(HttpServletRequest request,HttpServletResponse response, @PathVariableString projectId) {Project project = this.projectService.getProjectById(projectId);ModelAndView mav = new ModelAndView();if (project == null) {mav.setViewName("forward:/error/page-not-found");return mav;}                //中文需转义String pdfName = "pdfName";response.setHeader("Content-disposition", "attachment;filename="+pdfName;response.setContentType("application/pdf");OutputStream os = response.getOutputStream();ITextRenderer renderer = new ITextRenderer();//指定模板地址renderer.setDocument("http://localhost/project/preview/"+projectId);ITextFontResolver fontResolver = renderer.getFontResolver();if (StringUtils.isOSWindow())fontResolver.addFont("C:/Windows/Fonts/ARIALUNI.TTF",BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);elsefontResolver.addFont("/usr/share/fonts/TTF/ARIALUNI.TTF",BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);renderer.layout();renderer.createPDF(os);os.close();return null;}        @RequestMapping("/preview/{projectId}")public ModelAndView pdf(@PathVariableString projectId) {Project project = this.projectService.getProjectById(projectId);ModelAndView mav = new ModelAndView();if (project == null) {mav.setViewName("forward:/error/page-not-found");return mav;}mav.setViewName("pdf");mav.addObject("project",project);return mav;}

jsp页面如下：

 <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>title</title><link href="file:///D|/project/WebContent/commons/css/print-pdf.css" rel="stylesheet" type="text/css"  /></head><body style="font-family:'Arial Unicode MS'">   <table border="1" cellspacing="0" cellpadding="0" style="table-layout:fixed; word-break:break-strict;">    <tr>      <td rowspan="9" width="4%" style="width:160px">（1）项目单位名称 </td>      <td colspan="2"><%=StringUtils.getValueString(user.getDeptName()) %></td>    </tr>    </table></body>

1 楼 yindashan 2011-09-23 图片不能完全显示被遮盖一部分，怎么解决？ 2 楼 a418040445 2011-11-22 是啊，我也碰到了。

热点排行

PowerDesigner

flying saucer 使用中的一些有关问题 (java导出pdf)