اكتب التعليقات التوضيحية في Java

مع تقديم Java 8 ، قدم الإصدار ميزتين جديدتين تسمى التعليقات التوضيحية المتكررة وكتابة التعليقات التوضيحية. حتى هذا الوقت ، إذا كنت تريد استخدام التعليقات التوضيحية في Java ، فلا يمكنك فعل ذلك إلا في الإعلانات. باستخدام Java 8 ، يمكنك الآن إضافة التعليقات التوضيحية لأي نوع من الاستخدامات. أينما كنت تستخدم نوعًا (بما في ذلك الأنواع في الإعلانات ، والعوامل العامة ، والكتابات) ، يمكنك إرفاق ذلك مع تعليق توضيحي.

اكتب بناء الجملة للتعليقات التوضيحية

يمكن أن تعلن Java 8 عن كتابة التعليقات التوضيحية على أي نوع استخدام. أحد الأمثلة هو المقتطف أدناه:

@ بيانات سلسلة مشفرة ؛ قائمة سلاسل سلاسل <NonNull> ؛ myGraph = (Immutable Graph) tmpGraph ؛ يمكنك ببساطة تقديم نوع تعليق توضيحي جديد. تشبه العملية تحديد تعليق توضيحي باستخدام هدف ElementType.TYPE_PARAMETER أو هدف ElementType.TYPE_USE أو كلا الهدفين:Target ({ElementType.TYPE_PARAMETER، ElementType.TYPE_USE}) publicinterface Encrypted {}

يشير هدف ElementType.TYPE_PARAMETER إلى أنه يمكنك كتابة التعليق التوضيحي على إعلان متغير النوع (مثل class MyClass {….}). يشير العنصر Element.Type.TYPE_USE إلى أنه يمكنك كتابة التعليق التوضيحي على أي نوع استخدام (أي الأنواع الموجودة في الإعلانات ، والعوامل العامة ، والقوالب).

يمكنك حفظ التعليقات التوضيحية في ملفات الفصل الدراسي ، لكنها لا تؤثر أو تؤثر على تنفيذ البرنامج. كمثال ، يمكنك التصريح عن متغيرين للملف واتصال كما هو موضح في الكود أدناه:

ملف الملف =… .؛ @ Encryted File encryptedFile =… ؛ @ فتح اتصال اتصال =… ؛ أثناء تنفيذ البرنامج ، ستكون النتيجة هي نفسها إذا قمت بتمرير أي من الملفين إلى طريقة الإرسال () الخاصة بالاتصال. connect.send (ملف) ؛ connect.send (ملف مشفر) ؛

بعض الأمثلة على نوع التعليقات التوضيحية

قائمةnonNull قائمة <NonNull String> str Arrays <NonNegative Integer> sortEncypted File fileOpen Connection connection void divideInteger (int a، int b) throwsZeroDivisior ArithmeticException