1. ما هو التعليق التوضيحي المكرر؟
يسمح باستخدامات متعددة لنفس التعليق التوضيحي على نفس النوع المعلن (الفئة أو الخاصية أو الطريقة)
2. مثال بسيط
قبل Java 8، كانت هناك أيضًا حلول لإعادة استخدام التعليقات التوضيحية، لكن سهولة القراءة لم تكن جيدة جدًا، مثل الكود التالي:
انسخ رمز الكود كما يلي:
هيئة الواجهة العامة {
دور السلسلة ()؛
}
سلطات @interface العامة {
قيمة السلطة[]();
}
الطبقة العامة تكرار AnnotationUseOldVersion {
@Authorities({@Authority(role="Admin"),@Authority(role="Manager")})
الفراغ العام doSomeThing () {
}
}
استخدم تعليقًا توضيحيًا آخر لتخزين التعليقات التوضيحية المتكررة. عند استخدامه، استخدم سلطات التعليق التوضيحي للتخزين لتوسيع التعليقات التوضيحية المتكررة، دعنا نلقي نظرة على النهج المتبع في Java 8:
انسخ رمز الكود كما يلي:
@Repeatable(Authorities.class)
هيئة الواجهة العامة {
دور السلسلة ()؛
}
سلطات @interface العامة {
قيمة السلطة[]();
}
الطبقة العامة تكرار AnnotationUseNewVersion {
@Authority(الدور = "المسؤول")
@Authority(الدور = "المدير")
الفراغ العام doSomeThing(){ }
}
الفرق هو أنه عند إنشاء هيئة التعليقات التوضيحية المتكررة، أضف @Repeatable للإشارة إلى سلطات التعليقات التوضيحية المخزنة. عند استخدامها، يمكن إعادة استخدام التعليقات التوضيحية للسلطة مباشرة. من المثال أعلاه، يمكننا أن نرى أن النهج المتبع في Java 8 أكثر ملاءمة للتفكير التقليدي وأكثر قابلية للقراءة.
3. ملخص
لا يحتوي JEP120 على الكثير من المحتوى، إنها ميزة صغيرة فقط لتحسين إمكانية قراءة التعليمات البرمجية. هذه المرة، أجرى Java 8 تحسينين على التعليقات التوضيحية (JEP 104، JEP120)، وأعتقد أنه سيتم استخدام التعليقات التوضيحية بشكل متكرر أكثر من ذي قبل.