玩玩微信公众号Java版之六：微信网页授权

我们经常会访问一些网站，用微信登录的时候需要用到授权，那么微信网页授权是怎么一回事呢，一起来看看吧！

 

参考官方文档：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842

 

官方的文档有很详细的说明，这里就主要分析重要的几点：

第一，网页授权分类及说明：

1、以snsapi_base为scope发起的网页授权，是用来获取进入页面的用户的openid的，并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页（往往是业务页面）

2、以snsapi_userinfo为scope发起的网页授权，是用来获取用户的基本信息的。但这种授权需要用户手动同意，并且由于用户同意过，所以无须关注，就可在授权后获取该用户的基本信息。

 

第二，网页授权流程分为四步：

1、引导用户进入授权页面同意授权，获取code 

2、通过code换取网页授权access_token（与基础支持中的access_token不同） 

3、如果需要，开发者可以刷新网页授权access_token，避免过期 

4、通过网页授权access_token和openid获取用户基本信息（支持UnionID机制） 

 

了解到网页授权的这些知识，下面就开始去实现吧~

 

开始的准备工作：在接口配置中，设置对应的回调域名，地址：“开发 - 接口权限 - 网页服务 - 网页帐号 - 网页授权获取用户基本信息”的配置选项

由于我的是个人，因此使用测试账号的配置：

配置好了，就可以进行开发了，首先来看一下具体的流程：

其实很多功能点，前面已经实现过，只用改一下调用地址和参数即可。

首先，调用的定义链接：https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

链接中需要使用urlEncode对链接进行处理，可以在工具类中添加一个转码方法：

     /**
      * 对URL地址进行EnCode处理
      * @param url
      * @return
      */
     public static String urlEnCode(String url)
     {
         String enCodedUrl = "";

         try
         {
             enCodedUrl = URLEncoder.encode(url, "utf-8");
         }
         catch (UnsupportedEncodingException e)
         {
             // TODO Auto-generated catch block
             e.printStackTrace();
             System.out.println("转码失败！");
         }

         return enCodedUrl;
     }

另外将其他参数补充完整，可以得到一个访问链接。

