Skip to end of metadata
Go to start of metadata

UReport2教学视频

UReport2 QQ群

UReport2的QQ群号:423339793

       UReport2的设计器是基于网页的,所以我们配置好一个项目,也就完成了报表设计器的安装,国为 UReport2是一款纯Java的报表引擎,所以它支持现在流行的所有类型J2EE项目,这里我们将主要介绍基于Maven的J2EE项目中如何包含UReport2。

基于Maven的UReport2项目搭建

       首先我们需要创建一个标准的Maven项目(具体创建过程可以使用Eclipse或其它工具,这里就不再赘述),然后要打开Maven的pom.xml文件,在其中添加UReport2的依赖信息,如下所示:

UReport2的依赖信息

关于版本

在上面的依赖信息中,[version]表示ureport2-console包的具体版本号,我们可以到http://search.maven.org/上查询“ureport2-console”关键字,以查看该包的具体版本号。最新源码可以到https://github.com/youseries/ureport上下载。

       需要注意的是,在http://search.maven.org/上我们只能查找到最新的release版本,如果您需要最新的snapshot,那么可以到https://oss.sonatype.org/上查找,因为sonatype规定,只有正式版本才可以发到http://search.maven.org/上,也就是mave的central repository中,snapshot版本只能存在于https://oss.sonatype.org/中,所以如果我们要采用https://oss.sonatype.org/中最新的snapshot,那么就需要在pom.xml中添加一个repository信息,告诉Maven该到这里去下载snapshot版本的包,repository信息如下所示:

Repository信息

       到这里,Maven的pom.xml文件就配置完成了,pom.xml的完整配置如所下所示:

pom.xml完整内容

       在实际使用中,我们的pom.xml文件可能还需要添加其它依赖信息,比如目标数据库驱动等,如果有那么只需要修改上述pom.xml文件,加上相应依赖即可。

       接下来,我们需要配置一个UReport2需要使用到的servlet。打开项目的web.xml文件,在其中添加如下所示的servlet配置:

Servlet配置

       在这个servlet配置当中,值为“/ureport/*”的url-pattern是一定不能变的,否则系统将无法运行。

       因为UReport2是架构在spring之上的,所以作为配置的最后一步就是让我们的项目加载UReport2的spring配置文件,加载的方法有很多,比如我们可以打开web.xml,在其中添加一个spring提供的listener直接加载UReport2提供的spring配置文件,如下所示:

直接加载UReport2的spring配置文件

       如果您的项目中没有采用spring,那么就可以采用上述配置直接加载UReport2提供的spring配置文件,如果您的项目中也用到了spring,或项目中其它模块用到了spring,那么可以在我们已存在的spring配置文件中导入UReport2提供的spring配置文件,如下配置所示:

导入UReport2提供的spring配置文件

       如果项目中没已存在的spring配置文件,那么我们可以在WEB-INF目录下新建一个名为context.xml的spring配置文件,在其中导入UReport2提供的spring配置文件,如下所示:

context.xml文件内容

关于Properties文件加载

如果你是将UReport配置到一个已存在的Spring项目中,同时项目也要Spring中加载自己的Properties文件,比如通过下面的方式加载自己的Properties文件

<context:property-placeholder location="/WEB-INF/app.properties"/>

这时启动应用,我们会发现启动过程中系统会报各种属性找不到的异常,解决办法就是在上面配置中加上 ignore-unresolvable="true" 以及 order="1" 两个属性即可,其中ignore-unresolvable属性表达忽略当前配置的Properties文件中没有配置的属性,order属性值表示加载优先级,值越小,优先级越高。

当然如果你的项目中Properties文件加载是通过配置PropertyPlaceholderConfigurer为bean的方式加载,那么同样需要为这个bean添加如下两个属性,作用也是一样:

       接下来打开web.xml,在其中添加一个spring提供的listener,加载我们新建的这个context.xml文件,如下所示:

listener中加载context.xml文件

       到这里,我们就在一个标准的Maven项目中加入了UReport2,运行项目,在浏览器中访问URL:http://localhost:8080/ureport-demo/ureport/designer,就可以看到UReport2的报表设计器界面:

关于URL

上述的URL“http://localhost:8080/ureport-demo/ureport/designer”中,需要根据项目情况修改8080端口号为当前Server端口号,将“ureport2-demo”换成实际的项目名称。

非Maven项目中添加UReport2

       如果我们的项目是一个传统的J2EE项目,没有采用Maven来对项目进行管理,如果要在这种项目中添加UReport2,方法与上面的基于Maven项目基本类似,唯一不同的地方就是不用配置pom.xml文件,这样的话UReport2相关的Jar及依赖的第三方Jar我们需要手动复制到项目的WEB-INF/lib目录当中。

       UReport2依赖的第三方Jar包,可以从后面的链接中下载(Jar包较大,分两个压缩包,点击下载第一部分Jar包下载第二部分Jar包);UReport2自己的Jar包有三个,分别是ureport2-core、ureport2-font及ureport2-console,我们可以到https://oss.sonatype.org/上分别下载他们(分别输入ureport2-core、ureport2-font或ureport2-console关键字查询下载最新版)。

       将下载下来的第三方Jar包和UReport2自己的三个Jar包一起放到项目的WEB-INF/lib目录下,然后向上面介绍的方法一样配置UReport2的Servlet并加载UReport2提供的spring配置文件,这样就可以将UReport2加入到项目当中。

Labels