購物參謀服務(wù)端軟件使用說明書

1、PAGE PAGE 37團(tuán)購參謀服務(wù)端軟件 V1.0團(tuán)購參謀服務(wù)端軟件使用說明書1 軟件概述1.1編寫目的為了確定系統(tǒng)的最終功能，使系統(tǒng)能夠真正滿足用戶的需求，更清晰、更明確、更有效的為用戶發(fā)送數(shù)據(jù)，開發(fā)人員為此編寫了團(tuán)購參謀服務(wù)端軟件使用說明書，從而更好的建立起服務(wù)器端開發(fā)人員與用戶的聯(lián)系，并為未來的評(píng)價(jià)和激勵(lì)奠定基礎(chǔ)。1.2服務(wù)端介紹1.2.1服務(wù)端定義服務(wù)端主要用于數(shù)據(jù)存儲(chǔ)，以及對(duì)客戶端的請(qǐng)求作出相應(yīng)，完成數(shù)據(jù)的交互等操作。環(huán)境為：mysql數(shù)據(jù)庫軟件+rails框架數(shù)據(jù)單元：數(shù)據(jù)庫表1.2.2服務(wù)端主要功能客戶端客戶端Ruby on railsmysql數(shù)據(jù)將手機(jī)端與服務(wù)器端基本的數(shù)據(jù)

2、同步，使客戶端功能有限實(shí)現(xiàn)。目前已經(jīng)實(shí)現(xiàn)的功能如下：可完成數(shù)據(jù)的增、刪、改、查功能。即可在數(shù)據(jù)表中增加、刪除、修改、查詢記錄。前十查詢功能，即可隨時(shí)查詢、返回任一榜單前十條記錄信息。姓名查詢功能，即輸入姓名查詢?cè)撔彰鶎?duì)應(yīng)的榜單記錄信息。中心查詢功能，即可隨時(shí)根據(jù)某條記錄，查詢?nèi)我话駟挝挥谶@條記錄前五、后五名的用戶記錄信息。范圍查詢功能，可根據(jù)任意榜單的區(qū)間數(shù)據(jù)，查詢出位于這一區(qū)間的所有記錄。查詢更新功能，通過客戶端請(qǐng)求信息，判斷數(shù)據(jù)庫中是否存在相同數(shù)據(jù)，若查得信息，則對(duì)相應(yīng)的字段值進(jìn)行替換，若記錄不存在，則新建相應(yīng)的信息。排序查詢功能，通過客戶端的請(qǐng)求信息，查詢?nèi)我鈹?shù)量的記錄，并對(duì)返回的記錄

3、進(jìn)行排序。購物榜單批量上傳功能，完成若干條購物記錄信息的上傳功能，服務(wù)器對(duì)客戶端的請(qǐng)求做出解析，提取出相應(yīng)的記錄，于數(shù)據(jù)庫端新建記錄，存儲(chǔ)購物記錄數(shù)據(jù)。1.3啟動(dòng)程序本演示程序的服務(wù)器端部分：Script目錄下的Server服務(wù)器。1.4數(shù)據(jù)庫軟件及版本號(hào)mysql軟件（版本號(hào)5.5）2 服務(wù)器端啟動(dòng)過程服務(wù)器的系統(tǒng)啟動(dòng)過程有2種方法：2.1服務(wù)器系統(tǒng)啟動(dòng)過程（第1種方法）在圖1中輸入cd list_self命令，進(jìn)入list_self項(xiàng)目目錄中。圖1圖2在圖2中輸入ruby .script/server命令，啟動(dòng)網(wǎng)絡(luò)服務(wù)器。圖3啟動(dòng)網(wǎng)絡(luò)服務(wù)器成功之后，則進(jìn)入圖3所示的界面。2.2 服務(wù)器系統(tǒng)

4、啟動(dòng)過程（第2種方法）首先進(jìn)入InstantRails-2.0-win文件夾，運(yùn)行InstantRails.exe，會(huì)出現(xiàn)如圖4所示的提示框。圖4選擇“是”，則會(huì)跳出如圖5所示的服務(wù)啟動(dòng)主頁面。圖5圖6點(diǎn)擊圖6籃圈標(biāo)注的按鈕，則會(huì)出現(xiàn)圖7所得界面。圖7將鼠標(biāo)放在“Raila Applications”上面，則會(huì)呈現(xiàn)圖8中顯示的列表頁面。圖8選擇“Manage Rails Applications”項(xiàng)，進(jìn)入圖9所示的頁面。圖9圖9中在“Rails Applications”項(xiàng)下選擇“tuangou”，如圖10所示。圖10然后選擇右側(cè)的“Start with Mongrel”按鈕（圖11藍(lán)圈標(biāo)注）

