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，需要引导用户打开此页面
@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