校园C2C系统详细设计说明

山东农业大学掌中校园C2c系统详细设计说明书ProceduraIDesignSpecification编写:董健兴校对:于梦审核:批准:开发单位:山东农业大学一Perfect项目负责人:董建兴目录TOC\o"1-5"\h\z一•引言 4编写目的 4.项目背景 4定义 4.参考资料 4.程序系统的结构 6\o"CurrentDocument".WEB端程序设计说明 71程序描述 72功能 73性能 84输入项 85输出项 86算法 8验证码生成算法 9HTML字符转换算法 11图片转换成byte数组,并且获取表单元素算法 117程序逻辑 13♦登录模块 14♦创建商店 158接口 179存储分配 1710.设计规则与约束条件 1711测试计划 18\o"CurrentDocument"四.J2ME端程序设计说明 18手机端 18序描述 18功能 18性能 19输入项 20法 207程序逻辑 24用户手机端登录模块 24用户手机端修改信息模块 26用户手机端购买模块 27管理模块 30管理员审核模块 31接口 319存储分配 3110.限制条件 3211测试计划 32\o"CurrentDocument"五服务器端程序设计说明 32程序描述 32.1.I开发环境 32.1.2应用程序模型 33持久层 逻辑层 表示层 33.1.3域模型设计 数据库表结构的生成 35.1.4持久层的设计 351.5逻辑层设计 361.5全文搜索 371.5.1全文搜索简介 371.5.2集成Compass 371.5.3实现全文搜索 371.6发送E-mail 371.6.1配置JMS 371.6.2JavaMail 371.7发布web服务 385*1.7.1web月ノ,、3XFire 385.2功能 38性能 38输出项 39算法 395.7程序逻辑 395.8接口 395.9存储分配 405.10限制条件 405.11测试计划 40.引言编写目的该详细设计说明书在概要设计的基础上详细说明了C2C系统的各个模块的功能、所要达到的性能以及运行预期效果以便开发小组各个成员明确了解该软件各个子系统的具体功能分工和实现。同时也为大赛评委了解系统整体设计构思提供依据。预期读者:指导老师,大赛评委,团队成员,该系统用户.项目背景系统名称:掌中校园C2c系统开发者:山东农业大学Perfect团队面向用户:①需要获取商品信息,进行购买的在校消费者;②需要扩大校园潜在消费者的商户;③需要发布商品信息的校园消费者定义C2C：customertocustomer.即商品和信息从消费者直接到消费者。.参考资料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端程序设计说明※消费者web端模块3.1程序描述3.2功能功能类别功能名称、标识符描述注册商户注册校外商家,商家通过填写个人信息,上传身份证复印件来注册，并向系统管理员提交请求，管理员通过比对信息，来判断是否允许用户通过，以获得程序的接入权限。商家注册完成，并且通过管理员的审核以后，可以搦有创建网上商店,上传商品等功能,宣传自己的商店、商品,提高自己的经济效益学生注册学生，学生通过提交自己的真是信息,以及上传校园卡影像来实现注册。注册后学生可以在网ヒ实现网上交易（网上下订单,面对面交易）。也可以在网上浏览商品,获取自己有用的信息用户登录用户登录对用户输入的用户名、密码、验证码进行验证,只有登录用户才能使用程序的功能。登录后登陆信息将保存在服务器session中。査找功能查找商品査找商品应该可以按照商品的各个属性査找支持查找条件的复合，为用户提供尽可能多的选择查找商店査找商店也应该可以按照商品的各个属性査找支持查找条件的复合，为用户提供尽可能多的选择评论商品评论用户在浏览商品的时候,可以根据自己的购买经验对商品的实用性,性价比，质量优劣,信誉程度等信息作出评价,评价可以作为其他消费者购买的参考商店评论当用户查看商店的时候,同样可以对商店的做出自己的评价,系统管理员管理评论,对于评论较差的商店,作出相应的处理

