<span>ThreadLocal的基本用法</span>

1.基本用法

Java ThreadLocal类允许您创建只能由同一线程读写的变量。因此，即使两个线程正在执行相同的代码，并且代码引用了相同的ThreadLocal变量，这两个线程也不能看到彼此的ThreadLocal变量。因此，Java ThreadLocal类提供了一种使代码线程安全的简单方法。

//创建
private ThreadLocal threadLocal = new ThreadLocal();
//一旦创建了ThreadLocal，就可以使用它的set()方法设置要存储在其中的值。
threadLocal.set("A thread local value");
//获取值
String threadLocalValue = (String) threadLocal.get();
//移除一个值
threadLocal.remove();

2. 普通ThreadLocal

//您可以创建具有泛型类型的ThreadLocal。使用泛型类型时，只能将泛型类型的对象设置为ThreadLocal的值。
//此外，您不必对get()返回的值进行类型转换。
private ThreadLocal<String> myThreadLocal = new ThreadLocal<String>();
//现在只能在ThreadLocal实例中存储字符串。另外，您不需要对从ThreadLocal获得的值进行类型转换
myThreadLocal.set("Hello ThreadLocal");
String threadLocalValue = myThreadLocal.get();

3.初始化ThreadLocal的值

可以为Java ThreadLocal设置一个初始值，该值将在第一次调用get()时使用.
有两种方式指定ThreadLocal初始值：

3.1创建一个ThreadLocal子类，该子类覆盖initialValue()方法:

//为Java ThreadLocal变量指定初始值的第一种方法是创建ThreadLocal的子类，该子类覆盖了它的initialValue()方法。
//创建ThreadLocal子类的最简单方法是直接在创建ThreadLocal变量的地方创建一个匿名子类。下面是建匿名子类的示例，
//该子类覆盖了initialValue()方法
private ThreadLocal myThreadLocal = new ThreadLocal<String>() {
    @Override protected String initialValue() {
        return String.valueOf(System.currentTimeMillis());
    }
};
//注意，不同的线程仍然会看到不同的初始值。每个线程将创建自己的初始值。
//只有当从initialValue()方法返回完全相同的对象时，所有线程才会看到相同的对象。
//但是，首先使用ThreadLocal的全部意义在于避免不同的线程看到相同的实例

3.2创建具有Supplier接口实现的ThreadLocal。

//为Java ThreadLocal变量指定初始值的第二种方法是使用其内部的静态工厂方法(Supplier)，将Supplier接口实现作为参数传递。
//这个Supplier实现为ThreadLocal提供初始值。
//下面是一个使用其withInitial()静态工厂方法创建ThreadLocal的示例，该方法传递一个简单的供应商实现作为参数
ThreadLocal<String> threadLocal = ThreadLocal.withInitial(new Supplier<String>() {
    @Override
    public String get() {
        return String.valueOf(System.currentTimeMillis());
    }
});
//Java8 lambda表达式的写法
ThreadLocal threadLocal = ThreadLocal.withInitial(
        () -> { return String.valueOf(System.currentTimeMillis()); } );
//还可以更短
ThreadLocal threadLocal3 = ThreadLocal.withInitial(
        () -> String.valueOf(System.currentTimeMillis()) );

4.延迟设置ThreadLocal的值

//在某些情况下，您不能使用设置初始值的标准方法。例如，您可能需要一些在创建ThreadLocal变量时不可用的配置信息。
//在这种情况下，可以延迟设置初始值。
//下面是如何在Java ThreadLocal上惰性地设置初始值的示例
public class MyDateFormatter {

    private ThreadLocal<SimpleDateFormat> simpleDateFormatThreadLocal = new ThreadLocal<>();

    public String format(Date date) {
        SimpleDateFormat simpleDateFormat = getThreadLocalSimpleDateFormat();
        return simpleDateFormat.format(date);
    }
    
    private SimpleDateFormat getThreadLocalSimpleDateFormat() {
        SimpleDateFormat simpleDateFormat = simpleDateFormatThreadLocal.get();
        if(simpleDateFormat == null) {
            simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            simpleDateFormatThreadLocal.set(simpleDateFormat);
        }
        return simpleDateFormat;
    }
}
//注意format()方法是如何调用getThreadLocalSimpleDateFormat()方法来获取Java SimpleDatFormat实例的。
//如果在ThreadLocal中没有设置SimpleDateFormat实例，那么就会在ThreadLocal变量中创建并设置一个新的SimpleDateFormat。
//一旦线程在ThreadLocal变量中设置了自己的SimpleDateFormat，就会对该线程使用相同的SimpleDateFormat对象继续前进。
//但只是为了那条线。每个线程创建自己的SimpleDateFormat实例，因为它们不能看到在ThreadLocal变量上设置的其他实例。

