1、14搜職天下服務(wù)端軟件 V1.0搜職天下服務(wù)端軟件使用說明書1 概述1.1 編寫目的隨著網(wǎng)絡(luò)的發(fā)展，越來越多的企業(yè)通過互聯(lián)網(wǎng)進行招聘工作，為此本人開發(fā)了搜職天下服務(wù)端軟件。為了確定軟件的最終功能，使軟件能夠真正滿足求職者的需求，更清晰、更明確、更有效的為求職者發(fā)送數(shù)據(jù)，本人針對開發(fā)的搜職天下服務(wù)端軟件特編寫了使用說明書，從而更好的建立起服務(wù)器端開發(fā)人員與用戶的聯(lián)系，并為未來的評價和激勵奠定基礎(chǔ)。1.2 搜職天下服務(wù)端軟件介紹搜職天下服務(wù)端開發(fā)語言為Java、XML、JS、Ruby，部署環(huán)境為linux。數(shù)據(jù)來源是搜索引擎接口。主要負責(zé)接收用戶發(fā)送的查詢請求，然后將查詢請求組合與搜索引擎交互取得

2、商品信息。最后解析接收到的商品信息，顯示給用戶看。后臺使用SQL server 2005數(shù)據(jù)庫系統(tǒng)。1.2.1 軟件含義搜職天下服務(wù)端軟件是整個軟件的核心，提供給求職者最新的職位信息、招聘會信息和職場資訊信息，使求職者隨時隨地都可以使用手機找工作，幫助您不錯過任何一份好工作。本服務(wù)端軟件主要完成服務(wù)端功能，接收搜職天下手機客戶端發(fā)來的請求，回復(fù)相關(guān)內(nèi)容給手機客戶端。主要用于數(shù)據(jù)存儲，以及對客戶端的請求作出相應(yīng)，完成數(shù)據(jù)的交互等操作。環(huán)境為：mysql數(shù)據(jù)庫軟件+rails框架數(shù)據(jù)單元：數(shù)據(jù)庫表1.3 啟動程序本演示程序的服務(wù)器端部分：Script目錄下的Server服務(wù)器。1.4 功能簡介客戶

3、端Ruby on railsmysql數(shù)據(jù)圖1將手機端與服務(wù)器端基本的數(shù)據(jù)同步，使客戶端功能有限實現(xiàn)。目前已經(jīng)實現(xiàn)的功能如下：1.4.1 可完成數(shù)據(jù)的增、刪、改、查功能。即可在數(shù)據(jù)表中增加、刪除、修改、查詢記錄。1.4.2 前十查詢功能，即可隨時查詢、返回任一榜單前十條記錄信息。1.4.3 姓名查詢功能，即輸入姓名查詢該姓名所對應(yīng)的榜單記錄信息。1.4.4 查詢更新功能，通過客戶端請求信息，判斷數(shù)據(jù)庫中是否存在相同數(shù)據(jù)，若查得信息，則對相應(yīng)的字段值進行替換，若記錄不存在，則新建相應(yīng)的信息。1.4.5 排序查詢功能，通過客戶端的請求信息，查詢?nèi)我鈹?shù)量的記錄，并對返回的記錄進行排序。2 服務(wù)器端啟

4、動過程首先進入InstantRails-2.0-win文件夾，運行InstantRails.exe，會出現(xiàn)如圖2所示的提示框。圖2選擇“是”，則會跳出如圖3所示的服務(wù)啟動主頁面。圖3圖4點擊圖4籃圈標注的按鈕，則會出現(xiàn)圖5所得界面。圖5將鼠標放在“Raila Applications”上面，則會呈現(xiàn)圖6中顯示的列表頁面。圖6選擇“Manage Rails Applications”項，進入圖7所示的頁面。圖7圖7中在“Rails Applications”項下選擇“caree”，如圖8所示。圖8然后選擇右側(cè)的“Start with Mongrel”按鈕（圖9圓圈圈標注），則服務(wù)器啟動成功。圖9

