技术架构规范

1、v1.0可编写可更正序言1.1目的经过对系统整体架构和技术规范的描述，为下一步大规模设计开发供应基础和规范。1.2对象与范围项目管理人员，开发人员，测试人员。1.3归纳系一致期，以实现功能为主，效率性能为辅，但设计兼顾未来性能的扩展，以减少未来重构的工作量。webapp按逻辑分为两层，第一层用户服务接入，第二层内部服务。第一层一期不分模块，以二级目录形式表示不同样模块，第二层依照不同样服务分模块，第一层和第二层之间使用hessian通信。第一层和第二层独立部署，第二层的不同样模块也可以独立部署。下一期考虑第一层分模块的二级域名独立部署，并实现单点登录。webapp采用集群负载均衡，数据库采用负

2、载均衡和读写分别，以满足必然的性能需求。文档描述了各层结构和模块使用的技术和框架。最后描述了开发的规范和用到的开发工具。文档可是描述了一期的架构，系统架构图一期系统架构以下1v1.0可编写可更正用户阅读器http负载均衡，动静分别（nginx）静态央求网络储藏动向请求文件存取WebAPP(bull)rmi缓存WebAPP(bull)同步HessianHessian管理员阅读邮件服务器后台管理系统httphessian器（hourse）物流公司A8系统WS物流对外进销调用Smtp支付邮件短信找寻(ant第三方网站(lio(eag(pigi(dog服务存外面n)elople)eon)(cam(fo

3、x(mou短信平台apie)el)se)银行，第三方支付JDBCJDBC数据库读写分别，负载均衡（Amoeba）ODBCDBDB（salver）（salver）DB(master)REPLICATIONDBDB（salver）（salver）2v1.0可编写可更正层次和模块3.1前端负载均衡nginx是一个口碑很好的开源免费WEB服务器，国内很多大型网站都转选nginx平台，比方腾讯，豆瓣等。Nginx可以实现动静分别和webapp的负载均衡。3.1.1动静分别动静分别可以很好得分担服务器的负载，有两种方式实现动静分别。1使用2级域名，配置特地的静态文件服务器。2利用nginx的url转发功能

4、，把静态央求转发到静态服务器或在nginx本地办理，动向央求转发到应用服务器。我们当前部署上采用第二种方式，同时也实现第一种方式。系统可以配置动向服务器地址和静态服务器地址，在生成页面时获取这两个地址，对图片、js脚本、css和静态页面使用静态配置生成url，对ajax恳求和动向页面使用动向服务器地址生成url。3.1.2负载均衡nginx可以配置upstream服务器组，实现组内的负载均衡。经过ip_hash的方式把动向央求转发到组内的某台服务器，同时保证客户端在IP不变的情况下素来接见同一台服务器，解决session保持问题。3.2Webapp网站前端，基于j2ee，spring框架开发。

5、3v1.0可编写可更正3.2.1页面显现和控制系统有三种页面方式。1动向同步央求，经过velocity模板生成页面，客户端刷新整个页面。2ajax异步央求。Ajax异步央求又有三种形式：与velocity模板结合返回html串；返回json格式；直接返回简单的字符串。3模板生成的纯静态页面前台页面采用的框架和第三方技术有：1jquery-core（事件办理，ajax央求，页面刷新）。2Jqzoom（图片放大器）3Jquery-validator（输入考据）3.2.2权限安全控制使用apacheshiro框架实现权限控制。Shiro是一个富强、使用简单的权限安全框架。同时Shiro也能与cas单

6、点登录整合，方便在下一期扩展多个应用模块。框架把权限系统分成subject（当前用户），manager(管理所适用户)，realms(权限数据)三层。支持基于实质资源和基于角色的权限校验，同时我们扩展shiro的UsernamePasswordToken，Realm实现基于考据码和数据库用户密码的用户登录考据。在过滤器层，我们暂时只使用shiro的3各种类过滤器控制接见：1AnonymousFilter匿名过滤器任何人可以接见。2AuthenticatingFilter认证过滤器必定经过身份认真才能接见（跳转到登录页面）。可以对当前subject直接调用方法完成判断可否登录，登录，注销等操作，

7、方便对登录功能的扩展。4v1.0可编写可更正3.2.3控制器层采用spring基于解说的控制器，控制器支持velocity视图返回，ajaxjson返回和ajaxtext返回。3.2.4数据考据使用和扩展apache的common-validator。3.2.5逻辑层采用spring基于解说的事务控制。3.2.6数据长远层采用ibatis框架，基于sqlmap配置实现数据的读写，sqlmap配置可以控制基层sql语句，便于数据库的调优。3.2.7缓存的办理使用缓存可以降低与数据库的交互次数，极大提高系统性能。我们采用ehcache缓存框架。用到两种缓存方式：1页面缓存：直接在过滤器层对页面进行

8、缓存办理，在过滤器层就可以返回缓存的页面，不用转到控制器去办理。对于页面比较复杂，调用业务逻辑比很多的页面，采用页面缓存收效很好，比方首页。2基于解说的方法缓存，可以对方法的返回值缓存，存入的参数可以组成key。可以在逻辑层使用缓存，也可以在长远层试用。对于央求简单，接见量大，但更正频率5v1.0可编写可更正比较低的数据进行缓存可以达到很好的收效。比方商品分类，系统数据字典，地区等数据。Ehcache支持分布式缓存，ehcache支持服务器之间经过rmi调用保持所有服务器之间缓存同步。缓存的两种过期体系：1准时过期，直接经过ehcache的配置确定缓存过期频率。2主动通知，管理员在后台系统进行

9、某些操作后，经过hessian远程调用通知应用服务器缓存过期。只需通知一台应用服务器，应用服务器之间经过ehcache自带分布式缓存复制方式同步缓存。后台管理系统可以供应刷新缓存功能，管理员在后台管理系统主动刷新缓存。3.2.8去其他模块之间的通信经过hessian远程调用框架，实现与其他模块功能之间的通信。Hessian是一个基于http的二进制远程过程调用框架，比webservice更高效。与Spring框架很好结合，开发简单。3.3后台管理系统管理员用来保护网站的系统。基于j2eespring框架。与网站前台使用到的技术差不多，现只介绍不同样点：3.3.1页面的显现大部分央求采用页面刷新

10、的体系。6v1.0可编写可更正头部，中部左侧菜单和底部固定不变。中部右侧iframe为主操作区，每次操作刷新页面。商品描述的编写需要使用到富文本编写器，我们采用开源的TinyMCE，TinyMCE在国内应用比较广泛。3.3.2缓存体系后台系统接见不是很频频，同事管理员需要的是实时的数据，所今后台管理系统不对数据进行缓存。3.3.3权限管理采用spingsecurity框架进行权限的控制，基于用户、角色和资源的授权体系。3.4支付模块：支付模块主要功能是订单的管理，与银行等支付系统的交互。基于j2eespring框架。采用springmvc模式。3.4.1与银行和其他支付系统的交互需要供应一个U

11、rl地址，供银行在用户完成支付后回调，通知系统已经支付成功。3.4.2与内部模块之间的通信主要来自网站前端的调用。基于hessian体系。7v1.0可编写可更正3.5物流模块支付模块当前主要功能是调用物流公司的接口追踪物流状态，随着系统的不断发展，在拥有自己的物流后，可能发展成一个弘大的系统。基于j2eespring框架。采用springmvc模式。基于hessian体系对外供应远程功能服务。3.6邮件模块邮件模块主要用来向客户发送邮件。基于j2eespring框架。采用springmvc模式。3.6.1邮件发送使用javamail包发送邮件，支持以固定模板发送邮件。3.6.2准时发送使用sp

12、ring+quartz框架实现准时任务发送邮件。3.6.3与内部模块之间的通信为网站前端和后台管理系统供应远程调用服务。基于hessian体系。3.7短信模块短信模块主要用来向客户发送短信。基于j2eespring框架。采用springmvc模式。8v1.0可编写可更正3.7.1邮件发送调用短信设备api发送短信，支持以固定模板发送短信。3.7.2准时发送使用spring+quartz框架实现准时任务发送短信。3.7.3与内部模块之间的通信为网站前端和后台管理系统供应远程调用服务。基于hessian体系。3.8进销存模块调用A8系统接口，实现库存的管理。基于j2eespring框架。采用spr

13、ingmvc模式。3.8.1Webservice调用采用spring+xfile框架调用a8系统webservice。3.8.2与内部模块之间的通信为网站前端和后台管理系统供应远程调用服务。基于hessian体系。3.9找寻模块为网站供应找寻服务。包括商品检索和问答式找寻的问题检索。基于j2eespring框架。采用springmvc模式。9v1.0可编写可更正3.9.1检索框架我们使用国产开源coreSeek找寻引擎，基于俄国开源项目Sphinx研发并独立开发的找寻引擎。自带中文分词器mmseg，有大量中文文档。供应JAVAAPI。索引建立效率高而且与业务没关。在国内有大量成功案例。3.9.

14、2与内部模块之间的通信为网站前端供应远程调用服务。基于hessian体系。3.10第三方服务调用模块调用第三方合作服务商的接口。基于j2eespring框架。采用springmvc模式。Webservice调用采用spring+xfile框架调用第三方服务webservice。与内部模块之间的通信为网站前端和后台管理系统供应远程调用服务。基于hessian体系。3.11对外服务接口对外面系统供应webservice接口服务Webservice服务采用spring+xfile框架对外供应webservice服务。10v1.0可编写可更正与内部模块之间的通信调用内部其他模块的服务。基于hessia

15、n体系。3.12数据库使用数据库储藏数据，并使用读写分别体系提高数据库性能。数据库读写分别我们使用开源的mysql代理Amoeba实现数据库的读写分别，把写央求发送到主服务器，读央求发送到从服务器，主从之间经过mysql自带的复制体系实现数据的同步。数据库负载均衡Amoeba支持轮询和权重两种负载均衡体系，我们使用权重任载体系实现读服务器的负载均衡。数据库表引擎的选择主服务器必定使用innodb支持事务的储藏引擎，行级锁表。而从服务器可以考虑使用myisam引擎，不支持事务，表级锁表，拥有更高的读写效率，但不支持外键。主从数据库的差异优化主服务器只需要建立唯一索引和外键拘束，其他针对对盘问优化

16、的索引可以不建立，这要可以提高主服务器的性能。从服务器字段使用char而不用varchar，没有varchar,text,blob字段的表是静态11v1.0可编写可更正表，反之是动向表，静态表的检索效率要比动向表好若干倍。工程命名工程以动物命名，结合了各种动物特色与我们各工程的职责：公共接口工具magpie（喜鹊）网站前台服务bull（公牛）物流cheetah（猎豹）支付lion（狮子）进销存接口fox（狐狸）找寻dog（狗）邮件eagle（鹰）短信pigeon（鸽子）后台管理horse(马)调用第三方合作接口mouse(老鼠)对外服务接口camel(骆驼)工程规范5.1工程目录结构src源码

17、WebContentWEN-INFlibjar包config配置文件views视图模板12v1.0可编写可更正layout布局模板screen页面模板各模块common公共的styles样式文件resources资源文件scriptsjs文件common公共js各模块，各开源js项目5.2包结构包命名基根源则：小写字母开头，若是有多个单词，除第一个单词之外的单词首字母大写5.2.1公共工具接口工程公共工具：各层的公共基类：下的各子包远程调用公共dto：供应服务的工程名.remoting.dto.业务子模块远程调用公共接口：供应服务的工程名.业务子模块第三方开源包的扩展：第三方开源包名5.2.2

18、各模块工程数据对象：工程名.domain.业务子模块长远层dao接口：工程名.dao.业务子模块长远层dao接口实现：工程名.dao.业务子模块.长远层框架名（ibatis）13v1.0可编写可更正长远层sqlmap：工程名.dbMap.业务子模块.数据库种类(mysql)业务逻辑接口：工程名.service.业务子模块业务逻辑实现：工程名.service.业务子模块.implWeb控制器action：com.工程名.业务子模块Web考据器：com.工程名.业务子模块Web过滤器：com.工程名.工具：工程名.util远程调用接口实现：工程名.业务子模块.impl5.3类、接口命名类命名基根源

19、则：首字母大写，多个单词的首字母大写接口命名基根源则：以大写字母I开头，若是有多个单词，每个单词头字母大写I数据对象：数据库表名.javaDao接口：I+数据对象名+dao实现：数据对象名+Dao+框架名(Ibatis).javasqlmap：数据对象名.xml业务逻辑接口：I+数据对象名+业务逻辑实现：数据对象名+Webaction：domain名+Webvalidator：domain名+Dto：*远程调用接口：I+数据对象名+远程调用实现：数据对象名+14v1.0可编写可更正5.4变量和方法命名类变量、局部变量命名规范：变量名首字母必定小写，若是该变量名有多个单词组成，后边的单词首字母大写，单词与单词之间不要使用_做连接。类常量命名规范：所有字母大写，若是有多个单词组成，单词与单词之间以_分开。而且该变量必定是公共、静态、final种类。方法命名规范：方法名首字母必定小写，若是该变量名有多个单词组成，