一、項目介紹
題目:基於微信公眾號的用戶認證服務平台及前端插件。
內容:可用於桌面Web、桌面軟件等場景的二維碼掃碼驗證用戶,及微信瀏覽器自動驗證用戶。
二、軟件架構
本項目為Web項目,可以采用B/S架構,簡化系統的開發、維護和使用,實現快速開發與迭代。具體而言,采用B/S的變體:三層架構進行項目構建。
UI(表現層):
主要是指與用戶交互的界面。用於接收用戶輸入的數據和顯示處理后用戶需要的數據。
BLL(業務邏輯層):
UI層和DAL層之間的橋梁。實現業務邏輯。業務邏輯具體包含:驗證、計算、業務規則等等。
DAL(數據訪問層):
與數據庫打交道。主要實現對數據的增、刪、改、查。將存儲在數據庫中的數據提交給業務層,同時將業務層處理的數據保存到數據庫。
三層是為了解決整個應用程序中各個業務操作過程中不同階段的代碼封裝的問題,為了使程序員更加專注的處理某階段的業務邏輯。比如將數據庫操作代碼封裝到DAL層中,提供一些方法根據參數直接返回用戶需要的相應數據,這樣在處理具體的業務邏輯的時候,就不用關心數據的存儲問題了。而業務實體是面向對象思想的體現,貫穿於三層中,進行數據的傳遞。
三、設計模式
為了解決應用程序用戶界面的樣式替換問題,把展示數據的 HTML 頁面盡可能的和業務代碼分離,則具體設計模式可以使用MVC設計模式。這也是目前主流的Web視圖層設計模式。
MVC把純凈的界面展示邏輯(用戶界面)獨立到一些文件中(Views),把一些和用戶交互的程序邏輯(Controller)單獨放在一些文件中,在 Views 和 Controller 中傳遞數據使用一些專門封裝數據的實體對象,這些對象,統稱為Models。
Model(模型)
模型代表一個存取數據的對象或 Java POJO。它也可以帶有邏輯,在數據變化時更新控制器。
View(視圖)
視圖代表模型包含的數據的可視化。
Controller(控制器)
控制器作用於模型和視圖上。它控制數據流向模型對象,並在數據變化時更新視圖。它使視圖與模型分離開。
四、微信API文檔
1、臨時二維碼,是有過期時間的,最長可以設置為在二維碼生成后的30天(即2592000秒)后過期,但能夠生成較多數量。臨時二維碼主要用於帳號綁定等不要求二維碼永久保存的業務場景 2、永久二維碼,是無過期時間的,但數量較少(目前為最多10萬個)。永久二維碼主要用於適用於帳號綁定、用戶來源統計等場景。
用戶掃描帶場景值二維碼時,可能推送以下兩種事件:
如果用戶還未關注公眾號,則用戶可以關注公眾號,關注后微信會將帶場景值關注事件推送給開發者。
如果用戶已經關注公眾號,在用戶掃描后會自動進入會話,微信也會將帶場景值掃描事件推送給開發者。
獲取帶參數的二維碼的過程包括兩步,首先創建二維碼ticket,然后憑借ticket到指定URL換取二維碼。
創建二維碼ticket
每次創建二維碼ticket需要提供一個開發者自行設定的參數(scene_id),分別介紹臨時二維碼和永久二維碼的創建二維碼ticket過程。
臨時二維碼請求說明
http請求方式: POST URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN POST數據格式:json POST數據例子:{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}} 或者也可以使用以下POST數據創建字符串形式的二維碼參數:{"expire_seconds": 604800, "action_name": "QR_STR_SCENE", "action_info": {"scene": {"scene_str": "test"}}}
永久二維碼請求說明
http請求方式: POST URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN POST數據格式:json POST數據例子:{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}} 或者也可以使用以下POST數據創建字符串形式的二維碼參數: {"action_name": "QR_LIMIT_STR_SCENE", "action_info": {"scene": {"scene_str": "test"}}}
參數說明
參數 |
說明 |
expire_seconds |
該二維碼有效時間,以秒為單位。 最大不超過2592000(即30天),此字段如果不填,則默認有效期為30秒。 |
action_name |
二維碼類型,QR_SCENE為臨時的整型參數值,QR_STR_SCENE為臨時的字符串參數值,QR_LIMIT_SCENE為永久的整型參數值,QR_LIMIT_STR_SCENE為永久的字符串參數值 |
action_info |
二維碼詳細信息 |
scene_id |
場景值ID,臨時二維碼時為32位非0整型,永久二維碼時最大值為100000(目前參數只支持1--100000) |
scene_str |
場景值ID(字符串形式的ID),字符串類型,長度限制為1到64 |
返回說明
正確的Json返回結果:
{"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm
3sUw==","expire_seconds":60,"url":"http://weixin.qq.com/q/kZgfwMTm72WWPkovabbI"}
參數 |
說明 |
ticket |
獲取的二維碼ticket,憑借此ticket可以在有效時間內換取二維碼。 |
expire_seconds |
該二維碼有效時間,以秒為單位。 最大不超過2592000(即30天)。 |
url |
二維碼圖片解析后的地址,開發者可根據該地址自行生成需要的二維碼圖片 |
通過ticket換取二維碼
獲取二維碼ticket后,開發者可用ticket換取二維碼圖片。請注意,本接口無須登錄態即可調用。
請求說明
HTTP GET請求(請使用https協議)https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET 提醒:TICKET記得進行UrlEncode
返回說明
ticket正確情況下,http 返回碼是200,是一張圖片,可以直接展示或者下載。
HTTP頭(示例)如下: Accept-Ranges:bytes Cache-control:max-age=604800 Connection:keep-alive Content-Length:28026 Content-Type:image/jpg Date:Wed, 16 Oct 2013 06:37:10 GMT Expires:Wed, 23 Oct 2013 14:37:10 +0800 Server:nginx/1.4.1
五、執行視圖
六、實現視圖
七、部署視圖
八、概念原型與核心工作機制
用戶在需要適當的環境調用該插件,提供服務器域名,生成二維碼,對訪問者進行身份認證。
九、總結
通過這兩次的作業,我對軟件的分析與設計流程有了一個初步的認識,在后面的學習中應該更側重於對各類描述軟件的各個角度的視圖的作圖方法與工具的學習,畫出更規范更標准的圖。