5、服務(wù)器啟動后會出現(xiàn)服務(wù)器啟動命令行，如圖10所示。圖10在服務(wù)器啟動成功后，就可以訪問該服務(wù)器上的網(wǎng)頁，見圖11。圖113 數(shù)據(jù)模塊3.1 數(shù)據(jù)增加模塊的設(shè)計 開始自動生成編號寫入數(shù)據(jù)庫結(jié)束輸入數(shù)據(jù)是否合法是否 圖12 數(shù)據(jù)增加流程圖添加信息時，編號字段由系統(tǒng)自動生成，且不能修改，其他信息由用戶輸入，之后對數(shù)據(jù)進行合法判斷，合法則寫入保存至數(shù)據(jù)庫，不合法則重新輸入數(shù)據(jù)。數(shù)據(jù)增加流程圖如12所示。此模塊的設(shè)計在于對各種站內(nèi)信息的增加，先選擇一個類別，例如新用戶的注冊，首先，我們增加這個信息時，會自動生成一個編號，然后輸入用戶的各種信息，如：用戶名，密碼，性別，生日等。在合法的情況下，將其寫入數(shù)據(jù)

6、庫，以提供數(shù)據(jù)的增加。在這個大模塊里主要實現(xiàn)了數(shù)據(jù)的增加，如增加管理員，增加會員，管理員發(fā)布公告，管理員發(fā)布新聞，會員留言等，舉例，添加公告：public void save(TGonggao transientInstance)log.debug(saving TGonggao instance);trygetHibernateTemplate().save(transientInstance);log.debug(save successful); catch (RuntimeException re)log.error(save failed, re);throw re;3.2 數(shù)據(jù)修改

7、模塊當(dāng)用戶選定一條記錄時，單擊刪除按鈕，會提示用戶是否確定刪除，然后刪除數(shù)據(jù)庫相關(guān)內(nèi)容。數(shù)據(jù)刪除流程圖如圖13所示。開始選擇需要修改記錄寫入數(shù)據(jù)庫結(jié)束輸入數(shù)據(jù)是否合法是否 圖13 數(shù)據(jù)修改流程圖往往一個數(shù)據(jù)庫的實現(xiàn)不可或缺的就是修改，我的也不例外，如同每個會員對其密碼，資料的修改等，第一步，先要選擇修改的數(shù)據(jù)，然后輸入新的數(shù)據(jù)，在數(shù)據(jù)合法的情況下將其寫入數(shù)據(jù)庫，完成操作。3.3 數(shù)據(jù)刪除模塊當(dāng)用戶選定一條記錄時，單擊刪除按鈕，會提示用戶是否確定刪除，然后刪除數(shù)據(jù)庫相關(guān)內(nèi)容。數(shù)據(jù)刪除流程圖如圖4.3所示。開始結(jié)束選擇需要刪除記錄是否刪除更新數(shù)據(jù)庫是否 圖14 數(shù)據(jù)刪除流程圖在這個模塊下，我們實現(xiàn)

8、的事數(shù)據(jù)的刪除，對于管理者來說，刪除時不可或缺的，在這里，我們第一步仍然是選擇要刪除的數(shù)據(jù)記錄，然后選擇刪除，并更新數(shù)據(jù)庫。這個模塊主要實現(xiàn)數(shù)據(jù)的刪除，其中包括管理員對公告，新聞，用戶的刪除，以及企業(yè)用戶對招聘信息的刪除等。例如刪除公告，其主要代碼如下：public void delete(TGonggao persistentInstance)log.debug(deleting TGonggao instance);trygetHibernateTemplate().delete(persistentInstance);log.debug(delete successful); catch

