ireport 5.1.0 教程之ireport快速入门文档

ireport5.1.0教程之ireport快速入门文档必要条件：

iReport需要Sun Java2SDK1.4以上版本;为了能编译jasper文件就必须安装完整的java2（JDK），不光是(JRE)这个运行环境。如果你还想编译iReport 源代码，你还要安装Jakarta Ant version1.6以上版本。

硬件方面，类似于java的环境，iReport也占很多的RAM，所以它也需要只少256Mb的内存和至少20Mb的磁盘空间。

下载：

你可以到SourceForge网站上的企业主页上下载最新发布的iReport，可能有几种不同的分类：

iReport-x.x.x.zip这是官方的zip格式的二进制文件。

iReport-x.x.x.tgz这是官方的tar gz格式的二进制文件。

iReport-x-x-x-src.zip这是官方的包含源代码的zip格式的二进制文件。

x.x.x表明了iReport的版本号。每一种都包含必须使用的第三方的库和程序及附加文件，例如模板和一些html格式的基础教程。

如果你想要更多最新版本的源程序，你可以直接地连接CVS库。但必须要有一个CVS客户端（像CVS，JCVS或者WinCVS）。

如果你有CVS那就执行如下的命令行：

cvs-d:pserver:anonymous@:/cvsroot/ireport

login（目前好象无法连接）

and then all on the same line…

cvs-z3

-d:pserver:anonymous@:/cvsroot/ireport

co iReport2

这样CVS客户端就可以将iReport的所有文件下载到本地，包括所有的文档，库和所有有用的编译iReport的文件。

就使用其他CVS的用户来说，SourceForge网站也自制了详细的解释用来检出工程。

编译iReport：

这些源中包含一个build.xml文件，它是被Jakarta Ant用来编译和启动iReport和或用来创建不同类型的工程。

下载iReport-x.x.x-src.zip,解压缩到你指定的目录，例如：

c:\devel(or/usr/devel on unix system)。打开命令提示符或shell，进入你解压的目录和iReport目录：C:\devel\iReport-0.3.2>ant iReport

如果这个源完整的存在与目录中，它将被编译进类中iReport就能直接启动。

基本的配置：

如果选择下载了iReport二进制版本的，那就直接将该压缩文件解压缩到指定目录，例如：c:\devel(or/usr/devel on a unix system).打开命令提示符或shell，进入被解压缩的目录，输入iReport目录：

C:\devel\iReport-0.3.2>iReport.bat

or on unix:

$./iReport.sh

(in this case,it should be preceded by a“chmod+x”if the file is not executable.)

第一步执行完毕时iReport将创建一个名叫”.ireport”的文件在用户的主目录。这里的主目录指由自己设置和配置的目录。如果文件夹不能被创建，这就有可能是解压缩造成的影响而不能够配置成功，这时，你就要自己手动的创建一个目录。

进行下一步之前你需要将tools.jar文件拷贝到JDK的lib目录下以及iReport 的lib目录下。如果没有这个文件的话在编译report时将会产生一些异常（carried out by using classes contained in this java library).在MacOS X系统中tools.jar文件就不需要拉，因为具有编译ireport所必须的类的classes.jar文件代替它。

iReport的初始化配置包括：设置所要查看运行后的文档的格式；选择语言；设置编译后的文件目录。其他的配置说明将在以下进行。为了继续的进行配置必须打开ireport，然后选择菜单选项中工具选项（menu Options→Tools.）。此时将出现2.1选项窗口。

2.1图

选择你最熟悉的语言接下来点“Compiler”选项卡。

2．2图

这个选项卡是用来设置编译后的文件存储目录，默认的目录会在iReport的根目录。一般情况下是要指定一个有效的目录来保存编译文件。这个目录也可以是加

载报表源时的目录，既然这样就选择“Use the reports directory for compiles”复选框。

2．3图

完成以上列出的配置后，接下来我们还要设置报表输出格式和查看XML源所用编辑器。重启iReport继续设置上图的选项。

创建一个空白报表测试一下我们的设置(menu File→New Document),领悟一下iReport所提供的功能。之后点工具条上的运行按扭。如果你操作的正确，将会有一个保存jrxml文件的提示，相应的一个jrxml文件将被创建，之后会发布出一个预先设置的空白页。这就意味着你刚才的配置ok拉。

创建JDBC连接：

一个有代表性的关系数据库可以提供最普通的数据源给一个报表。首先，我们来看看如何设置一个JDBC连接，点菜单D atasource

Connections/Datasources并点窗口的连接列表的new按扭。此时打开一个新

建连接（图2.4）窗口。在这个面板上填写连接名：(i.e.“My new connection”)并选择正确的JDBC驱动。iReport支持大部分的JDBC驱动URL格式。因此你能够自动创建一个URL通过在相应的输入框中填写服务器地址和数据库名。若要完成连接你就必须输入数据库名和密码用来连接数据库。如果你想保存密码，那就将“Save password”打对勾。

注意：iReport将密码保存在一个txt文件中，如果你不想保存密码就不要选择“Save password”复选框…

点test按扭测试一下连接，不过最好是再保存之前测试。

2．4图

iReport被装入的JDBC驱动只有MYSQL和HSQLDB。如果在测试期间发现有ClassNotFound异常，很有可能是能被选择的驱动的classpath中不包含JAR或（ZIP）文件。不用关闭iReport，拷贝这个JDBC驱动到lib目录下，重试一下；这个JAR将被重新被iReport加载。在第十章，我们将深入广泛的解释所有的数据源的配置形式。测试通过后按保存按钮保存连接。