技术架构规范

1引言

1.1目的

1.2通过对系统整体架构和技术规范的描述，为下一步大

规模设计开发提供基础和规范。

1.3对象与范围

项目管理人员，开发人员，测试人员。

1.4概述

系统一期，以实现功能为主，效率性能为辅，但设计兼顾未来性能的扩展，以减少

未来重构的工作量。

webapp按逻辑分为两层，第一层用户服务接入，第二层内部服务。第一层一建不分

模块，以二级目录形式表达不同模块，笫二层根据不同服务分模块，笫一层和笫二层之

间使用hessian通信。

第一层和第二层独立部署，第二层的不同模块也可以独立部署。

下一期考虑第一层分模块的二级域名独立部署，并实现单点登录。

webapp采用集群负载均衡，数据库采用负载均衡和读写分离，以满足一定的性能

需求。

文档描述了各层结构和模块使用的技术和框架,最后描述了开发的规范和用到的开

发工具。

2文档只是描述了一期的架构,

3系统架构图

一期系统架构如下

用户浏览器

!tt•

负载均衡，动静分离(nginx)

网络存储

:取

»ebAPP(bull)tfebAPP(bull)

--

Hcks:an

管理员浏览

邮件股务器」「后台管理系统

<bourse)

物流公司

A8系统

第三方网站

短信平台

银行,第三方支付

数据库读写分离，负载均衡(Amoeba)

4层次和模块

4.1前端负载均衡

4.1.1nginx是一个口碑很好的开源免费WEB服务器,

国内很多大型网站都转选nginx平台，比如腾讯,

豆瓣等。Nginx可以实现动静分离和webapp的负

载均衡。

4.1.2动静分离

动静分离可以很好得分担服务器的负载，有两种方式实现动静分离。

1.使用2级域名，配置专门的静态文献服务器。

2.运用nginx的url转发功能，把静态请求转发到静态服务器或在nginx本地解决,

动态请求转发到应用服务器。

我们目前部署上采用第二种方式，同时也实现第一种方式。系统可以配置动态服务

器地址和静态服务器地址，在生成页面时获取这两个地址，对图片、js脚本、css和静态

页面使用静态配置生成url,对ajax请求和动态页面使用动态服务器地址生成urL

4.1.3负载均衡

nginx可以配置upstream服务器组，实现组内的负载均衡。通过ip_hash的方式把

动态请求转发到组内的某台服务器，同时保证客户端在IP不变的情况下一直访问同一

台服务器，解决session保持问题。

4.2Webapp

4.2.1网站前端，基于j2ee,spring框架开发。

4.2.2页面展示和控制

系统有三种页面方式，

1.动态同步请求，通过velocity模板生成页面，客户端刷新整个页面。

2.ajax异步请求：）Ajax异步请求又有三种形式：与velocity模板结合返回html串:

返回json格式；直接返I可简朴的字符串。

3.模板生成的纯静态页面

1.前台页面采用的框架和第三方技术有：

2.jquery-core（事件解决,ajax请求，页面刷新...）。

3.Jqzoom（图片放大器）

3.Jquery-validator（输入验证）

4.2.3权限安全控制

使用apacheshiro框架实现权限控制。Shir。是一个强大、使用简朴的权限安全框架。

同时Shiro也能与cas单点登录整合，方便在下一期扩展多个应用模块。

框架把权限系统提成subject（当前用户）,manager（管理所有用户），realms（权限数据）三层。

支持基于实际资源和基于角色的权限校验，同时

我们扩展shiro的UsernamePasswordToken,Realm实现基于验证码和数据库用户密码的

用户登录验证。

在过滤器层，我们暂时只使用shir。的3种类型过滤器控制访问：

1.AnonymousFilter匿名过滤器件何人可以访问。

2.AuthenticatingFilter认证过滤器必须通过身份认真才干访问（跳转到登录页

面）。

可以对当前subject直接调用方法完毕判断是否登录，登录，注销等操作，方便对•登

录功能的扩展。

4.2.4控制器层

采用spring基于注解的控制器，控制器支持velocity视图返【可，ajaxjson返1可和ajaxtext

返回。

4.2.5数据验证

使用和扩展apache的common-validator。

4.2.6逻辑层

采用spring基于注解的事务控制。

4.2.7数据持久层

采用ibatis框架，基于sqlmap配置实现数据的读写,sqlmap配置可以控制底层sql语句，便于

数据库的调优。

4.2.8缓存的解决

1.使用缓存可以减少与数据库的交互次数，极大提高系统性能。我们采用ehcache缓

存框架。用到两种缓存方式：

页面缓存：直接在过滤器层对页面进行缓存解决，在过滤器层就可以返回缓存的页面,

不用转到控制器去解决。对于页面比较复杂，调用业务逻辑比较多的页面，采用页面缓

