BlogJava-Tom-随笔-随笔分类-Appfuse

iReport & JasperReport配置及用户简明手册

Tom — Mon, 04 Dec 2006 10:28:00 GMT

iReport & JasperReport配置及用户简明手册- -

关于iReport和JasperReport的简明手册

By Gem 伍子轩

1安装

1.1 iReport的安装

iReport直接解压后，将J2SDK\lib目录下的tools.jar拷贝到iReport\lib目录下，然后在iReport目录下运行iReport.bat即可。
需要注意的是tools.jar的版本必须要与本机安装的jre一致，也就是说，如果系统安装的是jre1.4.2就必须用jdk1.4.2的tools.jar。

1.2 JapserReport开发（运行）环境的搭建

JasperReport的开发环境必须要导入以下所有包：

1． JasperReport包，如jasperreports-0.6.1.jar；

2． Aparche Common包，包括logging、digester、beanutils、collections、logging-api；

3． iText包，包括itext-1.1.jar和iTextAsian.jar（用于输出中文字符到PDF文件）

以上所有包（除了iTextAsian.jar）都已经包含在iReport\lib目录下。

2 开发流程

用iReport可视化编辑生成的文件是jrxml文档，这是一种xml文件，记录了一份report的详细信息，我们可以直接用写字板打开它编辑，iReport就是一个方便我们生成和编辑jrxml文件的工具，它也可以很方便地将jrxml文件编译成jasper报表文件。

jrxml文件通过Jasper编译之后就变成了jasper文件，这份文件才是真正在程序中调用生成报表的report文件。

但是有一点要注意的是，jasper的各个版本编译出来的jasper文件并不兼容，就是说用0.6.1版编译出来的文件用0.6.4版调用是会出错的，而iReport自带的Jasper版本是0.6.1，而jasper的最新版本是0.6.4。所以为了保持通用性，我建议只用iReport来开发编辑jrxml文件，而不编译成jasper文件，在我们的打印报表程序中再即时编译一次。虽然这样效率可能会低了一点，但是保证了不同版本的兼容性。

在我们的程序中，要调用Jasper的话，首先要得到一个数据库的Connection，形如：Connection con = ...

需要往JasperReport传参数的话只需要新建一个Map，以参数名作为key，需要传入的对象作为value，譬如：

Map props = new HashMap();

props.put("name", new String("name"));

需要多个参数只需分别put进Map里去就可以了。

JasperReport有如下几个主要的Manager：

JasperCompileManager	将jrxml文件编译成jasper文件或JasperReport对象
JasperFillManager	从数据源中获取数据并填充jasper文件或JasperReport对象，产生JasperPrint对象
JasperPrintManager	将JasperPrint对象直接输出到打印机打印
JasperExportManager	将JasperPrint对象导出成PDF或HTML文件（或流）
JasperRunManager	运行一个jasper文件或JasperReport对象并输出到PDF或Html文件（或流）中，我的理解是等于集成了JasperFillManager和JasperExportManager的功能

对于上述对象的详细说明请参阅JasperReport的文档。

例程：

public static void main(String[] args) {

try {

Class.forName("org.gjt.mm.mysql.Driver");

Connection con = DriverManager.getConnection(

"jdbc:mysql://wes:3306/umpdb?useUnicode=true&characterEncoding=GBK", "root", "elite");

File f1 = new File("Account.jrxml");

File f2 = new File("Contact.jrxml");

JasperReport main = JasperCompileManager.compileReport(f1

.getAbsolutePath());

JasperReport report = JasperCompileManager.compileReport(f2

.getAbsolutePath());

Map props = new HashMap();

props.put("subreport", report);

JasperPrint print = JasperFillManager.fillReport(main, props,con);

//JasperPrintManager.printReport(print,true);

JasperExportManager.exportReportToPdfFile(print, "a.pdf");

//JasperRunManager.runReportToPdfFile("Account.jasper", "a.pdf", props, con);

} catch (ClassNotFoundException e) {

// TODO 自动生成 catch 块

e.printStackTrace();

} catch (SQLException e) {

// TODO 自动生成 catch 块

e.printStackTrace();

} catch (JRException e) {

// TODO 自动生成 catch 块

e.printStackTrace();

}

3 注意事项

1．iReport中新建中文报表的时候记得要输入XML编码GB2312。

2．iReport中定义中文字体的时候，要选择PDF Font Name为STSong-Light（宋体）、MHei-Medium（黑体）、MSung-Light，在PDF Encoding中选择GB-UCS2-H(Chinese Simplified)，否则输出到PDF时会乱码。

3．用Report SQL查询之后，可能会出现某些字段没有自动建立Field，就需要在Field中手动定义了。

Tom 2006-12-04 18:28 发表评论

appfuse 乱码问题

Tom — Fri, 17 Nov 2006 21:33:00 GMT

    捣鼓了一个晚上,又是ant new又是ant setup,好不容易搭建起来了appfuse, 乐呵呵的打开appfuse deploy到tomcat的测试项目,突然发现有些乱码,又是修改tomcat的URLEncording="UTF8",又是把ApplicationResources_zh_cn.properties 拷贝来拷贝去,google,baidu齐上阵,searching了下,看来这个问题还是非常普遍,但是中文乱码的原因有很多种,特罗列如下,看了appfuse对中文的支持有点问题.

     1.build.xml里面display资源没有国际化处理，也就是没有进行编码,在build.xml进行修改使之进行国际化.
     修改方案:
                    includes="ApplicationResources_zh*.properties" encoding="UTF-8"/>

     改为:
                    includes="*_zh*.properties" encoding="UTF-8"/>

    2.Tomcat 的URLEnCording要设置为UTF8,应为appfuse是以utf-8打包的

    3.就是要对原始ApplicationResources_zh_cn.properties进行ascii编码转换然后丢到classes里面,不要用他ant自动转换过的.奇怪的是appfuse的ant的时候是对文件进行转换了,但是还是有部分中文存在乱码,奇怪ing......不知道是appfuse的疏忽还是什么.继续研究中...我是appfuse-1.9-src的包.但是我手工转了下ant之前的源码,发现乱码问题消失.就这个原因搞了我一个晚上....郁闷
    修改方案:
    native2ascii -encoding UTF-8   ApplicationResources_zh_CN.properties te (te为转后文件名)
    native2ascii te ApplicationResources_zh_CN.properties1 -reverse(转回来呵呵)

补充一点,在appfuse的appfuse-1.9-src这个包里的 ApplicationResource...直接打开是中文是乱码,可以采用上面的两条命令把它还原出来.便于我们的开发然后修改ant任务即可.而对于appfuse-jsf-1.9-src来说,它的applicationResource...打开后就是我们可以看懂的中文:).

