“全民点评APP”概要设计

1、精品好资料学习推荐 1 / 27 “全名点评全名点评”APP”APP 概要设计说明书概要设计说明书 组员组员: :严骞（答辩人），卫浩（组长），季兆生，李严骞（答辩人），卫浩（组长），季兆生，李 红祥，李天宇红祥，李天宇 目录 1.引言 3 1.1 编写说明 3 1.2 背景 3 1.3 定义 3 1.4 参考资料 4 2.任务概述 5 2.1 目标 5 2.2 用户的特点 5 精品好资料学习推荐 2 / 27 2.3 假定与约束 5 2.4 运行环境 5 3.总体设计 6 3.1 对功能的规定 6 3.1.1 系统设计功能层次图 6 3.1.2 功能模块简介 7 3.2 非功能性需求设计 9

2、 4.运行环境要求 11 4.1 设备 11 4.2 支持软件 11 5. 接口设计 11 5.1 HTTP 接口设计 11 5.1.1 URL 接口 11 5.1.2 搜索用户接口 12 5.2Sokect 自定义协议 13 5.2.1 Client 部分 15 6. 系统出错设计 24 6.1 APK 文件异常处理 24 6.2 UI 文件异常处理 25 6.2 非软件内部问题处理措施 28 1.引言引言 1.1 编写说明编写说明 如今手机订餐、订票、订旅店的 APP 不胜枚举，这给我们生活带来了更多 的方便，也在改变着我们的生活方式，而在云云之中选择一款方便、安全、功 能强大的 app

3、则令人苦恼。因此开发这套全民点评 app 是非常有必要的。本需 求的编写目的在于为系统的开发做好前面的部署，以便于我们可以开发出系统 功能更加全面，使用户操作起来更加的方便。 1.2 背景背景 随着科学与技术的发展，人们对物质生活的要求越来越高，而如何快速选 择优质的社会服务，也逐渐成为社会的焦点，使今天的社会进入了以计算机为 核心的社会。网络的发展给我们带来了无限的商机与便利。点评类 APP 也同样 能够发挥巨大的作用那就是 APP 点评。全民点评来源于人民同时也服务于人民， 精品好资料学习推荐 3 / 27 用户可以根据真实情况对不同店铺做出不同评价，满足不同用户需求，采用奖 励制，采集优

4、质评价。 消费者既可以实现讲出自己消费后的内心感受，同时可以得到一定的回报。 最终要达到的目的是使得人们的生活更加的便利，一方面消费者在消费完之后， 通过全民点评这个软件来评价此次消费，并获得一定的积分奖励，当积分到一 定的程度就可以越换礼品；另一方面消费者可以通过全民点评来查看哪些地方 评价较高，自己选择提供参考。此项目的主要功能就是通过消费者点赞和评价， 来获取积分，并为他人的消费提供一个参考作用。 1.3 定义定义 本产品是为餐厅、旅店专门开发的一套点评管理系统，旨在合理化安排用 户需求，给用户提供更多有效数据，同时方便消费者更加方便的就餐、住店。 1.4 参考资料参考资料 Karl E

5、.Wiegers、刘伟琴、 刘洪涛，软件需求(第 2 版) .清华大学出版社 (2004-11 出版) 杨丰盛Android 应用开发揭秘M.北京:机械工业出版社,2010 余志龙，陈昱勋，郑名杰Android SDK 开发范例大M.北京:人民邮电出版社, 2010 郑建，贺超Android 和 Chrome 的发展与未来J.移动通信,2010.3 麦斯阿塞克(Leszek A.Maciaszek)、马素霞、王素琴、 谢萍，需求分析与系统 设计(原书第 3 版) .机械工业出版社 (2009-09 出版) . 王向辉，张国印，沈洁.Android 应用程序开发.清华大学出版社，2010 年 3

