scoped value 사용법

java 21 부터 preview기능으로 시작한 범위 지정 값(이하 scoped value) API가 java 25부터 정식 기능으로 채택되었다.
java scoped value API는 메서드 매개변수를 사용하지 않고 메서드에 안전하고 효율적으로 데이터를 공유할 수 있도록 한다.
특히 java21 부터 도입된 가상 스레드를 사용할 때 ThreadLocal을 사용하면서 발생할 수 있는 문제에 대해서 scoped value 기능은 ThreadLocal에 대한 문제들을 해결할 수 있을 것이다.
이번 포스팅에서는 scoped value에 대한 도입 배경과 ThreadLocal 사용에 대한 문제와 함께 scoped value를 사용하는 방법에 대해서 정리해 보고자 한다. 샘플코드는 Java21 (preview)로 작성하였다.