2团购参谋服务端软件使用说明书1 软件概述1.1 编写目的为了确定系统的最终功能，使系统能够真正满足用户的需求，更清晰、更明确、更有效的为用户发送数据，开发人员为此编写了团购参谋服务端软件使用说明书，从而更好的建立起服务器端开发人员与用户的联系，并为未来的评价和激励奠定基础。1.2 服务端介绍1.2.1 服务端定义服务端主要用于数据存储，以及对客户端的请求作出相应，完成数据的交互等操作。环境为：mysql数据库软件+rails框架数据单元：数据库表1.2.2 服务端主要功能客户端Ruby on railsmysql数据将手机端与服务器端基本的数据同步，使客户端功能有限实现。目前已经实现的功能如下：1.2.2.1 可完成数据的增、删、改、查功能。即可在数据表中增加、删除、修改、查询记录。1.2.2.2 前十查询功能，即可随时查询、返回任一榜单前十条记录信息。1.2.2.3 姓名查询功能，即输入姓名查询该姓名所对应的榜单记录信息。1.2.2.4 中心查询功能，即可随时根据某条记录，查询任一榜单位于这条记录前五、后五名的用户记录信息。1.2.2.5 范围查询功能，可根据任意榜单的区间数据，查询出位于这一区间的所有记录。1.2.2.6 查询更新功能，通过客户端请求信息，判断数据库中是否存在相同数据，若查得信息，则对相应的字段值进行替换，若记录不存在，则新建相应的信息。1.2.2.7 排序查询功能，通过客户端的请求信息，查询任意数量的记录，并对返回的记录进行排序。1.2.2.8 购物榜单批量上传功能，完成若干条购物记录信息的上传功能，服务器对客户端的请求做出解析，提取出相应的记录，于数据库端新建记录，存储购物记录数据。1.3 启动程序本演示程序的服务器端部分：Script目录下的Server服务器。1.4 数据库软件及版本号mysql软件（版本号5.5）2 服务器端启动过程服务器的系统启动过程有2种方法：2.1 服务器系统启动过程（第1种方法）在图1中输入cd list_self命令，进入list_self项目目录中。图1图2在图2中输入ruby .script/server命令，启动网络服务器。图3启动网络服务器成功之后，则进入图3所示的界面。2.2 服务器系统启动过程（第2种方法）首先进入InstantRails-2.0-win文件夹，运行InstantRails.exe，会出现如图4所示的提示框。图4选择“是”，则会跳出如图5所示的服务启动主页面。图5图6点击图6篮圈标注的按钮，则会出现图7所得界面。图7将鼠标放在“Raila Applications”上面，则会呈现图8中显示的列表页面。图8选择“Manage Rails Applications”项，进入图9所示的页面。图9图9中在“Rails Applications”项下选择“tuangou”，如图10所示。图10然后选择右侧的“Start with Mongrel”按钮（图11蓝圈标注），则服务器启动成功。图11服务器启动后会出现服务器启动命令行，如图12所示。图123 服务器数据库管理在服务器启动成功后，就可以访问该服务器上的网页，见图13。图13图13访问的url为：http:/localhost:3002/lzj/shenghuo。localhost为本地地址3002为端口号。此时，mm项目已加载到服务器。我们可以查看数据库的表结构（图14）：图14Field项下的列表是数据库表里面的域；Type指域的类型；Null指是否允许为空Key指是否为关键字Default指默认值；Extra指一些描述信息。图15在服务器启动成功后，我们还可以访问另一个服务器上的网页。访问url：http:/localhost:3001/sta/index，如图15。其中，localhost为本地地址；3001为端口号；Sta为控制的类；showall为对应的方法。从图15中我们可以看出数据库表有3项：排行榜、理财信息和收藏信息。首先我们先看一下排行榜。点击“排行榜”则跳转到图16所示的界面。图163.1 “增删改查”功能图17首先介绍数据的“增删改查”功能。如图17中，增删改查选项有“新建”、“删除”、“修改”、“全部”4个按钮（篮圈所示），可完成数据的增、删、改、查功能，即可在数据表中增加、删除、修改、查询记录。3.1.1 “新建”按钮点击排行榜主页的“新建”按钮，则跳转到图18中的页面。图18在图18中可填写姓名及签到、收藏、评论、分享、购物、理财、成就的次数，点击提交即可（如图19）。图19提交成功之后，则会跳转到榜单数据界面，我们可以看到刚才添加的angelno信息（图20）。图203.1.2 “删除”按钮返回排行榜主页，点击排行榜主页的“删除”按钮，则进入删除页面（图21）。图21在图21姓名栏中输入要删除的榜单名字或者直接输入ID号，点击提交即可。3.1.3 “修改”按钮返回排行榜主页，点击增减删除项下的“修改”按钮，则进入修改页面（图22）。图22在图22中我们可以输入要修改数据的姓名，新修改的数据，点击提交即可，如图23。图23在提交完成后，则会跳转到新的榜单数据界面，我们可以看到刚才修改的angelno信息（图24）。图243.1.4 “查询”按钮返回排行榜主页，点击“增删改查”项下的“查询”按钮，则进入图25所示的查询页面。图253.2 “前十查询”功能下面介绍数据的“前十查询”功能，即可随时查询、返回任一榜单前十条记录信息。下拉图26中的“前十查询”分类列表，可以呈现出分类列表：签到榜、收藏榜、评论榜、分享榜、购物榜、理财榜和成就榜。图26在“前十查询”列表里面选择签到榜，点击查询，则出现图27所示的签到榜界面。图27中的签到榜会根据签到的次数由大到小排列出来。由此可见，前十查询功能，即可随时查询、返回任一榜单前十条记录信息。图27如果您想查询收藏榜、评论榜、分享榜、购物榜、理财榜、成就榜等有关信息，可以根据上述的方法选择好之后点击查询即可。3.3 “姓名查询”功能接下来讲解“姓名查询”的相关功能。我们还可以在图28中输入想查询的姓名，如lele，如图28。图28在图28中输入姓名“lele”，点击查询即可查询到lele在签到榜、收藏榜等各个榜单中的活动次数及数据表ID，如图29。图293.4 “中心查询”功能中心查询功能，即可随时根据某条记录，查询任一榜单位于这条记录前五、后五名的用户记录信息。图30如图30，在中心查询项下输入姓名（如user3），选择签到榜，点击查询按钮，则会生成XML页面（图31），返回给客户端。图313.5 调试功能图32图32中的调试部分为两个功能函数:rho_query_sort和rho_query_update。3.5.1 rho_query_sort讲解点击“rho_query_sort”按钮，则会跳转到图33所示的页面。图33其功能如下：rho_query_sort用来响应客户端发来的查询请求功能，需要的参数为sig和num，sig为客户端需要查询的哪个榜单，num为客户端要求返回的记录数量。结果通过XML文件形式返回；操作实例：图34如在图34中输入num为5，sig为签到榜，点击提交则会跳转到图35中所示的XML页面。图353.5.2 rho_query_update讲解下面介绍调试部分的rho_query_update功能：rho_query_update用来响应客户端的查询及更新请求功能，客户端发来参数name,sig,value，服务器端通过name参数查得相应的纪录，若存在要查的纪录，则通过sig标志位找到相应的榜单信息，替换成新的value值，如无该纪录，则新建用户名为name的纪录，并将标志为sig的榜单赋值为value。点击“rho_query_update”按钮，则会跳转到图36所示的页面。图36操作实例1：图37首先在图37中我们在姓名中输入姓名：lele，点击查询进入图38中的界面，可以确定lele在各个榜单中有记录信息。图38从图38我们可以看到lele在各个榜单的记录信息：如在签到榜中的记录数据为899。返回主页面点击“rho_query_update”按钮，进入客户端的查询及更新页面。图39在图39中name中输入：lele；sig选择：签到榜；value输入：999，点击提交。返回排行榜页面，在姓名中重新输入“lele”，点击查询。可以查看到lele在各个榜单中有记录信息（图40）：刚才输入的签到榜value值为999。图40操作实例2：针对各个榜单没有的记录信息。图41首先我们在姓名中输入姓名：玛丽（如图41），点击查询进入图42中的界面，可以确定玛丽在各个榜单中没有记录信息。图42返回主页面点击“rho_query_update”按钮，进入客户端的查询及更新页面。图43如图43，在姓名中输入姓名：玛丽。sig选择：签到榜；value输入：1000，点击提交。返回各个榜单的前十条记录信息，可以看到榜单中已经生成姓名为“玛丽”的记录信息，其中签到榜的value数据为刚才输入的1000，如图44。图44以上2个操作实例讲解的是数据库中的查询更新功能，通过客户端请求信息，判断数据库中是否存在相同数据，若查得信息，则对相应的字段值进行替换，若记录不存在，则新建相应的信息。图45返回主页，点击表2中的“理财信息”如图45，进入理财页面（图46）。图46图46中的理财页面可完成数据的增删改查功能，即可在数据表中增加、删除、修改、查询记录。点击“新建”按钮，则进入图47所示的新建页面。该页面中可输入姓名、日期和用户名，点击提交即可。图47返回理财页面，点击“删除”按钮，则进入图48所示的删除页面，输入想删除的用户名点击提交即可删除成功。图48返回理财页面，点击“修改”按钮，则进入图49所示的修改页面，输入想修改的姓名、日期和用户名，点击提交即可修改成功。图49返回理财页面，点击“查询”按钮，则进入图50所示的查询页面，我们可以查询到添加的name、date和username。图50图51返回主页，点击表3中的“收藏信息”如图51，进入收藏信息页面（图52）。图52图52中的收藏信息页面可完成数据的增删改查功能，即可在数据表中增加、删除、修改、查询记录。