6、 月 江开耀.软件工程与开发技术（第二版）.西安:电子科技大学出版社，2009. 张星.网页开发三合一教程M.北京:中国宇航出版社.2009 王鹏.数据库技术及其应用M.北京:人民邮电出版社.2008 精品好资料学习推荐 4 / 27 2.任务概述任务概述 2.1 目标目标 开发该软件系统的主要意图为针对当前超消费，以及网络消费市场的广大 潜力和市场乱象，开发出一款新颖、透明、真实、准确的消费评价系统，真正 实现线上线下的资源共享和无缝接轨，树立行业标杆，网络远程整治市场乱象。 与其他同类软件系统相比，本软件系统严格管控企业用户和消费者信息录入， 力求录入信息最大程度的真实、有效，排除虚假信息

7、，给人们提供更加准确的 消费需求。 2.2 用户的特点用户的特点 该软件的主要是向经常使用网络的网络订餐用户提供选择的目标，主要是 通过用过餐用户的点评来为自己的选择做出指导。主要的用户群体在学生，单 位工作人员。 2.3 假定与约束假定与约束 在系统的开发过程中，由于系统比较庞大，系统和数据库之间的数据交互， 还有就是客户端与服务器间的交互会成为一个很严重的问题。在多用户多线程 同时提交信息的时候可能会导致系统出现卡顿现象，这是我们需要解决的。还 有约束条件就是开发产品与硬件设备的兼容性问题。 2.4 运行环境运行环境 Android 4.0 及以上版本智能手机 精品好资料学习推荐 5 /

8、27 3.总体设计总体设计 3.1 对功能的规定对功能的规定 3.1.1 系统设计功能层次图系统设计功能层次图 图 3-1 系统功能总图 图3-2 总体流程图 精品好资料学习推荐 6 / 27 3.1.2 功能模块简介功能模块简介 该系统分为登录页面、首页界面、赏析页面、我的界面四大模块。其中登 录页面主要包括用户登录、用户注册以及找回密码。首页页面主要包括每日签 到、发布信息、店铺评价信息、城市切换等快捷方式。赏析界面主要包括用户 评价。我的界面主要包括个人信息的查看与修改、进行每日签到、发布信息、 删除已发布信息和积分。 （1）主界面模块 主控界面是顾客打开 APP 时，最先呈献给用户的，

9、在功能布局进入界面是 城市用 GPS 定位所在的城市，还可以切换到其他的城市（现开放城市：沛县、 丰县、邳州、新沂、徐州、睢宁）、登录模块、主控模块、赏析功能和账号功 能等功能模块。模块的分布还是很合理的。主控制模块上面主要是签到等功能。 每个模块之间可以方便的切换。登录成功后，即进入首页界面，即主控模块， 主按模块主要用以下子功能 1.城市定位 当您点击城市按钮时，跳转到城市切换界面上，来选择该城市的消费评价 信息， 2.活动发布 这是我们一些活动的图片，您可以通过左右滑动来查看我们的活动图片 ， 当您点击图片是会自动访问网站相应活动页面，使用 webview 组件显示相应的 内容。 3.签

10、到 签到功能将提交用户 ID 到网站程序，由网站程序判断当日是否已经签到， 如果没有签到，即对积分加 1，并更新时间，最后返回 APP 相应的信息；如果 已经签到，即不对积分处理，并返回相应的信息。 4.最新消费评价信息 显示当前最新消费评价信息，当您对此消费信息感兴趣时，您可以点击进 入进一步了解此店铺，觉得是否消费。点击店铺介绍时，会显示该店铺的一些 信息，为了使您更加了解该店铺。 点击店铺评价时，你会看见评价界面的所有信息框架；你可以获取其他消 费者的点评信息。 精品好资料学习推荐 7 / 27 （2）注册登录模块 顾客在下载点击 APP 后可以很方便的进行用户的注册，点击注册之后，填

11、好用户名和密码，通过手机短信的验证来实现用户的注册，这样可以防止用户 的恶意注册，在注册完成之后，就可以直接登录了，十分的方便，一般注册过 程不超过 20 秒，这样免去了很多的麻烦也留住了很多的客户。注册完成之后就 可以进入主控制界面。 （3）赏析界面模块 这个模块是最主要的模块，我们主要做的就是赏析这个功能，这个功能就 是在我们消费完之后，用户可以登录我们的 app，选择相应的店铺，里面有评 分和说明，我们可以拍照上传进行评论。这个模块有一个非常方便的功能，就 是我们在评论的地方有个定位功能，我们可以直接定位到这家店铺，然后进行 评论。 （3）账户管理模块 当您点击我的时，跳转到我的界面 ，

