जावा एनोटेशंस, भाग I

यह जावा 5+ भाषा तंत्र जैसे कि एनोटेशन के बारे में एक लेख का पहला भाग है। इसमें एक परिचयात्मक चरित्र है और इसे जूनियर डेवलपर्स या उन लोगों के लिए डिज़ाइन किया गया है जो अभी भाषा सीखना शुरू कर रहे हैं।

मैं ऑनलाइन जावा प्रशिक्षण में लगा हुआ हूं और जावा कोर कोर्स के रीडिजाइन के हिस्से के रूप में कुछ प्रशिक्षण सामग्री प्रकाशित करूंगा।

मैं ऑनलाइन शिक्षा प्लेटफॉर्म udemy.com (कौरसेरा / एडएक्स के समान) पर जावा डेवलपर्स कोर्स के लिए स्काला भी सिखाता हूं।

मेरी शिक्षण पद्धति यह है कि मैं

1. उदाहरणों के बढ़ते क्रम का निर्माण
2. संभावित अनुप्रयोगों की व्याख्या करें
3. लेखकों द्वारा संचालित तर्क (जहाँ तक संभव हो) की व्याख्या करें
4. मैं बड़ी संख्या में परीक्षण (50-100) को व्यापक रूप से समझने और विभिन्न संयोजनों का प्रदर्शन करने के लिए देता हूं
5. मैं स्वतंत्र काम के लिए प्रयोगशाला देता हूं

यह लेख पैराग्राफ # 1 (उदाहरण का अनुक्रम) और # 2 (मामलों का उपयोग करें) का अनुसरण करता है।

चलो चलते हैं!

केस स्टडी: "वर्ग संस्करण" के बारे में मेटा-जानकारी के साथ उपयोगकर्ता कक्षाएं प्रदान करें।

Iteration # 1:
इंटरफ़ेस के सामने @ डाला।

public @interface Version {} 

Iteration # 2:
एनोटेशन में विशेषताएं हो सकती हैं।

 public @interface Version { public int version(); } 

उपयोग करते समय भरें

 @Version(version = 42) public class MyClass {} 

उपरोक्त सारांश पूरी तरह से निम्नलिखित (सार्वजनिक के बिना) के बराबर है। यह एनोटेशन इंटरफेस के समान है: स्कोप मॉडिफ़ायर की अनुपस्थिति का मतलब स्वचालित रूप से सार्वजनिक है (और कक्षाओं के साथ निजी रूप से पैकेज नहीं)।

 public @interface Version { int version(); } 

संरक्षित और निजी के साथ - संकलित नहीं

 public @interface Version { protected int version(); } >> COMPILATION ERROR: Modifier 'protected' not allowed here 

आगे मैं सार्वजनिक संशोधक के बिना विकल्प का उपयोग करूंगा

Iteration # 3:
यदि आप एक विशेषता नामित मूल्य की घोषणा करते हैं, तो आप इसका उपयोग करते समय इसे छोड़ सकते हैं

 public @interface Version { public int value(); } 

 @Version(42) public class MyClass {} 

यद्यपि आप कर सकते हैं और पुराने तरीके से

 @Version(value = 42) public class MyClass {} 

Iteration # 4:
आप एक विशेषता के लिए डिफ़ॉल्ट मानों की घोषणा कर सकते हैं।

 public @interface Version { int value(); String author() default "UNKNOWN"; } 

अब हमारे पास दो उपयोग के मामले हैं। इतना

 @Version(42) public class MyClass {} 

या ऐसे ही

 @Version(value = 42, author = "Jim Smith") public class MyClass { } 

लेकिन ऐसा नहीं (सुनो, अपमानजनक, हाँ)

 @Version(42, author = "Jim Smith") public class MyClass {} >> COMPILATION ERROR: Annotation attribute must be of the form 'name=value' 