在这里，可以结合之前学的菜单的处理，可以定义一个菜单进行专门的授权验证，这里需要改造上一节学到的点，具体如下：

     /**
      * 定义菜单属性
      * @return
      */
     private Menu getMenu()
     {
         Menu menu = new Menu();

         // 建3个导航菜单
         LevelMenu tLevelMenuOne = new LevelMenu();
         tLevelMenuOne.setName("Damon");
         LevelMenu tLevelMenuTwo = new LevelMenu();
         tLevelMenuTwo.setName("Panou");
         LevelMenu tLevelMenuThree = new LevelMenu();
         tLevelMenuThree.setName("Papaw");

         // 第一个导航菜单的子菜单
         SubMenuButton tSubMenuButton_oneone = new SubMenuButton();
         tSubMenuButton_oneone.setType(SysCon.WECHAT_MENU_TYPE_VIEW);
         tSubMenuButton_oneone.setName("网页授权");
         tSubMenuButton_oneone.setKey("11");
         tSubMenuButton_oneone.setUrl(getAuthorUrl());

         SubMenuButton tSubMenuButton_onetwo = new SubMenuButton();
         tSubMenuButton_onetwo.setType(SysCon.WECHAT_MENU_TYPE_CLICK);
         tSubMenuButton_onetwo.setName("swimming");
         tSubMenuButton_onetwo.setKey("12");

         // 加入导航菜单
         tLevelMenuOne.setSub_button(new SubMenuButton[]
         { tSubMenuButton_oneone, tSubMenuButton_onetwo });

         // 第二 个导航菜单的子菜单
         SubMenuButton tSubMenuButton_twoone = new SubMenuButton();
         tSubMenuButton_twoone.setType(SysCon.WECHAT_MENU_TYPE_CLICK);
         tSubMenuButton_twoone.setName("watching TV");
         tSubMenuButton_twoone.setKey("21");

         SubMenuButton tSubMenuButton_twotwo = new SubMenuButton();
         tSubMenuButton_twotwo.setType(SysCon.WECHAT_MENU_TYPE_CLICK);
         tSubMenuButton_twotwo.setName("play games");
         tSubMenuButton_twotwo.setKey("22");

         SubMenuButton tSubMenuButton_twothree = new SubMenuButton();
         tSubMenuButton_twothree.setType(SysCon.WECHAT_MENU_TYPE_CLICK);
         tSubMenuButton_twothree.setName("shopping");
         tSubMenuButton_twothree.setKey("23");

         // 加入导航菜单
         tLevelMenuTwo.setSub_button(new SubMenuButton[]
         { tSubMenuButton_twoone, tSubMenuButton_twotwo, tSubMenuButton_twothree });

         // 第三个导航菜单的子菜单
         SubMenuButton tSubMenuButton_threeone = new SubMenuButton();
         tSubMenuButton_threeone.setType(SysCon.WECHAT_MENU_TYPE_CLICK);
         tSubMenuButton_threeone.setName("cring");
         tSubMenuButton_threeone.setKey("31");

         SubMenuButton tSubMenuButton_threetwo = new SubMenuButton();
         tSubMenuButton_threetwo.setType(SysCon.WECHAT_MENU_TYPE_CLICK);
         tSubMenuButton_threetwo.setName("laughing");
         tSubMenuButton_threetwo.setKey("32");

         // 加入导航菜单
         tLevelMenuThree.setSub_button(new SubMenuButton[]
         { tSubMenuButton_threeone, tSubMenuButton_threetwo });

         menu.setButton(new MenuButton[]
         { tLevelMenuOne, tLevelMenuTwo, tLevelMenuThree });

         return menu;

     }

     /**
      * 获取微信网页授权页面链接
      * @return
      */
     private String getAuthorUrl()
     {
         String uri = "http://damonhouse.iok.la/Servlet/WeChatAuthorService";

         uri = WeChatUtil.urlEnCode(uri);

         String authorUrl = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect";

         authorUrl = authorUrl.replace("APPID", "appid").replace("REDIRECT_URI", uri).replace("SCOPE", "snsapi_userinfo");

         return authorUrl;
     }

先看一下具体效果：

点击会弹出一个授权的页面（由于我已经授权过，所以这里会自动登录）

这个时候后台还没有对应的处理，我们需要进行返回页面的处理，这里定义对应的service类，在doGet方法中进行处理：

 /**
  * 微信授权接口类
  * @author Damon
  */
 public class WeChatAuthorService extends HttpServlet
 {

     @Override
     protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException
     {
         // TODO Auto-generated method stub
         System.out.println("授权成功，进行返回处理！");
         req.setCharacterEncoding("utf-8");
         resp.setCharacterEncoding("utf-8");

         String code = req.getParameter("code");

         String state = req.getParameter("state");

         System.out.println("code :" + code + " and stat :" + state);

         // 业务处理，获取授权用户信息
         WeChatAuthorBL tWeChatAuthorBL = new WeChatAuthorBL();
         AuthorUserInfo tAuthorUserInfo = tWeChatAuthorBL.getAuthorData(code, state);

         req.setAttribute("nickname", tAuthorUserInfo.getNickname());
         // 获取信息成功，回写成功页面
         req.getRequestDispatcher("../wechat/authorsucc.jsp").forward(req, resp);

     }

     @Override
     protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException
     {
         // TODO Auto-generated method stub
         super.doPost(req, resp);
     }

 }

可以从授权中获取到 code 和state（可自定义用与此处校验）， 然后就是通过code来进行获取授权的用户信息：

从前面分析可知，需要先获取授权的acces_token，然后才能获取到授权的用户信息，那么结合前面2节内容，先定义2个实体类：

