最近在做个微信公众号的项目, 需要将入口放置在公众号二级菜单内, 通过点击该菜单链接后进入到该项目中去, 进入到项目后程序会自动通过微信公众号的 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. 具体代码如下:
- /// <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. 代码如下:
- /// <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 的操作, 具体代码如下:
- /// <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