5、，則服務(wù)器啟動(dòng)成功。圖11服務(wù)器啟動(dòng)后會(huì)出現(xiàn)服務(wù)器啟動(dòng)命令行，如圖12所示。圖123 服務(wù)器數(shù)據(jù)庫管理在服務(wù)器啟動(dòng)成功后，就可以訪問該服務(wù)器上的網(wǎng)頁，見圖13。圖13圖13訪問的url為： HYPERLINK http:/localhost:3002/lzj/shenghuo http:/localhost:3002/lzj/shenghuo。localhost為本地地址3002為端口號(hào)。此時(shí)，mm項(xiàng)目已加載到服務(wù)器。我們可以查看數(shù)據(jù)庫的表結(jié)構(gòu)（圖14）：圖14Field項(xiàng)下的列表是數(shù)據(jù)庫表里面的域；Type指域的類型；Null指是否允許為空Key指是否為關(guān)鍵字Default指默認(rèn)值；Extr

6、a指一些描述信息。圖15在服務(wù)器啟動(dòng)成功后，我們還可以訪問另一個(gè)服務(wù)器上的網(wǎng)頁。訪問url： HYPERLINK http:/localhost:3001/sta/index http:/localhost:3001/sta/index，如圖15。其中，localhost為本地地址；3001為端口號(hào)；Sta為控制的類；showall為對(duì)應(yīng)的方法。從圖15中我們可以看出數(shù)據(jù)庫表有3項(xiàng)：排行榜、理財(cái)信息和收藏信息。首先我們先看一下排行榜。點(diǎn)擊“排行榜”則跳轉(zhuǎn)到圖16所示的界面。圖163.1 “增刪改查”功能圖17首先介紹數(shù)據(jù)的“增刪改查”功能。如圖17中，增刪改查選項(xiàng)有“新建”、“刪除”、“修改”

7、、“全部”4個(gè)按鈕（籃圈所示），可完成數(shù)據(jù)的增、刪、改、查功能，即可在數(shù)據(jù)表中增加、刪除、修改、查詢記錄。3.1.1“新建”按鈕點(diǎn)擊排行榜主頁的“新建”按鈕，則跳轉(zhuǎn)到圖18中的頁面。圖18在圖18中可填寫姓名及簽到、收藏、評(píng)論、分享、購物、理財(cái)、成就的次數(shù)，點(diǎn)擊提交即可（如圖19）。圖19提交成功之后，則會(huì)跳轉(zhuǎn)到榜單數(shù)據(jù)界面，我們可以看到剛才添加的angelno信息（圖20）。圖203.1.2“刪除”按鈕返回排行榜主頁，點(diǎn)擊排行榜主頁的“刪除”按鈕，則進(jìn)入刪除頁面（圖21）。圖21在圖21姓名欄中輸入要?jiǎng)h除的榜單名字或者直接輸入ID號(hào)，點(diǎn)擊提交即可。3.1.3“修改”按鈕返回排行榜主頁，點(diǎn)擊增

8、減刪除項(xiàng)下的“修改”按鈕，則進(jìn)入修改頁面（圖22）。圖22在圖22中我們可以輸入要修改數(shù)據(jù)的姓名，新修改的數(shù)據(jù)，點(diǎn)擊提交即可，如圖23。圖23在提交完成后，則會(huì)跳轉(zhuǎn)到新的榜單數(shù)據(jù)界面，我們可以看到剛才修改的angelno信息（圖24）。圖243.1.4“查詢”按鈕返回排行榜主頁，點(diǎn)擊“增刪改查”項(xiàng)下的“查詢”按鈕，則進(jìn)入圖25所示的查詢頁面。圖253.2 “前十查詢”功能下面介紹數(shù)據(jù)的“前十查詢”功能，即可隨時(shí)查詢、返回任一榜單前十條記錄信息。下拉圖26中的“前十查詢”分類列表，可以呈現(xiàn)出分類列表：簽到榜、收藏榜、評(píng)論榜、分享榜、購物榜、理財(cái)榜和成就榜。圖26在“前十查詢”列表里面選擇簽到榜，

9、點(diǎn)擊查詢，則出現(xiàn)圖27所示的簽到榜界面。圖27中的簽到榜會(huì)根據(jù)簽到的次數(shù)由大到小排列出來。由此可見，前十查詢功能，即可隨時(shí)查詢、返回任一榜單前十條記錄信息。圖27如果您想查詢收藏榜、評(píng)論榜、分享榜、購物榜、理財(cái)榜、成就榜等有關(guān)信息，可以根據(jù)上述的方法選擇好之后點(diǎn)擊查詢即可。3.3 “姓名查詢”功能接下來講解“姓名查詢”的相關(guān)功能。我們還可以在圖28中輸入想查詢的姓名，如lele，如圖28。圖28在圖28中輸入姓名“l(fā)ele”，點(diǎn)擊查詢即可查詢到lele在簽到榜、收藏榜等各個(gè)榜單中的活動(dòng)次數(shù)及數(shù)據(jù)表ID，如圖29。圖293.4“中心查詢”功能中心查詢功能，即可隨時(shí)根據(jù)某條記錄，查詢?nèi)我话駟挝挥谶@

