WeChatパブリックプラットフォーム開発 セッション処理

WeChat ウィンドウでは入力情報が限られており、一部の情報を複数回リクエストする必要があります。

例: ユーザーをバインドする場合、ユーザー名、パスワード、名前、電話番号などの関連するユーザー情報を入力する必要があります。サーバー側が検証されていれば、システム ユーザーを WeChat ユーザーにバインドできます。

すると、この WeChat アカウントには特定の機能権限が付与され、ポイントや消費記録などを確認できるようになります。サービスアカウント:招商銀行クレジットカードには多くの機能があります。

WeChat クライアントは情報をキャッシュできず、現在のセッション ステータスをサーバーに保存するには複数のリクエストが必要です。これにはセッションが必要です。

この記事では、ユーザー認証とアカウント バインディングを例として、具体的な処理を説明します。

1. ユニバーサルセッション処理メカニズムを作成します。

原理をよりよく説明し、拡張を容易にするために、私たちは自分たちでセッションを設計します。もちろん、Web で一般的に使用されるセッション メカニズムである System.Web.SessionState.HttpSessionState もここで使用できます。

1. カスタムセッション

は、セッションフラグメントと関連データを保存するために使用されます。

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. 操作タイプ

は、特定の操作タイプを記録し、現在のセッションの特定の操作を識別します

/// 631fb227578dfffda61e1fa4d04b7d25
    /// 操作类型
    /// 039f3e95db2a684c7b74365531eb6044
    enum Operation
    {
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 认证
        /// 039f3e95db2a684c7b74365531eb6044
        Auth,
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 添加用户
        /// 039f3e95db2a684c7b74365531eb6044
        CreateUser
    }

3. 操作プロセスの列挙

は、現在の操作を識別するために使用されます。ステージが異なると、ステージごとに異なる処理が実行されます。

/// 631fb227578dfffda61e1fa4d04b7d25
    /// 操作过程
    /// 039f3e95db2a684c7b74365531eb6044
    enum OperationStage
    {
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 默认
        /// 039f3e95db2a684c7b74365531eb6044
        Default,
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 第一步
        /// 039f3e95db2a684c7b74365531eb6044
        First,
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 第二步
        /// 039f3e95db2a684c7b74365531eb6044
        Second,
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 第三步
        /// 039f3e95db2a684c7b74365531eb6044
        Third
    }

4. セッションキャッシュ項目

操作タイプ、操作ステップ、セッションオブジェクトを記録するキャッシュレコード項目。セッション管理を容易にするために、最終アクセス時刻とロゴを自動的に消去するかどうかも追加されます。

class SessionItem
    {
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 操作类型
        /// 039f3e95db2a684c7b74365531eb6044
        public Operation Oper { get; set; }
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 当前步骤
        /// 039f3e95db2a684c7b74365531eb6044
        public OperationStage Stage { get; set; }
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 数据对象
        /// 039f3e95db2a684c7b74365531eb6044
        public object Data { get; set; }
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 是否自动删除
        /// 039f3e95db2a684c7b74365531eb6044
        public bool AutoRemove
        {
            get;
            set;
        }
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 最后更新时间
        /// 039f3e95db2a684c7b74365531eb6044
        public DateTime UpdateTime { get; set; }
    }

2 番目に、メッセージ処理にセッション処理を追加する必要があります。

1. キャッシュ項目データオブジェクトを追加します

このオブジェクトは、セッション中にユーザーが入力した関連情報を記録します。業務処理データのオブジェクトとしても使用されます。

class AuthSessionItem
    {
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 用户名
        /// 039f3e95db2a684c7b74365531eb6044
        public string FromUserName { get; set; }
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 账号
        /// 039f3e95db2a684c7b74365531eb6044
        public string Code { get; set; }
        /// 631fb227578dfffda61e1fa4d04b7d25
        /// 唯一标识
        /// 039f3e95db2a684c7b74365531eb6044
        public string ID { get; set; }
    }

2. 認証プロセス

1) 認証の入力を開始し、認証キーワードに従って識別し、セッションを開始し、関連データをキャッシュします

2) 個人アカウント情報の入力を求めます

3 ) WeChat ユーザーが個人アカウントを入力し、サーバーがアカウント情報を記録し、従業員カード番号の入力を求めます

4) WeChat ユーザーがカード番号情報を入力し、サーバーがカード番号情報を記録し、特定の認証ロジックを呼び出します

5) ユーザーが認証されて WeChat OpenId にバインドされ、バインド成功情報が表示され、セッションがクリアされます。

認証プロセス中、ユーザー入力情報の合法性を検証する必要があり、セッション中、ユーザーは現在の操作を終了することがサポートされます。

/// 631fb227578dfffda61e1fa4d04b7d25
        /// 认证用户信息
        /// 039f3e95db2a684c7b74365531eb6044
        /// 48c89b85c0dea34386a1ce7621016c778bb7487ae6a16a43571bc14c7fcf93c2
        /// 2363942ed0d6cd3e85bae1dffa568116f7735d9f6a7af371769ab5c16d23b2f3
        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. セッションを終了してセッションをクリーンアップします

認証プロセス中に、ユーザーはコマンドを使用して現在の操作を強制的に終了できます。現在の操作を終了するときは、セッション情報をクリアする必要があります。

/// 631fb227578dfffda61e1fa4d04b7d25
        /// 退出，并清理Session
        /// 039f3e95db2a684c7b74365531eb6044
        /// 48c89b85c0dea34386a1ce7621016c778bb7487ae6a16a43571bc14c7fcf93c2
        /// ac0426a4c30f960f93a3daeaf71812178bb7487ae6a16a43571bc14c7fcf93c2
        /// 2363942ed0d6cd3e85bae1dffa568116f7735d9f6a7af371769ab5c16d23b2f3
        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. ユーザー認証が成功し、WeChat アカウントがバインドされました

ユーザー認証が成功し、WeChat OpenId がバインドされました OpenId を通じて、アドレス帳の確認、個人ポイントや消費記録の確認などが可能です。ユーザー認証は、ID 認証プロセスとユーザー バインド プロセスです。ユーザー ID が認証されている場合は、WeChat アカウントを通じて特定の情報を照会できます。現時点では、ビジネス層は、WeChat によって割り当てられた OpenId に基づいてユーザー関連情報を直接クエリできます。

4. 追記

この方法により、パブリックアカウントは小さなテキスト入力ボックスを通じてより複雑なビジネスアプリケーションを実現できます。もちろん、Web ページを提供することで情報を入力する方が直感的で便利です。

WeChat パブリック プラットフォームの開発とセッション処理に関連するその他の記事については、PHP 中国語 Web サイトに注目してください。