ال ' @قمع تحذيرات 'يوفر التعليق التوضيحي للمطورين فرصة لإلغاء التحذيرات دون الحاجة إلى تعديل التعليمات البرمجية وتجنب التغييرات غير الضرورية. يسمح بتكامل أكثر سلاسة دون التأثير على وظائف أو هيكل الكود القديم. باستخدامه ، يمكن للمبرمجين التركيز على عملية إعادة البناء دون أن تطغى عليهم التحذيرات التي يمكن معالجتها لاحقًا.
توضح هذه المقالة استخدام التعليق التوضيحيSuppressWarnings.
كيفية استخدام التعليق التوضيحيSuppressWarnings في جافا؟
ال ' @قمع تحذيرات يمنع التعليق التوضيحي التحذيرات المتعلقة باستخدام واجهات برمجة التطبيقات المحددة مع الاعتراف بمخاطرها. يتم استخدامه في الغالب لمنع التحذيرات المتعلقة بـ ' غير محدد 'أو' مهمل 'أو' غير مستخدم 'أو' أنواع خام 'أو' تسلسلي '. بالإضافة إلى ذلك ، فهو يساعد في تحسين الكود من خلال الإشارة صراحة إلى أن المطور على دراية ببعض التحذيرات ويختار عن قصد قمعها.
بناء الجملة
بناء جملة ' @قمع تحذيرات 'تم ذكر التعليق التوضيحي على النحو التالي:
@قمع تحذيرات ( 'ضوضاء' )
ال ' ضوضاء 'باسم التحذير المطلوب الذي يجب إلغاؤه.
دعونا نزور بعض الأمثلة للحصول على شرح مفصل:
مثال 1: قم بإلغاء التحذير الذي لم يتم التحقق منه
ال ' دون رادع 'سيتم منع التحذير من خلال استخدام' @قمع تحذيرات 'في مقطع الشفرة أدناه:
يستورد java.util.ArrayList ؛
يستورد java.util.List ؛
عام فصل حاشية. ملاحظة {
@قمع تحذيرات ( 'غير محدد' )
عام ثابتة فارغ رئيسي ( خيط [ ] حج )
{
// إعلان قائمة الصفيف
قائمة بلدان = جديد ArrayList ( ) ؛
// تم رفع تحذير لم يتم التحقق منه
بلدان. يضيف ( 'النمسا' ) ؛
نظام . خارج . println ( بلدان ) ؛
}
}
في مقتطف الشفرة أعلاه:
- أولاً ، قم باستيراد الأدوات المساعدة المطلوبة في ملف Java وإنشاء فئة باسم ' حاشية. ملاحظة '.
- ثم استخدم ' @قمع تحذيرات 'التعليق التوضيحي وتمرير اسم التحذير' دون رادع '.
- الآن ، أعلن عن قائمة صفيف بسيطة باسم ' بلدان 'وإدراج عنصر وهمي فيه.
- هذا يسبب ' دون رادع 'التحذير الذي يتم التعامل معه أو إلغاؤه بواسطة' @قمع تحذيرات ' حاشية. ملاحظة.
بعد التجميع:
يظهر الإخراج حدوث تحذير ويتم منعه من قبل المترجم لعرض الإخراج المطلوب.
مثال 2: قم بإلغاء التحذيرات غير المستخدمة والمهملة
لمنع كل من التحذيرات غير المستخدمة والمهملة ، دعنا نتبع الكود أدناه:
يستورد java.util.ArrayList ؛يستورد java.util.List ؛
@قمع تحذيرات ( { 'غير مستعمل' و 'إهمال' } )
عام فصل حاشية. ملاحظة {
خاص int unUseVar ؛
@إهمال
عام فارغ تستنكر ( ) {
// تنفيذ الأسلوب الموقوف
نظام . خارج . println ( 'إنه مهمل'. ) ؛
}
عام ثابتة فارغ رئيسي ( خيط [ ] أرجس ) {
// توليد كائن للفئة
عرض توضيحي = جديد حاشية. ملاحظة ( ) ؛
تجريبي. تستنكر ( ) ؛
}
}
في الكود أعلاه:
- لأول مرة ' @قمع تحذيرات 'التعليق التوضيحي لمنع أخطاء التحذير غير المستخدمة والمتعلقة بالإهمال.
- بعد ذلك ، أعلن عن فئة باسم ' حاشية. ملاحظة 'والإعلان عن متغير باسم' unUseVar ' داخله.
- ثم استخدم ' @إهمال 'التعليق التوضيحي لإيقاف' ديليك () 'الطريقة التي تحتوي على رسالة وهمية.
- بعد ذلك ، أعلن عن شيء ' تجريبي 'لفئة' التعليق التوضيحي 'واستخدم هذا الكائن لاستدعاء' ديليك () 'في' رئيسي() ' طريقة.
بعد التجميع ، يظهر الإخراج أدناه:
تسلط اللقطة أعلاه الضوء على المتغيرات غير المستخدمة والأدوات المساعدة والطرق المهملة التي يجب أن تثير التحذيرات. ولكن تم إلغاء هذه التحذيرات بسبب استخدام ' @قمع تحذيرات ' حاشية. ملاحظة.
خاتمة
في جافا ، ' @قمع تحذيرات 'التعليق التوضيحي يوجه المترجم إلى منع تحذيرات معينة أثناء عملية التجميع. يوفر للمطورين فرصة لتجاهل تحذيرات معينة بشكل انتقائي على أساس كل عنصر ، مثل الفئات أو الطرق أو المتغيرات. يجب استخدام التعليق التوضيحيSuppressWarnings بحذر وحذر لأن استخدامه غير السليم قد يؤدي إلى حدوث المزيد من الأخطاء في الكود.