generated from mingliqiye/lib-tem
minglipro
09792e2c3b
All checks were successful
Gitea Actions Build / Build (push) Successful in 53s
106 lines
2.3 KiB
Java
106 lines
2.3 KiB
Java
/*
|
||
* Copyright 2025 mingliqiye
|
||
*
|
||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
* you may not use this file except in compliance with the License.
|
||
* You may obtain a copy of the License at
|
||
*
|
||
* http://www.apache.org/licenses/LICENSE-2.0
|
||
*
|
||
* Unless required by applicable law or agreed to in writing, software
|
||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
* See the License for the specific language governing permissions and
|
||
* limitations under the License.
|
||
*
|
||
* ProjectName mingli-utils
|
||
* ModuleName mingli-utils.main
|
||
* CurrentFile ThreadLocalDataHolder.java
|
||
* LastUpdate 2025-09-09 08:37:33
|
||
* UpdateUser MingLiPro
|
||
*/
|
||
|
||
package com.mingliqiye.utils.data;
|
||
|
||
/**
|
||
* 泛型线程局部变量持有器
|
||
* <p>
|
||
* 封装了 ThreadLocal 的常用操作，提供更便捷的 API 来管理线程本地变量。
|
||
*
|
||
* @param <T> 存储的数据类型
|
||
* @author MingLiPro
|
||
*/
|
||
public class ThreadLocalDataHolder<T> {
|
||
|
||
private final ThreadLocal<T> threadLocal;
|
||
|
||
/**
|
||
* 构造函数，初始化 ThreadLocal 实例
|
||
*/
|
||
public ThreadLocalDataHolder() {
|
||
this.threadLocal = new ThreadLocal<>();
|
||
}
|
||
|
||
/**
|
||
* 获取当前线程存储的值
|
||
*
|
||
* @return 当前线程存储的值，如果没有则返回null
|
||
*/
|
||
public T get() {
|
||
return threadLocal.get();
|
||
}
|
||
|
||
/**
|
||
* 设置当前线程的值
|
||
*
|
||
* @param value 要存储的值
|
||
*/
|
||
public void set(T value) {
|
||
threadLocal.set(value);
|
||
}
|
||
|
||
/**
|
||
* 移除当前线程存储的值
|
||
* <p>
|
||
* 防止内存泄漏，使用完毕后应调用此方法清理资源。
|
||
*/
|
||
public void remove() {
|
||
threadLocal.remove();
|
||
}
|
||
|
||
/**
|
||
* 获取当前线程存储的值，如果不存在则返回默认值
|
||
*
|
||
* @param defaultValue 默认值
|
||
* @return 当前线程存储的值或默认值
|
||
*/
|
||
public T getOrDefault(T defaultValue) {
|
||
T value = threadLocal.get();
|
||
return value != null ? value : defaultValue;
|
||
}
|
||
|
||
/**
|
||
* 安全获取值（避免NPE）
|
||
* <p>
|
||
* 在某些异常情况下防止抛出异常，直接返回 null。
|
||
*
|
||
* @return 值或null
|
||
*/
|
||
public T safeGet() {
|
||
try {
|
||
return threadLocal.get();
|
||
} catch (Exception e) {
|
||
return null;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 检查当前线程是否有值
|
||
*
|
||
* @return 是否有值
|
||
*/
|
||
public boolean isPresent() {
|
||
return threadLocal.get() != null;
|
||
}
|
||
}
|