Iteration # 5:
विशेषताएँ में एक सरणी प्रकार हो सकता है।

 public @interface Author { String[] value() default {}; } 

 @Author({"Anna", "Mike", "Sara"}) public class MyClass {} 

लेकिन केवल एक-आयामी

 public @interface Author2D { String[][] value() default {}; } >> COMPILATION ERROR: Invalid type of annotation member 

Iteration # 6:
मजेदार चाल संभव: एनोटेशन - एनोटेशन विशेषता

 public @interface Version { int value(); String author() default "UNKNOWN"; } 

 public @interface History { Version[] value() default {}; } 

इस तरह लागू किया गया

 @History({ @Version(1), @Version(value = 2, author = "Jim Smith") }) public class MyClass {} 

एनोटेशन की कई सीमाएँ हैं। हम उनमें से कुछ को सूचीबद्ध करते हैं।

बाधा: विशेषता प्रकार

1. गुण केवल निम्न प्रकार हो सकते हैं

• पुरातन
• तार
• कक्षा या "कक्षा का कोई भी मानकीकृत आह्वान"
• enum
• टिप्पणी
• उपरोक्त में से किसी भी प्रकार के तत्वों की एक सरणी

अंतिम बिंदु को इस तथ्य के रूप में समझा जाना चाहिए कि केवल एक आयामी सरणियों की अनुमति है।

ठीक है, तो चलो सीमा के भीतर कार्य करते हैं

Iteration # 7:
एक विशेषता प्रकार के रूप में, आप "नियमित" जावा कक्षाओं (java.lang.String और java.lang.Class के अपवाद के साथ) का उपयोग नहीं कर सकते, java.util.Date का कहना है

 import java.util.Date; public @interface Version { Date date(); } >> COMPILATION ERROR: Invalid type for annotation member 

लेकिन आप एनोटेशन पर नोट्स / संरचनाओं का अनुकरण कर सकते हैं

 public @interface Date { int day(); int month(); int year(); } 

 public @interface Version { Date date(); } 

 @Date(year = 2001, month = 1, day = 1) public class MyClass {} 

Iteration # 8:
एक एनोटेशन विशेषता एनम हो सकती है। सुखद से, यह एनोटेशन घोषणा में घोषित किया जा सकता है (जैसा कि इंटरफ़ेस घोषणा में एनम, वर्ग, इंटरफ़ेस, एनोटेशन घोषणा हो सकता है)

 public @interface Colored { public enum Color {RED, GREEN, BLUE} Color value(); } 

 import static net.golovach.Colored.Color.RED; @Colored(RED) public class MyClass {} 

Iteration # 9:
एनोटेशन विशेषता एक वर्ग शाब्दिक हो सकती है।
संस्करण सारांश में कक्षा के पिछले संस्करण का लिंक शामिल है।

 public @interface Version { int value(); Class<?> previous() default Void.class; } 

कक्षा का पहला संस्करण

 @Version(1) public class ClassVer1 {} 

पहले के संदर्भ में दूसरा संस्करण

 @Version(value = 2, previous = ClassVer1.class) public class ClassVer2 {} 

// हां, मुझे पता है कि सामान्य लोग वर्ग के नाम को वर्ग नाम में शामिल नहीं करते हैं। लेकिन आप जानते हैं कि वास्तविक अभ्यास के अनुरूप उदाहरणों के साथ आना कितना उबाऊ है?

Iteration # 10:
एक वर्ग शाब्दिक के साथ एक कम तुच्छ उदाहरण, जहां मैं विरोध नहीं कर सका और जेनरिक जोड़ा।
"धारावाहिक" का इंटरफ़ेस वह है जो आउटपुट के टी से बाइट स्ट्रीम में एक उदाहरण लिख सकता है

 import java.io.IOException; import java.io.OutputStream; public interface Serializer<T> { void toStream(T obj, OutputStream out) throws IOException; } 