12、界面中间是您的姓名和您注册时的城 市，下面分别是个人信息、签到、发布、信息删除和积分。 1.帐户信息维护 当您第一次使用点评 app 时 您的姓名是没有的，你可以点击个人信息，完 善个人的基本信息列表,在输入你的姓名时，该文本框不为空，若为空则跳出提 示框告诉你该用户名姓名不可以修改；否则可以修改，这必须要点击保存信息 后 事件才能告诉你，若是修改成功，自动跳转到我的界面，并且把中间部分的 姓名与所在地更改。如图 3-10 所示 2.积分记录 主要显示相应的用户积分，显示你在什么情况下获取到积分的，获得的积 分是多少，以及积分的消费情况。 3.签到 与主模块的“签到”功能一致。 4.发布评价信

13、息 发布你已消费的店铺的评价信息。 5.删除曾经评价记录 精品好资料学习推荐 8 / 27 6.在用户界面我们可以修改密码，在输入旧密码之后就可以修改新的密码 （4）管理员后台管理模块 1、管理员在后台登录后，可以创建其它权限不同的管理员。 2、管理员可以对餐厅全民点评 app 上的菜单进行添加、删除和修改，比如 更改菜单的图片，价格，菜单的描述，更换新品，添加新菜等。 3、管理员对每个菜品的评价信息进行更新和重置等等 3.2 非功能性需求设计非功能性需求设计 （1）方便操作，操作流程合理 尽量从用户角度出发，以方便使用本产品。如：新增用户信息时，是使用自己 的手机号码来获取验证码，设置自己的

14、登录密码和所在的省市等等。 （2）支持Android手机版本4.0以上版本。并且获取评价信息很简单。 （3）容错能力 系统具有一定的容错和抗干扰能力，必须在有网络或无线网下，系统能够保证 正常运行，并有足够的提示信息帮助用户有实现。 （5）操作完成时有统一规范的提示信息 （6）服务器稳定性：保证系统的服务器具有良好的稳定性，需要实现 7*24 小时不停的运作。 （7）服务器稳定性：保证系统的服务器具有良好的稳定性，需要实现 7*24 小时不停的运作。 （8）数据完整准确：录入数据采用表格方式，限制录入数据类型及取值范 围以保证数据的完整性及准确性。系统具有部分反悔修改功能，系统 备有的修改功能

15、均可反悔。 （9）系统安全：用户在身份认证、授权控制、私密性等方面的要求。 （10）系统易用：系统操作界面美观、简便，通俗，便于操作。 （11）系统可维护：系统在出现故障时可以及时维修，使其数据恢复。 以下列表是描述 Android 手机端要显示的功能模块： 模块子模块详细介绍 登陆 个人可以根据手机号码登陆。注：登陆一 次下次使用无需再次登陆，默认上次登陆 的会员 精品好资料学习推荐 9 / 27 注册 个人可用手机号+短息验证+城市选择进行 个人注册，注册成功跳转至个人信息完善 和修改的页面。 找回密码 输入手机号码，发送短息验证码，修改新 密码 下菜单首页，赏析，账户 城市切换 进入界面

16、是城市用 GPS 定位所在的城市， 还可以切换到其他的城市（现开放城市： 无锡，南京，苏州，常州） 活动图片展示放置最新活动，点击可查看详情 主控模块 推荐评价列表最新的评价信息展示 店铺评价评价信息 用户点赞点赞情况赏析 用户评价评价信息 个人中心主页展 示 欢迎图片+快捷入口超链接 信息查看修改查看个人信息可修改 签到签到，一天一次，签一次+1 积分 发布信息发布评价信息 删除评价信息删除已发布评价信息 账户中心 积分明细积分明细 3.3 需求分析需求分析 详情请参照需求分析文档 4.运行环境要求运行环境要求 4.1 设备设备 外围设备：手机; 编译程序：Android studio; 操

