技术架构规范标准Word格式文档下载.docx
《技术架构规范标准Word格式文档下载.docx》由会员分享,可在线阅读,更多相关《技术架构规范标准Word格式文档下载.docx(12页珍藏版)》请在冰豆网上搜索。
前端,基于j2ee,spring框架开发。
3.2.1页面展示和控制
系统有三种页而方式。
1.动态同步请求,通过velocity模板生成页而,客户端刷新整个页而。
2.ajax异步请求。
Ajax异步请求又有三种形式:
与velocity模板结合返回html串;
返回json格式:
直接返回简单的字符串。
3.模板生成的纯静态页面
前台页面采用的框架和第三方技术有:
1・jquery-core(事件处理,ajax请求,页而刷新)。
2.Jqzoom(图片放大器)
3.Jquery-validator(输入验证)
3.2.2权限安全控制
使用apacheshiro框架实现权限控制。
Shiro是一个强大、使用简单的权限安全框架。
同时Shiro也能与cas单点登录整合,方便在下一期扩展多个应用模块。
框架把权限系统分成subject(当前用户),manager(管理所有用户),realms(权限数据)三层。
支持基于实际资源和基于角色的权限校验,同时
我们扩展shiro的UsernamePasswordToken,Realm实现基于验证码和数据库用户密码的用户登录验证。
在过滤器层,我们暂时只使用shiro的3种类型过滤器控制访问:
1.AnonymousFilter匿名过滤器任何人可以访问。
2.AuthenticatingFilter认证过滤器必须通过身份认真才能访问(跳转到登录页面
可以对当前subject直接调用方法完成判断是否登录,登录,注销等操作,方便对登录功能的扩展。
3.2.3控制器层
采用spring基于注解的控制器,控制器支持velocity视图返回,ajaxjson返回和ajaxtext返回。
3.2.4数据验证
使用和扩展apache的common-validatoro
3.2.5逻辑层
采用spring基于注解的事务控制。
3.2.6数据持久层
采用ibatis框架,基于sqlmap配置实现数据的读写,sqlmap配置可以控制底层sql语句,便于数据库的调优。
3.2.7缓存的处理
使用缓存可以降低与数据库的交互次数,极大提髙系统性能。
我们采用ehcache缓存框架。
用到两种缓存方式:
1.页而缓存:
直接在过滤器层对页面进行缓存处理,在过滤器层就可以返回缓存的页而,不用转到控制器去处理。
对于页而比较复杂,调用业务逻辑比较多的页而,采用页而缓存效果很好,比如首页。
2.基于注解的方法缓存,可以对方法的返回值缓存,存入的参数可以组成key.可以在逻辑层使用缓存,也可以在持久层试用。
对于请求简单,访问量大,但修改频率比较低的数据进行缓存可以达到很好的效果。
比如商品分类,系统数据字典,地区等数据。
Ehcache支持分布式缓存,ehcache支持服务器之间通过rmi调用保持所有服务器之间缓存同步。
缓存的两种过期机制:
1.定时过期,直接通过ehcache的配置确定缓存过期频率。
2.主动通知,管理员在后台系统进行某些操作后,通过hessian远程调用通知应用服务器缓存过期。
只需通知一台应用服务器,应用服务器之间通过ehcache自带分布式缓存复制方式同步缓存。
后台管理系统可以提供刷新缓存功能,管理员在后台管理系统主动刷新缓存。
3.2.8去其他模块之间的通信
通过hessian远程调用框架,实现与其他模块功能之间的通信。
Hessian是一个基于http的二进制远程过程调用框架,比webservice更髙效。
-与Spring框架很好结合,开发简单。
3.3后台管理系统
管理员用来维护的系统。
基于J2eespring框架。
与前台使用到的技术差不多,现只介绍不同点:
33.1页面的展示
大部分请求采用页而刷新的机制。
头部,中部左侧菜单和底部固左不变。
中部右侧iframe为主操作区,每次操作刷新页商品描述的编辑需要使用到富文本编辑器,我们采用开源的TinyMCE,TinyMCE在国应用比较广泛。
3.3.2缓存机制
后台系统访问不是很频繁,同事管理员需要的是实时的数据,所以后台管理系统不
对数据进行缓存。
3.3.3权限管理
采用spingsecurity框架进行权限的控制,基于用户、角色和资源的授权机制。
3.4支付模块:
支付模块主要功能是订单的管理,与银行等支付系统的交互。
基于j2eespring框架。
采用springmvc模式。
3.4.1与银行和其他支付系统的交互
需要提供一个Url地址,供银行在用户完成支付后回调,通知系统已经支付成功。
3.4.2与部模块之间的通信
主要来自前端的调用。
基于hessian机制。
3.5物流模块
支付模块目前主要功能是调用物流公司的接口跟踪物流状态,随着系统的不断发展,在拥有自己的物流后,可能发展成一个庞大的系统。
采用springmvc模式。
基于hessian机制对外提供远程效用服务。
3.6模块
模块主要用来向客户发送。
基Tj2eespring框架。
采用springmvc模式。
3.6.1发送
使用javamail包发送,支持以固迫模板发送。
3.6.2定时发送
使用spring+quartz框架实现定时任务发送。
363与部模块之间的通信
为前端和后台管理系统提供远程调用服务。
3.7短信模块
短信模块主要用来向客户发送短信。
3.7.1发送
调用短信设备api发送短信,支持以固左模板发送短信。
3.7.2定时发送
使用spring+quartz框架实现定时任务发送短信。
3.73与部模块之间的通信
3.8进销存模块
调用A8系统接口,实现库存的管理。
釆用springmvc模式。
3.8.1Webservice调用
采用spring+xfile框架调用a8系统webservicec
3.8.2与部模块之间的通信
3.9搜索模块
为提供搜索服务。
包括商品检索和问答式搜索的问题检索。
采用springmvc模式。
3.9.1检索框架
我们使用国产开源coreSeek搜索引擎,基于俄国开源项目Sphinx研发并独立开发的搜索引擎。
自带中文分词器mmseg,有大量中文文档。
提供JAVAAPL索引建立效率高并且与业务无关。
在国有大量成功案例。
3.9.2与部模块之间的通信
为前端提供远程调用服务。
3.10第三方服务调用模块
调用第三方合作服务商的接口。
采用spring+xfile框架调用第三方服务webservice©
3.10.2与部模块之间的通信
3.11对外服务接口
对外部系统提供webservice接「1服务
3.11.1Webservice服务
釆用spring+xfile框架对外提供webservice服务。
3.11.2与部模块之间的通信
调用部其他模块的服务。
3.12数据库
使用mysql5.5数据库存储数据,并使用读写分离机制提高数据库性能。
3・12・1数据库读写分离
我们使用开源的mysql代理Amoeba实现数据库的读写分离,把写请求发送到主服务器,读请求发送到从服务器,主从之间通过mysql自带的复制机制实现数据的同步。
3・12・2数据库负载均衡
Amoeba支持轮询和权重两种负载均衡机制,我们使用权重负载机制实现读服务器的负
载均衡。
3・12・3数据库表引擎的选择
主服务器必须使用innodb支持事务的存储引擎,行级锁表。
而从服务器可以考虑使用myisam引擎,不支持事务,表级锁表,具有更髙的读写效率,但不支持外键。
3・12・4主从数据库的差异优化
主服务器只需要建立唯一索引和外键约束,其它针对对查询优化的索引可以不建立,这要可以提高主服务器的性能。
从服务器字段使用char而不用varchar,没有varchar,text,blob字段的表是静态表,反之是动态表,静态表的检索效率要比动态表好若干倍。
4工程命名
工程以动物命名,结合了各种动物特征与我们各工程的职责:
公共接口工具magpie(喜鹊)
前台服务bull(公牛)
物流cheetah(猎豹)
支付lion(狮子)
进销存接口fox(狐狸)
搜索dog(狗)
eagle(鹰)
短信pigeon(鸽子)
后台管理horse(马)
调用第三方合作接口mousef老鼠)
对外服务接口camel(骆驼)
5工程规
5.1工程目录结构
src源码
WebContent
WEN-INF
libjar包config配置文件
views视图模板
layout布局模板
screen页面模板
……各模块common公共的
styles样式文件
resources资源文件scriptsjs文件
common公共js
……各模块,各开源js项目
5.2包结构
包命名基本原则:
小写字母开头,如果有多个单词,除第一个单词之外的单词首字母大写
5.2.1公共工具接口工程
公共匸具:
・mon.util
各层的公共基类:
mon卜的各子包
远程调用公共dto:
.zjdelai.emall.提供服务的工程名.remoting.dto.业务子模块
远程调用公共接口:
.zjdelai.emall.提供服务的工程名.remoting.interfaces.业务子模块
第三方开源包的扩展:
mon.第三方开源包名
5.2.2各模块工程
数据对象:
.zjdelai.email•匸程劣.domain.业务子模块
持久层dao接口:
.delai.email.T程名・dao•业务子模块
持久层dao接「1实现:
.zjdelai.emall.11程名.dao.业务子模块.持久层框架名(ibatis)
持久层sqlmap:
.zjdelai.emall.T程需.dbMap.业务子模块.数据库类型(mysql)
业务逻辑接口:
.zjdelai.emall.T程名.service.业务子模块
业务逻辑实现:
.zjdelai.emall.K程名.service.业务子模块・impl
Web控制器action:
・zjdelai.emall.II程名.web.action.ilk务子模块
Web验证器:
.zjdelai.emall.E程名.web.validator.业务子模块
Web过滤器:
.zjdelai.emall.E程名.web.filter
工具:
.zjdelai.emall.K程名.util
远程调用接口实现:
.zjdelai.email•匸程名.remoting.interfaces.业务子模块・impl
5.3类、接口命名
类命名基本原则:
首字母大写,多个单词的首字母大写
接口命需基本原则:
以大写字母T开头,如果有多个单词,每个单词头字母大写I
数据库表划.java
Dao接口:
1+数据对象名+Dao.java
dao实现:
数据对象名+Dao+框架名(Ibatis).java
sqlmap:
数据对象名・xml
业务逻辑接口:
1+数据对象^i+Manager.java
数据对象^+Managerlmpl.java
Webaction:
domain名+Action.java
Webvalidator:
domain4^+Validator.java
Dto:
***Dto.java
远程调用接口:
1+数据对象名+Sercice.java
远程调用实现:
数据对象^+Sercicelmpl.java
5.4变量和方法命名
类变量、局部变量命爼规:
变量名首字母必须小写,如果该变量名有多个单词组成,后面的单词首字母大写,单词与单词之间不要使用做连接。
类常量命需规:
所有字母大写,如果有多个单词组成,单词与单词之间以'
一’隔开。
而且该变呈:
必须是公共、静态、final类型。
方法命名规:
方法名首字母必须小写,如果该变量名有多个单词组成,后面的单词首字母大写,单词与单词之间不要使用做连接。
方法参数需命名规:
参数名首字母必须小写,如果该变量划有多个单词组成,后面的单词首字母大写,单词与单词之间不要使用'
‘做连接。
5.5注释
类、接口必须要有注释。
描述类、接口的功能,作者,版本,最近修改时间。
类的注释必须写在该类的声明语法之前。
在注释中要描述该类的基本作用,作者,日期.版本。
/♦*
*XXXX功能类
♦
*authorXXX
*versionX.X.X修改时间作者
5.5.2类、接口的变量和常量注
类、接口的变量和常量必须有注释,变量和常量注释必须写在变量和常量左义之前,简单描述其代表的意义。
♦XXXXXX
*/
5.53类、接口方法注释
方法必须要有注释,方法注释必须写在方法左义之前。
该注释包括:
方法苴功能的简单描述,方法的参数、返回值类型、返回值意义简单的描述,跑出异常描述
/**
*XXXXXX功能
*param
*return
*throws
aa参数的意义bb参数的意义返回类型返回的意义
XXXX异常
逻辑代码必须注释。
每个条件判断和每个循环都需要有注释。
其它关键代码也需要注释
*当XXXX的时候xxxx
lf(){
♦循环xxxx
for(){
*xxxxxx
程序代码
6开发环境和工具
JDK1.6
Eclipse3.7
Jboss5.1.0
Mysql5.5
7部署环境
RedHatEnterpriseLinuxServerrelease5JDK1.6
Amoebaformysql