java微信开发API解析(七)-网页开发-微信网页授权
全局说明
* 详细说明请参考前两篇文章。
本文说明
- 本文主要完成获取用户基本信息的工作,包括(昵称、头像、地址、国家等基本信息)
- 对于snsapi_base和snsapi_userinfo我们只演示关于snsapi_userinfo。因为snsapi_userinfo更难,如果能够理解snsapi_userinfo,那么snsapi_base不在话下。
- 对于该部分(微信网页开发)我们只介绍如何获取用户基本信息,对于开发样式库,js-SDK、开发者工具不能再讲解。(我是搞技术的,不会UI=_+)
- 文章最后有演示的地址和操作源码
效果图
文档原文-网页授权获取用户基本信息(摘要)
- 文档地址:http://mp.weixin.qq.com/wiki/4/9ac2e7b1f1d22e9e57260f6553822520.html
- 接入微信公众平台开发,开发者需要按照如下步骤完成:
1 第一步:用户同意授权,获取code 2 第二步:通过code换取网页授权access_token 3 第三步:刷新access_token(如果需要) 4 第四步:拉取用户信息(需scope为 snsapi_userinfo)
- 关于网页授权回调域名的说明
1、在微信公众号请求用户网页授权之前,开发者需要先到公众平台官网中的开发者中心页配置授权回调域名。请注意,这里填写的是域名(是一个字符串),而不是URL,因此请勿加 http:// 等协议头; 2、授权回调域名配置规范为全域名,比如需要网页授权的域名为:www.qq.com,配置以后此域名下面的页面http://www.qq.com/music.html 、 http://www.qq.com/login.html 都可以进行OAuth2.0鉴权。但http://pay.qq.com 、 http://music.qq.com 、 http://qq.com无法进行OAuth2.0鉴权 3、如果公众号登录授权给了第三方开发者来进行管理,则不必做任何设置,由第三方代替公众号实现网页授权即可
- 关于网页授权的两种scope的区别说明
1、以snsapi_base为scope发起的网页授权,是用来获取进入页面的用户的openid的,并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页(往往是业务页面) 2、以snsapi_userinfo为scope发起的网页授权,是用来获取用户的基本信息的。但这种授权需要用户手动同意,并且由于用户同意过,所以无须关注,就可在授权后获取该用户的基本信息。 3、用户管理类接口中的“获取用户基本信息接口”,是在用户和公众号产生消息交互或关注后事件推送后,才能根据用户OpenID来获取用户基本信息。这个接口,包括其他微信接口,都是需要该用户(即openid)关注了公众号后,才能调用成功的。
- 理解
- 在开发之前我们需要填写回调地址,该地址就是我们项目的服务器地址(ip或者域名)
- 我们需要按照文档的要求进行四步操作才能获取到用户的基本信息。当然,如果我们只是获取snsapi_base,也就是一个用户的openid,就不需要四步了。
- 请特别注意:关于网页授权access_token和普通access_token的区别,它们是不一样的。
实现
- 前奏:首先构建需要的json对应的bean
- 通过code换取网页授权access_token,我们将返回的值存在AutoWebParams
public class AutoWebParams { private String access_token; private String expires_in; private String refresh_token; private String openid; private String scope; //Setter、Getter... }
*最终返回的用户信息,我们存储到UserInfo
public class UserInfo { private String openid; private String nickname; private String sex; private String province; private String city; private String country; private String headimgurl; private List<String> privilege; private String unionid; //Setter、Getter... }
- 通过code换取网页授权access_token,我们将返回的值存在AutoWebParams
- 第一步:用户同意授权,获取code,需要引导用户打开此页面
@WebServlet("/GuideServlet") public class GuideServlet extends HttpServlet { @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 设置编码 req.setCharacterEncoding("utf-8"); resp.setContentType("text/html;charset=utf-8"); resp.setCharacterEncoding("utf-8"); PrintWriter writer = resp.getWriter(); /** * 第一步:用户同意授权,获取code:https://open.weixin.qq.com/connect/oauth2/authorize * ?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE * &state=STATE#wechat_redirect */ String redirect_uri = "http://42.96.144.28/WeixinApiDemo/WeixinWebServlet";// 目标访问地址 redirect_uri = URLEncoder.encode( "http://42.96.144.28/WeixinApiDemo/WeixinWebServlet", "UTF-8");// 授权后重定向的回调链接地址,请使用urlencode对链接进行处理(文档要求) // 按照文档要求拼接访问地址 String url = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=" + GlobalParams.APPID + "&redirect_uri=" + redirect_uri + "&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect"; resp.sendRedirect(url);// 跳转到要访问的地址 } }
- 第二步:通过code换取网页授权access_token
/** * 第二步:通过code换取网页授权access_token */ String code = req.getParameter("code");// 获取返回码 // 同意授权 if (code != null) { // 拼接请求地址 String url = "https://api.weixin.qq.com/sns/oauth2/access_token?" + "appid=" + GlobalParams.APPID + "&secret=" + GlobalParams.SECERT + "&code=" + code + "&grant_type=authorization_code"; String json = MyHttpUtils.getReturnJson(url, null);// 拿去返回值 AutoWebParams autoWebParams = new AutoWebParams(); Gson gson = new Gson(); autoWebParams = gson.fromJson(json, new AutoWebParams().getClass()); }
- 第三步:刷新access_token(如果需要),我们按照文档要求来,使用这一步
/** * 第三步:刷新access_token(如果需要) */ String url2 = "https://api.weixin.qq.com/sns/oauth2/refresh_token?" + "appid=" + GlobalParams.APPID + "&grant_type=refresh_token&refresh_token=" + autoWebParams.getRefresh_token(); String json2 = MyHttpUtils.getReturnJson(url2, null);// 拿去返回值 AutoWebParams autoWebParams2 = new AutoWebParams(); Gson gson2 = new Gson(); autoWebParams2 = gson2 .fromJson(json2, new AutoWebParams().getClass());
- 第四步:拉取用户信息(需scope为 snsapi_userinfo)
/** * 第四步:拉取用户信息(需scope为 snsapi_userinfo) */ String url3 = "https://api.weixin.qq.com/sns/userinfo?access_token=" + autoWebParams2.getAccess_token() + "&openid=" + autoWebParams2.getOpenid() + "&lang=zh_CN"; String json3 = MyHttpUtils.getReturnJson(url3, null);// 拿去返回值 UserInfo userInfo = new UserInfo(); Gson gson3 = new Gson(); userInfo = gson3.fromJson(new String(json3.getBytes(), "utf-8"), new UserInfo().getClass()); System.out.println(userInfo);
- 测试显示
// 显示用户信息 req.setAttribute("userInfo", userInfo); req.getRequestDispatcher("userinfo.jsp").forward(req, resp);
- 显示的userinfo.jsp
<body> <h1>页面太丑,只看内容</h1> <table style="margin: 0 auto;"> <tr> <td>openid(id)</td> <td>${userInfo.openid}</td> </tr> <tr> <td>nickname(昵称)</td> <td>${userInfo.nickname}</td> </tr> <tr> <td>sex(性别)</td> <td> <c:if test="${userInfo.sex==0}">未知</c:if> <c:if test="${userInfo.sex==1}">男</c:if> <c:if test="${userInfo.sex==2}">女</c:if> </td> </tr> <tr> <td>province(省)</td> <td>${userInfo.province}</td> </tr> <tr> <td>city(市)</td> <td>${userInfo.city}</td> </tr> <tr> <td>country(国家)</td> <td>${userInfo.country}</td> </tr> <tr> <td>headimgurl(头像)</td> <td><img alt="头像" style="width: 40px;height: 40px;" src="${userInfo.headimgurl}"></td> </tr> <tr> <td>privilege(特权,什么意思看文档)</td> <td> <c:forEach items="${userInfo.privilege}" var="p"> ${p.String }| </c:forEach> </td> </tr> <tr> <td>unionid(unionid)</td> <td>${userInfo.unionid}</td> </tr> </table> </body>
测试请在下面的测试号中访问该地址
http://42.96.144.28/WeixinApiDemo/GuideServlet
测试的微信号二维码
技术博客
源码下载
http://download.csdn.net/detail/wgyscsf/9508289
时间: 2024-10-06 18:46:33