基于若依前后端分离框架的小程序的token验证

文章介绍了如何在使用若依框架的后端和管理端时,为前端小程序添加微信授权登录功能。这涉及到创建WxLoginUser实体类和服务类WxTokenService,用于处理token验证和用户信息存储。通过JWT生成和解析令牌,并在JwtAuthenticationTokenFilter中检查管理员和微信用户的token有效性。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

后端和管理端都用的若依框架。
但是前段的小程序需要微信授权登录。这时候就需要在若依框架上重新再起一套token验证。

首先创建两个类(只要放在你能够引用得到的位置就可以):

第一个:实体

package com.ruoyi.system.toeknUnits;

public class WxLoginUser
{
    private static final long serialVersionUID = 1L;

    /**
     * 用户ID
     */
    private Long userId;

    /**
     * 部门ID
     */
    private Long deptId;

    /**
     * 用户唯一标识
     */
    private String token;

    /**
     * 登录时间
     */
    private Long loginTime;

    /**
     * 过期时间
     */
    private Long expireTime;

    /**
     * 登录IP地址
     */
    private String ipaddr;

    /**
     * 登录地点
     */
    private String loginLocation;

    /**
     * 浏览器类型
     */
    private String browser;

    /**
     * 操作系统
     */
    private String os;

    private String openId;

    private String nickName;
	// getset我不粘贴了, 也可以使用lombok的@Data
}

第二个service:

package com.ruoyi.system.toeknUnits;

import com.ruoyi.common.constant.Constants;
import com.ruoyi.common.core.redis.RedisCache;
import com.ruoyi.common.utils.ServletUtils;
import com.ruoyi.common.utils.StringUtils;
import com.ruoyi.common.utils.ip.AddressUtils;
import com.ruoyi.common.utils.ip.IpUtils;
import com.ruoyi.common.utils.uuid.IdUtils;
import eu.bitwalker.useragentutils.UserAgent;
import io.jsonwebtoken.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.TimeUnit;

/**
 * token验证处理
 *
 * @author ruoyi
 */
@Component
public class WxTokenService
{
    // 令牌自定义标识
    @Value("${token.header}")
    private String header;

    // 令牌秘钥
    private String secret = "这个自己随便定义一段英文";

    // 令牌有效期(默认30分钟)
    @Value("${token.expireTime}")
    private int expireTime;

    protected static final long MILLIS_SECOND = 1000;

    protected static final long MILLIS_MINUTE = 60 * MILLIS_SECOND;

    private static final Long MILLIS_MINUTE_TEN = 20 * 60 * 1000L;
// 更换前缀的话  这个类中所有的tf: 全部更换
    private static  final String wx_prefix = "tf:";

    @Autowired
    private RedisCache redisCache;

    /**
     * 获取用户身份信息
     *
     * @return 用户信息
     */
    public WxLoginUser getWxUser(HttpServletRequest request)
    {
        // 获取请求携带的令牌
        String token = getToken(request);
        if (StringUtils.isNotEmpty(token))
        {
            try
            {
                // 解析对应的权限以及用户信息
                 Claims claims = parseToken(token);
                // 解析对应的权限以及用户信息
                String uuid = (String) claims.get(wx_prefix);
                String userKey = getTokenKey(uuid);
                WxLoginUser user = redisCache.getCacheObject(userKey);
                return user;
            }
            catch (Exception e)
            {
                e.printStackTrace();
            }
        }
        return null;
    }

    /**
     * 设置用户身份信息
     */
    public void setWxLoginUser(WxLoginUser wxUser)
    {
        if (StringUtils.isNotNull(wxUser) && StringUtils.isNotEmpty(wxUser.getToken()))
        {
            refreshToken(wxUser);
        }
    }

    /**
     * 删除用户身份信息
     */
    public void delWxUser(String token)
    {
        if (StringUtils.isNotEmpty(token))
        {
            String userKey = getTokenKey(token);
            redisCache.deleteObject(userKey);
        }
    }

    /**
     * 创建令牌
     *
     * @param wxUser 用户信息
     * @return 令牌
     */
    public String createToken(WxLoginUser wxUser)
    {
        String token = IdUtils.fastUUID();
        wxUser.setToken(token);
        setUserAgent(wxUser);
        refreshToken(wxUser);

        Map<String, Object> claims = new HashMap<>();
        claims.put(wx_prefix, token);
        return createToken(claims);
    }

