repid-framework 使用说明.doc

Rapid-framework使用手册一、搭建项目：1.创建web project 项目Web root foler的值为web，注意大小写。注意：1、如果未修改或者后期修改，在项目部署的时候就会报404错误，页面无法找到。2.拷贝rapid-framework至项目根目录将rapidframework.zip解压出来的内容全部拷贝至项目根目录,拷贝完效果如下。3.设置项目的编码为utf-8右键点击项目,修改项目属性4.设置源码路径将原有的一个source删掉，没用。5.将generator/lib的jars加入classpath点击Add jars按钮将生成器依赖的jar包需要加入classpath。6.安装框架项目为框架结构,spring框架为核心框架不需要手动安装，而web框架及dao层需要安装(可以安装不同的web框架或是dao层框架，也可以自定义框架组合，使操作更加快捷)。打开plugins/build.xml,并打开MyEclipse的 Outline 视图，选择所需要的框架安装即可。提示：自定义框架方法：定义方法类似于spring配置文件内bean，选择对应的name即可，结构图如下：备注：如果ant运行异常，导致无法安装框架，可以使用手动安装： 拷贝插件目录下的内容至项目根目录 将插件目录下的web_merge.xml合并至项目的web.xml的尾部7.修改生成器配置文件perties的jdbc数据库连接信息 其它属性暂不修改注意：1、当使用不同的DAO层插件时部分参数文件也要同时进行修改，具体参数如下： 数据库方言的修改：方言的作用主要是可以为jdbc,ibatis,ibatis3提供分页功能，如果未进行设置可能导致页面的分页功能失效或者异常。 主键生成策略的修改：如果不进行修改，在save数据时，就会报错！Hibernate: 1.方言(Dialect)修改:src/resource/spring/applicationContext-dao.xml,默认为:MysqlDialect 2.主键生成策略修改:简单主键修改perties的hibernate_id_generator即可,复杂主键如sequence请直接修改$className.java(这里文件指的是生成器生成后对应的MODEL文件),默认为increment:Ibatis: 1.分页方言(Dialect)修改: src/resource/spring/applicationContext-dao.xml 默认值为:MySQLDialect,(注:用于支持不同的数据库分页查询,该项为rapid的扩展) 2.主键生成策略修改:修改$classNameSqlMap.xml(这里的也是生成后的文件)中的节点,默认是使用mysql 的auto_incrementIbatis3: 1.分页方言(Dialect)修改: src/resource/configuration.xml 默认值为:MySQLDialect,(注:用于支持不同的数据库分页查询,该项为rapid的扩展) 2.主键生成策略修改:修改$classNameMapper.xml(这里的也是生成后的文件)中的insert节点,默认是适用mysql 的auto_increment(sqlserver的identity也适用)Spring_jdbc: 1.分页方言(Dialect)修改: src/resource/spring/applicationContext-dao.xml 默认值为:MySQLDialect,(注:用于支持不同的数据库分页查询,该项为rapid的扩展) 2.主键生成策略修改 2.1修改模板$classNameDao.java中的save()方法；默认适用mysql auto_increment及sqlserver identity注意：当主键策略为序列时，需要修改生成器生成后对应的DAO文件中的SAVE方法，示例： 2.2其它生成策略为 sqlserver identity：insertWithIdentity(entity,sql) oracle sequence：insertWithOracleSequence(entity,sequenceName,insertSql) db2 sequence：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.dostruts2：配置文件src/resources/struts.xml修改说明：1.修改pakcage的namespace属性,因为URL访问规则是: /namesapce/Entity/method.do,默认值是pages2.根据你的包结构修改action节点的class属性URL访问规则为：/namespace/Entity/method.do,如/pages/User/list.do完整URL示例：http:/localhost:8080/$context_path/pages/User/list.doSpringmvc：配置文件:web/WEB-INF/springmvc-servlet.xml修改说明:1.修改class=ControllerClassNameHandlerMapping节点的pathPrefix以确定URL生成的前缀,默认值是pagesURL访问规则为：/pathPrefix/Entity/method.do, 如/pages/User/list.do完整URL示例: http:/localhost:8080/$context_path/pages/User/list.dospringmvc_rest：不用修改配置文件URL访问规则为：http:/localhost:8080/$context_path/userinfo3、当对java源文件路径basepackage进行修改时web插件部分参数文件也需要进行修改,示例：8.运行代码生成器 GeneratorMain.java以application的方式运行.rapid_framework.generator.GeneratorMain,直接修改源码,以便生成不同的表及对应的jsp/action/service/dao/model。备注：这里的自动生成全部表的方法无法使用，由于无法生成存放代码的目录，所以使用时会报错,原因不明。但是可以屏蔽掉clean方法，使用手工删除目录里面的内容，就可以使用自动生成全部表了，这里提示一点：使用自动生成全部表，如果是oracle数据库，则perties里面的jdbc.schema参数必须配置数据库名，而且字母必须是大写，否则无法识别。9.拷贝生成的代码至项目根目录生成器生成的文件默认会输出在d:/webapp-generator-output，如果想修改此路径必须同时修改perties内的outRoot及GeneratorMain.java。10.将 java_src,java_test加入源代码路径参考第4步,设置完后效果如下：注意该步骤不能遗漏，否则无法生成文件，导致系统无法运行备注：这里java_test报错是因为该文件javax.annotaction.Resource无法导入，该问题暂时无法解决(没这个文件)。11.修改src/resources/perties的数据库连接信息该配置是应用需要连接的数据库,与生成器的数据库连接是分开配置的,与第7步的数据库连接配置相同即可。12.部署应用至tomcat到操作到这一步后，项目基本就搭建完成了，但是这个项目包含实际上只有关于各个表的相关操作及文件，并不能算一个完整的项目，之后就要对其进行改造，将其改造成一个完整项目。13.访问规则1、action:组成模式：/namespace/action名称/方法名.do例如：一个项目的namespace为jsp，现在需要访问LoginAction中的方法login，则url为 /jsp/Login/login.do2、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语句及Pa