17、作系统：Android 操作系统; 精品好资料学习推荐 10 / 27 数据库支持：SQL Server 2008 4.2 支持软件支持软件 服务器端：tomcat 系统平台：Windows XP 或更高版本的操作系统 计算机语言：Java，SQL 语言， 网络通信协议：TCP/IP 开发工具：Android studio 5.接口设计接口设计 5.1 HTTP 接口设计接口设计 5.1.1 URL 接口接口 (1)URL 的组成：基本的网络地址 分支节点 :8080/chat 为 基本的网络地址 /login 为 分支节点 :808

18、0/chat/login 组成完整的 URL 当前统一的基本网络地址为 :8080/ChatServer 请求方式： POST、GET、PUT (2)请求消息头： 键值对(key value 形式) (3)请求参数: 键值对(key value 形式) (4)响应的状态码: 统一的返回码为: 200 (注:只要访问服务器成功，一律返回 200) 精品好资料学习推荐 11 / 27 (5)响应的格式: flag:true, data:. 成功的标记为 flag 为 true (6)根据具体的请求，如果需要返回值 data 节点 包含的是 返回结果 不需要需要返回值

19、，则没有 data 节点 (6)失败: flag:false,errorCode:1,errorString:错误原因 失败的标记为 flag 为 false,flag 为 false 时，必然返 errorCode 和 errorString 节点 (7)errorCode 说明了错误编码,errorString 说明错误原因。 5.1.2 搜索用户接口搜索用户接口 （1）分支节点 : /user/search （2）请求方式 : POST （3）请求消息头 : （4）请求参数 : （5）响应结果 : 成功： key 类型说明 accountString 用户的账号 tokenString

20、用户的唯一标识 key 类型说明 searchString 搜索的账号 精品好资料学习推荐 12 / 27 flag: true, data: account: zhangsan, name: 张三, icon: /a/b/zhangsan.png, sign: 我的个性签名, area: 徐州 失败： 5.2Sokect 自定义协议自定义协议 1.协议的定义 （1）传输格式为 json （2）协议分为请求和响应 （3）传输方向: client - server : 发送消息 server - client : 推送消息 （4）发送消息 发送过程包含的两个过程： 求 : client 发送消息

21、到 server 响应 : server 响应 lient 的这次消息请求 两个过程 都完成才算当前消息发送成功 errorCodeerrorString 200 用户不存在 精品好资料学习推荐 13 / 27 （5）推送消息 推送过程包含的两个过程： 请求 : server 发送消息到 client 响应 : client 响应 server 的这次消息请求 两个过程都完成才算当前消息发送成功 （6）消息必备格式 请求部分: sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d2, type: request, action: text 响应部分: se

22、quence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d2, type: response, flag: true sequece : 标记请求和响应，用来表明响应是针对哪次请求的 type : 用来标记是请求还是响应 action : 请求发送方的发送类型，由具体请求决定取值。 5.2.1 Client 部分部分 1.Auth 认证 （1）Action : auth （2）请求的 key-Value key 类型说明 typeString 请求：request sequenceString 请求的序列号 精品好资料学习推荐 14 / 27 actionStrin

23、g 请求的行为:auth senderString 发送者账号 tokenString 发送者 token 标志 （3）请求的 json 格式: sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d2, type: request, action: auth, sender:xxxx, token:xxxx sequence:1,type:request,action:auth,sender:iphone1, token:0dce6f76ac1a29d276c0c6dabe60519c （4）响应的 json 格式: 成功 : sequence: 9f4c

24、696e-9ab5-46cf-959c-b1e2e35200d2, type: response, flag: true, 失败 : sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d2, type: response, flag: false, errorCode:, errorString: 精品好资料学习推荐 15 / 27 （5）发送邀请 Action : invitation （6）请求的 key-Value key 类型说明 typeString 请求：request sequenceString 请求的序列号 actionString 请求

25、的行为:invitation senderString 发送者账号 tokenString 发送者 token 标志 receiverString 接收者的账号 （7）请求的 json 格式: sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d2, type: request, action: invitation, token:xxxx, sender:xxxx, receiver:xxxx, content:xxxxxx （8）响应的 json 格式: 成功 : sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200

