1. 复合JavaBean数据源
1.1 说明
在使用Eclipse BIRT进行报表开发时，会遇到使用复合型的JavaBean作为数据源的情况，例如Contact对象有一个Address类型的对应address，而Address对象又具有两个属性，分别为addressId和addressName，在此种情况下应该使用Eclipse BIRT提供的“Script Data Source”进行数据源。如下将通过实例展现在Eclipse BIRT中如何使用复合JavaBean作为数据源。
所用环境说明：
l IDE环境：birt-report-designer-all-in-one-2_2_1_1；、
l Tomcat：5.5.27；
l Eclipse BIRT版本：2.2.1
l birt-runtime-2_2_1_1。
1.2 开发实例
1.2.1 在Java工程中创建复合JavaBean类Contact.java
在集成了BIRT的Eclipse中建立Java工程：birtJavaProject，并建立amigo.report包，并在该包下建立复合JavaBean的类：Contact.java，该类的代码如下所示：
{{
1.2.2 在Java工程创建复合JavaBean的关联JavaBean类Address.java
接下来在amigo.report包下建立Contact类关联的JavaBean类，代码如下所示：
{{
1.2.3 在Java工程中创建数据工厂类ContactListFactory.java
在Java工程中还需要创建制造数据的工程类：ContactListFactory.java，该类的代码如下所示：
{{
截至此步，Java源码已经编写完毕，余下的工作是做报表编程。
1.2.4 创建报表工程
在开发环境中选择“New”-> “Project”，如下所示：
在弹出对话框选择“Bussiness Intelligence… ” -> “Report Project ”，如下图所示：
而后点击“Next >”,在弹出对话框中输入报表工程的名称“birtreport”后，点击“Finish”按钮完成报表工程的创建。
1.2.5 创建报表
选择报表工程“birtreport”后点击右键，选择“New” –> “Report”，如下图所示：
在弹出窗口中输入报表的名称：helloBirt.rptdesign，点击“Finish”按钮完成报表的创建。
1.2.6 创建Scripted数据源
使用JavaBean作为数据源，需要创建Script数据源。首先打开“Data Explorer”视图，（若该视图被关闭，请使用“Show View”打开）。在“Data Explorer”中选择“Data Sources”->“New Data Source”，如下图所示：
创建数据源的弹出窗口如下图所示：
在上述窗口中选择“Scripted Data Source”，在“Data Source Name”中输入数据源的名字，例如“Data Source”，点击“Finish”按钮完成数据源的创建。
1.2.7 创建数据集
在“Data Explorer”视图中点击“Data Sets”->“New Data Set”，弹出窗口如下所示：
在“Data Set Name”中输入数据集的名称，例如“Data Set”，在“Data Source”中选择刚才创建的Scripted数据源，而后点击“Next >”按钮，输入列名和显示名称等信息，窗口如下所示：
1.2.8 编写数据访问脚本
打开“helloBirt.rptdesign”，切换到“Script”，在“Data Explorer”视图中选择刚才创建的数据集，open对应的脚本如下所示：
count = 0;
cf = new Packages.amigo.report.ContactListFactory();
c = cf.createContactList();
对应图形如下所示：
在“Script”的下拉框中选择“fetch”，对应的脚本如下所示：
if (count <= c.length - 1){
row["firstName"] = c[count].getFirstName();
row["lastName"] = c[count].getLastName();
row["phoneNum"] = c[count].getPhoneNum();
row["addressId"] = c[count].getAddress().getAddressId();
row["addressName"] = c[count].getAddress().getAddressName();
count ++;
return true;
}
1.2.9 设计报表视图
视图中选择layout，简单的将我们建立的data set 拖到报表视图中即可，完成这步以后可以在preview中查看预览效果了。
1.2.10 部署与浏览
将birt-runtime-2_2_1_1目录下的WebViewerExample工程拷贝到Tomcat的webapps下面，并将helloBirt.rptdesign报表文件拷贝到Tomcat根目录/webapps/WebViewerExample工程下。
接着在：Tomcat根目录/webapps/WebViewerExample/WEB-INF目录下建立classes子目录，存放Java工程中的三个类文件对应的class文件，将birtJavaProject/bin下的amigo目录整个拷贝到Tomcat根目录/webapps/WebViewerExample/WEB-INF/classes目录，完成报表文件的部署。
访问地址为:
http://localhost:8080/WebViewerExample/frameset?__report=helloBirt.rptdesign
在浏览器的运行效果图如下所示：
2. 对JavaBean数据源的数据进行分组
2.1 说明
在复合JavaBean作为数据源的实例中，展示了如何进行复合JavaBean数据的展示，但是在某些情况下，需要对JavaBean进行分组显示，本实例将展示如何对JavaBean数据源进行分组显示。
2.2 开发实例
2.2.1 创建报表
在报表工程中创建报表groupByReport.rptdesign，创建方式与上例一样。
2.2.2 创建数据源和数据集
因为该实例的数据源和数据集与上例相同，只需要在“Data Explorer”视图中将数据源和数据集拷贝到本实例即可，编写的数据访问脚本和设计的报表也与上例一样。
2.2.3 对数据进行分组
接下来将向读者展示如何按照addressId对数据进行分组，首先在“Layout”中选择table后，点击右键，选择“Insert Group”-> “Above”，如下所示：
弹出的新建分组的窗口如下所示，在窗口中输入分组的名称，例如：addressIdGroup，在“Group on”中选择“addressId”，在“Interval”中选择“Interval”，在“Range”中输入1，如下图所示：
在上图中点击“OK”按钮完成分组的创建。
2.2.4 部署与浏览
部署的方法与上例相似，访问地址为：
http://localhost:8080/WebViewerExample/frameset?__report=groupByReport.rptdesign
运行效果如下图所示：
3. 将BIRT集成到现有Web项目中
3.1 说明
在上面的实例中，将报表和相关的类文件放在BIRT对应的Web项目WebViewerExample中来进行报表的查看和浏览，但是在实际的开发过程中，已经有Web项目，将报表的部分部署到WebViewerExample项目，而其它的部分部署到另一个Web项目，显然不太合适，本实例讲解如何将BIRT集成到现有的Web项目中，并进行报表的查看。
参考文章：http://blog.csdn.net/bjd14/archive/2006/12/25/1458947.aspx
3.2 集成实例
3.2.1 新建项目的Web工程
在MyEclipse新建一个Web Project，名为reportintegration，将上例中的amigo.report包以及其下的所有三个类（Contact.java、Address.java和ContactListFactory.java）拷贝到src目录下。并将helloBirt.rptdesign和groupByReport.rptdesign两个报表文件拷贝到WebRoot目录下。
3.2.2 拷贝BIRT的Web项目WebViewerExample的文件
打开Tomcat下的WebViewerExample项目，其目录结构如下图所示：
将该目录下的两个子目录report和webcontent拷贝到工程的WebRoot目录下。
接下来进入WebViewerExample"WEB-INF目录，目录结构如下所示：
将lib、platform和tlds三个子目录拷贝到Web工程的WebRoot"WEB-INF目录，并拷贝server-config.wsdd、viewer.properties和web.xml三个文件。到此所有文件都拷贝完毕。Web工程的结构如下图所示：
lib目录的结构如下图所示：
3.2.3 部署与浏览
部署reportintegration到Tomcat下，启动成功后，访问路径类似如下所示：
http://localhost:8080/reportintegration/frameset?__report=groupByReport.rptdesign
运行效果与上例一样，不再赘述。
3.2.4 访问参数说明
在访问时，路径实例如下所示：
http://localhost:8080/reportintegration/frameset?__report=groupByReport.rptdesign
其中”__report”表示访问的报表文件的路径，若将groupByReport.rptdesign报表文件拷贝到WebRoot/report目录下，则访问路径变成：
http://localhost:8080/reportintegration/frameset?__report=report/groupByReport.rptdesign
其它访问参数的说明如下所示：
| 选项 |
说明 |
| __format |
报表输出格式：html或pdf，缺省是html。对于frameset不起作用。 |
| __isnull |
指明一个参数是null，常用于字符串类型。如果提供参数且值为空： - 对于日期和数字类型，BIRT会将它们当作null处理。 - 对于字符串，BIRT会将它作为空字符串。因此，为了说明某个字符串是null，通常写为：__isnull=参数。 |
| __locale |
本地化选项，缺省是jvm的locale。 |
| __report |
报表设计文件路径。 |
| 报表参数 |
报表参数参数值对，形式：参数名=参数值。对于frameset，直接在地址栏中输入参数名=参数值后回车，不会影响报表结果。虽然，此时选择"运行报表"时，弹出的参数值已经改变。 |