功能类别功能名称、标识符描述商品购买订单用户通过选中商品填写订单提交自己的购物请求,并可随时查看已发订单的状态（等待中、商户忽略,正在处理、处理完成）。系统将订单转给商品所有者等待其进•步处理。创建商店学生创建商店学生创建的商店不需要再进行审核,只要学生的注册信息审核完成以后,他就有创建商店的权限商户创建商店商户创建商店需要上传经营许可证,商店的门头照，并且需要经过管理员审核后才能对该商店进行下ー步操作上传商品上传商品用户建立商店之后，可以上传商品到商店，商品的信息包括商品的名称数量等基本属性以及商品的图片信息3.3性能3.4输入项Web页面用使用了大量的表单,如果只是使用服务器端验证必定会加大服务器的服务器负担。所以,程序应该采用客户端与服务器验证相结合的方式进行验证。3.5输出项系统错误要打印日志;用户错误给出合理提示,人性化设计。3.6算法♦验证码生成算法Bufferedlmagebufflmg=newBufferedlmage(width,height,BufferedImage.TYPE」NT_RGB);Graphics2Dg=bufflmg.createGraphics();Randomrandom=newRandom();g.setColor(Color.WHITE);g.fillRect(O,0,width,height);/Z设置字体Fontfont=newFont(MTimesNewRoman",Font.BOLD,20);g.setFont(font);/Z画边框g.setColor(Color.GRAY);g.drawRect(0,0,width-1,height-1);g.setColor(Color.GRAY);/Z随机产生干扰线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);)/Z数字字母集合char[] numbersAndLettersStore =("0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHUKLMNOPQRSTUVWXYZ").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(newColoured,green,blue));Stringtem=String.valueOf(numbersAndLettersStore[random.nextlnt(62)]);randomCode+=tem;g.drawString(tem,15*i+16,17);)/Z验证码保存到Session范围HttpSessionsession=req.getSession();session.setAttribute(ncoden,randomCode.toStringO);System.out.printlnC'servlet里显示验证码:“+randomCode.toString());//禁止缓存resp.setHeader(”Prama"，"no-cache")；resp.setHeader(”Coche・Controド,"no-cache”)；resp.setDateHeader("Expires”,0);resp.setContentType(”image力peg”)；/Z将图像输出到ServletOutputStreamsos=resp.getOutputStream();ImageIO.write(bufflmg,"jpeg",sos);sos.close();♦HTML字符转换算法publicstaticStringHTMLChange(Stringsource){StringchangeStr二"”；changeStr=source.replaceAll("&,',,,&");changeStr=changeStr.replaceAll(*'"," ");changeStr=changeStr.replaceAH(”v”,”<”)；changeStr=changeStr.replaceAll(">”J>”)；changeStr=changeStr.replaceAll(n\r\nn,n<br>");returnchangeStr;}publicstaticStringTextAreaChange(Stringsource){StringchangeStr二””；changeStr=source.replaceAll(”vbr>”,”\n”)；returnchangeStr;♦图片转换成byte数组,并且获取表单元素算法while(it.hasNext())Fileitemfi=(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-generatedcatchblocke.printStackTrace();))else(try(StringpathStr=fi.getName();〃得到文件表单的值,就是用户本地的文件路径〃如果文件表单为空,则不处理if(pathStr.trim().equals(""))！continue;picByte=丘get。;picByte=丘get。;catch(Exceptione)e.printStackTrace();returnnull;)finally{〃立即删除保存表单字段内容的临时文件fi.delete();formlnfo.setPicBytre(picByte);formlnfo.setMap(map);returnformInfo;3.7程序逻辑♦登录模块♦创建商店

开始WebService用户经过审核用户还没有建立商转到建立商店页面WebService功提示页favaScript判断输入、格式是否合法,根据返回值判断:立商店是否成功;开始WebService用户经过审核用户还没有建立商转到建立商店页面WebService功提示页favaScript判断输入、格式是否合法,根据返回值判断:立商店是否成功;向WebService服务器传递参数,并得到返回值通过用户的的用户名,取得用户信息用户输入商店信息提示用户出错处,给出出错原因3.8接口3.9存储分配3.10.设计规则与约束条件方法命名规则符合java命名规则Package（包）的命名:采用完整的英文描述符,应该都是由小写字母组成。Interface（接口）、Class（类）的命名:采用完整的英文描述符说明接口封装,所有单词的第一个字母大写。通常由多个单词合成一个类名，要求每个单词的首字母也要大写。方法的命名:方法名的第一个单词应该是动词,大小写可混用,但首字母应小写。在每个方法名内，大写字母将词分隔并限制使用下划线。参数的名字必须和变量的命名规范…致。使用有意义的参数命名,如果可能的话,使用和要赋值的字段ー样的名字（这里方法命名和MyEclipse自动生成getter和setter-一致）：setCounter（intsize）｛this.size=size;）避免长型名称（小于15个字符比较合适）,巧妙节俭地使用缩写,将标准首字母缩写词的第一个字母大写。使用大小写混合增强名称的可读性。属性（变量）的第一个字母要小写避免名称过于相似或仅在大小写方面有区别包结构Com.cc2c.bean放javaBeanCom.cc2c.filter放置servletCom.cc2c.menu放置用于生成菜单的servletCom.cc2c.servlet主要的servletCom.cc2c.admin.servlet后台管理的servletCom.cc2c.serviceWebServie客户端Com.cc2c.dao数据库操作类Com.cc2c.monitor监视器类放置在这里3.11测试计划四,J2ME端程序设计说明※消费者手机端序描述本程序为掌上设备（手机）开发是客户端的主要部分。提供掌上应用的所有功能,可供多个用户同时使用。由于掌上设备的局限性,此部分不包含用户开店注册功能。功能具体功能列表如下:功能类别功能名称、标识符描述用户登录用户登录对用户输入的用户名、密码进行验证,验证通过后,该用户可以使用系统中分配到的权限进行操作,否则拒绝使用。

功能类别功能名称、标识符描述维护基本资料个人资料维护用户更新个人信息,包括资料图片、地址信息、登录密码、联系方式等店铺信息更新用户修改,删除,新增所开店铺的商品数据,系统根据用户的操作,对商品资料进行更新或显示。浏览査看模糊ftiflj用户通过输入查询的关键字进行模糊查询。系统内部将执行相应的査询操作并显示结果高级査询用户通过输入内容或选择动态得到的选项（包括商品分类,价格区间的获得）等进行精确的查询。商品购买购物车用户可将浏览到的商品其放入购物车暂存。i「単用户通过选中商品填写订单提交自己的购物请求,并可随时查看已发订单的状态（等待中、正在处理、处理完成）。系统将订单转给商品所有者等待其进一步处理。评论对店铺评论评论设定限制,只有买过此店铺商品的人才有评论的权限。评论・旦产生只有管理员有权限删除。对商品评论用户可以针对某件商品进行评论或提问。评论一旦产生只有管理员有权限删除。对校内新闻评论用户可针对某条校内新闻发表自己的评论。信息发布跳蚤市场一般权限的用户即可发布广告性质的供求信息,无需审核即可发布成功.系统维护维护用户资料拥有系统维护权限的用户可以増加新用户,并可以对用户的资料进行修改、删除以及査询。处理举报及意见建议拥有权限管理的用户可以设定其他用户对软件的访问权限。修改密码用户重新设定自己的密码维护店铺资料拥有系统维护权限的用户可以批准店铺,并可以对用户的资料进行修改、删除以及査询。维护校内信息删除不合法或过时的信息性能正确性。业务逻辑错误不允许出现。响应速度。WebService的调用及客户端的响应速度要在用户的忍耐范围之内〇易用性。无需专门的学习即可使用清晰性。业务流程明确。可扩展性。能根据变更的需求,在现有系统基础之上改变扩充功能。灵活性。服务器端可运行在大多数主流的操作平台之上。手机客户端满足・定型号的手机的使用。输入项基本数据类型的输入:输入项由用户的操作和选择实现,不同的输入项对输入要求不同。如密码输入时必须安全显示;Email输入时必须符合Email基本格式;电话号码输入时必须全为数字,长度不超过11个字符等。传输格式XML。图片数据类型:用户提交个人信息时上传的图片资料,大小应控制在2M内。传输格式XMLo5输出项错误输出：对有用户操作引起的错误应通过提示框给出明确的提示。系统内部错误抛出异常,应尽量显示错误原因。基本数据类型输出:Customitem或Form上显示。图片数据类型的输出:Canvas,Form或Customitem上显示法①图片放大缩小处理算法:publicstaticImageZoomimage(Imagesrc,intdesW,intdesH){Imagedeslmg=null;intsrcW=src.getWidth();//原始图像宽intsrcH=src.getHeight();//原始图像高int[]srcBuf=newint[srcW*srcH];//原始图片像素佶息缓存src.getRGB(srcBuf,〇,srcW,0,0,srcW,srcH);//计算插值表int[]tabY=newint[desH];int[]tabX=newint[desW];intsb=0;intdb=0;intterns=0;inttemd=0;intdistance=srcH>desH?srcH:desH;for(inti=0;i<=distance;i++){/*垂直方向*/tabY[db]=sb;terns+=srcH;temd+=desH;if(terns>distance){terns-=distance;sb++;}if(temd>distance){temd-=distance;db++;})sb=0;db=0;terns=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(desBuf,dy-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(desBufrdesW,desH,false);returndeslmg;}②低级界面自动换行算法://设置低级界面的文木自动换行publicstaticVectorgetSubsection(StringstrzintCharacterNumber){Vectorvector=newVector();inti=0;while(!str.equals("")){if(str.length()>CharacterNumber){vector.addElement(str.substring(0,CharacterNumber));str=str.substring(CharacterNumber);)else{vector.addElement(str);str=MM;returnvector;序逻辑♦用户手机端登录模块进入个人空间♦用户手机端购买模块成功发布商品用户进行删除,用户进行删除,在管理员端的管理工作主要是对于被举报的,不合法的店铺、所以主要介绍ー下删除功能的实现4.8接口参见《掌上校园C2c概要设计说明》提供的接口。4.9存储分配J2ME客户端和Web客户端共用ー个数据库。1、图片大小应控制,并对图片分辨率进行限制。2、输入数据限定为基本数据类型,故开店注册不宜在此实现。3、由于掌上设备的局限性对系统运行占用的内存和存储空间有一定要求。4、在手机端为避免信息读取不全,手机硬件不够等客观因素造成管理员管理失当,所以只有简单的删除管理和审核管理,让手机端的管理权限有局限性。4.11测试计划1、本部分测试时输入的数据应为基本数据类型,输出的数据在手机屏幕显示。2、测试应当用真机作为测试设备,检测系统运行内存占用情况和运行速度,尽量贴近实际。3、输入的数据要能代表一般性又不乏特殊性。4、J2ME客户端实现的方法都要用数据进行测试。5、链接WebService时用本地PC机作为服务器。五服务器端程序设计说明程序描述开发环境本程序是服务器端逻辑层以及控制层开发,部署在服务器上,构建系统框架提供通用接口发布web服务。程序使用spring2.0+hibernate3.2+JDK5.0+MySql5配置开发环境,使用ant作为项目的构建工具,XDolet自动生成配置文件。采用三层应用程序模型,数据库、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配置文件JavaBean数据库表结构.hbm配置文件图551.1 图5.1.2根据本系统的功能,我们设计一下几个实体。StudentStudent实体代表・个用户,因为用户名唯，所以直接作为主键,private属性用来表示用户的权限,其他属性是用户的基本个人信息,ー是用来管理员验证信息,二是用来填写订单时默认的属性，避免用户重复输入。BusinessmanBusinessman实体户,用户名直接作为主键,其余属性为基本信息,用于管理员的审核以及用户的浏览。CategoryCategory实体代表这分类,由于商品的分类是一种树形结构,并非关系数据库的二维结构,因此需要以ー种合适的方式保存这种树形结构。根据参考一系列的资料我们设计根据整型!D本身的关系表示层次关系，这种方式类似IP地址的掩码,例如电脑配件的ID是OxOBOO,鼠标和键盘的分类ID分别为OxOBOl和0x0602,用户查询电脑配件时使用掩码就可以一次查询到所有的电脑配件。SelectgformGoodsasgwherebitand(Category,OxOBOO)=OxOBOO注:bitand为hibernate自定义函数,进行&运算。BasketBasket为购物车,主键采用UUID主键生成策略,包含Goods和Student以及商品数量和加入时间属性。Order和orderitemOrder实体用于保存用户的ー个订单,ー个Order对象还包括若干个Orderitem对象,表示订单的每一项书籍和数量。ShopShop实体表示ー个商店,商店的ID采用主键自动生成,其属性除了店主(host)商品(list<Goods)外还包括一些商店的基本属性,比如地址、简述等,由于商店不仅仅是businessman所拥有的,还包括ー些学生开得虚拟店铺,为了不破坏实体的完整性,仓促之间设计的实体关系已经不符合3NF标准，在以后的优化中会尽快改正。Comment,Commentshop,CommentMarket这些实体用于表示一条用户的饿评论,分别为对商品、商店和市场信息的评论。Campusnews>Inform>suggestion分别表示校内新闻,检举信息和意见建议Admin管理员，主键为用户名。集体ER关系见图数据库表结构的生成完成域对象模型设计后，我们就可以利用工具完成域对象模型到数据库关系模型的自动转化,从而获得数据库表结构的DDL脚本。应用Hibernate提供的HibernateTools工具完成转化,hibernatetools以Ant扩展任务形式来实现DDL的自动生成,编辑hibernate.cfg.xml配置文件,然后在Ant中建立任务make-schema,讲自动生成的schema.sq!放在/sql下,应用专用的数据库工具欲行这个DDL脚本就可以生成表结构的创建了。5.1.4持久层的设计持久层中DAO模式为标准模式,再次我们不采用spring提供的现成的DAO体系,而是设计ー个类型安全的泛型DAO,通过泛型DAO,能够讲公共代码以泛型的方式放入泛型超类中,进ー步减少代码量。注:本设计方式参考《Spring2.0核心技术与最佳实践》5.142分页的实现设计Page对象,初始化每页显示的记录数和显示的页数,然后利用hql语言查询出所需要的结果。一般hql查询首先利用selectcount查询结果总数赋予totalCount,对于DetachedCriteria的记录总数查询采用专门的方法获得,具体参照代码。5.1.5逻辑层设计逻辑层是需要实现应用程序的逻辑,一般的操作简单调用逻辑层。根据系统设计应该判断权限,鉴于能力时间限制亟待进一步开发。逻辑层设计为外观模式(Facade)StudentService学生操作BusinessService商人操作Adminservice管理员操作Publicservice公共的错做Mailservice邮件操作SearchSercice全文搜索操作FileupSercice上传操作图5.5,1.4全文搜索1.5.1全文搜索简介全文搜索是根据关键字搜索的ー种查询方式,能够快速的定位包含该关键字的相关记录,原理是分词+索引。在Java领域,开源全文搜索引擎Lucene是纯Java编写的全文搜索引擎,可以嵌套任何Java编写的程序中。1.5.2集成Compass由于Lucene提供的AP1的都比较底层，需要手动编写大量的代码和实现引和搜索两大部分的功能,并且操作的数据是Lucene提供的Document和Filed类,需要手动转化我们自定义的域对象,因此使用起来比较繁琐。Compass正是为了简化Lucene的使用而创建的框架。在本系统中我们需要实现全文搜索的是商品信息,即Goods对象,如图所示:1.5.3实现全文搜索Compass支持XML和Java5注解,在本程序中我们采用Java5注解,在Goods类中对以get开头的属性添加Compass注解。发送E-mail配置JMSTomcat不支持JMS,采用ActiveMQ集成到tomcat中,新建activemq.xml配置文件,在spring的配置文件中部署ActiveMQ,使