jasperReport+struts2+jatoolsPrinter打印

前言：

      jasperReport(4.5最新版，下面用ireport代替)大家都很熟悉，但是打印用到jatoolsPrinter的，应该不多吧、这里介绍下struts2的ireport插件，以及jatoolsPrinter打印。

 

 

1、首先得准备支持ireport的几个常用包，根据ireport版本的不同，包的新旧也不同，我用的ireport最新版的，所以用到的包也得是最新的，下面还会列出我遇到的包的问题；

   a>groovy-all-1.7.5.jar

   b>iText-2.1.0.jar[生成pdf文档用]

   c>iTextAsian.jar[语言支持]

   d>jasperreport_4.5.0.jar[必备包]

   e>poi-3.7.jar[导出excel时候用]

   f>commons-collections-3.2.jar

   g>commons-beanutils-1.7.1.jar

   h>commons-digester-1.7.jar

   i>org-netbeans-core.jar[可有可无，当你对报表进行样式处理时候(styles)会用到，比如：奇偶换色等]

 列举几个包的问题：

   Ⅰ、导出excel时候报错：

org.apache.jasper.JasperException: javax.servlet.ServletException: java.lang.NoSuchMethodError: org.apache.poi.hssf.usermodel.HSSFSheet.setRightToLeft(Z)V

      解决方法：你使用的poi-xxx.jar版本过低，换个高版本的jar包即可。

   Ⅱ、生成PDF格式文档时候报错：

java.lang.NoSuchMethodError: com.lowagie.text.pdf.PdfWriter.setRgbTransparencyBlending(Z)V

      解决方法：iText.jar文件过旧，将之改为2.1.X就可以了。

   Ⅲ、使用ireport时候报错：

java.lang.NoClassDefFoundError: org/codehaus/groovy/control/CompilationFailedException  

      解决方法：添加groovy-all-1.7.5.jar。ps:像这样的错误(java.lang.NoClassDefFoundError)最好解决，一看就是少了Jar包，找到添加上就OK了。

   Ⅳ、使用ireport时候报错：

net.sf.jasperreports.engine.JRRuntimeException: Unknown hyperlink target 0

      解决方法：版本不搭配的问题，可能会是当前使用的iRrport 的版本高于操作时的包的版本。

   Ⅴ、在使用PDF格式预览的时候报错：

net.sf.jasperreports.engine.JRRuntimeException: Could not load the following font :

pdfFontName   : STSong-Light

pdfEncoding   : UniGB-UCS2-H

isPdfEmbedded : false

      解决办法：添加语言包支持，iTextAsian.jar。ps：这里需要注意，有中文字的field，如果想在PDF格式文档中正常显示，一定需要设置其两个属性pdfFontName和pdfEncoding为STSong-Light，UniGB-UCS2-H；否则不显示。

   Ⅵ、在ireport中设计报表时候预览报错：

org.codehaus.groovy.control.MultipleCompilationErrorsException: startup failed；......

    解决办法：你使用了text field存放静态文本那内容了，改为static field存放就ok。

 

2、和struts2结合，肯定得需要一个插件包struts2-jasperreports-plugin-2.0.11.2.jar，这里需要注意它里面的struts-plugin.xml文件中的包并没有继承自struts-default,需要把它拿出来改一下

<package name="jasperreports-default" extends="struts-default">

   定义Result类型为jasper时,需要指定三个参数:

1、location:指定.jasper文件的位置.

2、format:指定生成的报表文件的格式,如果不指定,默认生成PDF文件（XLS：excel格式，HTML：html格式，CSV，XML，。。。）.

3、dataSource:指定一个集合属性名,JasperReports报表将自动迭代输出该集合中的数据。

 

项目中，我对该插件进行了改进和升级。如果按照原插件的原理，我每次都需要查询得到一个结果集，传递给ireport进行显示。既然ireport设计器可以直接连接JDBC数据源查询数据，我们何不把查询结果集的事情也交给ireport来做呢。

于是修改插件源代码，思路如下：

1、首先需要给ireport提供一个数据源(c3p0或者dbcp)，使其能够进行数据库操作【属性名：connection】。

2、再提供一个Map格式数据，向ireport传递参数【属性名：reportParameters】。

3、还有两个参数location和format，以及dataSource。

核心代码修改如下：

 

//定义两个变量，传递参数和数据源连接。
protected String reportParameters;
protected String connection;