存效果很好，比如首页。

基于注解的方法缓存，可以对方法的返回值缓存，存入的参数可以组成key。可以在逻

辑层使用缓存，也可以在持久层试用。对于请求简朴，访问量大，但修改频率比较低的

数据进行缓存可以达成很好的效果。比如商品分类，系统数据字典，地区等数据。

Ehcache支持分布式缓存,ehcache支持服务器之间通过rmi调用保持所有服务器之间缓

存同步。

1.缓存的两种过期机制：

定期过期，直接通过ehcache的配置拟定缓存过期频率。

积极告知，管理员在后台系统进行某些操作后，通过hessian远程调用告知应用

服务器缓存过期。只需告知一台应用服务器，应用服务器之间通过ehcache自

带分布式缓存复制方式同步缓存。

后台管理系统可以提供刷新缓存功能，管理员在后台管理系统积极刷新缓存。

4.2.9去其他模块之间的通信

通过hessian远程调用框架，实现与其他模块功能之间的通信。

Hessian是一个基于http的一进制远程过程调用框架，比webservice更高效。与Spring

框架很好结合，开发筒朴。

4.3后台管理系统

管理员用来维护网站的系统。基于j2eespring框架。与网站前台使用到的技术差不多,

现只介绍不同点：

4.3.1页面的展示

大部分请求采用页面刷新的机制。

4.3.2头部，中部左侧菜单和底部固定不变。中部右侧

iframe为主操作区，每次操作刷新页面。

4.3.3商品描述的编辑需要使用到富文本编辑器，我

们采用开源的TinyMCE,TinyMCE在国内应用比较

广泛。

4.3.4缓存机制

后台系统访问不是很频繁，同事管理员需要的是实时的数据，所以后台管理系统不

对数据进行缓存。

4.3.5权限管理

采用spingsecurity框架进行权限的控制，基于用户、角色和资源的授权机制。

支付模块：

支付模块重要功能是订单的管理，与银行等支付系统的交互。基于j2eespring框架。采

用springmvc模式。

4.3.6与银行和其他支付系统的交互

需要提供一个Url地址，供银行在用户完毕支付后回调，告知系统已经支付成功。

4.3.7与内部模块之间的通信

重要来自网站前端的调用。基于hessian机制。

4.4物流模块

支付模块目前重要功能是调用物流公司的接口跟踪物流状态，随着系统的不断发展，在

拥有自己的物流后，也许发展成一个庞大的系统。基于j2eespring框架。采用springmvc

模式。基于hessian机制对外提供远程效用服务。

4.5邮件模块

邮件模块重要用来向客户发送邮件。基于j2eespring框架。采用springmvc模式。

4.5.1邮件发送

4.5.2使用javamail包发送邮件，支持以固定模板发

送邮件。

4.5.3定期发送

使用spring+quartz框架实现定期任务发送邮件。

4.5.4与内部模块之间的通信

为网站前端和后台管理系统提供远程调用服务。基于hessian机制。

4.6短信模块

短信模块重要用来向客户发送短信。基于j2eespring框架。采用springmvc模式。

4.6.1邮件发送

调用短信设备api发送短信，支持以固定模板发送短信。

4.6.2定期发送

使用spring+quartz框架实现定期任务发送短信。

4.6.3与内部模块之间的通信

为网站前端和后台管理系统提供远程调用服务。基于hessian机制。

4.7进销存模块

调用A8系统接口,实现库存的管理。基于j2eespring框架。采用springmvc模式。

4.7.1Webservice调用

采用spring+xfile框架调用a8系统webserviceo

4.7.2与内部模块之间的通信

为网站前端和后台管理系统提供远程调用服务。基于hessian机制。

4.8搜索模块

为网站提供搜索服务，涉及商品检索和问答式搜索的问题检索。基于j2eespring枉架。

采用springmvc模式。

4.8.1检索框架

我们使用国产开源coreSeek搜索引擎，基于俄国开源项目Sphinx研发并独立开发

的搜索引擎。自带中文分词器mmseg,有大量中文文档。提供JAVAAPI。索引建立效率

高并且与业务无关。在国内有大量成功案例。

4.8.2与内部模块之间的通信

为网站前端提供远程调用服务。基于hessian机制。

4.9第三方服务调用模块

调用第三方合作服务商的接口。基于j2eespring框架。采用springmvc模式。

4.9.1Webservice调用

采用spring+xfile框架调用第三方服务webservice。

4.9.2与内部模块之间的通信

为网站前端和后台管理系统提供远程调用服务。基于hessian机制。

4.10对外服务接口

对外部系统提供web$ervice接口服务

4.10.1Webservice月艮务

采用spring+xfile框架对外提供webservice服务。

4.10.2与内部模块之间的通信

