技术架构规范-（高清版）

引言目的通过对系统整体架构和技术规范的描述，为下一步大规模设计开发提供基础和规范。对象与范围项目管理人员，开发人员，测试人员。概述未来重构的工作量。webapphessian通信。第一层和第二层独立部署，第二层的不同模块也可以独立部署。webapp采用集群负载均衡，数据库采用负载均衡和读写分离，以满足一定的性能需求。文档描述了各层结构和模块使用的技术和框架发工具。文档只是描述了一期的架构，系统架构图一期系统架构如下用户浏览器http负载均衡，动静分离（nginx）

静态请求

网络存储动态请求WebAPP(bull)

rmi同步

Web

文件存取邮件服务器物流公司A8系统 WS

Hessian

Hessian

hessian （hourse）

http

管理员浏览器第三方网站短信平台银行，第三方支付

Smtpapi

(lion)

(antelope)

(eagle)

(pigieon))

(camel)

存(fox)

调用(mouse)

JDBCJDBC数据库读写分离，负载均衡（Amoeba）ODBCDB（salver）

DB（salver）DB(master) REPLICATIONDB（salver）

DB（salver）层次和模块前端负载均衡nginxWEBnginx平Nginxwebapp的负载均衡。动静分离动静分离可以很好得分担服务器的负载，有两种方式实现动静分离。2级域名，配置专门的静态文件服务器。nginxurl转发功能，把静态请求转发到静态服务器或在nginx本地处理，动态请求转发到应用服务器。jscss和静urlajax请求和动态页面使用动态服务器地址生成。负载均衡nginxupstreamip_hash的方式把动态请求转发到组内的某台服务器，同时保证客户端在IPsession保持问题。Webapp网站前端，基于j2ee，spring框架开发。页面展示和控制系统有三种页面方式。velocity模板生成页面，客户端刷新整个页面。ajaxAjaxvelocityhtml串；json格式；直接返回简单的字符串。模板生成的纯静态页面前台页面采用的框架和第三方技术有：e（ajax请求，页面刷新……。Jqzoom（图片放大器）输入验证）……权限安全控制apacheshiroShiroShirocas单点登录整合，方便在下一期扩展多个应用模块。框架把权限系统分成（当前用户权限数据)三层。支持基于实际资源和基于角色的权限校验，同时shiro实现基于验证码和数据库用户密码的用户登录验证。在过滤器层，我们暂时只使用shiro的3种类型过滤器控制访问1．AnonymousFilter 匿名过滤器 任何人可以访问。2．AuthenticatingFilter认证过滤器必须通过身份认真才能访问（跳转到登录页面。