ValueStack stack = invocation.getStack();
//先从stack获取数据源，如果为null，判断其是否为JRDataSource，若是转换成JRDataSource，否则，再采用ValueStackDataSource方式赋值给JRDataSource接口
Connection conn = (Connection) stack.findValue(connection);   //获取提供的数据源
if (conn == null){
Object obj  = stack.findValue(dataSource);
if(obj instanceof JRDataSource) {
	jrDataSource = (JRDataSource) obj;
}else {         
	jrDataSource = new ValueStackDataSource(stack, dataSource);
}
}
...
ServletContext servletContext = (ServletContext) invocation.getInvocationContext().get(ServletActionContext.SERVLET_CONTEXT);
String systemId = servletContext.getRealPath(finalLocation);
File directory = new File(systemId.substring(0, systemId.lastIndexOf(File.separator)));
Map parameters = new ValueStackShadowMap(stack);
parameters.put("reportDirectory", directory);
parameters.put(JRParameter.REPORT_LOCALE, invocation.getInvocationContext().getLocale());
//获取向ireport传递的参数
Map reportParams = (Map) stack.findValue(reportParameters);
if (reportParams != null) {
    parameters.putAll(reportParams);
}
.....
if (conn == null){
	jasperPrint = JasperFillManager.fillReport(jasperReport, parameters, jrDataSource);
}else{
	jasperPrint = JasperFillManager.fillReport(jasperReport, parameters, conn);
}

然后写一个公用的Action，代码如下：
/**
 * @author aokunsang
 * @date 2012-1-20
 */
@Component("jasperReportAction")
@Scope("prototype")
public class JasperReportAction extends ActionSupport {

	private List<?> list;           //相当于dataSource,集合属性，查询的结果集[如果想使用list,则connection一定为null，否则没用]
	private Connection connection;  //数据源连接
	@Resource(name="dataSource")
	private PooledDataSource dataSource;   //数据源
	private Map<String,?> para;     //传递的参数
	
	public String execute() throws Exception {
		this.connection = dataSource.getConnection();
		if(connection != null ){
		    this.list = null ;
		}
		return SUCCESS;
	}
      setter和getter....
}

 

struts.xml配置如下：

首先要把插件配置进去，你可以写个struts-plugin.xml，也可以直接写到struts.xml中(因为我使用的注解，struts.xml配置文件较少，直接写进去了)。

 <package name="aa" extends="struts-default">
	<!-- 设置JasperReport的type类型 -->
	<result-types>
		<result-type name="jasper" class="xxx.report.JasperReportsResult"/>
	</result-types>
	<!-- 报表输出Action -->
	<action name="JR_*_*" class="jasperReportAction">
	    <result name="success" type="jasper">
	        <param name="location">/reports/{1}.jasper</param>                
	        <param name="connection">connection</param>
		<param name="format">{2}</param>
		<param name="reportParameters">para</param>
		<!--<param name="dataSource">list</param>-->  <!-- 注意：connection和dataSource不能共存。两个共存时，优先级是connection高。  -->
	    </result>
	</action>
</package>

 Okay，到这里ireport和struts2的结合就完成了，其难点就在于插件中对数据源的修改，接下来说说jatoolsPrinter打印。

3、目前常用的web打印应该是applet了吧，不过它需要在IE上安装几十兆的jre，我是很不喜欢，我想你的客户应该也不喜欢这个东西吧。

既然说到打印，肯定说的就是套打，简单打印自不必多说，页面打印就ok。看看web套打的解决方案：

一、浏览器的打印功能菜单

这种方案的优势是不需要对浏览器作任何扩充，是最简单的办法，但问题也最多，如：

  1、不能精确分页。浏览器一般是根据用户设置的页面大小，web页面的内容多少，来自行决定分页位置，程序员很难控制。会有页脚页眉干扰。

  2、不能准确对齐边边距及打印文字。

  3、不能解决连续打印。比如，不是仅打印一张票据，而是连续一次打印若干个票据。

二、使用webbrowser控件+ javascript

这实际上，是浏览器打印功能菜单的一种程序调用，与打印功能菜单没什么两样。分页的问题仍然存在，只不过，可以让用户不用去点菜单，直接在网页中的一个按钮，或一个链接里面调用罢了。

三 、使用print css 

这是一种最理想的实现web套打的方法。这种方法通过在html文档中，嵌入打印相关的css样式，来实现对html文档输出打印的控制，比如设置纸张大小，纸张纵横方向，打印边距，分页等。显而易见，这种方式成本小，不需要下载任何插件，而且跨平台性非常好。print css推出已经有些时日，但遗憾的是，至今没有一个厂商的浏览器很好地实现了这些标准，这使得程序员目前还不能利用print css进行实际的开发。关于打印css，参见http://css-discuss.incutio.com/?page=PrintStylesheets

四 、使用pdf文件 

用这种方式，就是从服务器端下载一个pdf文件流，在IE中用adobe插件打开，然后用adobe的打印菜单进行打印，虽然这种方案，也能实现精确套打，但需要下载adobe插件。这是国外报表工具经常推荐的一种打印方法，但在pdf不那么普及的中国，这种方案不是最好选择。

五 、采用纯ActiveX 

