repidframework 使用说明.docx

repidframework 使用说明.docx

《repidframework 使用说明.docx》由会员分享，可在线阅读，更多相关《repidframework 使用说明.docx（15页珍藏版）》请在冰豆网上搜索。

repidframework使用说明

Rapid-framework使用手册

一、搭建项目：

1.创建webproject项目

Webrootfoler的值为web，注意大小写。

注意：

1、如果未修改或者后期修改，在项目部署的时候就会报404错误，页面无法找到。

2.拷贝rapid-framework至项目根目录

将rapidframework.zip解压出来的内容全部拷贝至项目根目录,拷贝完效果如下。

3.设置项目的编码为utf-8

右键点击项目,修改项目属性

4.设置源码路径

将原有的一个source删掉，没用。

5.将generator/lib的jars加入classpath

点击"Addjars"按钮将生成器依赖的jar包需要加入classpath。

6.安装框架

项目为框架结构,spring框架为核心框架不需要手动安装，而web框架及dao层需要安装（可以安装不同的web框架或是dao层框架，也可以自定义框架组合，使操作更加快捷）。

打开plugins/build.xml,并打开MyEclipse的Outline视图，选择所需要的框架安装即可。

提示：

自定义框架方法：

定义方法类似于spring配置文件内bean，选择对应的name即可，结构图如下：

备注：

如果ant运行异常，导致无法安装框架，可以使用手动安装：

∙拷贝插件目录下的内容至项目根目录

∙将插件目录下的web_merge.xml合并至项目的web.xml的尾部

7.修改生成器配置文件generator.properties的jdbc数据库连接信息其它属性暂不修改

注意：

1、当使用不同的DAO层插件时部分参数文件也要同时进行修改，具体参数如下：

数据库方言的修改：

方言的作用主要是可以为jdbc,ibatis,ibatis3提供分页功能，如果未进行设置可能导致页面的分页功能失效或者异常。

主键生成策略的修改：

如果不进行修改，在save数据时，就会报错！

Hibernate:

1.方言（Dialect）修改:

src/resource/spring/applicationContext-dao.xml,默认为:

MysqlDialect

2.主键生成策略修改:

简单主键修改generator.properties的hibernate_id_generator即可,复杂主键如sequence请直接修改${className}.java（这里文件指的是生成器生成后对应的MODEL文件）,默认为increment:

Ibatis:

1.分页方言（Dialect）修改:

src/resource/spring/applicationContext-dao.xml

默认值为:

MySQLDialect,（注:

用于支持不同的数据库分页查询,该项为rapid的扩展）

2.主键生成策略修改:

修改${className}SqlMap.xml（这里的也是生成后的文件）中的节点,默认是使用mysql的auto_increment

Ibatis3:

1.分页方言（Dialect）修改:

src/resource/configuration.xml

默认值为:

MySQLDialect,（注:

用于支持不同的数据库分页查询,该项为rapid的扩展）

2.主键生成策略修改:

修改${className}Mapper.xml（这里的也是生成后的文件）中的insert节点,默认是适用mysql的auto_increment（sqlserver的identity也适用）

Spring_jdbc:

1.分页方言（Dialect）修改:

src/resource/spring/applicationContext-dao.xml

默认值为:

MySQLDialect,（注:

用于支持不同的数据库分页查询,该项为rapid的扩展）

2.主键生成策略修改

2.1修改模板${className}Dao.java中的save（）方法；

默认适用mysqlauto_increment及sqlserveridentity

注意：

当主键策略为序列时，需要修改生成器生成后对应的DAO文件中的SAVE方法，示例：

2.2其它生成策略为

sqlserveridentity：

insertWithIdentity（entity,sql）

oraclesequence：

insertWithOracleSequence（entity,sequenceName,insertSql）

db2sequence：

insertWithDB2Sequence（entity,sequenceName,insertSql）

uuid：

insertWithUUID（entity,insertSql）

手工分配：

insertWithAssigned（entity,insertSql）

2、当对页面文件路径namespace进行修改时web插件部分参数文件也要同时进行修改，具体参数如下：

Strust：

配置文件web/WEB-INF/struts-config.xml

修改说明:

根据你的包结构修改struts的通配符配置

URL访问规则为：

/namespace/Entity/method.do,如/pages/User/list.do

完整URL示例:

