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中，修改对应的配置即可。
然后再需要方法前追加标注即可。
三、另外还有模板继承功能，可以自定义模板。
四、根据开发者文档上说明项目完成后后可以删除部分多余文件，具体能删除哪些，现阶段还没测试。
升级会员 