前言
最近在做個微信公眾號的項目,需要將入口放置在公眾號二級菜單內,通過點擊該菜單鏈接后進入到該項目中去,進入到項目后程序會自動通過微信公眾號的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