التزامن المهيكل والقيم المحصورة النطاق في Java
بفضل العمل على JEP-505، يقدّم Java 25 التزامن المهيكل. يشرح هذا المقال، المحدَّث في سبتمبر 2025، فكرة التزامن المهيكل، ويقارنها بالواجهة البرمجية الحالية، وينظر في المشكلات التي يعالجها.
بفضل العمل على JEP-533، يقدّم Java 25 التزامن المهيكل. يشرح هذا المقال، المحدَّث في سبتمبر 2025، فكرة التزامن المهيكل، ويقارنها بالواجهة البرمجية الحالية، وينظر في المشكلات التي يعالجها.
خضع هذا المقال لتحديث في 9 سبتمبر 2026.
ما هو التزامن المهيكل
مع التزامن المهيكل، ترتبط كل مهمة فرعية بنطاق مهمتها الأم ولا يمكنها أن تعيش بعدها – على النحو نفسه الذي لا يمكن فيه لاستدعاء دالة أن يستمر أطول من الدالة التي أجرته.
وهذا يجعل الشيفرة المتزامنة أسهل بكثير في الاستدلال: فلا تبقى خيوط خلفية يتيمة تعمل بعد انتهاء المهمة الأم، وتصبح معالجة الأخطاء أكثر قابلية للتنبؤ لأن الإخفاقات يمكن التعامل معها في مكان واحد، ويصبح النظام بأكمله أسهل في المراقبة وتصحيح الأخطاء.
وعمليًا، فهو يحمي من الفخاخ المعتادة للتزامن غير المضبوط، مثل تسرب الخيوط أو بقاء المهام معلّقة إلى الأبد، وهي أمور كثيرًا ما تنتج أنظمة هشة يصعب صيانتها.
وفي Java، يعمل التزامن المهيكل مع الخيوط الافتراضية التي أدخلها Project Loom. وبما أن الخيوط الافتراضية خفيفة للغاية، فإن إنشاء مهام جديدة لا يكلّف شيئًا يُذكر، مما يُبقي هذا النهج عمليًا وفعّالًا حتى في التطبيقات شديدة التزامن.
مثال: إنشاء فاتورة بالتزامن المهيكل
لنبيّن ما الخطأ في الواجهة البرمجية الحالية، لنأخذ مثالًا بسيطًا: إنشاء فاتورة. نحتاج إلى جلب المُصدِر والعميل وقائمة العناصر. وتنفيذ ذلك واحدًا تلو الآخر على خيط واحد يعمل لكن ببطء. والأفضل جلب البيانات بالتوازي.
لنبدأ بالنظر في كيفية إنجاز ذلك باستخدام ExecutorService.
التزامن (غير) المهيكل
Invoice generateInvoice() throws ExecutionException, InterruptedException {
try (final var executor = Executors.newFixedThreadPool(3)) {
Future<Issuer> issuer = executor.submit(this::findIssuer);
Future<Customer> customer = executor.submit(this::findCustomer);
Future<List<Item>> items = executor.submit(this::findItems);
return new Invoice(issuer.get(), customer.get(), items.get());
}
}
يأتي هذا النهج بعدة مشكلات:
- إذا استغرق
findCustomerوقتًا أطول منfindItems، وألقىfindItemsاستثناءً،
فسيتوقف الكود عندcustomer.get()حتى يكتمل الخيط الذي ينفذfindCustomer. وبذلك نهدر الموارد في انتظار انتهاء تلك المهمة الفرعية. - إذا قوطع الخيط الذي يستدعي
generateInvoice()، فلن تُقاطَع المهام الفرعية في المنفِّذ (executor) وتتسرب.
وقد تستمر حتى في العمل إلى أجل غير مسمى، خارج السيطرة.
التزامن المهيكل
Invoice generateInvoice() throws InterruptedException, ExecutionException {
try (var scope = StructuredTaskScope.open(
StructuredTaskScope.Joiner.allSuccessfulOrThrow() // (1)
)) {
Subtask<Issuer> issuer = scope.fork(this::findIssuer);
Subtask<Customer> customer = scope.fork(this::findCustomer);
Subtask<List<Item>> items = scope.fork(this::findItems);
scope.join(); // (2)
return new Invoice(issuer.get(), customer.get(), items.get());
}
}
- (1): يُنشأ
StructuredTaskScopeجديد عبر دالة المصنعopen()بسياسةallSuccessfulOrThrow().
وإذا ألقىfindIssuerأوfindCustomerأوfindItemsاستثناءً، تُلغى المهام الفرعية المتبقية ويفشل النطاق. - (2): يتوقف حتى تنتهي كل المهام الفرعية في النطاق، ويلقي استثناءً إذا فشلت إحداها.
لاحظ أنscope.join()يلقي افتراضيًاExecutionExceptionعند فشل إحدى المهام الفرعية. لكن يمكننا ضبطه ليلقي أي استثناء مخصص نختاره. وهذا يتطلب تعديلًا بسيطًا على السطر (1): استدعاءStructuredTaskScope.Joiner.allSuccessfulOrThrow(MyCustomException::new). وعندئذ سيتعين علينا أيضًا التصريح بـMyCustomExceptionفي عبارةgenerateInvoice() throwsبدلًا منExecutionExceptionالافتراضي.
لا تعاني الشيفرة أعلاه من المشكلات الموصوفة سابقًا:
- إذا استغرق
findCustomerوقتًا أطول منfindItems، لكنfindItemsألقى استثناءً، تُلغى المهمة الأطول زمنًا. - إذا قوطع الخيط الذي يستدعي
generateInvoice()، ينتشر الإلغاء إلى المهام الفرعية. - تنتهي كل مهمة فرعية قبل الخروج من النطاق.
للوهلة الأولى يبدو أن الاختلاف قليل: فـ StructuredTaskScope يحل محل ExecutorService، وبما أن كليهما ينفذ AutoCloseable، تعمل try-with-resources مع كل منهما. لكن الفرق مهم: فـ ExecutorService يعتمد عادةً على خيوط المنصة، بينما يستخدم StructuredTaskScope الخيوط الافتراضية الخفيفة من مشروع Loom. وإضافة إلى ذلك، يعيد ExecutorService كائن Future<T>، بينما نتعامل هنا مع Subtask<T>.
سياسات التزامن المهيكل
السياسة هي مجموعة قواعد تحدد كيف يتفاعل StructuredTaskScope عند نجاح مهامه الفرعية أو فشلها.
وتنفذها الواجهة البرمجية الجديدة على شكل Joiners.
allSuccessfulOrThrow
عند فشل أي مهمة فرعية، تُلغى الأخرى ويفشل النطاق. وهذا يناسب مثال الفاتورة لدينا جيدًا – إذ يجب أن يكون كل جزء من البيانات موجودًا.
anySuccessfulOrThrow
بمجرد نجاح مهمة فرعية واحدة، تُوقف المهام المتبقية؛ وإذا فشلت كلها، يُلقى استثناء. وهذا مفيد عند الاستعلام من عدة مصادر عن البيانات نفسها حيث لا يهم إلا الأسرع – سيناريو حالة التسابق الكلاسيكي.
allUntil
يُبقي كل المهام الفرعية تعمل حتى يتحقق شرط، ثم يلغي المتبقية.
سياسات أخرى
عند الضرورة، يمكنك كتابة سياستك الخاصة بتنفيذ StructuredTaskScope.Joiner<T, R, R_X extends Throwable> مخصص.
القيم محصورة النطاق (Scoped values)
توفر القيم محصورة النطاق طريقة بسيطة وآمنة لمشاركة بيانات غير قابلة للتغيير عبر الدوال والخيوط الفرعية. وهي أسهل في الاستدلال من ThreadLocal وأرخص منها، خاصة عند دمجها مع الخيوط الافتراضية والتزامن المهيكل.
في JDK 25 (JEP 506) أصبحت واجهة القيم محصورة النطاق نهائية. وهناك فرق بسيط عن نسخ المعاينة: لم تعد الدالة orElse تقبل null.
مثال: معرّف الطلب في التسجيل
import java.util.concurrent.StructuredTaskScope;
import java.util.concurrent.StructuredTaskScope.Joiner;
import static java.lang.ScopedValue.where;
public class LoggerExample {
private static final ScopedValue<String> REQUEST_ID =
ScopedValue.newInstance();
static void main() throws InterruptedException, ExecutionException {
try (var scope = StructuredTaskScope
.open(Joiner.allSuccessfulOrThrow())) {
scope.fork(() -> where(REQUEST_ID, "abc-123")
.run(Main::handleRequest));
scope.fork(() -> where(REQUEST_ID, "xyz-789")
.run(Main::handleRequest));
scope.join();
}
}
static void handleRequest() {
log("handleRequest: start");
try (var scope = StructuredTaskScope
.open(Joiner.allSuccessfulOrThrow())) {
scope.fork(Main::queryDatabase);
scope.fork(Main::callExternalService);
scope.join();
} catch (InterruptedException | ExecutionException e) {
throw new RuntimeException(e);
}
log("handleRequest: done");
}
static void queryDatabase() {
log("Querying database...");
}
static void callExternalService() {
log("Calling external service...");
}
static void log(String message) {
String rid = REQUEST_ID.isBound() ?
REQUEST_ID.get() : "<unbound>";
System.out.println("[" + rid + "] " + message);
}
}
- تُعلن قيمة محصورة النطاق REQUEST_ID لتخزين معرّف الطلب.
- داخل main()، تُنشأ مهمتان فرعيتان، وتربط كل منهما REQUEST_ID بقيمتها الخاصة (abc-123 وxyz-789).
- تفتح handleRequest نطاقًا مهيكلًا وتشغّل مهامًا فرعية بالتوازي؛ وترى كل مهمة فرعية تلقائيًا معرّف الطلب المرتبط الصحيح.
- تبحث الدالة log عن REQUEST_ID ديناميكيًا، لذا تحمل كل رسالة معرّف الطلب الصحيح دون تمريره كمعامل.
مثال على المخرجات:
[xyz-789] handleRequest: start
[abc-123] handleRequest: start
[abc-123] Querying database...
[xyz-789] Querying database...
[xyz-789] Calling external service...
[xyz-789] handleRequest: done
[abc-123] Calling external service...
[abc-123] handleRequest: done
يوضح هذا كيف تتيح القيم محصورة النطاق تدفق السياق بنظافة وكفاءة على امتداد سلسلة الاستدعاءات وإلى المهام الفرعية.
الخلاصة
يُعد التزامن المهيكل والقيم محصورة النطاق إضافة قيّمة إلى الواجهة البرمجية القياسية في Java، تجعل كتابة الشيفرة المتزامنة أبسط.
- التزامن المهيكل (JEP 533) يتيح التعامل مع مجموعة من المهام الفرعية كوحدة عمل واحدة، مع إلغاء ومعالجة أخطاء يمكن التنبؤ بهما.
- القيم محصورة النطاق (JEP 506) توفر طريقة فعّالة وآمنة لمشاركة بيانات السياق غير القابلة للتغيير عبر الدوال والخيوط، دون المشكلات التي تأتي مع
ThreadLocal.