Springboot项目登录校验功能实现

2025-08-09 21:50

本文主要是介绍Springboot项目登录校验功能实现,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《Springboot项目登录校验功能实现》本文介绍了Web登录校验的重要性,对比了Cookie、Session和JWT三种会话技术,分析其优缺点,并讲解了过滤器与拦截器的统一拦截方案,推荐使用JWT...

引言

在Web应用程序中,登录校验是确保系统安全性的关键步骤。

通过验证用户身份,可以防止未授权的访问,保护用户数据和系统资源的安全。本文将详细介绍Web应用程序中登录校验的实现方法,包括会话跟踪技术和统一拦截技术,并提供详细的代码注释。

一、登录校验的基本概念

登录校验是指服务器在接收到客户端(通常是浏览器)的请求后,首先验证用户是否已经登录。

如果用户已登录,则允许执行相应的业务操作;如果未登录,则拒绝访问并跳转到登录页面。

二、HTTP协议的无状态性

HTTP协议是一种无状态协议,意味着每次请求都是独立的,服务器无法直接判断两次请求是否来自同一用户。

因此,需要通过会话跟踪技术来维护用户状态,实现登录校验。

三、会话跟踪技术

1. Cookie

原理:Cookie是存储在客户端浏览器中的数据,服务器可以通过设置和读取Cookie来跟踪用户会话。

实现代码

// 设置Cookie示例
@GetMapping("/setCookie")
public String setCookie(HttpServletResponse response) {
    // 创建一个名为"userId"的Cookie,值为"12345",有效期为1天
    Cookie cookie = new Cookie("userId", "12345");
    cookie.setMaxAge(24 * 60 * 60); // 设置Cookie有效期(秒)
    response.addCookie(cookie); // 将Cookie添加到响应中
    return "Cookie设置成功";
}
// 读取Cookie示例
@GetMapping("/getCookie")
public String getCookie(HttpServletRequest request) {
    Cookie[] cookies = request.getCookies(); // 获取所有Cookie
    if (cookies != null) {
        for (Cookie cookie : cookies) {
            if ("userId".equals(cookie.getName())) { // 查找名为"userId"的Cookie
                return "找到的userId: " + cookie.getValue();
            }
        }
    }
    return "未找到userId Cookie";
}

优缺点

  • 优点:HTTP协议支持,无需手动操作。
  • 缺点:用户可以任意更改存储在浏览器的Cookie值,也可禁用Cookie,不安全;此外,移动端不支持,且不能跨域。

2. Session

原理:Session是存储在服务器端的数据,通过Cookie中的Session ID进行关联。

实现代码

@RestController
@Slf4j
public class SessionController {
    // 设置Session示例
    @GetMapping("/setSession")
    public String setSession(HttpSession session) {
        session.jssetAttribute("username", "john_doe"); // 向Session中存储数据
        log.info("Session ID: {}", session.getId()); // 打印Session ID
        return "Session设置成功";
    }
    // 获取Session示例
    @GetMapping("/getSession")
    public String getSession(HttpSession session) {
        String username = (String) session.getAttribute("username"); // 从Session中获取数据
        if (username != null) {
            return "当前登录用户: " + username;
        } else {
            return "Session中未找到用户名";
        }
    }
}

优缺点

  • 优点:存储在服务端,相对安全。
  • 缺点:服务器集群环境下无法直接使用,移动端不支持,依赖于Cookie。

3. 令牌技术(JWT)

原理:JWT(jsON Web Token)是一种自包含的、基于JSON的开源协议,用于双方之间安全地传输信息。

用户登录成功后,服务器生成JWT令牌并返回给前端,前端在后续请求中携带该令牌,服务器通过校验令牌的有效性来验证用户身份。

JWT生成字符串的组成

  • Header:记录令牌类型、签名算法等。
  • Payload:携带自定义信息、默认信息等。
  • Signature:防止Token被篡改,确保安全性。

首先在pom.XML文件中引入JWT的依赖:

<!--JWT-->
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt</artifactId>
    <version>0.9.1</version>
</dependency>

创建 JWT 工具类实现代码

// 引入JWT依赖后,使用Jwts工具类生成和校验JWT令牌
public class JwtUtils {
    private static String signKey = "5L2g5aW977yM5pyL5Y+L77yB"; // 签名密钥(自行更换)
    private static Long expire = 43200000L; // 令牌有效期(毫秒)
    // 生成JWT令牌
    public statiwww.chinasem.cnc String generateJwt(Map<String, Object> claims) {
        String jwt = Jwts.builder()
                .addClaims(claims) // 添加自定义信息
                .signWith(SignatureAlgorithm.HS256, signKey) // 使用HS256算法签名
                .setExpiration(new Date(System.currentTimeMillis() + expire)) // 设置令牌有效期
                .compact(); // 生成令牌字符串
        return jwt;
    }
    // 校验JWT令牌
    public static Claims parseJWT(String jwt) {
        Claims claims = Jwts.parser()
                .setSigningKey(signKey) // 设置签名密钥
                .parseClaimsJws(jwt) // 解析令牌
                .getBody(); // 获取令牌中的信息
        return claims;
    }
}

优缺点

  • 优点:支持PC端和移动端,解决集群环境下的认证问题,减轻服务器存储压力。
  • 缺点:需要手动实现令牌的生成、传递和校验。

四、统一拦截技术

