校园C2C系统详细设计说明

山东农业大学

掌中校园C2c系统

详细设计说明书

ProceduralDesignSpecification

编写：董健兴

校对：于梦

审核：

批准：

开发单位：山东农业大学一Perfect

项目负责人：董建兴

目录

—.引言4

1.1编写目的4

1.2.项目背景4

1.3定义4

1.4.参考资料4

二.程序系统的结构6

三.WEB端程序设计说明7

派消费者web端模块7

3.1程序描述7

3.2功能7

3.3性能8

3.4输入项8

3.5输出项8

3.6算法8

♦验证码生成算法9

♦HTML字符转换算法11

♦图片转换成byte数组，并且获取表单元素算法II

3.7程序逻辑13

♦登录模块14

♦创建商店15

3.8接口17

3.9存储分配17

3.10.设计规则与约束条件17

3.11测试计划18

四.J2ME端程序设计说明18

派消费者手机端18

4.1程序描述18

4.2.功能18

4.3.性能19

4.4.输入项20

4.5输出项20

4.6算法20

4.7程序逻辑24

♦用户手机端登录模块24

♦用户手机端修改信息模块26

♦用户手机端购买模块27

♦用户手机端发布商品模块29

♦管理模块30

♦管理员审核模块31

4.8接口31

4.9存储分配31

4.10.限制条件32

4.11测试计划32

五服务器端程序设计说明32

5.1程序描述32

5.1.1开发环境32

5.1.2应用程序模型33

持久层33

逻辑层33

表示层33

5.1.3域模型设计33

数据库表结构的生成35

5.1.4持久层的设计35

5.1.5逻辑层设计36

5.1.5全文搜索37

全文搜索简介37

集成Compass37

实现全文搜索37

5.1.6发送E-mail37

配置川S37

JavaMail37

5.1.7发布web月艮务38

web服务38

XFire38

5.2功能38

5.3性能38

5.4输入项38

5.5输出项39

5.6算法39

5.7程序逻辑39

5.8接口39

5.9存储分配40

5.10限制条件40

5.11测试计划40

引言

1.1编写目的

该详细设计说明书在概要设计的基础上详细说明了C2C系统的各个模块的功

能、所要达到的性能以及运行预期效果以便开发小组各个成员明确了解该软件各个

子系统的具体功能分工和实现。同时也为大赛评委了解系统整体设计构思提供依据。

预期读者：指导老师，大赛评委，团队成员，该系统用户

1.2.项目背景

系统名称：掌中校园C2c系统

开发者：山东农业大学Perfect团队

面向用户：

①需要获取商品信息，进行购买的在校消费者；

②需要扩大校园潜在消费者的商户；

③需要发布商品信息的校园消费者

1.3定义

C2C：customertocustomer,即商品和信息从消费者直接到消费者。

1.4.参考资料

1、《软件需求说明书(GB8567-88)》

2、大赛题目设置：《基于WebServices的掌上应用系统》

3、参考书籍：

《JavaME使用详解-用Eclipes进行移动开发》刘斌编著。北京：电子工业出

版社,2007.2;

《JavaME核心技术与最佳实践》詹建飞著。北京：电子工业出版社，2007.1；

《大话设计模式》程杰著。北京：清华大学出版社，2007.12；

《WebService基础教程》蔡月茹、柳西玲等著；北京：清华大学出版社，2005；

<WebSerices原理与研发实践》刘家茂、柴晓路著。北京：机械工业出版社,

2007.9；

《Spring2.0核心技术开发与最佳实践》廖雪峰著。北京：电子工业出版社,

2007.7;

《SpringinAction（第二版）中文版》沃尔斯（美）布雷登巴赫（美）著,

毕庆红等译。北京：人民邮电出版社，2008.10；

网上资料及教程

二.程序系统的结构

三.WEB端程序设计说明

X消费者web端模块

3.1程序描述

3.2功能

功能类别功能名称、标识符描述

校外商家，商家通过填写个人信息，上传身

份证复印件来注册，并向系统管理员提交请

求，管理员通过比对信息，来判断是否允许

商户注册用户通过，以获得程序的接入权限。商家注

册完成，并且通过管理员的审核以后，可以