这种方案就是下载一个控件，票据的数据不再以html方式呈现，而是呈现在ActiveX中。这种方案的优点是打印的精确度高，分页的可控性好，但缺点也是很明显的，嵌入ActiveX控件破坏了web应用的整体html风格，且这样的控件比较大（一般超过1M），下载颇费时间）。市场上的非java类报表产品，一般都采用这种方案。

六 、采用Applet方式 

采用Applet方式，分页或精确打印，都可以做到完美，但缺点也很明显，表现在：

   1、安装Applet成本巨大。需要下载十几M的文件。

   2、打印报表时，需要重新向服务器检索数据，效率低。因为Applet方案，一般采用html方式呈现数据，打印时Applet必须向服务器检索同一张票据的数据，看上去，是打印了当前页的票据，实际上，Applet根本不会用当前html页的数据来打印，而是向服务器下载数据到Applet中来打印。也就是说，打印的话，必须两次请求，一次html呈现，一次用来打印。

   3、不能解决连续打印。比如，不是仅打印一张票据，而是连续一次打印若干个票据。

   4、不能解决打印机设置问题，如存在多台打印机时，总是需要手工选择，打印到哪一台打印机。

   5、市场上java类的报表工具，一般推荐Applet方式来实现打印。

七 、轻量级的ActiveX打印方式---jatoolsPrinter 

这是杰创软件最新推出的一种最具创意的web套打解决方案。杰表作为一款纯java的报表工具，以前提供的web套打方案也是基于Applet的，Applet也做到了尽可能的小(只有24kb)，但用户还是抱怨，因为jre太大，安装需要耐心。另外，用Applet方式，很难实现客户端的批量打印功能。 

采用jatoolsPrinter，其优点是：

   1、安装方便，只有90k。

   2、可以通过web脚本来选择输出打印机，纸张大小，打印方向等，不必每次手工设定。

   3、支持附件打印问题。

4、说了那么多都是些废话，最重要的是怎么用它才是真的。ps：需要注意的是，jatoolsPrinter目前是收费的。但是本人找到个破解版的，附件中大家共享下，希望杰创软件别给封杀了，哈哈。

提供两个博客大家可以借鉴学习，很简单，我这里就不多数了，说一下自己使用时候遇到的小问题吧、

  1、http://www.blogjava.net/three-3/archive/2010/07/27/327184.html

  2、http://www.blogjava.net/three-3/archive/2010/06/24/324329.html

重点说一下：上面博客写的是挺好的，但是有点问题，预览时候调用方法为： jatoolsPrinter.printPreview(myDoc);   // 打印预览  只有一个参数

<a>、首先需要在打印页面(下面用index.jsp代替)的head中添加打印控件。<OBJECT ID="jatoolsPrinter" CLASSID="CLSID:B43D3361-D975-4BE2-87FE-057188254255" codebase="jatoolsP.cab#version=1,2,0,2"></OBJECT>

<b>、它需要一个jatoolsP.cab文件[我提供的这个是破解版的，呵呵]，需要放在打印页面同一目录中(当然，你看到有个属性codebase,可以设置其路径位置)。

<c>、在使用ireport的时候，你可能会使用iframe(比如Id和name都是：iframe_ireport)来显示你的报表数据，这时需要设置参数documents:window.frames['iframe_report'].document,具体参数设置如下（还有更多参数设置，我提供一个文档在附近，大家自己学习）:

var myDoc = {

    //settings:{

       //pageWidth: 2100,    //自定义纸张宽度（单位为十分之一毫米）

       //pageHeight: 1400,  //自定义纸张高度（单位为十分之一毫米）

       //orientation: 1     //打印方向 [1/2 = 纵向/横向]

   // },

documents:window.frames['iframe_report'].document,

enableScreenOnlyClass:true, // 使所有使用 screen-only 样式类的对象，只在预览、显示时可见，打印时隐藏

marginIgnored: true,

copyrights:'杰创软件拥有版权 www.jatools.com' 

};

如果你使用的是div来显示，那就直接用documents:document

<d>、在上面的参数设置中，你会发现有个copyrights，这个是版权所有说明，让我蛋疼的是必须得设置成他们公司，其他就会报错，恶心人的很。

<e>、还有一个重头戏就是ireport和jatoolsPrinter的分页打印问题，上面博客中以及说的很明白了，我就不多说了，我只把修改后打包的jar文件放出来，大家下载使用吧。

<f>、接下来就是打印的三种方式：

jatoolsPrinter.printPreview(myDoc);   // 打印预览

jatoolsPrinter.print(myDoc,true);   // 打印前弹出打印设置对话框

jatoolsPrinter.print(myDoc,false);       // 不弹出对话框打印

评论

2 楼 caoliang0914 2016-06-20  

[size=x-small]jatoolsPrinter还有破解文件不[/size]

1 楼 lupeng335 2012-05-03  

有没有例子的整个源码？共享出来研究一下，最近我也在做报表，很蛋疼，特别是打印这功能。。