调用内部其他模块的服务。基于hessian机制。

4.11数据库

4.11.1使用mysql5.5数据库存储数据，并使用读写分

离机制提高数据库性能。

4.11.2数据库读写分离

我们使用开源的mysql代理Amoeba实现数据库的读写分离，把写请求发送到主服务器,

读请求发送到从服务器，主从之间通过mysql自带的复制机制实现数据的同步。

4.11.3数据库负载均衡

4.11.4Amoeba支持轮询和权重两种负载均衡机制，我

们使用权重负载机制实现读服务器的负载均衡。

4.11.5数据库表引擎的选择

主服务器必须使用innodb支持事务的存储引擎，行级锁表。而从服务器可以考虑使用

myisam引擎，不支持事务，表级锁表，具有更高的读写效率，但不支持外键。

4.11.6主从数据库的差异优化

5主服务器只需要建立唯一索引和外键约

束，其它针对对查询优化的索引可以不建

立，这要可以提高主服务器的性能。

6从服务器字段使用char而不用varchar,

没有varchar,text,blob字段的表是静态表,

反之是动态表，静态表的检索效率要比动

态表好若干倍。

7工程命名

工程以动物命名，结合了各种动物特性与我们各工程的职责：

公共接口工具magpie（喜鹊）

网站前台服务bull（公牛）

物流cheetah（猎豹）

支付lion（狮子）

进销存接口fox（狐狸）

搜索dog（狗）

邮件eagle（鹰）

短信pigeon（鸽子）

后台管理horse（马）

调用第三方合作接口mouse（老鼠）

对外服务接I」camel（骆驼）

8工程规范

8.1工程目录结构

src源码

WebContent

WEN-INF

libjar包

config配置文献

views视图模板

layout布局模板

screen页面模板

...各模块

common公共的

styles样式文献

resources资源又献

scriptsjs文献

common公共js

各模块，各开源js项目

8.2包结构

8.2.1包命名基本原则：小写字母开头，假如有多个单

词，除第一个单词之外的单词首字母大写

8.2.2公共工具接口工程

公共工具：mon.util

各层的公共基类:mon下的各子包

远程调用公共dto:com.zjdelai.emall.提供服务的工程名demoting.dto.业务了,模块

远程调用公共接口：com.zjdelai.emall.提供服务的工程名.erfaces.业务子模块

8.2.3第三方开源包的扩展：

com.zjdelai.email.common.第三方开源包名

8.2.4各模块工程

数据对象:com.zjdelai.emall.工程名.domain.业务子模块

持久层dao接口：ccm.delai.emall.工程名.dao.业务子模块

持久层dao接口实现：com.zjdelai.emall.工程名.dao.业务子模块.持久层框架名(ibatis)

持久层sqlmap:com.zjdelai.emall.工程名.dbMap业务子模块.数据库类型(mysql)

业务逻辑接口：comzjdelai.email.工程名.service.业务子模块

业务逻辑实现：com.zjdelai.emall.工程名.service.业务子模块.impl

Web控制器.zjdelai.email.工程名.web.action.业务子模.

Web验证器:com.zjdelai.email.工程名.web.validator.业务子模.

Web过滤器:com.zjdelai.emall.匚程名.web.filter

工具:com.zjdelai.emall.工程名.util

远程调用接口实现；com.zjdelai.email.工程名.erfaces.业务子模块.impl

8.3类、接口命名

类命名基本原则：首字母大写，多个单词的首字母大写

接口命名基本原则：以大写字母叩开头，假如有多人单词，每个单词头字母大写।

数据对象：数据库表名.java

Dao接口：1+数据对象名+Dao.java

dao实现：数据对象名+Dao+框架名(Ibatis).java

sqlmap:数据对象名.xml

业务逻辑接口：1+数据对象名+Manager.java

业务逻辑实现：数据对象名+Managerlmpl.java

Webaction:domain名+Action.java

Webvalidator:domain名+Validator.java

Dto:***Dto.java

远程调用接口：1+数据对象名+Sercice.java

远程调用实现：数据对象名+Sercicelmpl.java

8.4变量和方法命名

类变量、局部变量命名规范：

变量名首字母必须小写，假如该变量名有多个单词组成，后面的单词首字母大写，单词与单

词之间不要使用做连接。

类常量命名规范：

所有字母大写，假如有多个单词组成，单词与单词之间以隔开。并且该变量必须是公共、

静态、final类型。

方法命名规范:

方法名首字母必须小写，假如该变量名有多个单词组成，后面的单词首字母大写，单词与单

词之间不要使用［'做连接。

方法参数名命名规范：

参数名首字母必须小写，假如该变量名有多个单词组成，后面的单词首字母大写，单词与单

词之间不要使用做连接。

8.5注释

8.5.1