10、條記錄前五、后五名的用戶記錄信息。圖30如圖30，在中心查詢項(xiàng)下輸入姓名（如user3），選擇簽到榜，點(diǎn)擊查詢按鈕，則會(huì)生成XML頁面（圖31），返回給客戶端。圖313.5 調(diào)試功能圖32圖32中的調(diào)試部分為兩個(gè)功能函數(shù):rho_query_sort和rho_query_update。3.5.1rho_query_sort講解點(diǎn)擊“rho_query_sort”按鈕，則會(huì)跳轉(zhuǎn)到圖33所示的頁面。圖33其功能如下：rho_query_sort用來響應(yīng)客戶端發(fā)來的查詢請(qǐng)求功能，需要的參數(shù)為sig和num，sig為客戶端需要查詢的哪個(gè)榜單，num為客戶端要求返回的記錄數(shù)量。結(jié)果通過XML文件形式返回

11、；操作實(shí)例：圖34如在圖34中輸入num為5，sig為簽到榜，點(diǎn)擊提交則會(huì)跳轉(zhuǎn)到圖35中所示的XML頁面。圖353.5.2rho_query_update講解下面介紹調(diào)試部分的rho_query_update功能：rho_query_update用來響應(yīng)客戶端的查詢及更新請(qǐng)求功能，客戶端發(fā)來參數(shù)name,sig,value，服務(wù)器端通過name參數(shù)查得相應(yīng)的紀(jì)錄，若存在要查的紀(jì)錄，則通過sig標(biāo)志位找到相應(yīng)的榜單信息，替換成新的value值，如無該紀(jì)錄，則新建用戶名為name的紀(jì)錄，并將標(biāo)志為sig的榜單賦值為value。點(diǎn)擊“rho_query_update”按鈕，則會(huì)跳轉(zhuǎn)到圖36所示的頁面

12、。圖36操作實(shí)例1：圖37首先在圖37中我們?cè)谛彰休斎胄彰簂ele，點(diǎn)擊查詢進(jìn)入圖38中的界面，可以確定lele在各個(gè)榜單中有記錄信息。圖38從圖38我們可以看到lele在各個(gè)榜單的記錄信息：如在簽到榜中的記錄數(shù)據(jù)為899。返回主頁面點(diǎn)擊“rho_query_update”按鈕，進(jìn)入客戶端的查詢及更新頁面。圖39在圖39中name中輸入：lele；sig選擇：簽到榜；value輸入：999，點(diǎn)擊提交。返回排行榜頁面，在姓名中重新輸入“l(fā)ele”，點(diǎn)擊查詢。可以查看到lele在各個(gè)榜單中有記錄信息（圖40）：剛才輸入的簽到榜value值為999。圖40操作實(shí)例2：針對(duì)各個(gè)榜單沒有的記錄信息。

13、圖41首先我們?cè)谛彰休斎胄彰含旣悾ㄈ鐖D41），點(diǎn)擊查詢進(jìn)入圖42中的界面，可以確定瑪麗在各個(gè)榜單中沒有記錄信息。圖42返回主頁面點(diǎn)擊“rho_query_update”按鈕，進(jìn)入客戶端的查詢及更新頁面。圖43如圖43，在姓名中輸入姓名：瑪麗。sig選擇：簽到榜；value輸入：1000，點(diǎn)擊提交。返回各個(gè)榜單的前十條記錄信息，可以看到榜單中已經(jīng)生成姓名為“瑪麗”的記錄信息，其中簽到榜的value數(shù)據(jù)為剛才輸入的1000，如圖44。圖44以上2個(gè)操作實(shí)例講解的是數(shù)據(jù)庫中的查詢更新功能，通過客戶端請(qǐng)求信息，判斷數(shù)據(jù)庫中是否存在相同數(shù)據(jù)，若查得信息，則對(duì)相應(yīng)的字段值進(jìn)行替換，若記錄不存在，則新建相應(yīng)的信息。圖45返回主頁，點(diǎn)擊表2中的“理財(cái)信息”如圖45，進(jìn)入理財(cái)頁面（圖46）。圖46圖46中的理財(cái)頁面可完成數(shù)據(jù)的增刪改查功能，即可在數(shù)據(jù)表中增加、刪除、修改、查詢記錄。點(diǎn)擊“新建”按鈕，則進(jìn)入圖47所示的新建頁面。該頁面中可輸入姓名、日期和用戶名，點(diǎn)擊提交即可。圖47返回理財(cái)頁面，點(diǎn)擊“刪除”按鈕，則進(jìn)入圖48所示的刪除頁面，輸入想刪除的用戶名點(diǎn)擊提交即可刪除