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

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

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

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

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

6、庫，以提供數據的增加。在這個大模塊里主要實現了數據的增加，如增加管理員，增加會員，管理員發布公告，管理員發布新聞，會員留言等，舉例，添加公告：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 數據修改

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

8、的事數據的刪除，對于管理者來說，刪除時不可或缺的，在這里，我們第一步仍然是選擇要刪除的數據記錄，然后選擇刪除，并更新數據庫。這個模塊主要實現數據的刪除，其中包括管理員對公告，新聞，用戶的刪除，以及企業用戶對招聘信息的刪除等。例如刪除公告，其主要代碼如下：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 數據庫結構數據庫包括6個表：管理員表(admin)、留言表（liuyan）、新聞表（news）、投放簡歷表（toujianli）、用戶表（user）、人才招聘表（zhaopin）。下面分別介紹這些表的結構。(1) 管理員表(admin)表4-1 管理員表(admin)字段名稱字段類型字段長度鍵類型說 明USERID自動編號長整型主鍵用戶編號USERNAMEVarchar50管理帳號USERPWchar32管理密碼(2)留言表（liuyan）表4-2 留言表（liuyan）

10、字段名稱字段類型字段長度鍵類型說 明LIUYAN_ID自動編號長整型主鍵留言編號LIUYAN_TITLEVARCHAR50留言題目LIUYAN_CONTENTVARCHAR5000留言內容LIUYAN_DATEVARCHAR50留言日期LIUYAN_USERVARCHAR50發布者(3) 新聞表（news）表4-3 新聞表（news）字段名稱字段類型字段長度鍵類型說 明NEWS_ID自動編號長整型主鍵新聞編號NEWS_TITLEVARCHAR50新聞題目NEWS_CONTENTVARCHAR8000新聞內容NEWS_DATEVARCHAR50發布日期(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學歷(6) 人才招聘表（zhaopin）表4-6 人才招聘表（zhaopin）字段名稱字段類型字段長度鍵類型說 明ID自動編號長整型主鍵編號ZHIWEIVARCHAR50招聘職位XUELIYAOQIUVARCHAR50學歷要求DAIYUVARCHAR50待遇GONGZUODIDIANVARCHAR50工作地點GONGZUOJINGYANVARCHAR50工作經驗QITASHUOMINGVARC

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

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

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

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

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

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