搭建源代码文件和运行示例
最好的开始JasperReports工作的方式为从以下位置下载整个工程的包:
这个JasperReports-x.x.x.zip文件包含了所有源代码文件,必须的libraries,免费提供的文档,以及一个完整的示例程序和报表。
下载压缩包并解压到本地机器上,你将看到JasperReports的action,而无需创建一个java应用程序嵌入到JasperReports中
ANT构建工具
在使用JasperReports的发行包和示例之前,请安装ANT工具在你的电脑上。
JasperReports深度依赖Apache基金会的ANT工具来编译源代码文件,构建发型包,生成jcvacdoc文档和运行示例程序,ANT工具将JasperReports工作更容易,请参考ANT文档安装说明。
从源文件构建项目
一旦你安装了ANT,你可以编译源文件,生成javadoc API文档,或者构建发布JAR files,完成之后,执行工程根目录下的ant声明文件build.xml。
要看到每一个可用任务的详细信息,在根目录下使用ant -p 在命令提示符窗口中。
运行示例
JasperReports发布包附带了一套完整的样品,应用程序和报告,说明每个功能可以使用的library。
示例程序在工程目录的/demo/samples中。
HSQLDB演示数据库
在运行这些示例之前,需要在/demo/hsqldb目录下启用命令窗口运行ant runserver 命令去启动HSQLDB数据库。
如果要管理应用程序,在相同的目录下运行ant runManager命令。
要测试一个/demo/samples目录下的特定的示例,进入相应的子文件夹在命令行中运行ant -p命令。
这将显示一个简短的描述什么样的示例,以及一个完整队示例程序的的ant可执行任务的列表。
以下列表为运行一个示例程序的典型步骤:
1.通过ant javadoc编译jasperReport源文件
2.使用ant的示例程序编译JRXML模板
3.使用ant fill命令对模板中填入数据
4.使用ant view命令显示视图
要导出其他格式,只需要使用命令如ant pdf或者ant html
这些示例程序被用来指引和说明这些library的作用。
因此确保你可以运行这些示例程序在阅读其他的本指南之前。