9、 (RuntimeException re)log.error(delete failed, re);throw re;4 數(shù)據(jù)庫結(jié)構(gòu)數(shù)據(jù)庫包括6個表：管理員表(admin)、留言表（liuyan）、新聞表（news）、投放簡歷表（toujianli）、用戶表（user）、人才招聘表（zhaopin）。下面分別介紹這些表的結(jié)構(gòu)。(1) 管理員表(admin)表4-1 管理員表(admin)字段名稱字段類型字段長度鍵類型說 明USERID自動編號長整型主鍵用戶編號USERNAMEVarchar50管理帳號USERPWchar32管理密碼(2)留言表（liuyan）表4-2 留言表（liuyan）

10、字段名稱字段類型字段長度鍵類型說 明LIUYAN_ID自動編號長整型主鍵留言編號LIUYAN_TITLEVARCHAR50留言題目LIUYAN_CONTENTVARCHAR5000留言內(nèi)容LIUYAN_DATEVARCHAR50留言日期LIUYAN_USERVARCHAR50發(fā)布者(3) 新聞表（news）表4-3 新聞表（news）字段名稱字段類型字段長度鍵類型說 明NEWS_ID自動編號長整型主鍵新聞編號NEWS_TITLEVARCHAR50新聞題目NEWS_CONTENTVARCHAR8000新聞內(nèi)容NEWS_DATEVARCHAR50發(fā)布日期(4) 投放簡歷表（toujianli）表4

11、-4 投放簡歷表（toujianli）字段名稱字段類型字段長度鍵類型說 明ID自動編號長整型主鍵編號ZHAOPIN_IDINT4外鍵招聘編號USER_IDINT4外鍵用戶編號TOUDISHIJIANVARCHAR50投遞時間(5)用戶表（user）表4-5 用戶表（user）字段名稱字段類型字段長度鍵類型說 明USER_ID自動編號長整型主鍵用戶編號USER_NAMEVARCHAR50用戶名USER_PWVARCHAR50密碼USER_TYPEINT4用戶類型USER_REALNAMEVARCHAR50真實姓名USER_ADDRESSVARCHAR50地點USER_SEXVARCHAR50性別

12、USER_TELVARCHAR50電話USER_EMAILVARCHAR50郵箱USER_AGEVARCHAR50年齡USER_BIRTHDAYVARCHAR50生日USER_XUELIVARCHAR50學(xué)歷(6) 人才招聘表（zhaopin）表4-6 人才招聘表（zhaopin）字段名稱字段類型字段長度鍵類型說 明ID自動編號長整型主鍵編號ZHIWEIVARCHAR50招聘職位XUELIYAOQIUVARCHAR50學(xué)歷要求DAIYUVARCHAR50待遇GONGZUODIDIANVARCHAR50工作地點GONGZUOJINGYANVARCHAR50工作經(jīng)驗QITASHUOMINGVARC

13、HAR50其他說明USER_IDINT4外鍵用戶編號5 搜職天下服務(wù)端與手機客戶端的通信首先，客戶端發(fā)送查詢請求到 &class= &city=&origin= &sort_type=&price_min=10&price_max=100&industry=服務(wù)端會返回搜索到的招聘信息數(shù)量，比如：217。上面列出的參數(shù)可以有一個或者多個，沒有的參數(shù)不用加。然后客戶端第二次發(fā)送請求到 &class= &city=&origin= &sort_type=&price_min=10&price_max=100&industry=&pn=1兩次發(fā)送的參數(shù)應(yīng)保持不變，第二次參數(shù)中需要多加一個參數(shù)pn，p

14、n為返回第幾頁的信息信息。每頁固定返回15條招聘信息，信息以xml格式返回。不加pn的話默認顯示第一頁。客戶端用戶提交查詢請求服務(wù)端接收用戶查詢請求后返回信息第一次發(fā)送請求返回搜索到的信息總數(shù)第二次發(fā)送請求，并指定頁數(shù)以xml格式返回職位招聘信息圖15 搜職天下服務(wù)端與手機客戶端的交互圖6 詳細接口說明手機客戶端與服務(wù)器端需要兩次通信，第一次獲取返回的招聘信息總數(shù)。手機端通過返回的總數(shù)計算共需要顯示多少頁（每頁固定返回15條信息，最后一頁例外）。第二次就可以在參數(shù)中加pn，需要第幾頁的商品信息就將pn設(shè)置為多少，但是注意不要超過本次搜索的最大頁數(shù)（該頁數(shù)通過前面計算得到 信息總數(shù)除以15）。下

