【文章內(nèi)容簡(jiǎn)介】 ler 的處理 過(guò) 后， 最后 會(huì) 生成統(tǒng)一的 Response實(shí)體形成響應(yīng)， 而且 會(huì) 返回 Response 實(shí)體的 JSON 格式數(shù)據(jù)。 其過(guò)程圖 如下 圖 16： 圖 16 控制 層 架構(gòu)圖 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 8 服務(wù)層架構(gòu)設(shè)計(jì) 服務(wù)層 架構(gòu) 劃分為兩層，分別是 后臺(tái) 內(nèi)容 管理層和 RESTful 資源。 后臺(tái) 內(nèi)容管理層 主要 負(fù)責(zé)系統(tǒng) 對(duì)于 一些 基本資源的管理， RESTful 資源 是 按照功能 來(lái)細(xì)分為各個(gè)部分 ，系統(tǒng) 應(yīng)用 的 資源包括了系統(tǒng)核心業(yè)務(wù)的服務(wù)資源， 系統(tǒng)數(shù)據(jù)資源 包括了系統(tǒng)所需要 的 CRUD 操作接口及實(shí)現(xiàn)。 1. 后臺(tái)內(nèi)容 管理 系統(tǒng)通過(guò)后臺(tái) 內(nèi)容管理 層能夠?qū)?資源進(jìn)行分配管理， 能夠 調(diào)用 RESTful 資源 來(lái) 系統(tǒng)業(yè)務(wù)邏輯 完善 ， 然而 客戶(hù)端 在 網(wǎng)絡(luò)接入 的 情況下 獲取 RESTful 資源，并給用戶(hù) 呈現(xiàn) 一個(gè)良好 的體驗(yàn) 。 如下圖 17 所示： 圖 17 后臺(tái) 內(nèi)容管理系統(tǒng)架構(gòu)圖 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 9 2. RESTful 資源 RESTful 資源中 的 不同的部分劃分 ,如下圖 18 所示： 圖 18 RESTful 資源架構(gòu)圖 基礎(chǔ)設(shè)施層架構(gòu)設(shè)計(jì) 系統(tǒng)可以 在不同的 外設(shè) 上使用，比如在 PC 端 以及移動(dòng) 端連接 訪問(wèn)到服務(wù)器 提供的服務(wù) 。然而 管理員可以 在 PC 上 訪問(wèn)到 后臺(tái)的 管理系統(tǒng) ， 而且能管理一些 圖片、 文件等資源。然而 用戶(hù) 就可以在 不同 的 移動(dòng) 智能 設(shè)備連上 客戶(hù)端 進(jìn)行 兼職 的查詢(xún) 以及兼職 的申請(qǐng)，信息 的 交流等等。 如下圖 17 所 描述： 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 10 圖 17 基礎(chǔ) 設(shè)施層架構(gòu)圖 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 11 2 系統(tǒng) 設(shè)計(jì) 系統(tǒng)概要用例 用例圖主要是指參與者、用例以及它們之間的關(guān)系構(gòu)建成的，用于描述系統(tǒng)功能的動(dòng)態(tài)視圖。用例圖也被稱(chēng)為參與者的外部用戶(hù)所能看到的系統(tǒng)功能模型圖，其中呈現(xiàn)了一部分參與者和一部分用例，以及它們之間的關(guān)系，主要用于對(duì)系統(tǒng)、子系統(tǒng)或類(lèi)的功能行為進(jìn)行建模。 用戶(hù)請(qǐng)求系統(tǒng)的服務(wù)用例圖如下 圖 21： 圖 21 用戶(hù)用例圖 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 12 管理員請(qǐng)求系統(tǒng)的服務(wù)用例圖如下 圖 22： 圖 22 管理員用例圖 系統(tǒng)設(shè)計(jì)用例 規(guī)約 用例規(guī)約是用文本的方式來(lái)表述的，這樣能更加清晰地描述事件流，也可以選擇使用狀態(tài)圖、活動(dòng)圖或時(shí)序圖來(lái)輔助說(shuō)明。只要是有助于更簡(jiǎn)潔的表達(dá)，就能在用例中任意粘貼用戶(hù)界面和流程的圖形化顯示方式。就如活動(dòng)圖對(duì)復(fù)雜的決策流程描述有幫助，狀態(tài)轉(zhuǎn)移圖也對(duì)描述與狀態(tài)相關(guān)的系統(tǒng)行為有幫助，時(shí)序圖適合于描述基于時(shí)間順序的消息傳遞。 由于本系統(tǒng)的系統(tǒng)用例規(guī)約比較多，因此本章節(jié)列出一些核心模塊的用例圖和用例規(guī)約，完整的用例圖和用例規(guī)約請(qǐng)與附錄中查找。 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 13 運(yùn)營(yíng) 數(shù)據(jù) 管理用例 規(guī)約 運(yùn)營(yíng) 數(shù)據(jù) 管理的用例 規(guī)約 如下 圖 23： 圖 22 運(yùn)營(yíng) 數(shù)據(jù)管理 用例 圖 聊天信息 統(tǒng)計(jì) 用例 規(guī)約 如下 ： 用例名稱(chēng)： 聊天信息 統(tǒng)計(jì) 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn) 對(duì)聊天信息的統(tǒng)計(jì) 前置條件： 啟動(dòng)程序，進(jìn)入 信息 統(tǒng)計(jì) 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 1. 用戶(hù)點(diǎn)擊統(tǒng)計(jì)聊天信息 該用戶(hù)是否已登錄 其它事件流： 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 聊天信息 列表 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 14 收藏兼職用例 規(guī)約 如下 ： 用例名稱(chēng)： 收藏 兼職 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn) 收藏兼職 的統(tǒng)計(jì) 前置條件： 啟動(dòng)程序，進(jìn)入 統(tǒng)計(jì) 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 2. 用戶(hù)點(diǎn)擊統(tǒng)計(jì) 收藏 兼職 該用戶(hù)是否已登錄 其它事件流： 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 兼職收藏 列表 報(bào)名兼職 統(tǒng)計(jì) 用例 規(guī)約 如下 ： 用例名稱(chēng)： 報(bào)名兼職統(tǒng)計(jì) 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn)報(bào)名 兼職的統(tǒng)計(jì) 前置條件： 啟動(dòng)程序，進(jìn)入 統(tǒng)計(jì) 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 3. 用戶(hù)點(diǎn)擊統(tǒng)計(jì)報(bào)名 兼職 該用戶(hù)是否已登錄 其它事件流： 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 無(wú) 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 15 閃屏管理用例歸約 閃屏管理 的用例 規(guī)約 如下 圖 23： 圖 23 閃屏 管理 用例 圖 閃屏管理用例 規(guī)約 如下 ： 用例名稱(chēng)： 閃屏管理 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn) 閃屏的管理 前置條件： 啟動(dòng)程序，進(jìn)入 閃屏管理 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 4. 用戶(hù)點(diǎn)擊統(tǒng)計(jì) 閃屏 管理 該用戶(hù)是否已登錄 其它事件流： 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 閃屏 列表 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 16 閃屏管理用例 規(guī)約 如下 ： 用例名稱(chēng)： 添加 閃屏 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn) 閃屏的 添加 前置條件： 啟動(dòng)程序，進(jìn)入 閃屏 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 5. 用戶(hù)點(diǎn)擊統(tǒng)計(jì)閃屏 添加 該用戶(hù)是否已登錄 其它事件流： 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 無(wú) 閃屏其他用例 規(guī)約 如下 ： 用例名稱(chēng)： 閃屏 其他 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn)閃屏的 其他 前置條件： 啟動(dòng)程序，進(jìn)入 閃屏 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 6. 用戶(hù)點(diǎn)擊統(tǒng)計(jì) 其 他 該用戶(hù)是否已登錄 其它事件流： 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 閃屏 列表 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 17 用戶(hù)信息管理用例 規(guī)約 用戶(hù)信息管理的用例規(guī)約如下 圖 24： 圖 24 用戶(hù) 信息管理 用例 圖 用戶(hù)信息 管理 用例 規(guī)約 如下 ： 用例名稱(chēng)： 用戶(hù)信息 管理 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn) 用戶(hù)信息 管理 前置條件： 啟動(dòng)程序，進(jìn)入 用戶(hù) 信息 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響 應(yīng) 7. 用戶(hù)點(diǎn)擊 用戶(hù) 信息管理 該用戶(hù)是否已登錄 其它事件流： 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 用戶(hù) 信息 列表 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 18 用戶(hù)信息 驗(yàn)證 用例 規(guī)約 如下 ： 用例名稱(chēng)： 用戶(hù)信息驗(yàn)證 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn) 用戶(hù)信息驗(yàn)證 前置條件： 啟動(dòng)程序，進(jìn)入 用戶(hù) 信息 驗(yàn)證 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 8. 用戶(hù)點(diǎn)擊用戶(hù) 信息 驗(yàn)證 該用戶(hù)是否已登錄 其它事件流： 統(tǒng)沒(méi)有任何問(wèn)題 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 用戶(hù) 信息 驗(yàn)證 列表 用戶(hù)授權(quán)用例 規(guī)約 如下 ： 用例名稱(chēng)： 用戶(hù)授權(quán) 用例 ID： 角色： 管理員 用例說(shuō)明： 用例主要功能是 實(shí)現(xiàn) 用戶(hù)授權(quán) 前置條件： 啟動(dòng)程序，進(jìn)入 用戶(hù) 授權(quán) 界面 基本事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 9. 用戶(hù)點(diǎn)擊用戶(hù) 授權(quán) 該用戶(hù)是否已登錄 其它事件流： 異常事件流： 參與者動(dòng)作 系統(tǒng)響應(yīng) 無(wú) 無(wú) 后置條件： 用戶(hù) 授權(quán) 信息 列表 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 19 3 系統(tǒng) 實(shí)現(xiàn) Restful 架構(gòu)接口代碼 本 系統(tǒng) 的服務(wù)端 與客戶(hù)端 的 對(duì)接 接口 使用 了 RESTFUL架構(gòu) 的 API設(shè)計(jì)方 式，這樣的系統(tǒng) 分層 設(shè)計(jì) 讓 我們的系統(tǒng)可擴(kuò)展性 得到了 增強(qiáng)。 并且 ，系統(tǒng) 分層 之間存在跨域調(diào)用的問(wèn)題，因此，我們?cè)谙到y(tǒng)內(nèi)加入了 CORS（ CrossOrigin Resource Sharing）的支持， 這是 W3C 中 的一種跨域資源共享規(guī)范， 讓 我們的客戶(hù)端 獲取 服務(wù)端跨域資源更加簡(jiǎn)單 輕松 。 系統(tǒng)在返回碼的設(shè)計(jì)上 ， 基本沿用 協(xié)議的狀態(tài)碼，在錯(cuò)誤碼上 也 大部分 沿用 協(xié)議 的錯(cuò)誤碼。 返回碼： 表 31 返回碼 返回碼 含義 說(shuō)明 200 SUCCESS 操作成功 201 CREATED 創(chuàng)建成功 202 ACCEPTED 更新成功 400 BAD_REQUEST 請(qǐng)求地址不存在或者包含不支持的參數(shù) 401 UNAUTHORIZED 未授權(quán) 403 FORBIDDEN 被禁止訪問(wèn) 404 NOT_FOUND 請(qǐng)求資源不存在 415 UNSUPPORTED_MEDIA_TYPE 服務(wù)器無(wú)法處理請(qǐng)求附帶的媒體格式 500 INTERNAL_SERVER_ERROR 內(nèi)部錯(cuò)誤 501 NOT_IMPLEMENTED 服務(wù)器不支持請(qǐng)求的功能，無(wú)法完成請(qǐng)求 502 BAD_GATEWAY 充當(dāng)網(wǎng)關(guān)或代理的服務(wù)器，從遠(yuǎn)端服務(wù)器收到了一個(gè)無(wú)效的請(qǐng)求 999 Fail 失敗返回碼 錯(cuò)誤碼 ： 表 32 錯(cuò)誤碼 錯(cuò)誤碼 含義 說(shuō)明 1000 NEED_PERMISSION 需要權(quán)限 1001 URI_NOT_FOUND 資源不存在 1002 MISSING_ARGS 參數(shù)不全 口袋兼職 APP 服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn) 20 1003 IMAGE_TOO_LARGE 上傳的圖片太大 1004 HAS_BAN_WORD 輸入有違禁詞 1005 INPUT_TOO_SHORT 輸入為空，或者輸入字?jǐn)?shù)不夠 1006 TARGET_NOT_FOUNT 相關(guān)的對(duì)象不存在 1007 NEED_CAPTCHA 需要驗(yàn)證碼，驗(yàn)證碼有誤 1008 IMAGE_UNKNOW 不支持的圖片格式 1009 IMAGE_WRONG_FORMAT 照片格式有誤 (僅支持JPG,JPEG,GIF,PNG 或BMP) 1010 NOT_LOGGED_IN 未登錄 1011 TOKEN_IS_EMPTY token 為空 1012 USER_NOT_EXIST 用戶(hù)不存在 1025 RUNTIME_EXC