আমি জানি যে এটি ইস্যুগুলির পক্ষে সবচেয়ে গুরুত্বপূর্ণ নয়, তবে আমি কেবল বুঝতে পেরেছি যে টীকাটি দেওয়ার আগে বা পরে জাভাদোক মন্তব্য ব্লকটি রাখতে পারি। কোডিং স্ট্যান্ডার্ড হিসাবে আমরা কী গ্রহণ করতে চাই?
/**
* This is a javadoc comment before the annotation
*/
@Component
public class MyClass {
@Autowired
/**
* This is a javadoc comment after the annotation
*/
private MyOtherClass other;
}উত্তর:
টীকা দেওয়ার আগে, যেহেতু টীকাটি কোডটি যা শ্রেণীর সাথে "সম্পর্কিত" " সরকারী ডকুমেন্টেশনে জাভাদোক সহ উদাহরণগুলি দেখুন ।
এখানে অন্য একটি সরকারী জাভা পৃষ্ঠায় আমি এলোমেলো উদাহরণ পেয়েছি :
/**
* Delete multiple items from the list.
*
* @deprecated Not for public use.
* This method is expected to be retained only as a package
* private method. Replaced by
* {@link #remove(int)} and {@link #removeAll()}
*/
@Deprecated public synchronized void delItems(int start, int end) {
...
}উপরের সবকিছু সাথে আমি একমত। অন্যের পক্ষে এটি সহায়ক হতে পারে যে ইন্টেলিজ (আইডিয়া) এর কোড শৈলী টেমপ্লেটগুলি উভয়ই মিথ্যা পজিটিভ ব্যর্থ হয় (যখন @ থ্রোজগুলি সঠিকভাবে নির্দিষ্ট করা হয়, এটি সতর্ক করে দেয়) এবং মিথ্যা নেতিবাচক (যখন @ থ্রোস নির্দিষ্ট না করা থাকে তবে হওয়া উচিত) রিস্টএসি স্টাইল ব্যবহার করার সময় টীকা। আমি আমার জাভাদোকগুলি অন্য কিছুর উপরে রাখি, তারপরে এনোটেশন, তারপরে কোড।
বাগ প্রতিবেদনটি এখানে দেখুন: https://youtrack.jetbrains.com/issue/IDEA-220520