    /**
     * 验证令牌有效期,相差不足20分钟,自动刷新缓存
     *
     * @param wxUser
     * @return 令牌
     */
    public void verifyToken(WxLoginUser wxUser)
    {
        long expireTime = wxUser.getExpireTime();
        long currentTime = System.currentTimeMillis();
        if (expireTime - currentTime <= MILLIS_MINUTE_TEN)
        {
            refreshToken(wxUser);
        }
    }

    /**
     * 刷新令牌有效期
     *
     * @param wxUser 登录信息
     */
    public void refreshToken(WxLoginUser wxUser)
    {
        wxUser.setLoginTime(System.currentTimeMillis());
        wxUser.setExpireTime(wxUser.getLoginTime() + expireTime * MILLIS_MINUTE);
        // 根据uuid将loginUser缓存
        String userKey = getTokenKey(wxUser.getToken());
        redisCache.setCacheObject(userKey, wxUser, expireTime, TimeUnit.MINUTES);
    }

    /**
     * 设置用户代理信息
     *
     * @param wxUser 登录信息
     */
    public void setUserAgent(WxLoginUser wxUser)
    {
        UserAgent userAgent = UserAgent.parseUserAgentString(ServletUtils.getRequest().getHeader("User-Agent"));
        String ip = IpUtils.getIpAddr();
        wxUser.setIpaddr(ip);
        wxUser.setLoginLocation(AddressUtils.getRealAddressByIP(ip));
        wxUser.setBrowser(userAgent.getBrowser().getName());
        wxUser.setOs(userAgent.getOperatingSystem().getName());
    }

    /**
     * 从数据声明生成令牌
     *
     * @param claims 数据声明
     * @return 令牌
     */
    private String createToken(Map<String, Object> claims)
    {
        String token = Jwts.builder()
                .setClaims(claims)
                .signWith(SignatureAlgorithm.HS512, secret).compact();
        return token;
    }

    /**
     * 从令牌中获取数据声明
     *
     * @param token 令牌
     * @return 数据声明
     */
    private Claims parseToken(String token)
    {
        JwtParser parser = Jwts.parser();
        JwtParser jwtParser = parser.setSigningKey(secret);
        Jws<Claims> claimsJws = jwtParser.parseClaimsJws(token);
        Claims body = claimsJws.getBody();
        System.out.println(body);
        return Jwts.parser()
                .setSigningKey(secret)
                .parseClaimsJws(token)
                .getBody();
    }

    /**
     * 从令牌中获取用户名
     *
     * @param token 令牌
     * @return 用户名
     */
    public String getUsernameFromToken(String token)
    {
        Claims claims = parseToken(token);
        return claims.getSubject();
    }

    /**
     * 获取请求token
     *
     * @param request
     * @return token
     */
    public String getToken(HttpServletRequest request)
    {
        String token = request.getHeader(header);
        if (StringUtils.isNotEmpty(token) && token.startsWith(wx_prefix))
        {
            token = token.replace(wx_prefix, "");
            return token;
        }else{
            return null;
        }
    }

    private String getTokenKey(String uuid)
    {
        return "tf: " + uuid;
    }
}

下一步: 找到

com.ruoyi.framework.security.filter;

这个文件

package com.ruoyi.framework.security.filter;

import java.io.IOException;
import javax.servlet.FilterChain;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import com.ruoyi.system.toeknUnits.WxLoginUser;
import com.ruoyi.system.toeknUnits.WxTokenService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
import org.springframework.security.core.context.SecurityContextHolder;
import org.springframework.security.web.authentication.WebAuthenticationDetailsSource;
import org.springframework.stereotype.Component;
import org.springframework.web.filter.OncePerRequestFilter;
import com.ruoyi.common.core.domain.model.LoginUser;
import com.ruoyi.common.utils.SecurityUtils;
import com.ruoyi.common.utils.StringUtils;
import com.ruoyi.framework.web.service.TokenService;

/**
 * token过滤器 验证token有效性
 *
 * @author ruoyi
 */
@Component
public class JwtAuthenticationTokenFilter extends OncePerRequestFilter
{
    @Autowired
    private TokenService tokenService;

