前言:
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.... }
<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>