1. 过滤器(Filter)

原理:过滤器是JavaWeb组件之一,用于在请求到达Servlet之前进行预处理,可以用于登录校验。

在springboot项目中,需要在启动类上添加@ServletComponentScan注解,开启SprChina编程ingBoot对Servlet组件的支持。

实现代码

@Slf4j
@WebFilter(urlPatterns = "/*") // 拦截所有请求
publwww.chinasem.cnic class TokenFilter implements Filter {
    @Override
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) 
            throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) resp;
        String url = request.getRequestURL().toString();
        if (url.contains("login")) { // 如果是登录请求,直接放行
            chain.doFilter(request, response);
            return;
        }
        String jwt = request.getHeader("token"); // 从请求头中获取JWT令牌
        if (!StringUtils.hasLength(jwt)) { // 令牌为空,返回未授权错误
            response.setStatus(HttpStatus.SC_UNAUTHORIZED);
            return;
        }
        try {
            JwtUtils.parseJWT(jwt); // 校验令牌
        } catch (Exception e) {
            response.setStatus(HttpStatus.SC_UNAUTHORIZED); // 令牌校验失败,返回未授权错误
            return;
        }
        chain.doFilter(request, response); // 令牌校验成功,放行请求
    }
}

2. 拦截器(Interceptor)

原理:拦截器是Spring框架提供的机制,用于在Controller方法执行前后进行拦截处理,也可以用于登录校验。

实现代码

@Slf4j
@Component
public class TokenInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) 
            throws Exception {
        String url = request.getRequestURL().toString();
        if (url.contains("login")) { // 如果是登录请求,直接放行
            return true;
        }
        String jwt = request.getHeader("token"); // 从请求头中获取JWT令牌
        if (!StringUtils.hasLength(jwt)) { // 令牌为空,返回未授权错误
            response.setStatus(HttpStatus.SC_UNAUTHORIZED);
            return false;
        }
        try {
            JwtUtils.parseJWT(jwt); // 校验令牌
        } catch (Exception e) {
            response.setStatus(HttpStatus.SC_UNAUTHORIZED); // 令牌校验失败,返回未授权错误
            return false;
        }
        return true; // 令牌校验成功,放行请求
    }
}

配置拦截器

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private TokenInterceptor tokenInterceptor;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(tokenInterceptor) // 注册拦截器
                .addPathPatterns("/**"); // 拦截所有请求
    }
}

注:过滤器和拦截器二选一即可。

五、总结

通过引入JWT令牌技术,结合过滤器或拦截器,可以有效地实现Web应用程序的登录校验功能。

这种方法不仅提高了系统的安全性,还简化了开发流程,适用于各种规模的Web应用开发。在实际开发中,可以根据项目需求选择合适的会话跟踪技术和统一拦截方案。

到此这篇关于Springboot项目登录校验功能实现的文章就介绍到这了,更多相关springboot登录校验内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)!

这篇关于Springboot项目登录校验功能实现的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1155652

相关文章

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流(parallelStream)的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS

C++中unordered_set哈希集合的实现

《C++中unordered_set哈希集合的实现》std::unordered_set是C++标准库中的无序关联容器,基于哈希表实现,具有元素唯一性和无序性特点,本文就来详细的介绍一下unorder... 目录一、概述二、头文件与命名空间三、常用方法与示例1. 构造与析构2. 迭代器与遍历3. 容量相关4

Java中Redisson 的原理深度解析

《Java中Redisson的原理深度解析》Redisson是一个高性能的Redis客户端,它通过将Redis数据结构映射为Java对象和分布式对象,实现了在Java应用中方便地使用Redis,本文... 目录前言一、核心设计理念二、核心架构与通信层1. 基于 Netty 的异步非阻塞通信2. 编解码器三、

C++中悬垂引用(Dangling Reference) 的实现

《C++中悬垂引用(DanglingReference)的实现》C++中的悬垂引用指引用绑定的对象被销毁后引用仍存在的情况,会导致访问无效内存,下面就来详细的介绍一下产生的原因以及如何避免,感兴趣... 目录悬垂引用的产生原因1. 引用绑定到局部变量,变量超出作用域后销毁2. 引用绑定到动态分配的对象,对象

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代

一篇文章彻底搞懂macOS如何决定java环境

《一篇文章彻底搞懂macOS如何决定java环境》MacOS作为一个功能强大的操作系统,为开发者提供了丰富的开发工具和框架,下面:本文主要介绍macOS如何决定java环境的相关资料,文中通过代码... 目录方法一:使用 which命令方法二:使用 Java_home工具(Apple 官方推荐)那问题来了,

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述:HashMap的宏观结构二、核心数据结构解析1. 数组(桶数组)2. 链表节点(Node

Java AOP面向切面编程的概念和实现方式

《JavaAOP面向切面编程的概念和实现方式》AOP是面向切面编程,通过动态代理将横切关注点(如日志、事务)与核心业务逻辑分离,提升代码复用性和可维护性,本文给大家介绍JavaAOP面向切面编程的概... 目录一、AOP 是什么?二、AOP 的核心概念与实现方式核心概念实现方式三、Spring AOP 的关

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储:配置灵活性:编码示例引入依赖:配置ehcache.XML文件:配置

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程?1.2 为什么需要虚拟线程?二、虚拟线程与平台线程对比代码对比示例:三