SpringBoot中使用 ThreadLocal 进行多线程上下文管理及注意事项小结

本文主要是介绍SpringBoot中使用 ThreadLocal 进行多线程上下文管理及注意事项小结,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《SpringBoot中使用ThreadLocal进行多线程上下文管理及注意事项小结》本文详细介绍了ThreadLocal的原理、使用场景和示例代码,并在SpringBoot中使用ThreadLo...

前言

在多线程编程中,线程安全是一个重要的问题。Java 提供了多种机制来处理线程安全问题,其中 ThreadLocal 是一个非常有用的工具。本文将详细介绍 ThreadLocal 的原理及其在多线程上下文管理中的应用,并在springboot中使用ThreadLocal保存请求中携带的用户信息。

技术积累

1.什么是 ThreadLocal

ThreadLocal 是 Java 提供的一个类,用于在多线程环境下为每个线程维护独立的变量副本。这意味着每个线程都可以独立地访问和修改自己的变量副本,而不会影响其他线程的变量。

2. ThreadLocal 的原理

2.1 线程隔离

每个线程都有一个 ThreadLocalMap 对象,该对象存储了所有 ThreadLocal 变量的副本。ThreadLocalMap 是 Thread 类的一个内部类,每个线程实例都有一个 ThreadLocalMap 实例。

2.2 存储机制

设置值: 当一个线程调用 ThreadLocal.set(value) 时,ThreadLocal 会将值存储到当前线程的 ThreadLocalMap 中。
获取值: 调用 ThreadLocal.get() 时,ThreadLocal 会从当前线程的 ThreadLocalMap 中获取值。

2.3 内存管理

弱引用: ThreadLocalMap 使用弱引用(WeakReferenandroidce)来存储 ThreadLocal 对象,以防止内存泄漏。
清理: 当 ThreadLocal 对象不再被使用时,它可以被垃圾回收,从而避免内存泄漏。

3. 使用场景

3.1 用户会话管理

在 Web 应用中,可以使用 ThreadLocal 存储用户会话信息,确保每个请求处理线程都能访问到正确的会话数据。

3.2 事务上下文管理

数据库操作中,可以使用 ThreadLocal 存储事务上下文,确保每个线程的操作都在正确的事务中进行。

3.3 线程局DnimSaP部变量

在多线程环境中,需要每个线程拥有独立的变量副本时,可以使用 ThreadLocal。

4. 示例代码

以下是一个简单的示例,展示了如何使用 ThreadLocal 来管理每个线程的独立变量。

public class ThreadLocalExample {
// 创建一个 ThreadLocal 实例
private static final ThreadLocal threadLocal = new ThreadLocal<>();
public static void main(String[] args) {
    // 创建多个线程
    for (int i = 0; i < 5; i++) {
        new Thread(() -> {
            // 为每个线程设置不同的值
            threadLocal.set((int) (www.chinasem.cnMath.random() * 100));
            try {
                // 模拟线程执行时间
                Thread.sleep(1000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            // 获取并打印当前线程的值
            System.out.println("Thread " + Thread.currentThread().getId() + ": " + threadLocal.get());
            // 清除 ThreadLocal 变量,避免内存泄漏
            threadLocal.remove();
        }).start();
    }
}
}

4.1 关键点

线程隔离: 每个线程都有独立的 ThreadLocal 变量副本。
内存管理: 使用 ThreadLocal.remove() 清除不再需要的变量,避免内存泄漏。
性能考虑: ThreadLocal 的使用会增加一定的内存开销,因此在不需要时应及时清理。

5. 注意事项

5.1 内存泄漏

如果不及时清理 ThreadLocal 变量,可能会导致内存泄漏。因此,建议在使用完 ThreadLocal 变量后调用 remove() 方法。

5.2 线程池

在使用线程池时,线程可能会被重用。如果 ThreadLocal 变量没有被清理,可能会导致后续任务访问到错误的数据。因此,在使用线程池时,务必在任务执行完毕后清理 ThreadLocal 变量。

实战演示

1. User 类

User 类表示用户数据

/**
 * User
 * @author senfel
 * @version 1.0
 * @date 2025/2/18 17:00
 */
@AllArgsConstructor
@NoArgsConstructor
@Data
public class User {
    private String id;
    private String username;
}

2. UserContext 类

UserContext 类使用 ThreadLocal 来存储和删除用户数据。

/**
 * UserContext
 * @author senfel
 * @version 1.0
 * @date 2025/2/18 17:01
 */
public class UserContext {
    // 创建一个 ThreadLocal 实例来存储 User 对象
    private static final ThreadLocal<User> userThreadLocal = new ThreadLocal<>();
    // 设置用户数据
    public static void setUser(User user) {
        userThreadLocal.set(user);
    }
    // 获取用户数据
    public static User getUser() {
        return userThreadLocal.get();
    }
    // 删除用户数据
    public static void clearUser() {
        userThreadLocalwww.chinasem.cn.remove();
    }
}

3.UserInterceptor 类

UserInterceptor 类用于在请求处理前后设置和清除 ThreadLocal 中的用户数据。

/**
 * UserInterceptor
 * @author senfel
 * @version 1.0
 * @date 2025/2/18 17:03
 */
@Component
public class UserInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // 模拟从请求中获取用户数据
        String userId = request.getParameter("userId");
   python     String username = request.getParameter("username");
        if (userId == null || username == null) {
            response.getWriter().write("User ID and Username are required.");
            return false;
        }
        // 创建 User 对象并存储在 ThreadLocal 中
        User user = new User(userId, username);
        UserContext.setUser(user);
        return true;
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        // 清除 ThreadLocal 中的用户数据,避免内存泄漏
        UserContext.clearUser();
    }
}

