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；否则不显示。

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....
}

 <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>