整合Struts2+JasperReport Web报表应用示例

整合Struts2+JasperReport Web报表应用示例

JasperReports作为一种优秀且开源的报表引擎,不利用太可惜了。同时,借助开源的JasperReports模板设计利器iReports,可以可视化的设计报表模板。基于Web的报表在很多项目中都是需要的。而随着Struts2的流行,就应该研究一下在Struts2下如何利用JasperReports进行报表输出。本示例比较简单,采用的数据源即为JavaBean,而没有采用复杂的数据库,其实原理是一样的。只是传递给JasperReports的参数随着连接方式的变化而略加修改而已。

准备工作

所使用的类库及Jar包如下图所示:

整合Struts2+JasperReport Web报表应用示例
1.使用的Jar

开发环境:MyEclipse6.0+Eclipse3.3+JDK6.0+Tomcat6.0+Struts 2.0.11。当然,本该所提供的源代码下载中没有提供相关的lib,因为文件大太,如果需要,请留下email。.
    另外下载Jasperreport以及可视化模板iReport的网子http://jasperforge.org/

设计报表模板

本例中采用JavaBean作为数据源,用于显示People对象的一些基本属性,如所在序号、城市、姓名、地址,并对同一城市的人员进行汇总小结显示。

至于如何在iReports中设计模板文件,请在网上参考其它文档。这里不再详细解读,或有时间俺再另写文章来具体讲解如何在iReports中设计报表模板。WebRoot"jasper"jasper_template.jrxml代码如下:

 

这里需要说明的是,由于俺们中国的中文比较特殊,由此在PDF中显示的时候,需要一些额外的Jar包字体来支持。因此需要下载iTextAsian.jar包,此包专门用于显示亚洲的字符。只不过iReport3.0.0以后就已经含了些包

设计JavaBean

由本例中没有使用数据库,而是使用JavaBean作为JRDataSource,来传递给JasperReports作为数据源,因此只需要设计JavaBean"src"com"sterning"PeopleBean.java的代码很简单,只在字个字段:cityidnamestreet,代码如下所示:

package  com.sterning;

public  class  PeopleBean
{
    
private String city = null;
    
private Integer id = null;
    
private String name = null;
    
private String street = null;

    
public PeopleBean(
        String pcity,
        Integer pid,
        String pname,
        String pstreet
        )
    
{
        city 
= pcity;
        id 
= pid;
        name 
= pname;
        street 
= pstreet;
    }


    
public PeopleBean getMe()
    
{
        
return this;
    }


    
public String getCity()
    
{
        
return city;
    }


    
public Integer getId()
    
{
        
return id;
    }


    
public String getName()
    
{
        
return name;
    }


    
public String getStreet()
    
{
        
return street;
    }

}


 

编译模板

其实表面上说是填充数据,其实就是填充一个List。具体的工具都是交给我们的JasperReports去完成。JasperReports要完成数据的填充工作,要经历将编译(将模板文件.jrxml编译成.jasper文件)、加载(加载.jasper文件)、填充(从数据源中取得数据并填充到.jasper二进制文件中)三大步骤。src"com"sterning"JasperAction.java,其代码如下所示:

package  com.sterning;

import  java.io.File;
import  java.util.ArrayList;
import  java.util.List;

import  net.sf.jasperreports.engine.JasperCompileManager;

import  org.apache.struts2.ServletActionContext;

import  com.opensymphony.xwork2.ActionSupport;

public  class  JasperAction  extends  ActionSupport  {
    
private static final long serialVersionUID = 1L;

    
private List<PeopleBean> myList;

    
public String execute() throws Exception {
        
//添加数据
        PeopleBean p1=new PeopleBean("长沙"new Integer(9), "李化""天洒路");
        PeopleBean p2
=new PeopleBean("长沙"new Integer(22), "王小样""呆小路564");
        PeopleBean p3
=new PeopleBean("南昌"new Integer(23), "王奸可""小顺路");
        PeopleBean p4
=new PeopleBean("南昌"new Integer(32), "李洒""顺濉路");
        PeopleBean p5
=new PeopleBean("武汉"new Integer(39), "张中尖""天洒路");
        PeopleBean p6
=new PeopleBean("武汉"new Integer(35), "陈主宁""天河路564");
        myList 
= new ArrayList<PeopleBean>();
        myList.add(p1);
        myList.add(p2);
        myList.add(p3);
        myList.add(p4);
        myList.add(p5);
        myList.add(p6);

        
try {
            String reportSource;
            reportSource 
= ServletActionContext.getServletContext()
                    .getRealPath(
"/jasper/jasper_template.jrxml");
            File parent 
= new File(reportSource).getParentFile();
            
//将.jrxml模板文件编译成为.jasper文件,当然,其文件名可以指定,如果没指定,则与.jrxml文件名一样.只是后缀不同而已
            JasperCompileManager.compileReportToFile(reportSource, new File(
                    parent, 
"compiled_jasper_template.jasper")
                    .getAbsolutePath());
        }
 catch (Exception e) {
            e.printStackTrace();
            
return ERROR;
        }

        
return SUCCESS;
    }


    
public List getMyList() {
        
return myList;
    }

}


 

