java实现微信小程序登录态维护

1. 前言

微信小程序是一种轻量级的应用程序，它不需要下载和安装即可使用。与安装包大小不同，小程序的访问速度更快。目前，越来越多的开发者开始使用微信小程序作为业务开发的一种方式。在本文中，我们将探索如何在Java中实现微信小程序登录态的维护。

2. 微信小程序登录

小程序提供了一组API，允许开发者使用微信账号进行登录。在用户第一次从小程序登录时，小程序获取用户的用户信息。此后，小程序可以使用code参数调用微信登录API获取用户的OpenID和session key。为了保证用户的登录状态，在用户登录后，小程序需要将session key与OpenID存储在服务器端。

以下是小程序登录的示例代码：

wx.login({
  success: function(res) {
    if (res.code) {
      //发起网络请求
      wx.request({
        url: 'https://example.com/onLogin',
        data: {
          code: res.code
        }
      })
    } else {
      console.log('登录失败！' + res.errMsg)
    }
  }
});

2.1. 会话管理

小程序的登录态由微信的服务器端session进行维护。session key是登录时获得的一次性字符串，可以用来在一定时间内换取openid等敏感信息。小程序需要在每个用户请求时将session key传回服务器端验证。服务器端需要对session key进行管理，防止被恶意使用。

2.2. 重新登录

小程序提供了wx.checkSession API，用于检查用户的登录态是否过期。如果过期，小程序应该调用wx.login重新登录。

以下是检查登录态的示例代码：

wx.checkSession({
  success: function(){
    //session 未过期，并且在本生命周期一直有效
  },
  fail: function(){
    //登录态过期
    wx.login() //重新登录
  }
})

3. Java实现微信小程序登录态维护

在Java中实现微信小程序登录态维护，开发者需要完成以下任务：

3.1. 登录态管理

当用户第一次使用小程序登录时，小程序需要将session key与OpenID存储在服务器端。在后续的用户请求中，小程序需要将session key发送给服务器端进行验证。开发者可以使用数据库，缓存等方式实现登录态的管理。

以下是用Redis缓存实现登录态管理的示例代码：

public class SessionManager {
  private RedisTemplate redisTemplate;
  public SessionManager(RedisTemplate redisTemplate) {
    this.redisTemplate = redisTemplate;
  }
  public void put(String sessionId, String sessionKey, String openId, long expireTime) {
    //将session key与open id存入redis中，并设置expireTime过期时间
    redisTemplate.opsForValue().set(sessionId, sessionKey + ":" + openId, expireTime, TimeUnit.SECONDS);
  }
  public String get(String sessionId) {
    //从redis中获取session key与open id，并返回结果
    return redisTemplate.opsForValue().get(sessionId);
  }
  public void remove(String sessionId) {
    //从redis中删除session
    redisTemplate.delete(sessionId);
  }
}

3.2. 小程序登录

当用户第一次从小程序登录时，小程序需要将code参数发送给服务器端。服务器端使用code参数调用微信登录API获取用户的OpenID和session key，并将其存储在session中。

以下是实现小程序登录的示例代码：

@PostMapping("/login")
public ResponseEntity login(@RequestParam(name = "code") String code,
                                       HttpSession session,
                                       HttpServletResponse response) {
  //调用微信登录API获取用户的OpenID和session key
  String openId = "";
  String sessionKey = "";
  session.setAttribute("openId", openId);
  session.setAttribute("sessionKey", sessionKey);
  //将session信息加密并存储在cookie中
  String sessionId = session.getId();
  cookieUtil.addCookie(response, SESSION_ID, sessionId);
  //存储session信息
  sessionManager.put(sessionId, sessionKey, openId, SESSION_EXPIRE_TIME);
  return ResponseEntity.ok().build();
} 

3.3. 验证登录态

在后续的用户请求中，小程序需要将session key发送给服务器端进行验证。如果验证失败，小程序需要重新登录。

以下是验证session key的示例代码：

@GetMapping("/api/info")
@ResponseBody
public ResponseEntity getUserInfo(HttpServletRequest request) {
  String sessionId = cookieUtil.getCookieValue(request, SESSION_ID);
  String sessionInfo = sessionManager.get(sessionId);
  //验证 session info
  if (StringUtils.isBlank(sessionInfo)) {
    return ResponseEntity.status(HttpStatus.UNAUTHORIZED).build();
  }
  String[] parts = sessionInfo.split(":");
  if (parts.length < 2) {
    return ResponseEntity.status(HttpStatus.UNAUTHORIZED).build();
  }
  String sessionKey = parts[0];
  String openId = parts[1];
  //调用微信接口，获取用户信息
  //...
  return ResponseEntity.ok(userInfoJson);
}

4. 总结

在本文中，我们探讨了如何在Java中实现微信小程序登录态的维护，包括登录态的管理，小程序登录，以及验证登录态。这些方法可以帮助开发者快速构建小程序登录功能，并实现登录态的维护。