一、准备
下载iReport3.7.1、JasperReport3.7.1、Struts2.1.8及其他需要的包，需导入包如下图：
如需生成Excel的话，还需导入poi-3.5.jar包。
二、整合Struts2+JasperReport3
1. 新建以下三个pojo类：
package com.xy.report.pojo;
public class Address {
private String city;
private String zipcode;
public String getCity() {
return city;
}
public void setCity(String city) {
this .city = city;
}
public String getZipcode() {
return zipcode;
}
public void setZipcode(String zipcode) {
this .zipcode = zipcode;
}
}
?
package com.xy.report.pojo;
import java.util.HashSet;
import java.util.Set;
public class Company implements Comparable < Company > {
private String name;
private Address address;
private Set < Staff > staffs = new HashSet < Staff > ();
@Override
public int compareTo(Company o) {
return o.getName().compareTo( this .getName());
}
public String getName() {
return name;
}
public void setName(String name) {
this .name = name;
}
public Address getAddress() {
return address;
}
public void setAddress(Address address) {
this .address = address;
}
public Set < Staff > getStaffs() {
return staffs;
}
public void setStaffs(Set < Staff > staffs) {
this .staffs = staffs;
}
}
?
?Company中compareTo方法用于在报表中排序。
?
?以上Address是Company的组件，Company与Staff是一对多关系。package com.xy.report.pojo;
public class Staff {
private String name;
private Company company;
public String getName() {
return name;
}
public void setName(String name) {
this .name = name;
}
public Company getCompany() {
return company;
}
public void setCompany(Company company) {
this .company = company;
}
}
?
2. 新建Action
?
package com.xy.report.action;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import com.opensymphony.xwork2.ActionSupport;
import com.xy.report.pojo.Address;
import com.xy.report.pojo.Company;
import com.xy.report.pojo.Staff;
public class DemoAction extends ActionSupport{
private static final long serialVersionUID = - 5460323122712890562L ;
private List < Staff > list;
private Map < String,Object > map;
@Override
public String execute(){
list = getData();
map = getParameter();
return SUCCESS;
}
private List < Staff > getData(){
Address address = new Address();
address.setCity( " 上海 " );
address.setZipcode( " 201400 " );
Company company1 = new Company();
company1.setName( " 飞利浦 " );
company1.setAddress(address);
Company company2 = new Company();
company2.setName( " 谷歌 " );
company2.setAddress(address);
Staff staff1 = new Staff();
staff1.setName( " 张三 " );
staff1.setCompany(company1);
Staff staff2 = new Staff();
staff2.setName( " 李四 " );
staff2.setCompany(company2);
Staff staff3 = new Staff();
staff3.setName( " 王五 " );
staff3.setCompany(company1);
List < Staff > list = new ArrayList < Staff > ();
list.add(staff1);
list.add(staff2);
list.add(staff3);
return list;
}
private Map < String,Object > getParameter(){
Map < String,Object > map = new HashMap < String,Object > ();
map.put( " date " , " 2010-03-12 " );
return map;
}
// getter, setter
public List < Staff > getList() {
return list;
}
public void setList(List < Staff > list) {
this .list = list;
}
public Map < String, Object > getMap() {
return map;
}
public void setMap(Map < String, Object > map) {
this .map = map;
}
}
?
以上list为提供给报表的数据源，map为提供给报表的参数，如日期范围等。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 >
< include file ="struts-default.xml" ></ include >
<!-- 报表演示 -->
< package name ="default" namespace ="/reports" extends ="struts-default,jasperreports-default" >
< action name ="demoReport" class ="com.xy.report.action.DemoAction" >
< result name ="success" type ="jasper" >
< param name ="location" > /reports/demoReport.jasper </ param >
< param name ="dataSource" > list </ param >
< param name ="format" > PDF </ param >
< param name ="reportParameters" > map </ param >
</ result >
</ action >
</ package >
</ struts >
?
location - 提供利用iReport制作编译好的报表文件。
dataSource - 数据源
format - 报表输出格式
reportParameters - 报表参数
三、利用iReport开发报表
1. 新建数据源
打开iReport，点击下图像插头一样的Report Datasources，弹出对象框中New,选择"JavaBeans set datasource"后Next,输入Name为"demo"后Save，如下两图：
2. 增加类路径
点击“工具”“选项”，选择classpath标签页，点击Add Folder，将项目类路径加入，如下图路径为：C:/Users/linli/Documents/workspace/JSReportDemo /build/classes
3. 新建报表
点击 create a new report
"Open this Template"后，输入报表名这里是demoReport后下一步，继续完成。
4. 读取bean属性
点击Preview字样右边的按钮设置数据源，在弹出框中选择"JavaBean Datasource"标签页，在Class name中输入类名，点击"Read attributes"会列出类中所有属性。选中所需的属性，这里是company和name，点击对话框中间的"Add selected field(s)"增加到报表字段中。
报表将会按公司分组，所以需先按公司排序，当然这一步也可对struts2提供的数据源list进行处理，这里使用了报表的Sort功能，所以 Company类必须实现Comparable接口。点击"Sort options..."，增加排序字段。
5. 增加分组
加击左侧Report Inspector中的demoReport，选择"Add Report Group"，在弹出框中输入分组名，选择分组字段，如下图。下一步至完成。
6. 设计报表
将左侧Report Inspector中Fields下刚加入的字段托到报表设计器中，取公司名写成$F{company}.getName()，公司地址为$F{company}.getAddress().getCity()，员工姓名为$F{name}。公司名和公司地址放在Group Header里，员工姓名放在Detail 1里。
增加一个Parameters下的REPORT_PARAMETERS_MAP，他相当于一个map，取从struts2中设置的date值的方法为$P{REPORT_PARAMETERS_MAP}.get("date")。
组件面板中托"Page X of Y"显示页码。
这里有一些Title、Summary之类的，可能不需要，直接托到高度为0了想要就托不出来了。这时在左侧Report Inspector中选中想要的项目，在右侧"属性"中输入Bank height的值就行了。
设计完的报表如下图：
ps: 设计报表时，如果字段要显示中文，需修改该字段三个属性的值，如下图
7. 编译报表
点击工具栏上Preview右边榔头一样的东西，将报表编译成.jasper文件。
8. 运行报表
将编译好的demoReport.jasper文件复制到项目WebContent/reports目录下，启动容器，浏览器下查看报表如下：
项目结构如下：