总之,new之后的项目的ApplicationResources...要用原来的文件替换掉.

Tom 2006-11-18 05:33 发表评论

AppFuse 环境的构建

Tom — Fri, 17 Nov 2006 17:30:00 GMT

AppFuse项目的主要目的是帮助你加速web应用程序的开发。下面说明如何利用它创建一个新工程的基本步骤。

安装 J2SE 1.4.2+ 并设置环境变量JAVA_HOME指向J2SE所在的目录。
下载源程序报或者从CVS(cvs -d :pserver:guest@cvs.dev.java.net:/cvs co appfuse)中检出appfuse模块。
注意: 你可以使用the all-in-one installer一次性下载安装AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 和 MySQL 4.1.11 (for Windows)。查看相关的 README.txt 文件可以了解更多信息。
安装 Install Ant 1.6.2+ 并设置 ANT_HOME 环境变量。安装 Tomcat 4.1.x+ (推荐使用Tomcat 5.0.28) 并设置 CATALINA_HOME 环境变量指向对应的Tomcat安装目录。参阅我的文章设置开发环境可以了解在哪里下载到这些程序并且可以了解我通常如何安装配置这些程序。
安装 MySQL 3.23.x+ (推荐使用 4.1.7).
注意: 如果你使用 MySQL 4.1.7, 确定正确设置了 UTF-8 字符集和 InnoDB 表类型。这里说明如何设置。
设置本机的 SMTP server 或者修改 mail.properties 文件(在 web/WEB-INF/classes 目录下) 和 build.properties 文件(在根目录下 -- 给 log4j 消息使用) 以使用一个已有的smtp server - 默认值是 localhost。
把文件 lib/junit3.8.1/junit.jar 拷贝到 $ANT_HOME/lib目录下。
注意: 你可能会发现在 $ANT_HOME/lib目录已经有一个 ant-junit.jar 文件了. 这个 jar 包不是 JUnit 类库, 而是 Ant 的 junit task 实现，在执行Ant junit task时会使用你新增的这个junit.jar 文件。
如果你计划使用 iBATIS (代替 Hibernate) 或者 struts 以外的 web framework, 现在安装它们 (安装指令下面可以查到)。安装完成以后, 在appfuse目录下运行 ant new 。会提示你输入application name, database name 和 package name。完成这些操作以后会在appfuse同级目录家里一个包含新程序所需要的全部文件的以你输入的application name命名的目录。
警告: 请不要在输入的application name, database name 和 package name使用 "test", 包含 "appfuse" 的名称或者以数字作为起始字符的名称，否则将会导致任务无法正常执行，此外使用两个破折号 (-) 会造成结果混乱。
切换到这个新的工程目录并且运行 ant setup (或者运行 ant setup-db setup-tomcat deploy) 创建数据库，配置tomcat并发布你的新应用程序。创建数据库的任务只有在你的root用户密码为空的情况下才能工作。需要的话你可以修改 build.properties 文件. 安装设置帮助 ?
若你细想要进行测试以确定所有程序工作良好，运行 ant test-all - 在运行这个任务的时候确定 Tomcat 没有启动。接下来, 运行 ant test-reports - 运行结束后会显示消息告诉你如何查看产生的报告。

在你确认你正确的完成了上述步骤以后 - 浏览一下指南了解如何使用appfuse开发程序。

安装的可选项

如果你希望使用 iBATIS 作为持久化framework, 查看extras/ibatis目录下的 README.txt 文件或者运行 ant install-ibatis。
如果你希望使用 Spring 作为web framework, 查看 extras/spring 目录下的 README.txt 文件或者运行 ant install-springmvc。
如果你希望使用 WebWork 作为web framework, 查看extras/webwork 目录下的 README.txt 文件或者运行 ant install-webwork。
如果你希望使用 JSF 作为web framework, 查看 extras/jsf 目录下的 README.txt 文件或者运行 ant install-jsf。
如果你希望使用 Tapestry 作为web framework, 查看 extras/tapestry 目录下的 README.txt 文件或者运行 ant install-tapestry。

如果你想写脚本自动基于Appfuse创建并测试自己的工程。在CVS上面有两个我已经写好的用来测试的脚本供参考: spring+ibatis 和 webwork. 注意在实际开发过程中最好不要使用 "appfuse" 作为工程名因为可能会造成不必要的查找/替换。
如果你不希望安装 iBATIS, Spring MVC, WebWork, JSF 和 Tapestry - 你应该在使用版本控制工具把它们检入前删除extras下的相关目录。

注意: 安装程序会修改 Eclipse classpath，但是不会是理想的方法。你需要人工修改它。

Tom 2006-11-18 01:30 发表评论