1、用户授权Token类

 /**
  * 用户授权Token
  * @author Damon
  */
 public class AuthorToken
 {
     // 网页授权接口调用凭证,注意：此access_token与基础支持的access_token不同
     private String access_token = "";

     // access_token接口调用凭证超时时间，单位（秒）
     private int expires_in = 0;

     // 用户刷新access_token ="";
     private String refresh_token = "";

     // 用户唯一标识，请注意，在未关注公众号时，用户访问公众号的网页，也会产生一个用户和公众号唯一的OpenID
     private String openid = "";

     // 用户授权的作用域，使用逗号（,）分隔
     private String scope = "";

     public String getAccess_token()
     {
         return access_token;
     }

     public void setAccess_token(String access_token)
     {
         this.access_token = access_token;
     }

     public int getExpires_in()
     {
         return expires_in;
     }

     public void setExpires_in(int expires_in)
     {
         this.expires_in = expires_in;
     }

     public String getRefresh_token()
     {
         return refresh_token;
     }

     public void setRefresh_token(String refresh_token)
     {
         this.refresh_token = refresh_token;
     }

     public String getOpenid()
     {
         return openid;
     }

     public void setOpenid(String openid)
     {
         this.openid = openid;
     }

     public String getScope()
     {
         return scope;
     }

     public void setScope(String scope)
     {
         this.scope = scope;
     }

 }

2、授权用户信息类

 /**
  * 通过网页授权获取的用户信息
  * @author Damon
  */
 public class AuthorUserInfo
 {
     // 用户的唯一标识
     private String openid = "";

     // 用户昵称
     private String nickname = "";

     // 用户的性别，值为1时是男性，值为2时是女性，值为0时是未知
     private String sex = "";

     // 用户个人资料填写的省份
     private String province = "";

     // 普通用户个人资料填写的城市
     private String city = "";

     // 国家，如中国为CN
     private String country = "";

     // 用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空。若用户更换头像，原有头像URL将失效。
     private String headimgurl = "";

     // 用户特权信息，json 数组，如微信沃卡用户为（chinaunicom）
     private List<String> privilege = new ArrayList<String>();

     // 只有在用户将公众号绑定到微信开放平台帐号后，才会出现该字段。
     private String unionid = "";

     public String getOpenid()
     {
         return openid;
     }

     public void setOpenid(String openid)
     {
         this.openid = openid;
     }

     public String getNickname()
     {
         return nickname;
     }

     public void setNickname(String nickname)
     {
         this.nickname = nickname;
     }

     public String getSex()
     {
         return sex;
     }

     public void setSex(String sex)
     {
         this.sex = sex;
     }

     public String getProvince()
     {
         return province;
     }

     public void setProvince(String province)
     {
         this.province = province;
     }

     public String getCity()
     {
         return city;
     }

     public void setCity(String city)
     {
         this.city = city;
     }

     public String getCountry()
     {
         return country;
     }

     public void setCountry(String country)
     {
         this.country = country;
     }

     public String getHeadimgurl()
     {
         return headimgurl;
     }

     public void setHeadimgurl(String headimgurl)
     {
         this.headimgurl = headimgurl;
     }

     public List<String> getPrivilege()
     {
         return privilege;
     }

     public void setPrivilege(List<String> privilege)
     {
         this.privilege = privilege;
     }

     public String getUnionid()
     {
         return unionid;
     }

     public void setUnionid(String unionid)
     {
         this.unionid = unionid;
     }

 }

