前言
最近在做个微信公众号的项目,需要将入口放置在公众号二级菜单内,通过点击该菜单链接后进入到该项目中去,进入到项目后程序会自动通过微信公众号的API完成用户的OpenId获取。需求很简单,实现起来也不复杂,于是在一番折腾后需求实现了。为此,写下此文仅为初次接触的朋友提供个小小的帮助。
准备
老规矩,在开始动手前,咱们先简单介绍下实现的组成部分,如下:
微信公众号静默获取用户OpenId:要实现该功能,可以通过微信公众号提供的“网页授权”接口完成(官网描述:以snsapi_base为scope发起的网页授权,是用来获取进入页面的用户的openid的,并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页(往往是业务页面)),具体说明在此:https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842
Lezhima.Site:是一个基于ASP.NET Core2的Web Mvc带视图的程序,用来模拟接受微信公众号菜单链接的请求,并自动获取用户的OpenId。
准备
如上面所述,我们已经清楚了整个实现思路,那么下面就来看看Lezhima.Site项目内的代码实现吧:
1、首先我们先创建一个名为“BasicController”的业务基类,并继承“Controller”类。其作用有两个,一是将验证是否正确获取OpenId的业务封装成基类,二是方便其它业务控制器使用OpenId。具体代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
/// <summary>
/// 业务基类
/// </summary>
public class BasicController:Controller
{
//当前用户openId
protected string CurrentUserOpenId { set ; get ; }
public BasicController()
{
//从Cookie中获取当前用户的openId
var cookie = Cookies.GetCookieByUser();
//如果没有,则导航到指定提示页,需要用户关闭后重新进入
if ( string .IsNullOrEmpty(cookie))
{
System.Web.HttpContext.Current.Response.Redirect( "/VxinWeb/Index" );
return ;
}
CurrentUserOpenId = cookie;
}
}
|
2、再创建一个名为“VxinWebController”的控制器与View视图。其作用是用来接受来自微信公众号菜单内的链接入口,并自动完成获取用户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
|
/// <summary>
/// 此页面用于对外微信菜单地址,用于获取用户openId
/// 这是本系统网页的入口
/// </summary>
public class VxinWebController : Controller
{
public ActionResult Index()
{
//获取当前进到本系统的微信用户的openid
//该请求从微信那边过来
if (Request.QueryString[ "code" ] != null )
{
var code = Request.QueryString[ "code" ].ToString();
var openId = VxinUtils.GetOpenID(code);
if (openId == null ) //没有获取到openId
{
//返回当前视图,需要提示用户关闭窗口,尝试重新进入
return View();
}
//将openId放入cookie,放到cookie之前需将openId进行加密,取出来后再解密
Cookies.SetUserToCookie(openId);
return RedirectToAction( "Index" , "Home" );
}
return View();
}
}
|
3、在第二步时,我们发现有个VxinUtils类,该类封装了对微信公众号API的操作,具体代码如下:
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
|
/// <summary>
/// 微信公众号工具类
/// </summary>
public class VxinUtils
{
/// <summary>
/// 微信token
/// </summary>
public static string WeiXinToken { get { return ConfigurationManager.AppSettings[ "WeiXinToken" ].ToString(); } }
/// <summary>
/// 微信appID
/// </summary>
public static string AppID { get { return ConfigurationManager.AppSettings[ "AppID" ].ToString(); } }
/// <summary>
/// 微信Aappsecret
/// </summary>
public static string Appsecret { get { return ConfigurationManager.AppSettings[ "Appsecret" ].ToString(); } }
/// <summary>
/// 获得access_token地址
/// </summary>
public static string Access_token_URL { get { return string .Format( "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}" , AppID, Appsecret); } }
/// <summary>
/// 通过code换取网页授权access_token地址
/// </summary>
public static string Web_Access_token_URL { get { return string .Format( "https://api.weixin.qq.com/sns/oauth2/access_token?appid={0}&secret={1}&grant_type=authorization_code&code=" , AppID, Appsecret); } }
/// <summary>
/// 微信菜单创建提交地址
/// </summary>
public static string MENU_POST_URL { get { return "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=" ; } }
/// <summary>
/// 微信获取用户分组地址
/// </summary>
public static string Group_Get_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/get?access_token=" ; } }
/// <summary>
/// 微信修改用户分组地址
/// </summary>
public static string Group_Update_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=" ; } }
/// <summary>
/// 微信获取用户所属分组地址
/// </summary>
public static string Group_GetUserGroup_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=" ; } }
/// <summary>
/// 拉取用户信息(需scope为 snsapi_userinfo)
/// 如果网页授权作用域为snsapi_userinfo,则此时开发者可以通过access_token和openid拉取用户信息了。
/// https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN
/// </summary>
public static string GetUserUserinfo_Url { get { return "https://api.weixin.qq.com/sns/userinfo?lang=zh_CN&access_token=" ; } }
/// <summary>
/// 获取用户的OpenId
/// </summary>
/// <param name="code"></param>
/// <returns></returns>
public static string GetOpenID( string code)
{
var openid = "" ;
using (var wl = new WebClient())
{
wl.Headers.Add(HttpRequestHeader.Accept, "json" );
wl.Headers.Add(HttpRequestHeader.ContentType, "application/json;charset=UTF-8" );
wl.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/4.0" );
wl.Encoding = Encoding.UTF8;
openid = wl.DownloadString(Web_Access_token_URL + code);
}
if (! string .IsNullOrEmpty(openid))
{
var token = JObject.Parse(openid).SelectToken( "openid" );
if (token != null )
openid = token.ToString();
}
return openid;
}
}
|
总结
1、基于“snsapi_base为scope发起的网页授权”的微信公众号方案,可以很方便的实现用户静默授权及获取用户的OpenId。
2、通过将获取到的OpenId写入在Cookie中,并封装一个业务基类完成Cookie的读取与判断,可以使其它业务类很方便的使用OpenId。
好了,以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对服务器之家的支持。
原文链接:https://www.cnblogs.com/Andre/p/10071022.html