125-java-concurrency

Identify and apply Java concurrency best practices to improve thread safety, scalability, and maintainability by using modern java.util.concurrent utilities, virtual threads, and structured concurrency.

Prerequisites: Run ./mvnw compile or mvn compile before applying any change. If compilation fails, stop immediately — compilation failure is a blocking condition that prevents any further processing.

Core areas: Thread safety fundamentals (ConcurrentHashMap, AtomicInteger, ReentrantLock, ReadWriteLock, Java Memory Model), ExecutorService thread pool configuration (sizing, keep-alive, bounded queues, rejection policies, graceful shutdown), Producer-Consumer and Publish-Subscribe concurrent design patterns (BlockingQueue), CompletableFuture for non-blocking async composition (thenApply/thenCompose/exceptionally/...

استخدمه عندما تحتاج إلى تطبيق أفضل ممارسات Java المتزامنة - بما في ذلك أساسيات سلامة سلاسل الرسائل، وإدارة تجمع سلاسل الرسائل ExecutorService، وأنماط التصميم المتزامنة مثل Producer-Consumer، والبرمجة غير المتزامنة مع CompletableFuture، والثبات والنشر الآمن، وتجنب حالة التوقف التام، والسلاسل الافتراضية والتزامن المنظم، والقيم المحددة النطاق، والضغط الخلفي، ونظام الإلغاء، وقابلية الملاحظة للأنظمة المتزامنة. جزء من مشروع مهارات جافا المصدر: jabrena/cursor-rules-java.