15、面列出所有可能用到的參數(shù)信息：pn第幾頁,首頁為1例如：3sort_type排序方式-1為相關(guān)度，1，聚合度，2薪資從低到高，3薪資從高到低keyword關(guān)鍵字例如：銷售Origin來源例如：趕集網(wǎng)City城市例如：北京class分類例如：銷售price_min最低薪資例如：100Price_max最高薪資例如：200industry行業(yè)例如：醫(yī)藥，金融7 根據(jù)fid獲取對應(yīng)招聘信息XML文件當(dāng)我們搜索的招聘信息有聚合時，前面的接口只是返回了聚合后的第一條記錄。但是在返回的欄位里有一個fid欄位，該欄位里包含了相同類別的其它fid.如果我們想查看聚合信息，將會用到下面的接口。該接口可以一次獲取

16、一個或多個fid對應(yīng)的招聘信息記錄。同樣以XML格式返回。多個fid中間用空格隔開 4140 4136多個fid之間以空格分開8 返回XML文件介紹有一些T4I欄位在XML頁面中沒有對應(yīng)的標簽。黃色的區(qū)域為XML頁面所有的標簽。T4I欄位欄位介紹現(xiàn)在XML名新XML名新XML標簽介紹0商城的名字和商家的名字Mallwebsite招聘信息發(fā)布網(wǎng)站1商品名稱及分類nameJob_summary職位簡述2上市時間sell_timePublish_time發(fā)布時間3商品描述DetailsPosition_described職位詳述4顏色ColorEmailEmail地址5評論DiscussCommen

17、t評論T1最低價Now_pricesalary薪資T2商品瀏覽次數(shù)viewsView_num招聘信息瀏覽次數(shù)T3商品購買次數(shù)buyNumber_of_Hiring招聘人數(shù)T4商品被評論次數(shù)Discuss_numComment_num招聘信息評論次數(shù)T5商品的好評率33當(dāng)前價34圖片地址PicPic招聘網(wǎng)站圖片35網(wǎng)站鏈接Web_linkhttp_link網(wǎng)站鏈接36網(wǎng)頁路徑37評論鏈接38庫存狀態(tài)reserve39團購價Tuan_price40返利價Fan_price41原價Yuan_price42折扣價Zhe_price43VIP價Vip_price44會員價Huiyuan_price45地

18、址addressaddress公司地址46電話celphoneCelphone公司電話47商家服務(wù)公司介紹48購物車鏈接longitude經(jīng)度49購買鏈接latitude緯度50圖片鏈接51商品IDXML文件中一些其它的標簽，這些標簽在原始T4I文件中沒有對應(yīng)的欄位，是根據(jù)搜索引擎返回的信息添加的。也是接口不可缺少的。T4I欄位欄位介紹現(xiàn)在XML名新XML名新XML標簽介紹城市CityCity公司所在城市商城數(shù)量Mall_numWebsite_num聚合后招聘相同職位的網(wǎng)站數(shù)量T4I文件idfidsfidsT4I文件id價格區(qū)間Price_rangeSalary_range薪資區(qū)間類別Type666Type招聘信息行業(yè)分類Company招聘公司名上面的mall_num和fids、salary_range是針對當(dāng)有聚合的情況下才有意義。沒有聚合時為一個T4I文件的信息。9 返回XML頁面實例趕集招聘 區(qū)域客戶主管 上市時間：09-02 20:34 顏色：未知 要求：中專及以上學(xué)歷，頭腦靈活，維護客戶關(guān)系 會開車，自備轎車（公司