10,606
社区成员
发帖
与我相关
我的任务
分享（分享）JasperReport下的打印问题
前言：
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
Encoding : 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,需要把它拿出来改一下
定义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。
核心代码修改如下：
struts.xml配置如下：
首先要把插件配置进去，你可以写个struts-plugin.xml，也可以直接写到struts.xml中(因为我使用的注解，struts.xml配置文件较少，直接写进去了)。
Ok，到这里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、安装方便，只有82k。
2、可以通过web脚本来选择输出打印机，纸张大小，打印方向等，不必每次手工设定。
3、支持附件打印问题。
4、说了那么多都是些废话，最重要的是怎么用它才是真的。ps：需要注意的是，jatoolsPrinter8.5是收费的，但是在今年他又推出一个无水印、无时间限制的免费版（当然功能相对来说简单点，但一般都够用了。）
预览时候调用方法为： 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); // 不弹出对话框打印
jasperReport-4.5.0
jatoolsPrinter(free1.0)
ireprot-all.zip
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
Encoding : 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....
}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>Ok，到这里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、安装方便，只有82k。
2、可以通过web脚本来选择输出打印机，纸张大小，打印方向等，不必每次手工设定。
3、支持附件打印问题。
4、说了那么多都是些废话，最重要的是怎么用它才是真的。ps：需要注意的是，jatoolsPrinter8.5是收费的，但是在今年他又推出一个无水印、无时间限制的免费版（当然功能相对来说简单点，但一般都够用了。）
预览时候调用方法为： 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); // 不弹出对话框打印
jasperReport-4.5.0
jatoolsPrinter(free1.0)
ireprot-all.zip
...全文
请发表友善的回复…
发表回复
人生人海茫茫 2014-05-28
- 打赏
- 举报
谢谢分享，忙了大忙了
