浏览 8046 次
精华帖 (0) :: 良好帖 (1) :: 新手帖 (0) :: 隐藏帖 (0)
|
|
---|---|
作者 | 正文 |
发表时间:2011-04-17
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;" 在一个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("C:/Windows/Fonts/arialuni.ttf", 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, @PathVariable String 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); else fontResolver.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(@PathVariable String 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" class="table" style="table-layout:fixed; word-break:break-strict;"> <tr> <td rowspan="9" width="4%" class="tc">项目单位基本信息</td> <td colspan="2" style="width:160px">(1)项目单位名称 </td> <td colspan="2"><%=StringUtils.getValueString(user.getDeptName()) %></td> </tr> </table> </body> 声明:ITeye文章版权属于作者,受法律保护。没有作者书面许可不得转载。
推荐链接
|
|
返回顶楼 | |