मैं जावा में पदावनत वर्ग की पहचान करने के लिए टिप्पणी जोड़ने का सबसे अच्छा तरीका जानना चाहूंगा। क्या मुझे उस कक्षा के शीर्ष पर जोड़ी गई पिछली टिप्पणी को हटा देना चाहिए जो किसी अन्य प्रोग्रामर को यह जानने में मदद करती है कि वह कक्षा किस लिए थी, या क्या मुझे इसे टिप्पणी के नीचे जोड़ना चाहिए?
जवाबों:
जावा में एक वर्ग, विधि या क्षेत्र को अपदस्थ करने के लिए अनुशंसित दृष्टिकोण @Deprecatedएनोटेशन का उपयोग करना है , जो जावा 5 में उपलब्ध है, या @deprecatedजावाडॉक टैग, जो कि जावा 1.1 के बाद से आसपास है। ओरेकल के पास एपीआई के बारे में एक दस्तावेज है कि कैसे और कब प्रासंगिक एपीआई प्रतीत होता है।
क्या मुझे उस कक्षा के शीर्ष पर जोड़ी गई पिछली टिप्पणी को हटा देना चाहिए जो किसी अन्य प्रोग्रामर को यह जानने में मदद करती है कि वह टिप्पणी के लिए वह वर्ग कौन सा था या उसे नीचे जोड़ें?
आपको JavaDoc टैग या एनोटेशन जोड़ने के अलावा, किसी भी मौजूदा टिप्पणी को संपादित या हटाना नहीं चाहिए। पदावनत कोड अभी भी विरासत प्रणालियों में उपयोग में हो सकता है, और उन प्रणालियों के डेवलपर्स को प्रलेखन तक पहुंच की आवश्यकता होती है जो मूल डेवलपर्स ने किसी रूप में किया था।
@Deprecatedएनोटेशन या @deprecatedJavaDoc टैग। वह यह है - और कुछ नहीं, और कुछ नहीं।
@deprecatedJavaDoc टैग और विवरण को @Deprecatedएनोटेशन के साथ जोड़ने से यह अधिक प्रकाश में आ जाएगा कि इसे क्यों हटाया गया था। इसलिए केवल @Deprecatedएनोटेशन के बजाय दोनों का उपयोग करना अधिक फायदेमंद होगा ।