26、d2, type: response, flag: true, 失败 : 精品好资料学习推荐 16 / 27 sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d2, type: response, flag: false, errorCode:, errorString: （9）发送文本消息 Action : text 请求的 key-Value key 类型说明 typeString 请求：request sequenceString 请求的序列号 actionString 请求的行为:invitation senderString 发送者账号 tok

27、enString 发送者 token 标志 receiverString 接收者的账号 contentString 邀请的文本内容 （10）请求的 json 格式: sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d2, type: request, action: text, token:xxxx, sender:xxxx, receiver:xxxx, content:xxxxxx （11）响应的 json 格式: 精品好资料学习推荐 17 / 27 成功 : sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d

28、2, type: response, flag: true, 失败 : sequence: 9f4c696e-9ab5-46cf-959c-b1e2e35200d2, type: response, flag: false, errorCode:, errorString: 2.Server 部分 （1）推送用户邀请 action : invitation （2）请求的 key-Value key 类型说明 typeString 请求：request sequenceString 请求的序列号 actionString 请求的行为:invitation senderString 发送者账号 r

29、eceiverString 接收者的账号 invitor_nameString 邀请者的名字 invitor_iconString 邀请者的头像 contentString 邀请的文本内容 精品好资料学习推荐 18 / 27 （3）请求的 json 格式: sequence:3, type:request, action:invitation, sender:iphone1, receiver:iphone2, invitor_name:iphone2, invitor_icon:/icon/iphone2.png, content:hehe （4）响应的 json 格式: 成功 : sequ

30、ence: 3, type: response, flag: true, 失败 : sequence: 3, type: response, flag: false, errorCode:, errorString: （5）推送用户接受邀请 action : reinvitation 请求的 key-Value 精品好资料学习推荐 19 / 27 key 类型说明 typeString 请求：request sequenceString 请求的序列号 actionString 请求的行为:reinvitation senderString 发送者账号 receiverString 接收者的账号

31、 nameString 接受邀请者的名字 iconString 接受邀请者的头像 contentString 邀请的文本内容 （6）请求的 json 格式: sequence:3, type:request, action:text, sender:iphone1, receiver:iphone2, name:iphone1, icon,/icon/iphone1.png, content:hehe （7）响应的 json 格式: 成功 : sequence: 3, type: response, flag: true, 失败 : 精品好资料学习推荐 20 / 27 sequence: 3,

32、 type: response, flag: false, errorCode:, errorString: （8）推送文本消息 action : text 请求的 key-Value key 类型说明 typeString 请求：request sequenceString 请求的序列号 actionString 请求的行为:text senderString 发送者账号 receiverString 接收者的账号 contentString 邀请的文本内容 （9）请求的 json 格式: sequence:3, type:request, action:text, sender:iphon

33、e1, receiver:iphone2, content:hehe （10）响应的 json 格式: 成功 : 精品好资料学习推荐 21 / 27 sequence: 3, type: response, flag: true, 失败 : sequence: 3, type: response, flag: false, errorCode:, errorString: （11）推送用户名变更 action : nameChange 请求的 key-Value key 类型说明 typeString 请求：request sequenceString 请求的序列号 actionString

34、请求的行为:nameChange senderString 发送者账号 receiverString 接收者的账号 nameString 发送者变更后的名字 （12）请求的 json 格式: 精品好资料学习推荐 22 / 27 sequence:3, type:request, action:text, sender:iphone1, receiver:iphone2, content:hehe （13）响应的 json 格式: 成功 : sequence: 3, type: response, flag: true, 失败 : sequence: 3, type: response, fla

35、g: false, errorCode:, errorString: 6.系统出错设计系统出错设计 6.1 APK 文件异常处理文件异常处理 1.更换安卓项目的库文件（即使库文件代码相同），运行工程闪退。 解决方法：将原来的 app 卸载再运行 精品好资料学习推荐 23 / 27 2.R 文件丢失：（一般是资源文件有错，特别是 clean 之后） 原因：res 文件夹的 xml 文件（不仅是 layout，还包括其他）缺少了必 要的属性或者添加了错误的属性。 3.导入 library 文件没有生成“private braries”. 可能原因“v4 包重复。（特别是在新项目导入基础库的时候）

