（轉）微信公衆平臺開發教程（七）Session處理

原文地址：http://www.cnblogs.com/yank/p/3476874.html

微信公衆平臺開發教程（七）Session處理 

在微信窗口，輸入的信息有限，咱們須要將一些信息分屢次請求。

好比：在進行用戶綁定時，咱們須要輸入用戶的相關信息，好比：用戶名、密碼，或者姓名、電話號碼，服務端驗證經過，便可將系統用戶與微信用戶綁定。

而後，此微信帳戶就有必定的功能權限了，能夠查積分，消費記錄等。服務號：招商銀行信用卡，就有不少功能。

微信客戶端沒法緩存信息，並且輸入信息有限，須要進行屢次請求，在服務端保存當前會話狀態。這就須要Session。

本文以用戶認證，綁定帳號爲例，來講明具體處理。 

1、建立通用的Session處理機制。

爲了更好的說明原理，便於擴展，咱們來本身設計Session。固然，這裏也可使用System.Web.SessionState.HttpSessionState,這是Web經常使用的Session機制。

一、自定義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();
        }
    }

二、操做類型

記錄具體的操做類型，標識當前會話的具體操做

    /// <summary>
    /// 操做類型
    /// </summary>
    enum Operation
    {
        /// <summary>
        /// 認證
        /// </summary>
        Auth,
        /// <summary>
        /// 添加用戶
        /// </summary>
        CreateUser
    }

三、操做過程枚舉

用於標識當前操做，處於哪個階段，不一樣階段作不一樣的處理。

    /// <summary>
    /// 操做過程
    /// </summary>
    enum OperationStage
    {
        /// <summary>
        /// 默認
        /// </summary>
        Default,
        /// <summary>
        /// 第一步
        /// </summary>
        First,
        /// <summary>
        /// 第二步
        /// </summary>
        Second,
        /// <summary>
        /// 第三步
        /// </summary>
        Third
    }

四、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; }
    }

 

2、就要在消息處理中，加入Session處理。

一、增長緩存項數據對象

這個對象，記錄用戶在會話過程當中，錄入的相關信息。也是做爲業務處理數據提供對象。

    class AuthSessionItem
    {
        /// <summary>
        /// 用戶名
        /// </summary>
        public string FromUserName { get; set; }
        /// <summary>
        /// 帳號
        /// </summary>
        public string Code { get; set; }
        /// <summary>
        /// 惟一標識
        /// </summary>
        public string ID { get; set; }
    }

 

二、認證處理過程

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;
        }

三、退出會話，清理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;
        }

 3、用戶認證經過，綁定微信帳戶

用戶認證經過，並綁定微信OpenId，經過OpenId便可查詢通信錄、查詢我的積分以及消費記錄等操做了。用戶認證是一個身份認證過程，也是一個用戶綁定過程。用戶身份認證經過，便可經過微信帳號查詢具體信息了。這時候業務層能夠根據微信分配的OpenId直接查詢用戶相關信息。

4、後記

經過這種方法，公衆帳號，能夠經過小小的文本輸入框，實現更多、更復雜的業務應用。固然，仍是經過提供網頁來進行信息錄入，更直觀便捷。