मायक्लास वर्ग के लिए एक विशिष्ट "धारावाहिक"

 import java.io.IOException; import java.io.OutputStream; public class MySerializer implements Serializer<MyClass> { @Override public void toStream(MyClass obj, OutputStream out) throws IOException { throw new UnsupportedOperationException(); } } 

वह व्याख्या जिसके साथ हम एक विशिष्ट वर्ग के लिए "क्रमबद्ध" गोंद करते हैं

 public @interface SerializedBy { Class<? extends Serializer> value(); } 

खैर, MyClass वर्ग ने "इसके धारावाहिक" MySerializer द्वारा क्रमिक रूप से चिह्नित किया

 @SerializedBy(MySerializer.class) public class MyClass {} 

Iteration # 11:
जटिल उदाहरण

 public enum JobTitle { JUNIOR, MIDDLE, SENIOR, LEAD, UNKNOWN } 

 public @interface Author { String value(); JobTitle title() default JobTitle.UNKNOWN; } 

 public @interface Date { int day(); int month(); int year(); } 

 public @interface Version { int version(); Date date(); Author[] authors() default {}; Class<?> previous() default Void.class; } 

और अंत में, एनोटेशन का उपयोग

 import static net.golovach.JobTitle.*; @History({ @Version( version = 1, date = @Date(year = 2001, month = 1, day = 1)), @Version( version = 2, date = @Date(year = 2002, month = 2, day = 2), authors = {@Author(value = "Jim Smith", title = JUNIOR)}, previous = MyClassVer1.class), @Version( version = 3, date = @Date(year = 2003, month = 3, day = 3), authors = { @Author(value = "Jim Smith", title = MIDDLE), @Author(value = "Anna Lea")}, previous = MyClassVer2.class) }) public class MyClassVer3 {} 

प्रतिबंध: विशेषता मान JVM संकलन / लोड समय स्थिरांक हैं

जिस समय कक्षा को JVM में संकलित या लोड किया जाता है, उस समय एनोटेशन विशेषता मानों की गणना करना संभव होना चाहिए।

 public @interface SomeAnnotation { int count(); String name(); } 

उदाहरण

 @SomeAnnotation( count = 1 + 2, name = MyClass.STR + "Hello" ) public class MyClass { public static final String STR = "ABC"; } 

एक और उदाहरण

 @SomeAnnotation( count = (int) Math.PI, name = "" + Math.PI ) public class MyClass {} 

लेकिन विधि कॉल पहले से ही रनटाइम हैं, यह पहले से ही निषिद्ध है

 @SomeAnnotation( count = (int) Math.sin(1), name = "Hello!".toUpperCase() ) public class MyClass {} >> COMPILATION ERROR: Attribute value must be constant 

निष्कर्ष

यह जावा में एक एनोटेशन लेख का पहला भाग है। दूसरे भाग में हम निम्नलिखित विषयों पर विचार करेंगे:

• अन्य एनोटेशन के व्यवहार को संशोधित करने वाली टिप्पणियां: @ लक्ष्य, @ प्रतिधारण, @ प्रलेखित, @ निहित
• संकलक और JVM व्यवहार को संशोधित करने वाली टिप्पणियां: @ पदावनत, @ ओवरराइड, @ SafeVarargs, @ SuppressWarnings
• प्रतिबिंब एपीआई का उपयोग कर एनोटेशन पढ़ना

संपर्क विवरण

मैं जावा प्रशिक्षण ऑनलाइन करता हूं (यहां प्रोग्रामिंग पाठ्यक्रम हैं ) और जावा कोर कोर्स के रीडिजाइन के भाग के रूप में प्रशिक्षण सामग्री का हिस्सा प्रकाशित करता हूं। आप YouTube चैनल पर दर्शकों के व्याख्यान की वीडियो रिकॉर्डिंग देख सकते हैं, शायद इस लेख में चैनल का वीडियो बेहतर व्यवस्थित है।

स्काइप: गोलोवचक्र्स
ईमेल: GolovachCourses@gmail.com