Identify and apply robust Java exception handling practices to improve error clarity, security, debuggability, and system reliability.
Prerequisites: Run ./mvnw compile or mvn compile before applying any changes. If compilation fails, stop immediately — do not proceed until the project is in a valid state.
Core areas: Specific exception types instead of generic Exception/RuntimeException, try-with-resources for automatic resource cleanup, secure exception messages that avoid information leakage, exception chaining to preserve full error context, early input validation with IllegalArgumentException/NullPointerException, InterruptedException handling with interrupted-status restoration, @throws JavaDoc documentation,...
استخدمه عندما تحتاج إلى تطبيق استثناءات Java للتعامل مع أفضل الممارسات - بما في ذلك استخدام أنواع استثناءات محددة، وإدارة الموارد من خلال المحاولة باستخدام الموارد، وتأمين رسائل الاستثناء، والحفاظ على سياق الخطأ عبر تسلسل الاستثناءات، والتحقق من صحة المدخلات مبكرًا باستخدام مبادئ الفشل السريع، والتعامل مع مقاطعة سلسلة المحادثات بشكل صحيح، وتوثيق الاستثناءات باستخدام @throws، وفرض سياسة التسجيل، وترجمة الاستثناءات عند حدود واجهة برمجة التطبيقات (API)، وإدارة عمليات إعادة المحاولة والعجز، وفرض المهلات، وإرفاق الاستثناءات المكبوتة، ونشر حالات الفشل في رمز غير متزامن/رد الفعل. جزء من مشروع مهارات جافا المصدر: jabrena/cursor-rules-java.