可以对当前subject直接调用方法完成判断是否登录，登录，注销等操作，方便对登录功能的扩展。控制器层springvelocityjsonajaxtext返回。数据验证使用和扩展apache的common-validator。逻辑层采用spring基于注解的事务控制。数据持久层采用ibatis框架，基于sqlmap配置实现数据的读写，sqlmap配置可以控制底层sql语句，便于数据库的调优。缓存的处理ehcache架。用到两种缓存方式：用页面缓存效果很好，比如首页。基于注解的方法缓存，可以对方法的返回值缓存，存入的参数可以组成。可以等数据。Ehcache支持分布式缓存，ehcache支持服务器之间通过rmi调用保持所有服务器之间缓存同步。缓存的两种过期机制：ehcache的配置确定缓存过期频率。主动通知，管理员在后台系统进行某些操作后，通过hessian用服务器缓存过期。只需通知一台应用服务器，应用服务器之间通过ehcache自带分布式缓存复制方式同步缓存。后台管理系统可以提供刷新缓存功能，管理员在后台管理系统主动刷新缓存。去其他模块之间的通信通过hessian远程调用框架，实现与其他模块功能之间的通信。Hessian是一个基于http的二进制远程过程调用框架，比webservice更高效。与Spring框架很好结合，开发简单。后台管理系统j2eespring页面的展示大部分请求采用页面刷新的机制。头部，中部左侧菜单和底部固定不变。中部右侧iframe为主操作区，每次操作刷新页面。商品描述的编辑需要使用到富文本编辑器，我们采用开源的TinyMCE，TinyMCE在国内应用比较广泛。缓存机制后台系统访问不是很频繁，同事管理员需要的是实时的数据，所以后台管理系统不对数据进行缓存。权限管理采用spingsecurity框架进行权限的控制，基于用户、角色和资源的授权机制。支付模块：j2eespringspringmvc模式。与银行和其他支付系统的交互需要提供一个Url地址，供银行在用户完成支付后回调，通知系统已经支付成功。与内部模块之间的通信主要来自网站前端的调用。基于hessian机制。物流模块j2eespringspringmvchessian机制对外提供远程效用服务。邮件模块邮件模块主要用来向客户发送邮件。基于j2eespring框架。采用springmvc模式。邮件发送使用javamail包发送邮件，支持以固定模板发送邮件。定时发送使用spring+quartz框架实现定时任务发送邮件。与内部模块之间的通信为网站前端和后台管理系统提供远程调用服务。基于hessian机制。短信模块短信模块主要用来向客户发送短信。基于j2eespring框架。采用springmvc模式。邮件发送调用短信设备api发送短信，支持以固定模板发送短信。定时发送使用spring+quartz框架实现定时任务发送短信。与内部模块之间的通信为网站前端和后台管理系统提供远程调用服务。基于hessian机制。进销存模块调用A8系统接口，实现库存的管理。基于j2eespring框架。采用springmvc模式。Webservice调用采用spring+xfile框架调用a8系统webservice。与内部模块之间的通信为网站前端和后台管理系统提供远程调用服务。基于hessian机制。搜索模块为网站提供搜索服务。包括商品检索和问答式搜索的问题检索。基于j2eespring框架。采用springmvc模式。检索框架coreSeekSphinx研发并独立开发的搜索引擎。自带中文分词器，有大量中文文档。提供。索引建立效率高并且与业务无关。在国内有大量成功案例。与内部模块之间的通信为网站前端提供远程调用服务。基于hessian机制。第三方服务调用模块调用第三方合作服务商的接口。基于j2eespring框架。采用springmvc模式。Webservice调用采用spring+xfile框架调用第三方服务webservice。与内部模块之间的通信为网站前端和后台管理系统提供远程调用服务。基于hessian机制。对外服务接口对外部系统提供webservice接口服务Webservice服务采用spring+xfile框架对外提供webservice服务。与内部模块之间的通信调用内部其他模块的服务。基于hessian机制。数据库使用mysql5.5数据库存储数据，并使用读写分离机制提高数据库性能。数据库读写分离我们使用开源的mysqlAmoeba实现数据库的读写分离mysql自带的复制机制实现数据的同步。数据库负载均衡Amoeba支持轮询和权重两种负载均衡机制，我们使用权重负载机制实现读服务器的负载均衡。数据库表引擎的选择主服务器必须使用innodb支持事务的存储引擎，行级锁表。而从服务器可以考虑使用myisam引擎，不支持事务，表级锁表，具有更高的读写效率，但不支持外键。主从数据库的差异优化要可以提高主服务器的性能。charvarchar,text,blob字段的表是静态表，反之是动态表，静态表的检索效率要比动态表好若干倍。工程命名工程以动物命名，结合了各种动物特征与我们各工程的职责：公共接口工具magpie（喜鹊）网站前台服务bull（公牛）物流cheetah（猎豹）支付lion（狮子）进销存接口fox（狐狸）搜索dog（狗）邮件eagle （鹰）短信pigeon（鸽子后台管理)调用第三方合作接口mouse(老鼠)对外服务接口camel(骆驼)工程规范工程目录结构src 源码WebContentWEN-INFlib jar包config 配置文件views 视图模板layout布局模板screen…… 各模块common公共的styles样式文件resources资源文件scripts js文件common js…… js项目包结构写公共工具接口工程公共工具：mon.util各层的公共基类：mon下的各子包远程调用公共dto：com.zjdelai.emall.提供服务的工程名.remoting.dto.业务子模块远程调用公共接口：com.zjdelai.emall.提供服务的工程名.erfaces.业务子模块第三方开源包的扩展：mon.第三方开源包名各模块工程数据对象：com.zjdelai.emall.工程名业务子模块dao接口：com.delai.emall..dao.业务子模块dao接口实现：com.zjdelai.emall.（ibatis）sqlmap：com.zjdelai.emall..dbMap..(mysql)业务逻辑接口：com.zjdelai.emall.工程名.service.业务子模块业务逻辑实现：com.zjdelai.emall..service..implWebaction：com.zjdelai.emall.业务子模块Web.zjdelai.emall.工程名业务子模块Web.zjdelai.emall.工程名.web.filter工具：com.zjdelai.emall.工程名.util远程调用接口实现：com.zjdelai.emall.工程名.erfaces.业务子模块.impl类、接口命名类命名基本原则：首字母大写，多个单词的首字母大写接口命名基本原则：以大写字母"I"开头，如果有多个单词，每个单词头字母大写I数据对象：数据库表名.javaDao接口：I+数据对象名+Dao.javadao实现：数据对象名+Dao+框架名(Ibatis).javasqlmap：数据对象名.xml+Manager.java+ManagerImpl.javaWeb：domain名+Action.javaWebvalidator：domain名+Validator.javaDto：***Dto.java远程调用接口：I+数据对象名+Sercice.java远程调用实现：数据对象名+SerciceImpl.java变量和方法命名类变量、局部变量命名规范：变量名首字母必须小写，如果该变量名有多个单词组成，后面的单词首字母大写，单词与单词之间不要使用‘_’做连接。类常量命名规范：所有字母大写，如果有多个单词组成，单词与单词之间以‘_’隔开。而且该变量必须是公共、静态、final类型。方法命名规范：方法名首字母必须小写，如果该变量名有多个单词组成，后面的单词首字母大写，单词与单词之间不要使用‘_’做连接。方法参数名命名规范：参数名首字母必须小写，如果该变量名有多个单词组成，后面的单词首字母大写，单词与单词之间不要使用‘_’做连接。注释类、接口的注释类、接口必须要有注释。描述类、接口的功能，作者，版本，最近修改时间。版本。/**XXXX功能类*@authorXXX@versionX.X.X */类、接口的变量和常量注释简单描述其代表的意义。/*** XXXXXX*/类、接口方法注释简单描述，方法的参数、返回值类型、返回值意义简单的描述，跑出异常描述/**XXXXXX功能@param a a参数的意义@param b b参数的意义@retur