论坛首页 Java企业应用论坛

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

浏览 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;"

  • 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, @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>
        

    论坛首页 Java企业应用版

    跳转论坛:
    Global site tag (gtag.js) - Google Analytics