4.配置拦截器

在 Spring Boot 中配置拦截器,使其在请求处理前后执行。

/**
 * WebConfig
 * @author senfel
 * @version 1.0
 * @date 2025/2/18 17:10
 */
@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private UserInterceptor userInterceptor;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(userInterceptor).addPathPatterns("/**");
    }

5.实战测试

随便访问一个路径,都会从请求中获取用户信息并放入local,在执行控制器结束后会清理掉数据。

SpringBoot中使用 ThreadLocal 进行多线程上下文管理及注意事项小结

SpringBoot中使用 ThreadLocal 进行多线程上下文管理及注意事项小结

总结

ThreadLocal 是一个非常强大的工具,可以帮助我们在多线程环境中管理线程局部变量。通过合理使用 ThreadLocal,可以有效地避免线程安全问题,提高程序的并发性能和稳定性。我们可以在 Spring Boot 应用中安全地存储和管理每个请求的用户数据,并通过显式地清理 ThreadLocal 变量,可以有效避免内存泄漏问题。

到此这篇关于SpringBoot中使用 ThreadLocal 进行多线程上下文管理及其注意事项的文章就介绍到这了,更多相关SpringBoot ThreadLocal多线程上下文管理内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持China编程(www.chinasem.cn)!

这篇关于SpringBoot中使用 ThreadLocal 进行多线程上下文管理及注意事项小结的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



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

相关文章

一文详解如何从零构建Spring Boot Starter并实现整合

《一文详解如何从零构建SpringBootStarter并实现整合》SpringBoot是一个开源的Java基础框架,用于创建独立、生产级的基于Spring框架的应用程序,:本文主要介绍如何从... 目录一、Spring Boot Starter的核心价值二、Starter项目创建全流程2.1 项目初始化(

Spring Boot3虚拟线程的使用步骤详解

《SpringBoot3虚拟线程的使用步骤详解》虚拟线程是Java19中引入的一个新特性,旨在通过简化线程管理来提升应用程序的并发性能,:本文主要介绍SpringBoot3虚拟线程的使用步骤,... 目录问题根源分析解决方案验证验证实验实验1:未启用keep-alive实验2:启用keep-alive扩展建

SpringBoot配置Ollama实现本地部署DeepSeek

《SpringBoot配置Ollama实现本地部署DeepSeek》本文主要介绍了在本地环境中使用Ollama配置DeepSeek模型,并在IntelliJIDEA中创建一个Sprin... 目录前言详细步骤一、本地配置DeepSeek二、SpringBoot项目调用本地DeepSeek前言随着人工智能技

Docker镜像pull失败两种解决办法小结

《Docker镜像pull失败两种解决办法小结》有时候我们在拉取Docker镜像的过程中会遇到一些问题,:本文主要介绍Docker镜像pull失败两种解决办法的相关资料,文中通过代码介绍的非常详细... 目录docker 镜像 pull 失败解决办法1DrQwWCocker 镜像 pull 失败解决方法2总

SpringBoot启动报错的11个高频问题排查与解决终极指南

《SpringBoot启动报错的11个高频问题排查与解决终极指南》这篇文章主要为大家详细介绍了SpringBoot启动报错的11个高频问题的排查与解决,文中的示例代码讲解详细,感兴趣的小伙伴可以了解一... 目录1. 依赖冲突:NoSuchMethodError 的终极解法2. Bean注入失败:No qu

Java异常架构Exception(异常)详解

《Java异常架构Exception(异常)详解》:本文主要介绍Java异常架构Exception(异常),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1. Exception 类的概述Exception的分类2. 受检异常(Checked Exception)

使用Java实现通用树形结构构建工具类

《使用Java实现通用树形结构构建工具类》这篇文章主要为大家详细介绍了如何使用Java实现通用树形结构构建工具类,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录完整代码一、设计思想与核心功能二、核心实现原理1. 数据结构准备阶段2. 循环依赖检测算法3. 树形结构构建4. 搜索子

Spring定时任务只执行一次的原因分析与解决方案

《Spring定时任务只执行一次的原因分析与解决方案》在使用Spring的@Scheduled定时任务时,你是否遇到过任务只执行一次,后续不再触发的情况?这种情况可能由多种原因导致,如未启用调度、线程... 目录1. 问题背景2. Spring定时任务的基本用法3. 为什么定时任务只执行一次?3.1 未启用

springboot报错Invalid bound statement (not found)的解决

《springboot报错Invalidboundstatement(notfound)的解决》本文主要介绍了springboot报错Invalidboundstatement(not... 目录一. 问题描述二.解决问题三. 添加配置项 四.其他的解决方案4.1 Mapper 接口与 XML 文件不匹配

基于Flask框架添加多个AI模型的API并进行交互

《基于Flask框架添加多个AI模型的API并进行交互》:本文主要介绍如何基于Flask框架开发AI模型API管理系统,允许用户添加、删除不同AI模型的API密钥,感兴趣的可以了解下... 目录1. 概述2. 后端代码说明2.1 依赖库导入2.2 应用初始化2.3 API 存储字典2.4 路由函数2.5 应