الرئيسية / Concurrency / القيم ذات النطاق
Concurrency متقدم

القيم ذات النطاق

شارك البيانات عبر مكدسات الاستدعاء بأمان دون مخاطر ThreadLocal.

مقارنة الكود
✕ Java 8 
static final ThreadLocal<User> CURRENT =
    new ThreadLocal<>();
void handle(Request req) {
    CURRENT.set(authenticate(req));
    try { process(); }
    finally { CURRENT.remove(); }
}
✓ Java 25 
static final ScopedValue<User> CURRENT =
    ScopedValue.newInstance();
void handle(Request req) {
    ScopedValue.where(CURRENT,
        authenticate(req)
    ).run(this::process);
}
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
🔒

ثابتة

يمكن للمستدعين القراءة لكن لا يستطيعون تعديل القيمة ذات النطاق.

🧹

تنظيف تلقائي

لا حاجة لـ remove() يدوي — القيمة محددة النطاق للكتلة.

⚡

آمنة مع الخيوط الافتراضية

تعمل بكفاءة مع ملايين الخيوط الافتراضية.

الأسلوب القديم
ThreadLocal
الأسلوب الحديث
ScopedValue
منذ JDK
25
الصعوبة
متقدم
دعم JDK
القيم ذات النطاق
متاح

أُنهيت في JDK 25 LTS (JEP 506، سبتمبر 2025).

كيف يعمل

يوفر ScopedValue سياقاً ثابتاً وقابلاً للوراثة ومحدود النطاق. بخلاف ThreadLocal، تُنظَّف القيم ذات النطاق تلقائياً وتعمل مع الخيوط الافتراضية ولا يمكن للمستدعين تعديلها.

توثيق ذو صلة
Scoped Values (JEP 487) ↗ ScopedValue ↗
أنماط ذات صلة
Concurrency مبتدئ

Virtual threads

Java 8
Thread thread = new Thread(() -> {
    System.out.println("hello");
});
thread.start();
thread.join();
Java 21+
Thread.startVirtualThread(() -> {
    IO.println("hello");
}).join();
مرر للرؤية الحديث ←
JDK 21+ →
Concurrency متقدم

Structured concurrency

Java 8
ExecutorService exec =
    Executors.newFixedThreadPool(2);
Future<User> u = exec.submit(this::fetchUser);
Future<Order> o = exec.submit(this::fetchOrder);
try {
    return combine(u.get(), o.get());
} finally { exec.shutdown(); }
Java 25 (Preview)
try (var scope = new StructuredTaskScope
        .ShutdownOnFailure()) {
    var u = scope.fork(this::fetchUser);
    var o = scope.fork(this::fetchOrder);
    scope.join().throwIfFailed();
    return combine(u.get(), o.get());
}
مرر للرؤية الحديث ←
JDK 25+ →
Concurrency متقدم

Stable values

Java 8
private volatile Logger logger;
Logger getLogger() {
    if (logger == null) {
        synchronized (this) {
            if (logger == null)
                logger = createLogger();
        }
    }
    return logger;
}
Java 25 (Preview)
private final StableValue<Logger> logger =
    StableValue.of(this::createLogger);

Logger getLogger() {
    return logger.get();
}
مرر للرؤية الحديث ←
JDK 25+ →
مشاركة 𝕏 🦋 in ⬡