药品集中采购平台系统框架

采购平台开发规范一、 概述本文档为采购平台的开发规范，阅读人员为系统开发工程师，旨在学会如何快速进行采购系统的开发。内容共包括两部分，base 和business，分别描述了每部分的开发规范。二、平台架构springMybatis技术框架模块，放spring、mybatis及整合的jar包。base业务基础模块，针对本系统的特点在技术框架基础之上进行封装，包括系统业务的基础功能，区域管理、用户管理、系统参数配置等，有了这些基础的业务功能，采购管理模块、供货管理模块、监督管理模块才可以正常的运行business业务模块，本系统的业务功能模块，包括药品目录、采购单管理、退货单管理，结算单管理等。util工具模块，包括了系统用到的所有工具类，本模块是独立于本系统的，可作为其它项目模块引用。三、base业务基础模块Base模块即为本系统的业务基础模块，内容如下：ContextConfig系统配置类Filter结构：包(ject.yycg.base.filter)LoginInterceptor对登陆权限功能进行拦截校验，用户未登陆不可使用具有登陆权限的功能。 PermissionInterceptor对操作权限功能进行拦截校验，用户未授权不可使用具有操作权限的功能。Action结构包(ject.yycg.base.action)Converters子包中定义了数据转换器，详细见下面描述。converters参数解析器对action方法参数进行解析，配置如下： 本系统对当前登录用户身份对象（ActiveUser）进行赋值。属性编辑器对view传递过来的数据进行类型或格式转换后向action参数赋值。Springmvc.xml进行配置Action具体的功能控制器。使用注解：l controllerl requestMapping返回视图：使用View.java封装类。方法返回结果：l String，具体的页面地址或url地址l ResponseBody SubmitResultInfo，表单提交返回结果，详细参考system模块l ResponseBody DataGridResultInfo，数据列表查询结果，详细参考system模块l ResponseBody ExceptionResultInfo，异常结果，详细参考system模块l ResponseBody 返回 view将转换为json，由于上边三个返回结果类封装了resultinfo对象，客户端使用统一js方法对resultinfo进行解析。baseServiceFacade此部分非action模块内容。具体模块的service层封装的服务接口门面，action中使用模块service门面方便简单。Service结构：包(ject.yycg.base.service)Impl子包中定义了service接口实现类。baseServiceFacade业务基础模块的service接口门面。门面中注入了各各service接口。baseDaoFacade此部分非Service模块内容。具体模块的Dao层封装的Dao接口门面，Service中使用模块Dao门面方便简单。Spring注入将服务接口及服务接口门面在resources/applicationContext-base-service.xml文件中配置。Dao结构包（ject.yycg.base.dao）mapper子包存放mapper文件包括：接口类和xml文件。自动扫描配置： 注意：由于将mapper的xml和java接口文件放在一个目录下且文件名相同，在sqlsessionFactory定义时无需指定mapperLocations属性。另外mybatis的配置文件sqlMapConfig.xml也无需指定mapper文件的位置了。MapperMapper文件xml和java 接口及用到的po类使用官方网站提供的mybatis-generator-core-1.3.2-bundle生成。Mapper接口方法与mapper xml文件中中定义的sql对应，方法名与sql的id对应。Java Mapper接口命名规则：表名mapper+Custom.javaXml Mapper 文件命名规则：表名mapper+Custom.xmlNamespace：与mapper java文件类路径相同。 baseDaofacdebaseMapperDao是base模块的 dao接口门面，可供base模块的service层使用。门面中包括了base模块所有的dao接口，service通过门面调用dao。Process系统执行包，包括统一异常处理，提交结果及查询列表结果信息处理。结构包（cess）Exception子包中定义了系统异常解析器。Result子包中定义系统执行结果类。exceptionExceptionResolverCustom，系统统一的异常处类，在springmvc.xml进行配置，如下：异常处理流程：resultSubmitResultInfo表单提交结果类，类封装了ResultInfo对象 。DataGridResultInfo数据列表查询结果类，类封装了ResultInfo对象 。ExceptionResultInfo操作异常结果类，类封装了ResultInfo对象 。ResultUtil工具类，封装了对操作结果的创建及访问方法。POJOPO存放mybatis 使用的数据模型，本系统是通过使用mybatis的mapper生成工具根据数据表结构自动生成。Mapper生成工具参考Dao部分。VO在Action及service中使用，当po的字段不够用时需要定义vo对象，通常采用继承po再进行扩充的方式创建。继承po创建vo命名规则：PO名+Customsrc/main/perties系统日志配置resources/perties定义系统提示信息，警告信息，错误信息，每个信息配置对应的代码，通过ResourcesUtil.getValue进行读取。sysPperties系统参数配置perties系统版本配置anonymousAperties公开操作action地址，无需登陆即可操作commonAperties公共操作action地址，需要登陆但无需授权即可操作menu_0,1,2,3,4.json系统菜单配置在menu_.json文件中，为groupid即用户类型的id，分别为：1,2,3,4,0，即卫生局，卫生院，卫生室，供货商，系统管理员。系统登陆时根据用户的groupid从相应的ment_.json文件中读取该用户类型所有的菜单放在session中，当用户登陆成功在view上加载菜单。注意：系统实际环境根据用户角色从数据库读取系统菜单。perties数据库链接参数spring/springmvc.xmlspringmvc相关spring/applicationContext.xml配置数据源和事务管理spring/applicationContext-base-dao.xml配置：会话工厂Mapper扫描Dao及门面spring/applicationContext-base-service.xml配置：服务接口、服务门面mybat