36、4.断点调试 can not findDexFile： 解决方法：把断点全部去掉重新添加断点。 5.http 的 post 或者 patch 请求如果显示请求类型错误 解决方法：添加一个请求头：Content-Type，值为对应的请求体类型。 6.eclipse 项目从 svn 检出后无法运行 原因：项目提交不全（首次提交全部文件，以后可忽略 classpath,bin 等不需要提交的文件） 7.在写入缓存文件的操作中一定要加上读写外部文件的权限。 8.在一个水平 LinearLayout 中，有 Button 和 Spinner，Button 放在 Spinner 的左边在执行 Activi

37、ty 的 findviewById 就会奔溃。换成右边就不会。 原因未知。 9.将 Android 项目提交 svn 后如果改包名或者类名，提交文件会报 Illegal target 的错误。 解决方法：彻底断开 svn 连接（删除 svn 元信息），重连之后，将原来 包名或者类的东西删除。 6.2 UI 文件异常处理文件异常处理 对于已经受 svn 源代码管理的文件或者文件夹，若想修改名字，可以这样 操作： 1.选中文件或者文件夹右键TortoiseSVN改名。 2.SVN 提交。 3.不同的布局文件的控件 id 尽量不要重复，不然在 eclipse 容易发生控件 精品好资料学习推荐 24

38、/ 27 选取混乱。 4.使用 evenbus 记得要添加 onEvent 方法。 5.使用 android.graphics.Color 不可以画图表折线的颜色。（原因未知， 只知道对应的数值为负数） 6.在类定义成员变量如下 GlobalDataManager.getInstance(). getSettingDataShowDay(getActivity()不能执行，原因可能是成员变量的定 义先于构造函数执行，导致无法执行 getActivity(); 7.侧滑菜单有控件空指针，执行到返回主界面的 fragment 就奔溃。（原因 未知，可能是 slidingMenu 的设计关联了主界面

39、 fragment?） 8.在一个 LinearLayout 中有两个控件，都是设置 height 为 0dp，weight 为 1，其中一个可见一个为 gone。在代码中设置不可见的为 visible，不可见 的仍然不可见。（可能是设置了权重就不可设置可见了。解决方案为动态设置 布局控件的属性才为两个控件设置权重） 9.ScrollView 的控件的 height 属性要为确切数字。（不然 ScrollView 不 能为其安排确切的大小） 10.有时候修改 xml 布局文件后出现控件类型转换错误。 解决方法：clean 一下工程一般可以解决。 11.eclipse 安卓工程创建没反应没提示。

40、 原因：在项目的创建目录有重复的工程名。 12.viewPager 放 fragment，fragment 从 fragment 集合中删除，再添加 fragment 到 fragment 集合，结果 viewPager 仍然显示删掉的 fragment。 原因：fragmentmanager 将删掉的 fragment 保存起来，又重新显示出 来。 13.带 CheckBox 的 ListView，CheckBox 要添加的属性： android:clickable=false android:focusable=false 当 ListView 项被按下的时候，notifyDataSetC

41、hanged()刷新整个 ListView,传 入的参数刷新。 精品好资料学习推荐 25 / 27 如果没有加这两属性，仅仅打钩 CheckBox 并没有点击到 ListView。（抢了 ListView 的焦点） 14.eclipse 复制一个 xml 布局文件后，在视图中修改其中一个文件控件的 id，会同时修改到另一个文件对应控件的 id。 15.eclipse 无法连接手机，出现 Adb connection Error:远程主机强迫关 闭了一个现有的连接 错误。 解决方法：DDMS 中 restart adb。 16.如果计算机连接的是（可能是选择了自动获取 ip）外网 ip，则会导致 svn 无法连接内网服务器。 17.NetworkInfo activeInfo = manager.getActiveNetworkInfo(); activeInfo.isAvailable(); （1）在广播 onReceive()方法外 activeInfo 获取不到。 （2）在网络开启的时候可以使用，在网络关闭的时候程序挂掉（但放在判 断语句中就可以用）。 原因未知。 18.在铺满 Activity 的 ImageView 中加一张尺寸足够的图片无法铺满？加 渐