微信--高效解决token及授权用户openid的持久化处理办法
关于微信开发的话题,例子确实已经有不少,但大部分都是人云亦云,很多小细节或者需要注意的地方却大多没有讲清楚,这令很多刚开始开发的人感觉大很迷茫。而我今天要说的话题,主要着眼于两个方面。
一:如何存储获取用户信息及调用第三方接口所需要的token.
二 : 第三方页面授权,如何减少从微信服务器获取用户openid的次数以及减少获取用户信息的次数,加速第三方页面的加载速速。
(注:演示所使用的是java语言,其他语言可与此类似)
下面我将开始讲述第一个问题。
如何存储获取用户信息及调用第三方接口所需要的token?
从微信的官方文档上,我们知道,获取token的次数为1天2000次,每两小时token失效一次,对于那种一天没有几个人访问的微信公众号而言,他们可能只是简单的每次调用高级接口都会去获取一遍token.众所周知,这种做法极其的耗费时间。从网上其他网友给出的存储方案大概有如下几种:
- 数据库:通过微信接口获取到 Token 之后,将 Token存储到数据库,每次需要时从数据库取出。采用定时任务的方法每隔一个固定的时间去获取一次token.
- NoSQl:这里以 Redis 为例子。通过微信接口获取到 Token 之后,存入 Redis,可以通过设置redis的过期时间,每次需要token时从redis中取出来,若没有,则证明Token 已过期可重新获取(当然也可采用上面的定时任务的方式定期获取)。
- 文件存储:这个比较适合单一公众号的情况。通过微信接口获取到 Token 之后,存入文件,采用定时任务的方法每隔一个固定的时间去获取一次token.
第三方页面授权,如何减少从微信服务器获取用户openid的次数以及减少获取用户信息的次数,加速第三方页面的加载速速?
从诸多的博客中,我们了解到,第三方页面授权获取用户信息,我们要调用两次微信接口。
- 第一次:构造应用授权的url,通过返回的code,换取用户的openid.
- 第二次:通过用户的openid与token获取用户信息。
对于页面比较多的应用,每个页面请求时都需要调用两个方法,于用户而言这是极其耗费时间的。
然而诸多的博客只是告诉我们改如何处理用户信息,诸如将用户信息先拉取下来存储到自己的数据库,然后每次需要时从自己的数据库中通过openid来获取。殊不知这种博客只说了一点,他们没有考虑到的问题是:
- 用户若修改了自己的信息,该如何同步到自己的表里面.
- 用户的信息是获取到了,但是每次用户访问网页,标识用户身份的openid依旧每次都要去调用接口获取。(获取用户信息的次数微信API规定为500000次)
那么接下来我要说的这个就是如何解决上面两个问题,处理过程大致如下:
a.添加拦截器,拦截需要授权页面的controller
拦截器:
package com.fdc.home.dec.wx.filter;
import com.alibaba.dubbo.common.utils.StringUtils;
import com.fdc.platform.common.yfutil.PropertyReader;
import org.springframework.web.method.HandlerMethod;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Arrays;/**
Created by pl on 2017/1/13.
*/
public class OAuth2Interceptor extends HandlerInterceptorAdapter {public static String indexUrl = PropertyReader.getValue("indexUrl");//从配置文件中读取域名
// private static String[] arrQueController = {"newquestion", "mycenter","testCookie"};
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
Cookie[] cookies = request.getCookies();
String openId=null;
//判断cookie中是否存在openid 若存在则直接跳过,不存在则获取一次
if(cookies!=null){
for(Cookie cookie : cookies){
if(cookie.getName().equals("openId")){
openId = cookie.getValue();
}
}
}
if (StringUtils.isEmpty(openId)) {
if (handler instanceof HandlerMethod) {
HandlerMethod handlerMethod = (HandlerMethod) handler;
String methodName = handlerMethod.getMethod().getName();
String uri = request.getRequestURI();
// if (checkList(arrQueController, methodName)) {
// System.out.println("执行了");
response.sendRedirect(indexUrl + "/oauth2Api?resultUrl=" + indexUrl + uri);
return false;
// }
}
return true;
} else {
return true;
}
}public void postHandle(
HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)
throws Exception {
}public void afterCompletion(
HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
}public boolean checkList(String[] arr, String targetValue) {
return Arrays.asList(arr).contains(targetValue);
}}
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/testCookie"/>
<mvc:mapping path="/testCookie1"/>
<bean class="com.fdc.home.dec.wx.filter.OAuth2Interceptor"/>
</mvc:interceptor>
</mvc:interceptors>
b.用户首次访问,调用微信接口获取openid和用户信息。将openid写入服务器端的cookie,将用户的信息写入redis缓存中,以openid作为redis的key。
package com.fdc.home.dec.wx.controller;
import com.fdc.home.dec.service.inter.service.DecWxService;
import com.fdc.home.dec.wx.service.CheckUserInfo;
import com.fdc.home.dec.wx.utils.JSONHelper;
import com.fdc.home.dec.wx.utils.WxUtils;
import com.fdc.home.dec.wx.vo.token.WeixinOauth2Token;
import com.fdc.home.dec.wx.vo.user.WeixinUserInfo;
import com.fdc.platform.common.yfutil.PropertyReader;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
import java.io.IOException;/**
Created by pl on 2017/1/13.
*/
@Controller
public class OAuth2Controller {@Autowired
private DecWxService decWxService;
//判断用户是否登录的公用方法
CheckUserInfo checkUserInfo = new CheckUserInfo();
//从配置文件获取appid
public static String appid = PropertyReader.getValue("appid");
//从配置文件获取appsecret
public static String appsecret = PropertyReader.getValue("appsecret");
//从配置文件获取主域名
public static String indexUrl = PropertyReader.getValue("indexUrl");
public static String wtoken = PropertyReader.getValue("wholetoken");/**
- 组装授权url
- @param request
- @param resultUrl
- @return
*/
@RequestMapping(value ="/oauth2Api")
public String oauth2API(HttpServletRequest request, @RequestParam String resultUrl) {
String redirectUrl = "";
if (resultUrl != null) {
String backUrl =indexUrl+"/oauth2MeUrl?oauth2url="+resultUrl;
//组装授权url
redirectUrl = WxUtils.oAuth2Url(appid, backUrl);
}
return "redirect:" + redirectUrl;
}/**
- 获取用户信息
- @param request
- @param response
- @param code
- @param oauth2url
- @return
- @throws IOException
*/
@RequestMapping(value = "/oauth2MeUrl")
public String oauth2MeUrl(HttpServletRequest request,HttpServletResponse response, @RequestParam String code, @RequestParam String oauth2url) throws IOException {
request.setCharacterEncoding("utf-8");
response.setCharacterEncoding("utf-8");
HttpSession session = request.getSession();
session.setAttribute("code",code);
// 用户同意授权
if (!"authdeny".equals(code)) {
// 获取网页授权access_token
WeixinOauth2Token weixinOauth2Token = WxUtils.getOauth2AccessToken(appid, appsecret, code);
// 网页授权接口访问凭证
String accessToken = weixinOauth2Token.getAccessToken();
// 用户标识
String openId = weixinOauth2Token.getOpenId();
String wholetoken = decWxService.getToken(wtoken);
//获取微信用户openid存储在cookie中的信息
Cookie userCookie=new Cookie("openId",openId);
userCookie.setMaxAge(-1);
userCookie.setPath("/");
response.addCookie(userCookie);
WeixinUserInfo weixinUserInfo = WxUtils.getWeixinUserInfo(wholetoken, openId);
//将用户信息写入redis
decWxService.setToken(openId, JSONHelper.beanToJson(weixinUserInfo));
}else {
return "redirect:"+indexUrl+"/error404";
}
return "redirect:" + oauth2url;
}
}
(注:WxUtils中封装各种请求微信服务器的接口,具体可自行百度)
以上两步基本可以解决用户授权的问题。基于此需要说明的是:
- 开发中要设置cookie过期时间,设置为负数,表明当用户关闭浏览器的时候自动清空cookie,但在实际的测试中,微信浏览器并不会立刻清理cookie,你可以自行清理cookie.每次用户访问时直接从cookie中获取openid,若没有,才会调用微信接口获取。在获取openid的同时,更新redis缓存中的用户信息,这样达到及时同步用户信息的效果,也减少了对微信服务器的访问。
- 有部分网页在博客中提到微信浏览器没有cookie和session,基于这类问题,还请自己动手验证吗,微信浏览器是有cookie和session的(请区分服务端session和客户端session),这里之所以没有将openid存储在session中,其主要是考虑到分布式多点项目中session比较难以处理。
- 比较重要的一点是,当用户更换微信登录时,cookie会自动清除,登录成功后,会重新获取新登录的用户的openid。