//SimpleDateFormat类不是线程安全的，因此多个线程不能同时使用它。为了解决这个问题，
//上面的MyDateFormatter类为每个线程创建一个SimpleDateFormat，
//因此调用format()方法的每个线程将使用自己的SimpleDateFormat实例。

5.多线程情况下使用 ThreadLocal

如果您计划从传递给Java线程池或Java ExecutorService的任务内部使用Java ThreadLocal，请记住，您不能保证哪个线程将执行您的任务。
但是，如果您所需要的只是确保每个线程使用某个对象的自己的实例，那么这不是问题。然后，您可以将Java ThreadLocal与线程池或ExecutorService一起使用。

5.1 完整的ThreadLocal 示例

public class ThreadLocalExample {

    public static void main(String[] args) {
        MyRunnable sharedRunnableInstance = new MyRunnable();

        Thread thread1 = new Thread(sharedRunnableInstance);
        Thread thread2 = new Thread(sharedRunnableInstance);

        thread1.start();
        thread2.start();

        thread1.join(); //wait for thread 1 to terminate
        thread2.join(); //wait for thread 2 to terminate
    }

}
//
public class MyRunnable implements Runnable {

    private ThreadLocal<Integer> threadLocal = new ThreadLocal<Integer>();

    @Override
    public void run() {
        threadLocal.set( (int) (Math.random() * 100D) );

        try {
            Thread.sleep(2000);
        } catch (InterruptedException e) {
        }

        System.out.println(threadLocal.get());
    }
}

//这个例子创建了一个MyRunnable实例，
//它被传递给两个不同的线程。两个线程都执行run()方法，因此在ThreadLocal实例上设置不同的值。
//如果对set()调用的访问是同步的，并且它不是ThreadLocal对象，那么第二个线程就会覆盖第一个线程设置的值。
//但是，因为它是ThreadLocal对象，所以两个线程不能看到彼此的值。因此，它们设置和获取不同的值。

6.可继承(Inheritable) ThreadLocal

InheritableThreadLocal类是ThreadLocal的子类。与每个线程在ThreadLocal中都有自己的值不同，
InheritableThreadLocal将对值的访问权授予一个线程和该线程创建的所有子线程。下面是一个完整的Java InheritableThreadLocal示例:

public class InheritableThreadLocalBasicExample {

    public static void main(String[] args) {

        ThreadLocal<String> threadLocal = new ThreadLocal<>();
        InheritableThreadLocal<String> inheritableThreadLocal =
                new InheritableThreadLocal<>();

        Thread thread1 = new Thread(() -> {
            System.out.println("===== Thread 1 =====");
            threadLocal.set("Thread 1 - ThreadLocal");
            inheritableThreadLocal.set("Thread 1 - InheritableThreadLocal");

            System.out.println(threadLocal.get());
            System.out.println(inheritableThreadLocal.get());

            Thread childThread = new Thread( () -> {
                System.out.println("===== ChildThread =====");
                System.out.println(threadLocal.get());
                System.out.println(inheritableThreadLocal.get());
            });
            childThread.start();
        });

        thread1.start();

        Thread thread2 = new Thread(() -> {
            try {
                Thread.sleep(3000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }

            System.out.println("===== Thread2 =====");
            System.out.println(threadLocal.get());
            System.out.println(inheritableThreadLocal.get());
        });
        thread2.start();
    }
}


//这个例子创建了一个普通的Java ThreadLocal和一个Java InheritableThreadLocal。
//然后，示例创建一个线程，该线程设置ThreadLocal和InheritableThreadLocal的值——然后创建一个子线程，
//该子线程访问ThreadLocal和InheritableThreadLocal的值。只有InheritableThreadLocal的值对子线程是可见的。
//最后，示例创建了第三个线程，该线程也尝试访问ThreadLocal和InheritableThreadLocal——但是它看不到第一个线程存储的任何值
//输出值：
===== Thread 1 =====
Thread 1 - ThreadLocal
Thread 1 - InheritableThreadLocal
===== ChildThread =====
null
Thread 1 - InheritableThreadLocal
===== Thread2 =====
null
null