配置Struts2文件

前面这些工作都是为JasperReports而作的。接下来就是将JasperReports集成到Struts2中。

1. Web.xml

首先是Web.xml。这个文件配置比较简单,也比较常规,没什么好说,代码如下WebRoot"WEB-INF"web.xml

<? xml version="1.0" encoding="UTF-8" ?>
< web-app  version ="2.4"  xmlns ="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi
="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation
="http://java.sun.com/xml/ns/j2ee 
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
>
    
< filter >
        
< filter-name > struts2 </ filter-name >
        
< filter-class >
            org.apache.struts2.dispatcher.FilterDispatcher
        
</ filter-class >
        
< init-param >
            
< param-name > config </ param-name >
            
< param-value >
                struts-default.xml,struts-plugin.xml,struts.xml
            
</ param-value >
        
</ init-param >
    
</ filter >
    
< filter-mapping >
        
< filter-name > struts2 </ filter-name >
        
< url-pattern > /* </ url-pattern >
    
</ filter-mapping >

    
<!--  The Welcome File List  -->
    
< welcome-file-list >
        
< welcome-file > index.jsp </ welcome-file >
    
</ welcome-file-list >
</ web-app >


 

2. struts.xml

按理说struts.xml配置文件应该更加简单,但这里由于集成了JasperReports,所以看上去要复杂一点。先来看代码:src" struts.xml

<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >
    
< package  name ="default"
        extends
="struts-default,jasperreports-default" >
        
< action  name ="PDF"  class ="com.sterning.JasperAction" >
            
< result  name ="success"  type ="jasper" >
                
< param  name ="location" >
                    /jasper/compiled_jasper_template.jasper
                
</ param >
                
< param  name ="dataSource" > myList </ param >
                
< param  name ="format" > PDF </ param >
            
</ result >
        
</ action >
        
< action  name ="HTML"  class ="com.sterning.JasperAction" >
            
< result  name ="success"  type ="jasper" >
                
< param  name ="location" >
                    /jasper/compiled_jasper_template.jasper
                
</ param >
                
< param  name ="dataSource" > myList </ param >
                
< param  name ="format" > HTML </ param >
            
</ result >
        
</ action >
        
< action  name ="XML"  class ="com.sterning.JasperAction" >
            
< result  name ="success"  type ="jasper" >
                
< param  name ="location" >
                    /jasper/compiled_jasper_template.jasper
                
</ param >
                
< param  name ="dataSource" > myList </ param >
                
< param  name ="format" > XML </ param >
            
</ result >
        
</ action >
        
< action  name ="CSV"  class ="com.sterning.JasperAction" >
            
< result  name ="success"  type ="jasper" >
                
< param  name ="location" >
                    /jasper/compiled_jasper_template.jasper
                
</ param >
                
< param  name ="dataSource" > myList </ param >
                
< param  name ="format" > CSV </ param >
            
</ result >
        
</ action >
        
< action  name ="XLS"  class ="com.sterning.JasperAction" >
            
< result  name ="success"  type ="jasper" >
                
< param  name ="location" >
                    /jasper/compiled_jasper_template.jasper
                
</ param >
                
< param  name ="dataSource" > myList </ param >
                
< param  name ="format" > XLS </ param >
            
</ result >
        
</ action >
    
</ package >
</ struts >

 

这里,当调用JasperActionexecute()方法成功后,返回后,可见有三个参数:location告诉JasperReports数据填充类二进制的.jasper文件的位置,dataSource指明使用什么数据源,format指明报表输出的格式。


 

页面文件

Index.jsp的代码非常的简单,如下:

<% @ page language="java" pageEncoding="GB2312" %>
<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" >
< html >
    
< head >
        
< title > Struts2+ JasperReports 使用示例 </ title >
    
</ head >
    
< body >
        
< href ="HTML.action" > HTML </ a >
        
<</spa
分享到:
评论
3 楼 504453471 2013-08-30  
你好!!!我想看看这个程序,和jar包,我的邮箱是[email protected],,,谢谢!!!
2 楼 yuchensuifeng 2012-04-27  
很简单的例子,先看看,谢谢分享!
1 楼 Listen_ing 2010-11-29  
看看,代码比较简洁,比较好,试试先

你可能感兴趣的:(apache,xml,Web,jsp,struts)