微信公眾平臺開發教程（八）Session處理
阿新 • • 發佈：2017-08-08
class 如果 obj returns name ref car opera 信用 
在微信窗口，輸入的信息有限，我們需要將一些信息分多次請求。
比如：在進行用戶綁定時，我們需要輸入用戶的相關信息，比如：用戶名、密碼，或者姓名、電話號碼，服務端驗證通過，即可將系統用戶與微信用戶綁定。
然後，此微信賬戶就有一定的功能權限了，可以查積分，消費記錄等。服務號：招商銀行信用卡，就有很多功能。
微信客戶端無法緩存信息，而且輸入信息有限，需要進行多次請求，在服務端保存當前會話狀態。這就需要Session。
本文以用戶認證，綁定賬號為例，來說明具體處理。
一、創建通用的Session處理機制。
為了更好的說明原理，便於擴展，我們來自己設計Session。當然，這裏也可以使用System.Web.SessionState.HttpSessionState,這是Web常用的Session機制。
1、自定義Session
用於存儲會話片段以及相關數據。
class Session
{
/// <summary>
/// 緩存hashtable
/// </summary>
private static Hashtable mDic = new Hashtable();
/// <summary>
/// 添加
/// </summary>
/// <param name="key">key</param>
/// <param name="value">value</param>
public static void Add(string key, object value)
{
mDic[key] = value;
}
/// <summary>
/// 移除
/// </summary>
/// <param name="key">key</param>
public static void Remove(string key)
{
if (Contains(key))
{
mDic.Remove(key);
}
}
/// <summary>
/// 設置值
/// </summary>
/// <param name="key"></param>
/// <param name="value"></param>
public static void Set(string key, object value)
{
mDic[key] = value;
}
/// <summary>
/// 獲取值
/// </summary>
/// <param name="key"></param>
/// <returns></returns>
public static object Get(string key)
{
return mDic[key];
}
/// <summary>
/// 是否含有
/// </summary>
/// <param name="key">key</param>
/// <returns>bool</returns>
public static bool Contains(string key)
{
return mDic.ContainsKey(key);
}
/// <summary>
/// 清空所有項
/// </summary>
public static void Clear()
{
mDic.Clear();
}
}
2、操作類型
記錄具體的操作類型，標識當前會話的具體操作
/// <summary>
/// 操作類型
/// </summary>
enum Operation
{
/// <summary>
/// 認證
/// </summary>
Auth,
/// <summary>
/// 添加用戶
/// </summary>
CreateUser
}
3、操作過程枚舉
用於標識當前操作，處於哪一個階段，不同階段做不同的處理。
/// <summary>
/// 操作過程
/// </summary>
enum OperationStage
{
/// <summary>
/// 默認
/// </summary>
Default,
/// <summary>
/// 第一步
/// </summary>
First,
/// <summary>
/// 第二步
/// </summary>
Second,
/// <summary>
/// 第三步
/// </summary>
Third
}
4、Session緩存項
緩存記錄的項，這裏面記錄了操作類型、操作步驟以及會話對象。為了便於進行Session管理，還增加了最後訪問時間，是否自動清除標識。
class SessionItem
{
/// <summary>
/// 操作類型
/// </summary>
public Operation Oper { get; set; }
/// <summary>
/// 當前步驟
/// </summary>
public OperationStage Stage { get; set; }
/// <summary>
/// 數據對象
/// </summary>
public object Data { get; set; }
/// <summary>
/// 是否自動刪除
/// </summary>
public bool AutoRemove
{
get;
set;
}
/// <summary>
/// 最後更新時間
/// </summary>
public DateTime UpdateTime { get; set; }
}
二、就要在消息處理中，加入Session處理。
1、增加緩存項數據對象
這個對象，記錄用戶在會話過程中，錄入的相關信息。也是作為業務處理數據提供對象。
class AuthSessionItem
{
/// <summary>
/// 用戶名
/// </summary>
public string FromUserName { get; set; }
/// <summary>
/// 賬號
/// </summary>
public string Code { get; set; }
/// <summary>
/// 唯一標識
/// </summary>
public string ID { get; set; }
}
2、認證處理過程
1）開始進入認證，根據認證關鍵字進行標識，啟動會話，並緩存相關數據
2）提示錄入個人賬號信息
3）微信用戶錄入個人賬號，服務端記錄賬號信息，並提示錄入員工卡號
4）微信用戶錄入卡號信息，服務端記錄卡號信息，並調用具體的認證邏輯
5）用戶認證通過，綁定微信OpenId，提示成功綁定信息，並清除會話。
在認證過程中，需要對用戶錄入信息進行合法性驗證，而且在會話過程中，支持用戶退出當前操作。
/// <summary>
/// 認證用戶信息
/// </summary>
/// <param name="tm"></param>
/// <returns></returns>
private bool Auth(TextMessage tm, ref string response)
{
SessionItem sessionItem = null;
if (string.Equals(tm.Content, "Auth", StringComparison.OrdinalIgnoreCase))
{
//檢查是否已經認證,業務組件驗證
if (UserManager.IsAuth(tm.FromUserName))
{
//如果已經認證，提示
tm.Content = "您已經認證過了，無需再次認證！";
}
else
{
AuthSessionItem authSessionItem = new AuthSessionItem();
authSessionItem.FromUserName = tm.FromUserName;
sessionItem.Oper = Operation.Auth;
sessionItem.Stage = OperationStage.First;
sessionItem.Data = authSessionItem;
Session.Set(tm.FromUserName, sessionItem);
//輸入賬號，並將數據和步驟，寫入緩存
tm.Content = "請輸入您的個人賬號";
}
response = ResponseText(tm);
return false;
}
//從Session獲取用戶信息
sessionItem = Session.Get(tm.FromUserName) as SessionItem;
//如果會話存在，且當前操作為用戶認證
if (sessionItem != null && sessionItem.Oper == Operation.Auth)
{
if (sessionItem.Stage == OperationStage.First)
{
tm.Content = tm.Content.Trim();
if (string.IsNullOrEmpty(tm.Content) || tm.Content.Length > 20)
{
tm.Content = "輸入的個人賬號不合法，請重新輸入。";
response = ResponseText(tm);
return false;
}
AuthSessionItem authSessionItem = sessionItem.Data as AuthSessionItem;
if (authSessionItem != null)
{
authSessionItem.Code = tm.Content;
}
//更新緩存
sessionItem.Stage = OperationStage.Second;
Session.Set(tm.FromUserName, sessionItem);
tm.Content = "請輸入您的員工卡號！\n退出認證請輸入Exit。";
response = ResponseText(tm);
}
else if (sessionItem.Stage == OperationStage.Second)
{
string cardNum = null;
if (!Common.TryConvertToCardNum(tm.Content, out cardNum))
{
tm.Content = "員工卡號不合法,請重新輸入。\n退出認證請輸入Exit。";
response = ResponseText(tm);
return false;
}
AuthSessionItem authSessionItem = sessionItem.Data as AuthSessionItem;
if (authSessionItem != null)
{
authSessionItem.ID = cardNum;
}
//認證
string message;
if (UserManager.Authenticate(authSessionItem, out message))
{
tm.Content = "祝賀您，已經認證成功，可以使用通訊錄的查詢功能呢。";
//清理緩存
Session.Remove(tm.FromUserName);
response = ResponseText(tm);
return true;
}
else if (!string.IsNullOrEmpty(message))
{
tm.Content = message;
}
else
{
tm.Content = "您輸入的信息有誤。\n重新認證請輸入：Auth!";
}
//過程結束：清理Session
Session.Remove(tm.FromUserName);
response = ResponseText(tm);
return false;
}
}
return false;
}
3、退出會話，清理Session
在認證過程中，用戶可以通過命令，強制退出當前操作，在退出當前操作時，需要清理會話信息。
/// <summary>
/// 退出，並清理Session
/// </summary>
/// <param name="tm"></param>
/// <param name="response"></param>
/// <returns></returns>
private bool Exit(TextMessage tm, ref string response)
{
//退出
if (string.Equals(tm.Content, "Exit", StringComparison.OrdinalIgnoreCase))
{
//清除Session
Session.Remove(tm.FromUserName);
tm.Content = "您已退出當前操作，請執行其他操作。";
response = ResponseText(tm);
return true;
}
return false;
}
三、用戶認證通過，綁定微信賬戶
用戶認證通過，並綁定微信OpenId，通過OpenId即可查詢通訊錄、查詢個人積分以及消費記錄等操作了。用戶認證是一個身份認證過程，也是一個用戶綁定過程。用戶身份認證通過，即可通過微信賬號查詢具體信息了。這時候業務層可以根據微信分配的OpenId直接查詢用戶相關信息。
四、後記
通過這種方法，公眾賬號，可以通過小小的文本輸入框，實現更多、更復雜的業務應用。當然，還是通過提供網頁來進行信息錄入，更直觀便捷。
微信公眾平臺開發教程（八）Session處理