个贷系统开发指导.doc

系统开发指导目 录1概述12开发体系结构12.1体系目录结构介绍13增加一个模块的基本步骤34Step by step44.1确保正确安装开发环境44.2增加数据库访问层54.3改造数据访问层，纳入Spring管理94.4增加业务逻辑Service94.5增加业务逻辑Operation114.6增加WEB程序124.7创建JSP文件164.8配置Struts184.9部署服务194.10启动服务215总体原则221 概述本文档用于系统开发人员，指导开发过程，不是项目正式文档。系统架构说明请参考浦发个贷03-项目实施03-概要设计105002-软件构架文档文档中涉及的各项技术，详情请参考浦发个贷07-其它01-系统开发技术文档下的各个手册。2 开发体系结构2.1 体系目录结构介绍整个系统分为业务逻辑层开发（0）与展现层开发（16）整个项目分为src（0）和web（16）两类文件。0 ：src目录包括了系统业务逻辑相关的文件， 逻辑层（src）分为架构层（1）、业务层（2）及相关资源（15）。1 ：系统框架中可重用的部分，包括各个模块的基础接口，通用方法等。2 ：业务层分为业务逻辑实现（3）和业务展现（10）。3 ：分为数据访问（4）和业务模块（7）。4 ：整个系统中对数据访问的封装放在一起，采用ORMapping框架hibernate，包括持久层值对象pojo以及数据访问对象DAO（6）。此部分内容基本上都由IDE的plugin自动完成。6 ：参考hibernate手册。7 ：逻辑层业务模块是逻辑层开发人员真正关注的内容，其中包括operation（8）和sevice（9）。8 ：封装了展现层请求的每个交易请求，每个交易对应一个operation；实现框架中的Ioperation接口，具体实现是通过调用service层实现的。9 ：封装了具体业务逻辑的实现，支持被operation调用；具体实现时，包括业务逻辑和数据访问的调用来实现。10：这里的web是展现层逻辑，完全支持struts用的，按业务模块（12）分类。11：（10）目录下的公共文件12：具体的业务模块，其中包括了各种action（13）和formbean（14）。13：参考struts手册。14：参考struts手册。15：整个系统用到的资源文件，主要是一些配置文件。这里面最重要的是spring的配置文件applicationContext.xml，详情请参考spring手册。16：web目录是web引用服务器相关的文件，包括html、jsp及图片等静态资源。17：jsp目录，也是按业务模块划分；详情参考相关文档。18：web公共文件。19：具体业务模块。3 增加一个模块的基本步骤1. 增加数据库访问层的实例a) 增加.dataaccess.#.hbm，利用hibernatesynchronizer自动生成数据库实体类。b) 增加.dataaccess.dao.#增加Java文件在/resources/模块名/services.xml中增加对Dao的配置2. 增加业务逻辑a) 增加.模块名.service增加Java文件在/resources/模块名/services.xml中增加对services的配置b) 增加.模块名.operation增加Java文件在/resources/模块名/services.xml中增加对operation的配置3. 增加界面a) 增加jsp/web/jsp/模块名/#.jspb) 增加WEB程序i. Actioncom.huateng.pdbloan.web.模块名.actionii. formcom.huateng.pdbloan.web.模块名.formiii. bean converter配置文件/resources/模块名/beans.xmliv. struts配置配置/web/WEB-INF/config/模块名/struts-config.xmlv. validation配置/web/WEB-INF/config/模块名/validation.xml4 Step by step以下教程以一个典型的业务“客户信息建立”为例，演示如何开发一个业务模块。模块名：客户信息，包名：customermanage4.1 确保正确安装开发环境Eclipse3.0、Weblogic、hibernatesynchronizer_2.3.1等。开发环境的安装请参考：浦发个贷07-其它02-项目组内部培训安装开发环境.doc。此部分内容不属于本文档，但是本文档内容的前提是开发环境必须正确一致。1. 用WinCVS从CVS服务器上取下最新的项目代码。2. 引入项目。Eclipse File Import Existing Project into Workspace4.2 增加数据库访问层首先申明的是，在系统中整个数据访问层是不分模块的，所有po及dao全部统一生成基础代码，业务模块开发人员需要做的是在基础代码上进行修改。(以下步骤可以帮助模块开发人员了解数据访问层的开发步骤，不用做，可以直接跳到1.5.3)打开目录至.dataaccess打开hibernate plugin选择Hibernate mapping file正确填写相关信息（这部分内容不同机器可能不同）在生成的hbm文件上点右键，选择Synchronize Files 在IDE视图里，可以看到已经生成了以下DAO、PO及一个映射文件修改resources/applicationContext.xml至此，数据访问层已经建立完毕。4.3 改造数据访问层，纳入Spring管理此时生成的DAO还没有用Spring进行管理，接下来进行修改；打开UserInfoDAO，把继承BaseUserInfoDAO改为继承HibernateDaoSupport，添加一个保存的方法save，一个查询的方法load，并修正引用。建立配置文件resources/customermanage/services.xml 修改web/WEB-INF/web.xml，找到以下部分，修改4.4 增加业务逻辑Service建立业务模块customermanage.service实现增加客户的Service：UserInfoServicepackage .customermanage.service;import com.huateng.ebank.framework.exceptions.CommonException;import .dataaccess.UserInfo;import .dataaccess.dao.UserInfoDAO;public class UserInfoService implements IUserInfoService UserInfoDAO userInfoDao;public String newUserInfo(UserInfo userInfo) throws CommonException return userInfoDao.save(userInfo);public UserInfoDAO getUserInfoDao() return userInfoDao;public void setUserInfoDao(UserInfoDAO userInfoDao) this.userInfoDao = userInfoDao;修改配置文件resources/customermanage/services.xml修改web.xml4.5 增加业务逻辑Operation建立业务模块customermanage.operation实现增加客户的operation：NewUserInfoOP主要的地方是execute方法。修改配置文件resources/customermanage/services.xml*至此，业务逻辑层的开发已经完成。4.6 增加WEB程序创建com.huateng.pdbloan.web.customermanage.action创建增加客户的NewUserInfoAction在execute方法中调用OP。UserInfoForm appform = (UserInfoForm) form;UserInfo vo = new UserInfo();BeanConverter.convert(appform, vo, userInfo);vo.setId(001);OperationContext context = new OperationContext();context.setAttribute(UserInfoConstant.USERINFO, vo);OperationCaller.call(newUserInfoOP, context);return mapping.findForward(success);创建com.huateng.pdbloan.web.customermanage.form创建UserInfoFormprivate String id;private String userName;private String password;private String email;private String description;private String tel;private String branchCode;private String userAccount;private String modifyDate;自动生成各自的getter，setter创建form与bean数据转换的映射文件resources/customermanage/beans.xml修改web.xml4.7 创建JSP文件一个填写内容的表单页面，一个显示创建成功的页面。new_user_info.jsp 创建客户 创建客户 userName： new_user_info_success.jsp 客户信息创建成功.4.8 配置Struts到这里，展现层需要的要素全部建立了，接下来要配置Struts创建/pdb-loan/web/WEB-INF/config/customermanage/ customermanage-validation.xml（在这个例子中简化起见，为空）创建/pdb-loan/web/WEB-INF/config/customermanage/ customermanage-struts- config.xml 修改web.xml编译项目，正常情况下应该可以正常通过，开发工作完成。4.9 部署服务正如前面所说，开发环境正确安装的情况下，这里我们默认weblogic也已经正常安装、配置，在主视图中可以看到Lomboz J2EE View；选中web应用，部署到应用服务器控制台会显示部署信息，类似：Buildfile: D:ProjectEclipseWorkSpacepdb-loanwebWEB-INFbuild.xmlundeploy:undeployTool:undeploy:undeploy:init: mkdir Created dir: D:ProjectEclipseWorkSpacepdb-loandist mkdir Created dir: D:ProjectEclipseWorkSpacepdb-loandistWEB-INF mkdir Created dir: D:ProjectEclipseWorkSpacepdb-loandistWEB-INFclasses mkdir Created dir: D:ProjectEclipseWorkSpacepdb-loandistWEB-INFlib copy Copying 55 files to D:ProjectEclipseWorkSpacepdb-loandist copy Copying 81 files to D:ProjectEclipseWorkSpacepdb-loandistWEB-INFclassesdeploy: jar Building jar: D:ProjectEclipseWorkSpacepdb-loanwebWEB-INFweb.war copy Copying 1 file to D:beauser_projectsdomainsmydomainapplications delete Deleting: D:ProjectEclipseWorkSpacepdb-loanwebWEB-INFweb.war delete Deleting directory D:ProjectEclipseWorkSpacepdb-loandistdeployTool:deploy:BUILD SUCCESSFULTotal time: 12 seconds