微信公众平台开发教程(八)Session处理问题

时间:2022-09-25 16:56:01

在微信窗口,输入的信息有限,我们需要将一些信息分多次请求。

比如:在进行用户绑定时,我们需要输入用户的相关信息,比如:用户名、密码,或者姓名、电话号码,服务端验证通过,即可将系统用户与微信用户绑定。

然后,此微信账户就有一定的功能权限了,可以查积分,消费记录等。服务号:招商银行信用卡,就有很多功能。

微信客户端无法缓存信息,而且输入信息有限,需要进行多次请求,在服务端保存当前会话状态。这就需要Session。

本文以用户认证,绑定账号为例,来说明具体处理。

一、创建通用的Session处理机制。

为了更好的说明原理,便于扩展,我们来自己设计Session。当然,这里也可以使用System.Web.SessionState.HttpSessionState,这是Web常用的Session机制。

1、自定义Session

用于存储会话片段以及相关数据。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
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、操作类型

记录具体的操作类型,标识当前会话的具体操作

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
/// <summary>
  /// 操作类型
  /// </summary>
  enum Operation
  {
    /// <summary>
    /// 认证
    /// </summary>
    Auth,
    /// <summary>
    /// 添加用户
    /// </summary>
    CreateUser
  }

3、操作过程枚举

用于标识当前操作,处于哪一个阶段,不同阶段做不同的处理。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/// <summary>
  /// 操作过程
  /// </summary>
  enum OperationStage
  {
    /// <summary>
    /// 默认
    /// </summary>
    Default,
    /// <summary>
    /// 第一步
    /// </summary>
    First,
    /// <summary>
    /// 第二步
    /// </summary>
    Second,
    /// <summary>
    /// 第三步
    /// </summary>
    Third
  }

4、Session缓存项

缓存记录的项,这里面记录了操作类型、操作步骤以及会话对象。为了便于进行Session管理,还增加了最后访问时间,是否自动清除标识。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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、增加缓存项数据对象

这个对象,记录用户在会话过程中,录入的相关信息。也是作为业务处理数据提供对象。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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,提示成功绑定信息,并清除会话。

在认证过程中,需要对用户录入信息进行合法性验证,而且在会话过程中,支持用户退出当前操作。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
/// <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

在认证过程中,用户可以通过命令,强制退出当前操作,在退出当前操作时,需要清理会话信息。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/// <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直接查询用户相关信息。

四、后记

通过这种方法,公众账号,可以通过小小的文本输入框,实现更多、更复杂的业务应用。当然,还是通过提供网页来进行信息录入,更直观便捷。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:http://www.cnblogs.com/yank/p/3476874.html