摭有创建网上商店，上传商品等功能，宣传

注册

自己的商店、商品，提高自己的经济效益

学生，学生通过提交自己的真是信息，以及

上传校园卡影像来实现注册。注册后学生可

学生注册以在网上实现网上交易（网上下订单，面对

面交易）。也可以在网上浏览商品，获取自己

有用的信息

对用户输入的用户名、密码、验证码进行验

用户登录用户登录证，只有登录用户才能使用程序的功能。

登录后登陆信息将保存在服务器session中。

查找商品应该可以按照商品的各个属性查找

查找商品支持查找条件的复合，为用户提供尽可能多

的选择

查找功能

杳找商店也应该可以按照商品的各个属性查

查找商店找支持查找条件的复合，为用户提供尽可能

多的选择

用户在浏览商品的时候，可以根据自己的购

买经验对商品的实用性，性价比，质量优劣，

商品评论

信誉程度等信息作出评价，评价可以作为其

评论他消费者购买的参考

当用户查看商店的时候，同样可以对商店的

商店评论做出自己的评价，系统管理员管理评论，对

了评论较差的商店，作出相应的处理

功能类别功能名称、标识符描述

用户通过选中商品填写订单提交口己的购物

请求，并可随时查看已发订单的状态（等待

商品购买订单

中、商户忽略，正在处理、处理完成）。系统

将订单转给商品所有者等待其进•步处理。

学生创建的商店不需要再进行审核，只要学

学生创建商店生的注册信息审核完成以后，他就有创建商

店的权限

创建商店

商户创建商店需要上传经营许可证，商店的

商户创建商店门头照，并且需要经过管理员审核后才能对

该商店进行下一步操作

用户建立商店之后，可以上传商品到商店，

上传商品上传商品商品的信息包括商品的名称数量等基本属性

以及商品的图片信息

3.3性能

3.4输入项

Web页面用使用了大量的表单，如果只是使用服务器端验证必定会加大服务器的

服务器负担。所以，程序应该采用客户端与服务器验证相结合的方式进行验证。

3.5输出项

系统错误要打印日志；

用户错误给出合理提示，人性化设计。

3.6算法

♦验证码生成算法

Bufferedlmagebufflmg=newBufferedlmage(width,height,

BufferedImage.TYPE_INT_RGB);

Graphics2Dg=bufflmg.createGraphics();

Randomrandom=newRandom();

g.setColor(Color.WHITE);

g.fillRect(O,0,width,height);

//设置字体

Fontfont=newFont("TimesNewRoman",Font.BOLD,20);

g.setFont(font);

//画边框

g.setColor(Color.GRAY);

g.drawRect(0,0,width-1,height-1);

g.setColor(Color.GRAY);

//随机产生干扰线

for(inti=0;i<50;i++){

intx=random.nextlnt(width);

inty=random.nextlnt(height);

intxl=random.nextlnt(2);

intyl=random.nextlnt(2);

g.drawLine(x,y,x+xl,y+yl);

)

//数字字母集合

char[]numbersAndLettersStore=

(H0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHUKLMNOPQRSTUVWXYZH)

.toCharArrayO;

StringrandomCode=,n,;

intred=0,green=0,blue=0;

for(inti=0;i<4;i++){

red=random.nextlnt(255);

green=random.nextlnt(255);

blue=random.nextlnt(255);

g.setColor(newColor(red,green,blue));

Stringtem=String.valueOf(numbersAndLettersStore[random

.nextlnt(62)]);

randomCode+=tem;

g.drawString(tem,15*i+16,17);

)

//验证码保存到Session范围

HttpSessionsession=req.getSession();

session.setAttribute(ncoden,randomCode.toStringO);

System.out.println(Hservlet里显示验证码：H+randomCode.toString());

//禁止缓存

resp.setHeader(nPraman,"no-cache");

resp.setHeaderC^oche-Control",nno-cachen);