下一步，就是通过调用接口来实现我们的功能了~

     /**
      * 获取授权用户
      * @param code
      * @param state
      * @return
      */
     public AuthorUserInfo getAuthorData(String code, String state)
     {

         // 1、通过code获取授权的authortoken
         AuthorToken tAuthorToken = getAuthorToken("appid", "appsecret", code);

         // 2、通过获取的 access_token和 openid 获取用户信息
         AuthorUserInfo tAuthorUserInfo = getAuthorUserInfo(tAuthorToken.getAccess_token(), tAuthorToken.getOpenid());

         return tAuthorUserInfo;
     }

     /**
      * 获取授权的access_token
      * @param appid
      * @param appsceret
      * @param code
      * @return
      */
     private AuthorToken getAuthorToken(String appid, String appsceret, String code)
     {

         String path = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code ";

         path = path.replace("APPID", appid).replace("SECRET", appsceret).replace("CODE", code);

         AuthorToken tAuthorToken = new AuthorToken();

         try
         {
             String strResp = WeChatUtil.doHttpsGet(path, "");

             System.out.println(strResp);

             // 解析获取的token信息
             Map<String, Object> tMap = WeChatUtil.jsonToMap(strResp);

             System.out.println(tMap.toString());

             // 封装 authortoken

             tAuthorToken.setAccess_token((String) tMap.get("access_token"));
             tAuthorToken.setExpires_in(Integer.parseInt((String) tMap.get("expires_in")));
             tAuthorToken.setOpenid((String) tMap.get("openid"));
             tAuthorToken.setScope((String) tMap.get("scope"));
             tAuthorToken.setRefresh_token((String) tMap.get("refresh_token"));

         }
         catch (HttpException e)
         {
             // TODO Auto-generated catch block
             e.printStackTrace();
         }
         catch (IOException e)
         {
             // TODO Auto-generated catch block
             e.printStackTrace();
         }

         return tAuthorToken;
     }

     /**
      * 通过授权的access_token及用户的openid来拉取用户信息
      * @param access_token
      * @param openid
      * @return
      */
     private AuthorUserInfo getAuthorUserInfo(String access_token, String openid)
     {
         String path = "https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN";

         path = path.replace("ACCESS_TOKEN", access_token).replace("OPENID", openid);

         AuthorUserInfo tAuthorUserInfo = new AuthorUserInfo();

         try
         {
             String strResp = WeChatUtil.doHttpsGet(path, "");

             System.out.println(strResp);

             // 解析获取的token信息
             Map<String, Object> tMap = WeChatUtil.jsonToMap(strResp);

             System.out.println(tMap.toString());

             // 封装 authortoken
             tAuthorUserInfo.setOpenid((String) tMap.get("openid"));
             tAuthorUserInfo.setNickname((String) tMap.get("nickname"));
             tAuthorUserInfo.setSex((String) tMap.get("sex"));
             tAuthorUserInfo.setCountry((String) tMap.get("country"));
             tAuthorUserInfo.setProvince((String) tMap.get("province"));
             tAuthorUserInfo.setCity((String) tMap.get("city"));
             tAuthorUserInfo.setHeadimgurl((String) tMap.get("headimgurl"));
             tAuthorUserInfo.setPrivilege((List<String>) tMap.get("privilege"));
             tAuthorUserInfo.setUnionid((String) tMap.get("unionid"));
         }
         catch (HttpException e)
         {
             // TODO Auto-generated catch block
             e.printStackTrace();
         }
         catch (IOException e)
         {
             // TODO Auto-generated catch block
             e.printStackTrace();
         }

         return tAuthorUserInfo;
     }

这些搞定，我们就已经获取到了用户的信息了。 最后我们来给用户一个好的界面体验~

这里新增一个页面，显示获取到的用户昵称：

 <%@ page language="java" contentType="text/html; charset=GBK"
     pageEncoding="GBK"%>
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <title>damon's house</title>
 </head>
 <body>
 <%
 String nickname=request.getAttribute("nickname").toString();
 %>
 <table><tr><%=nickname %> 您好，感谢授权Damon的奇趣小屋！</tr></table>
 </body>
 </html>

来看一下效果吧~

微信网页授权，获取用户信息就到这啦~