    @Autowired
    private WxTokenService wxTokenService;

    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain)
            throws ServletException, IOException
    {

        if( wxTokenService.getToken(request) == null){
            System.out.println("管理员用户");
            LoginUser loginUser = tokenService.getLoginUser(request);
            if (StringUtils.isNotNull(loginUser) && StringUtils.isNull(SecurityUtils.getAuthentication()))
            {
                tokenService.verifyToken(loginUser);
                UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(loginUser, null, loginUser.getAuthorities());
                authenticationToken.setDetails(new WebAuthenticationDetailsSource().buildDetails(request));
                SecurityContextHolder.getContext().setAuthentication(authenticationToken);
            }
        }else{
//            小程序逻辑
            System.out.println("微信用户");
            WxLoginUser wxUser = wxTokenService.getWxUser(request);
            if (StringUtils.isNotNull(wxUser) && StringUtils.isNull(SecurityUtils.getAuthentication()))
            {
                wxTokenService.verifyToken(wxUser);
                UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(wxUser, null, null);
                authenticationToken.setDetails(new WebAuthenticationDetailsSource().buildDetails(request));
                SecurityContextHolder.getContext().setAuthentication(authenticationToken);
            }
        }

        chain.doFilter(request, response);

    }
}

添加你获取code之类的。就是添加白名单。
在这里插入图片描述

### 若依前后端分离架构与微信小程序集成 #### 构建背景和技术选型 为了构建一个高效的社区平台,采用了基于Java的Spring Boot作为后端支持,并利用了微信小程序的优势来提升用户体验[^1]。对于前后端分离的应用来说,采用RESTful API是一种常见的做法,这使得前端可以更加灵活地调用后端服务[^2]。 #### 技术栈概述 在具体的技术实现上,选择了若依(RuoYi)开源框架作为基础,其本身是一个快速开发平台,提供了完整的权限管理系统和丰富的功能模块。结合微信小程序的特点,在此之上进行了定制化开发,实现了从前端到后端的一体化解决方案[^4]。 #### 实现步骤详解 ##### 后端配置 - **引入依赖** 在`pom.xml`文件中加入必要的Maven依赖项: ```xml <!-- Spring Boot Starter Web --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- RuoYi Core Module --> <dependency> <groupId>com.ruoyi.framework</groupId> <artifactId>ruoyi-framework-core</artifactId> <version>${project.version}</version> </dependency> ``` - **API接口定义** 定义RESTful风格的服务接口供微信小程序调用。例如登录认证接口如下所示: ```java @RestController public class LoginController { private final UserService userService; @PostMapping("/login") public ResponseEntity<LoginResponse> login(@RequestBody LoginRequest request) { User user = userService.findByUsername(request.getUsername()); if (user != null && BCrypt.checkpw(request.getPassword(), user.getPassword())) { String token = JwtUtil.createToken(user.getId().toString()); return ResponseEntity.ok(new LoginResponse(token)); } else { throw new UnauthorizedException("Invalid credentials"); } } static record LoginRequest(String username, String password) {} static record LoginResponse(String accessToken) {} } ``` ##### 前端接入 - **初始化项目** 使用WeChat DevTools创建新的微信小程序工程,并安装所需npm包: ```bash npm install axios qs --save ``` - **请求封装** 创建工具类用于发起网络请求并处理响应数据: ```javascript import axios from 'axios'; import Qs from 'qs'; const instance = axios.create({ baseURL: 'http://your-backend-server/api', timeout: 5000, headers: { 'Content-Type': 'application/json' }, }); export function post(url, params) { return instance.post(url, Qs.stringify(params)).then(res => res.data); } export default {post}; ``` - **页面逻辑编写** 编写具体的业务逻辑代码片段,比如用户登录界面中的提交按钮点击事件处理器: ```javascript Page({ data: { form: { username: '', password: '' } }, handleFormSubmit(e) { let formData = e.detail.value; api.post('/auth/login', formData).then(response => { wx.setStorageSync('token', response.accessToken); // 存储JWT令牌 wx.showToast({title:'登录成功'}); setTimeout(() => { wx.switchTab({url:'/pages/index/index'}); // 跳转至首页 }, 800); }).catch(error => console.error(error)); } }); ``` #### 测试验证 完成上述编码工作之后,应该进行全面的功能测试以确保各个部分能够正常协同运作。特别是要关注跨域资源共享(CORS)设置是否正确,因为这是前后端分离应用中最容易出现问题的地方之一[^3]。
评论 8
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

我不是码神(dn)

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值