resp.setDateHeader(nExpires'\0);

resp.setContentType(nimage/jpegn);

//将图像输出到

ServletOutputStreamsos=resp.getOutputStream();

ImageIO.write(bufflmg,njpegn,sos);

sos.close();

♦HTML字符转换算法

publicstaticStringHTMLChange(Stringsource){

StringchangeStr=,n,;

changeStr=source.replaceAll(n&',,n&");

changeStr=changeStr.replaceAll(nn,n n);

changeStr=changeStr.replaceAll("v”J<”)；

changeStr=changeStr.replaceAll(H>°">H);

changeStr=changeStr.replaceAH(,,\r\n,,,,,<br>");

returnchangeStr;

)

publicstaticStringlextAreaChange(Stringsource){

StringchangeStr=,n,;

changeStr=source.replaceAll(',<br>,,,',\nn);

returnchangeStr;

♦图片转换成byte数组，并且获取表单元素算法

while(it.hasNext())

Fileitemfl=(Fileltem)it.next();〃类型转换

if(fi.isFormField())

{〃判断该Fileitem对象是否是一个普通表单类型

try(

Stringname=fi.getFieldName();〃得到普通表单类型的表单名

Stringcontent=fi.getString("UTF-8");〃用指定编码得到普通表单

的值

System.out.println("formField,Name:"+name+''的值为:"+content);

if(name!=null&&content!=null)

map.put(name,content);

}catch(UnsupportedEncodingExceptione){

//TODOAuto-generatedcatchblock

e.printStackTrace();

}

}

else

(

try(

StringpathStr=fi.getName。;//得到文件表单的值，就是用户本地

的文件路径

〃如果文件表单为空，则不处理

if(pathStr.trim().equals(',n))

(

continue;

picByte=fi.get();〃fi.write(pathDest);〃写文件

catch(Exceptione)

e.printStackTrace();

returnnull;

finally{〃立即删除保存表单字段内容的临时文件

fi.delete();

formlnfo.setPicBytre(picByte);

formlnfo.setMap(map);

returnformInfo;

3.7程序逻辑

♦登录模块

♦创建商店

开始

3.8接口

3.9存储分配

3.10.设计规则与约束条件

方法命名规则

符合java命名规则

Package（包）的命名:采用完整的英文描述符，应该都是由小写字母组成。

Interface（接口）、Class（类）的命名：采用完整的英文描述符说明接口封装，所有

单词的第一个字母大写。通常由多个单词合成一个类名，要求每个单词的首字母也

要大写。

方法的命名：方法名的第一个单词应该是动词，大小写可混用，但首字母应小

写。在每个方法名内，大写字母将词分隔并限制使用下划线。参数的名字必须和变

量的命名规范一致。使用有意义的参数命名，如果可能的话，使用和要赋值的字段

--样的名字（这里方法命名和MyEclipse自动生成getter和setter一致）：

setCounter（intsize）｛

this.size=size;

）

避免长型名称（小于15个字符比较合适），巧妙节俭地使用缩写，将标准首

字母缩写词的第一个字母大写。

使用大小写混合增强名称的可读性。

属性（变量）的第一个字母要小写

避免名称过于相似或仅在大小写方面有区别

包结构

Com.cc2c.bean放javaBean

Com.cc2c.filter放置servlet

Com.cc2c.menu放置用于生成菜单的servlet

Com.cc2c.servlet主要的servlet

Com.cc2c.admin.servlet后台管理的servlet

Com.cc2c.serviceWebServie客户端

Com.cc2c.dao数据库操作类

Com.cc2c.monitor监视器类放置在这里

3.11测试计划

四.J2ME端程序设计说明

派消费者手机端

4.1程序描述

本程序为掌上设备（手机）开发是客户端的主要部分。提供掌上应用的所有功

能，可供多个用户同时使用。由于掌上设备的局限性，此部分不包含用户开店注册

功能。

4.2.功能

具体功能列表如下:

功能类别功能名称、标识符描述

对用户输入的用户名、密码进行验证，验证

用户登录用户登录通过后，该用户可以使用系统中分配到的权

限进行操作，否则拒绝使用。

功能类别功能名称、标识符描述

用户更新个人信息，包括资料图片、地址信

个人资料维护

息、登录密码、联系方式等

维护基本资料用户修改，删除，新增所开店铺的商品数据，

店铺信息更新系统根据用户的操作，对商品资料进行更新

或显示。

用户通过输入查询的关键字进行模糊查询。

模糊查询系统内部将执行相应的查询操作并显示结

果。

浏览查看

用户通过输入内容或选择动态得到的选项

高级查询（包括商品分类，价格区间的获得）等进行

精确的查询。

购物车用户可将浏览到的商品其放入购物车暂存。

用户通过选中商品填写订单提交自己的购物

商品购买请求，并可随时查看已发订单的状态（等待

订单

中、正在处理、处理完成）。系统将订单转给

商品所有者等待其进一步处理。

评论设定限制，只有买过此店铺商品的人才

对店铺评论有评论的权限。评论一旦产生只有管理员有

权限删除。

评论

用户可以针对某件商品进行评论或提问。评

对商品评论

论一旦产生只有管理员有权限删除。

对校内新闻评论用户可针对某条校内新闻发表自己的评论。

一般权限的用户即可发布广告性质的供求信

信息发布跳蚤市场

息，无需审核即可发布成功。

拥有系统维护权限的用户可以增加新用户，

维护用户资料并可以对用户的资料进行修改、删除以及查

询。

拥有权限管理的用户可以设定其他用户对软

处理举报及意见建议

件的访问权限。

系统维护

用户重新设定自己的密码

修改密码

拥有系统维护权限的用户可以批准店铺，并

维护店铺资料

可以对用户的资料进行修改、删除以及查询。

维护校内信息删除不合法或过时的信息

4.3.性能

1、正确性。业务逻辑错误不允许出现。

2、响应速度。WebService的调用及客户端的响应速度要在用户的忍耐范围之

内。

3、易用性。无需专门的学习即可使用

4、清晰性。业务流程明确。

5、可扩展性。能根据变更的需求，在现有系统基础之上改变扩充功能。

6、灵活性。服务器端可运行在大多数主流的操作平台之上。手机客户端满足

定型号的手机的使用。

4.4.输入项

基本数据类型的输入：输入项由用户的操作和选择实现，不同的输入项对输入

要求不同。如密码输入时必须安全显示；Email输入时必须符合Email基本格式；

电话号码输入时必须全为数字，长度不超过11个字符等。传输格式XML。

图片数据类型：用户提交个人信息时上传的图片资料，大小应控制在2M内。传

输格式XML。

4.5输出项

错误输出：对有用户操作引起的错误应通过提示框给出明确的提示。系统内部

错误抛出异常，应尽量显示错误原因。

基本数据类型输出：Customitem或Form上显示。

图片数据类型的输出：Canvas、Form或Customitem上显示

4.6算法

①图片放大缩小处理算法：

publicstaticImageZoomlmage(Imagesrc,intdesW,intdesH){

Imagedeslmg=null；

intsrcW=src.getWidth();//原始图像宽

intsrcH=src.getHeight();//原始图像高

int[]srcBuf=newint[srcW*srcH];//原始图片像素信息缓存

src.getRGB(srcBuf,0,srcW,0,0,srcW,srcH);

//计算插值表

int[]tabY=newint[desH];

int[]tabX=newint[desW];

intsb=0;

intdb=0;

inttems=0;

inttemd=0;

intdistance=srcH>desH?srcH:desH;

for(inti=0;i<=distance;i++){/*垂直方向

tabY[db]=sb;

tems+=srcH;

temd+=desH;

if(tems>distance){

tems-=distance;

sb++;

)

if(temd>distance){

temd-=distance;

db++;

)

)

sb=0;

db=0;

tems=0;

temd=0;

distance=srcW>desW?srcW:desW;

for(inti=0;i<=distance;i++){/*水平方向*/

tabX[db]=(short)sb;

terns+=srcW;

temd+=desW;

if(terns>distance){

terns-=distance;

sb++;

)

if(temd>distance){

temd-=distance;

db++;

)

)

//生成放大缩小后图形像素亚

int[]desBuf=newint[desW*desH];

intdx=0;

intdy=0;

intsy=0;

intoldy=-1;

for(inti=0;i<desH;i++){

if(oldy==tabY[i]){

System.arraycopy(desBufzdy-desW,desBufzdy,desW);

}else{

dx=0;

for(intj=0;j<desW;j++){

desBuf[dy+dx]=srcBuf[sy+tabX[j]];

dx++;

)

sy+=(tabY[i]-oldy)*srcW;

)

oldy=tabY[i];

dy+=desW;

)

//生成图片

deslmg=Image.createRGBImage(desBuffdesW,d㊀sH,false);

returndesImg;

}

②低级界面自动换行算法：

//设置低级界面的文木自动换行

publicstaticVectorgetSubsection(Stringstr,intCharacterNumber){

Vectorvector=newVector();

int;

while(!str.equals("")){

if(str.length()>CharacterNumber){

vector.addElement(str.substring(0,CharacterNumber));

str=str.substring(CharacterNumber);

)

else{

vector.addElement(str);

str=*'n;

)

)

returnvector;

4.7程序逻辑

♦用户手机端登录模块

♦用户手机端修改信息模块

♦用户手机端购买模块

♦用户手机端发布商品模块

♦管理模块

在管理员端的管理工作主要是对于被举报的，不合法的店铺、用户进行删除,

所以主要介绍一下删除功能的实现

♦管理员审核模块

4.8接口

参见《掌上校园C2c概要设计说明》提供的接口。

4.9存储分配

J2ME客户端和Web客户端共用一个数据库。

4.10.限制条件

1、图片大小应控制，并对图片分辨率进行限制。

2、输入数据限定为基本数据类型，故开店注册不宜在此实现。

3、由于掌上设备的局限性对系统运行占用的内存和存储空间有一定要求。

4、在手机端为避免信息读取不全，手机硬件不够等客观因素造成管理员管理失当，

所以只有简单的删除管理和审核管理，让手机端的管理权限有局限性。

4.11测试计划

1、本部分测试时输入的数据应为基本数据类型，输出的数据在手机屏幕显示。

2、测试应当用真机作为测试设备，检测系统运行内存占用情况和运行速度，尽量贴

近实际。

3、输入的数据要能代表一般性又不乏特殊性。

4、J2ME客户端实现的方法都要用数据进行测试。

5、链接WebService时用本地PC机作为服务器。

五服务器端程序设计说明

5.1程序描述

5.1.1开发环境

本程序是服务器端逻辑层以及控制层开发，部署在服务器上，构建系统框架提供通

用接口发布web服务。程序使用spring2.0+hibernate3.2+JDK5.0+MySql5配置开发环境，

使用ant作为项目的构建工具，XDolet自动生成配置文件。

5.1.2应用程序模型

采用三层应用程序模型，数据库、SpringloC容器部署持久层逻辑层以及表示层，一

方面集成XFire开发web服务，另一方面使用浏览器显示管理员的基本操作。

持久层

持久层负责实现所有数据的访问功能，他将上层传入的数据写入到持久化的存储系

统中，并根据上层的要求读取或者修改现有的数据。数据库映射采用对象-关系映射

(0/RMapping)的方案，采用hibernate构建ORM系统。

逻辑层

逻辑层负责完成应用程序的逻辑功能，包括调用持久层完成实体对象的存取、安全

检查、事务控制等。抽象出逻辑层的好处是讲应用程序的逻辑功能产品那个表示层中

剥离，这样就能服用逻辑层的功能。这样增加一个新的应用程序接口比如web服务不

会影响到表示层。此外，逻辑层也可以看作是对持久层的一个门面模式，简化表示层

对这些逻辑功能的调用。

表示层

表示层是与用户打交道的UI界面。在此我们开发出web服务与其他已存在的用户系

统相结合，同时我们开发出管理员管理界面，采用spring的MVC模式，采用C/S结构

浏览器访问相应的站点。

5.1.3域模型设计

传统的应用程序是先设计完成数据库的表结构然后根据表的结构设计应用程序中持

有数据的对象，这种设计方式本质中仍是以关系数据库为基础，不符合面向对象的设

计方式如图.1.

在本系统中我们从域模型入手，首先设计域对象的模型，并确定其关联模式，然后

通过Hibernate提供的DDL工具，自动地将域模型映射为数据库的表结构，这种方式

符合面向对象的设计方式，而且更容易建立UML模型，如图5.1.2。

JavaBean

数据库表结构,hbm配置文件

图5.5.11图5.1.2

根据本系统的功能，我们设计一下几个实体。

1.Student

Student实体代表一个用户，因为用户名唯一所以直接作为主键，private属性用来表

示用户的权限，其他属性是用户的基本个人信息，一是用来管理员验证信息，二是用

来填写订单时默认的属性，避免用户重复输入。

2.Businessman

Businessman实体户，用户名直接作为主键，其余属性为基本信息，用于管理员的审

核以及用户的浏览。

3.Category

Category实体代表这分类，由于商品的分类是一种树形结构，并非关系数据库的二

维结构，因此需要以•种合适的方式保存这种树形结构。

根据参考一系列的资料我们设计根据整型ID本身的关系表示层次关系，这种方式类

似IP地址的掩码，例如电脑配件的ID是0x0B00,鼠标和键盘的分类ID分别为OxOBOl

和0X0B02,用户查询电脑配件时使用掩码就可以一次查询到所有的电脑配件。

SelectgformGoodsasgwherebitand(Category,OxOBOO)=OxOBOO

注：bitand为hibernate自定义函数，进行&运算。

4.Basket

Basket为购物车，主键采用UUID主键生成策略，包含Goods和Student以及商品数

量和加入时间属性。

5.Order和orderitem

6.Order实体用于保存用户的一个订单，一个Order对象还包括若干个Orderitem

对象，表示订单的每一项书籍和数量。

7.Shop

Shop实体表示一个商店，商店的ID采用主键自动生成，其属性除了店主(host)商

品(list<Goods)外还包括一些商店的基本属性，比如地址、简述等，由于商店不仅仅

是businessman所拥有的，还包括一些学生开得虚拟店铺，为了不破坏实体的完整性,

仓促之间设计的实体关系已经不符合3NF标准，在以后的优化中会尽快改正。

8.Comment、Commentshop、CommentMarket

这些实体用于表示一条用户的饿评论，分别为对商品、商店和市场信息的评论。

9.Campusnews>Inform>suggestion

分别表示校内新闻，检举信息和意见建议

10.Admin

管理员，主键为用户名。

集体ER关系见图

数据库表结构的生成

完成域对象模型设计后，我们就可以利用工具完成域对象模型到数据库关系模型的

自动转化，从而获得数据库表结构的DDL脚本。应用Hibernate提供的HibernateTools

工具完成转化，hibernatetools以Ant扩展任务形式来实现DDL的自动生成，编辑

hibemate.cfg.xml配置文件，然后在Ant中建立任务make-schema,讲自动生成的

schema.sql放在/sql下，应用专用的数据库工具欲行这个DDL脚本就可以生成表结构

的创建了。

5.1.4持久层的设计

持久层中DAO模式为标准模式，再次我们不采用spring提供的现成的DAO体系，

而是设计一个类型安全的泛型DAO,通过泛型DAO,能够讲公共代码以泛型的方式

放入泛型超类中，进一步减少代码量。

注：本设计方式参考《Spring2.0核心技术与最佳实践》

分页的实现

设计Page对象，初始化每页显示的记录数和显示的页数，然后利用hql语言查询出

所需要的结果。

一般hql查询首先利用selectcount查询结果总数赋予totalCount,对于

DetachedCriteria的记录总数查询采用专门的方法获得，具体参照代码。

5.1.5逻辑层设计

逻辑层是需要实现应用程序的逻辑，一般的操作简单调用逻辑层。根据系统设计应

该判断权限，鉴于能力时间限制亟待进一步开发。逻辑层设计为外观模式（Faqade）

1.StudentService学生操作

2.BusinessService商人操作

3.Adminservice管理员操作

4.Publicservice公共的错做

5.Mailservice邮件操作

6.SearchSercice全文搜索操作

7.FileupSercice上传操作

图

5.1.5全文搜索

全文搜索简介

全文搜索是根据关键字搜索的一种查询方式，能够快速的定位包含该关键字的相关

记录，原理是分词+索引。在Java领域，开源全文搜索引擎Lucene是纯Java编写的

全文搜索引擎，可以嵌套任何Java编写的程序中。

集成Compass

由于Lucene提供的API的都比较底层，需要手动编写大量的代码和实现

引和搜索两大部分的功能，并且操作的数据是Lucene提供的Document和