在Spring Boot项目中，`ThreadLocal` 是一个非常有用的工具，特别是在处理用户会话信息时。`ThreadLocal` 允许你在同一个线程中存储和访问变量，而不会与其他线程的变量发生冲突。这对于存储用户会话信息、请求上下文等非常有用。

以下是一个示例，展示了如何在Spring Boot项目中使用 `ThreadLocal` 来存储和访问用户会话信息：

### 1. 创建一个 `ThreadLocal` 变量
首先，创建一个 `ThreadLocal` 变量来存储用户会话信息。通常，这个变量会被定义为一个静态变量。

public class UserContextHolder {private static final ThreadLocal<UserSession> userSessionHolder = new ThreadLocal<>();public static void setUserSession(UserSession userSession) {userSessionHolder.set(userSession);}public static UserSession getUserSession() {return userSessionHolder.get();}public static void clear() {userSessionHolder.remove();}
}

### 2. 定义用户会话类
定义一个用户会话类来存储用户信息。

public class UserSession {private String userId;private String username;// 其他用户信息// 构造函数、getter 和 setter 方法public UserSession(String userId, String username) {this.userId = userId;this.username = username;}public String getUserId() {return userId;}public void setUserId(String userId) {this.userId = userId;}public String getUsername() {return username;}public void setUsername(String username) {this.username = username;}
}

### 3. 在拦截器中设置用户会话信息
在Spring Boot中，可以使用拦截器（Interceptor）在请求到达控制器之前设置用户会话信息。

import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;@Component
public class UserSessionInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {// 从请求中获取用户会话信息，例如从请求头或Cookie中获取String userId = request.getHeader("X-User-Id");String username = request.getHeader("X-Username");if (userId != null && username != null) {UserSession userSession = new UserSession(userId, username);UserContextHolder.setUserSession(userSession);}return true;}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {// 清理ThreadLocal变量UserContextHolder.clear();}
}

### 4. 注册拦截器
在Spring Boot中注册拦截器。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;@Configuration
public class WebConfig implements WebMvcConfigurer {@Autowiredprivate UserSessionInterceptor userSessionInterceptor;@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(userSessionInterceptor);}
}

### 5. 在业务逻辑中使用用户会话信息
在业务逻辑中，可以通过 `UserContextHolder` 获取用户会话信息。

import org.springframework.stereotype.Service;@Service
public class UserService {public void doSomething() {UserSession userSession = UserContextHolder.getUserSession();if (userSession != null) {String userId = userSession.getUserId();String username = userSession.getUsername();// 使用用户会话信息进行业务逻辑处理System.out.println("User ID: " + userId + ", Username: " + username);} else {System.out.println("User session not found");}}
}

### 总结
通过上述步骤，我们可以在Spring Boot项目中使用 `ThreadLocal` 来存储和访问用户会话信息。`ThreadLocal` 确保了每个线程都有自己的用户会话信息副本，避免了线程安全问题，并且使得在业务逻辑中获取用户会话信息变得非常方便。