http:

//localhost:

8080/${context_path}/pages/User/list.do

struts2：

配置文件src/resources/struts.xml

修改说明：

1.修改pakcage的namespace属性,因为URL访问规则是:

/namesapce/Entity/method.do,默认值是pages

2.根据你的包结构修改action节点的class属性

URL访问规则为：

/namespace/Entity/method.do,如/pages/User/list.do

完整URL示例：

http:

//localhost:

8080/${context_path}/pages/User/list.do

Springmvc：

配置文件:

web/WEB-INF/springmvc-servlet.xml

修改说明:

1.修改class=ControllerClassNameHandlerMapping节点的pathPrefix以确定URL生成的前缀,默认值是pages

URL访问规则为：

/pathPrefix/Entity/method.do,如/pages/User/list.do

完整URL示例:

http:

//localhost:

8080/${context_path}/pages/User/list.do

springmvc_rest：

不用修改配置文件

URL访问规则为：

http:

//localhost:

8080/${context_path}/userinfo

3、当对java源文件路径basepackage进行修改时web插件部分参数文件也需要进行修改,示例：

8.运行代码生成器GeneratorMain.java

以application的方式运行cn.org.rapid_framework.generator.GeneratorMain,直接修改源码,以便生成不同的表及对应的jsp/action/service/dao/model。

备注：

这里的自动生成全部表的方法无法使用，由于无法生成存放代码的目录，所以使用时会报错,原因不明。

但是可以屏蔽掉clean方法，使用手工删除目录里面的内容，就可以使用自动生成全部表了，这里提示一点：

使用自动生成全部表，如果是oracle数据库，则generator.properties里面的jdbc.schema参数必须配置数据库名，而且字母必须是大写，否则无法识别。

9.拷贝生成的代码至项目根目录

生成器生成的文件默认会输出在d:

/webapp-generator-output，如果想修改此路径必须同时修改generator.properties内的outRoot及GeneratorMain.java。

10.将java_src,java_test加入源代码路径

参考第4步,设置完后效果如下：

注意该步骤不能遗漏，否则无法生成文件，导致系统无法运行

备注：

这里java_test报错是因为该文件javax.annotaction.Resource无法导入，该问题暂时无法解决（没这个文件）。

11.修改src/resources/jdbc.properties的数据库连接信息

该配置是应用需要连接的数据库,与生成器的数据库连接是分开配置的,与第7步的数据库连接配置相同即可。

12.部署应用至tomcat

到操作到这一步后，项目基本就搭建完成了，但是这个项目包含实际上只有关于各个表的相关操作及文件，并不能算一个完整的项目，之后就要对其进行改造，将其改造成一个完整项目。

13.访问规则

1、action:

组成模式：

/namespace/action名称/方法名.do

例如：

一个项目的namespace为jsp，现在需要访问LoginAction中的方法login，

则url为/jsp/Login/login.do

2、jsp:

组成模式：

/namespace/jsp文件夹/文件名.jsp

二、项目改造：

一、添加文件方式：

添加进入对应的文件夹内即可，无需配置XML文件。

View层control层及dao层

备注：

1、jsp页面上的分页部分采用的是自定义分页标签，源码无法查看，但是样式和图片应该是能修改的，未测试。

2、jsp页面如果使用自定义标签传递参数，参数必须有格式为：

“s_”+参数名，如何具体处理未知，action中不需要配置get/set方法，其获得的参数在类PageRequest中，此类包括分页相关参数，页面获取参数在一个filters（是MAP）中；如果采用我们原始的action中设置get/set方法也可以传递参数，但是无法使用他这个类了，因为处理此类的方法源码无法查看。

3、据开发者说，由于为了兼容插件（框架），service层及dao层均没有使用接口。

4、使用String_jdbc后,他自带了一套分页查询的方法，传入SQL语句及PageRequest即可；当然也可以使用自带的JdbcTemplate处理SQL语句。

5、

6、

7、

二、spring事务：

生成文件后有基本的事务处理，还提供了标注声明事务方式。

在配置文件applicationContext-resource.xml中，修改对应的配置即可。

然后再需要方法前追加标注即可。

三、另外还有模板继承功能，可以自定义模板。

四、根据开发者文档上说明项目完成后后可以删除部分多余文件，具体能删除哪些，现阶段还没测试。