نگاهی به کامنت گذاری در زبان برنامه نویسی جاوا


پیش از این هم  توضیحاتی درباره ی کامنت ها در برنامه نویسی به خصوص زبان برنامه نویسی جاوا دادیم. در واقع، اضافه کردن کامنت به سورس کد خود در حین برنامه نویسی، می تواند به طرز چشمگیری روند کدنویسی ما را اثربخش سازد. در حقیقت برنامه نویسان با این کار، راه را برای ویرایش سورس کد خود در آینده آسان تر می کنند. همان طور که قبلاً هم اشاره شد، در زبان برنامه نویسی جاوا سه مدل کامنت وجود دارد که عملکرد هر کدام از آن ها را مورد بررسی قرار خواهیم داد:

class FirstProgram {
    /*
    * This is a multi-line comment for you!
    */
    public static void main(String[] args) {
        String text = "In the name of God";
        System.out.println(text);
    }
}

نوع اول از کامنت ها چند خطی می باشند. به عبارت دیگر، چنانچه ما بخواهیم چند خط از کد خود را از دید کامپایلر پنهان سازیم، در خط اول علامت */ و در خط آخر علامت /* را قرار می دهیم و هر آنچه که مابین آن ها قرار گیرد جزو کامنت حساب خواهند شد (توجه داشته باشیم که قرار دادن علامت ستاره برای خطوط میانی دلخواه است و همان طور که در کد فوق مشاهده می کنید، به صورت پیش فرض نرم افزار اکلیپس برای خطوط میانی * را قرار می دهد.)

هشدار
نکته ای که در مورد این نوع از کامنت ها می بایست به خاطر داشته باشیم این است که ما نمی توانیم یک کامنت چند خطی را درون یک کامنت چند خطی دیگر قرار دهیم چرا که با این کار، در حین اجرای برنامه با مشکل مواجه خواهیم شد.

نوع دوم از کامنت ها به کامنت های پایان خط معروف هستند. در واقع چنانچه در انتهای خطی که کدی را در آن نوشته ایم بخواهیم جهت یادآوری خود چیزی بنویسیم، از این نوع کامنت با قرار دادن علامت های // استفاده خواهیم کرد. مثالی از این کامنت را در کد زیر مشاهده خواهید کرد:

class FirstProgram {
    public static void main(String[] args) {  //This is a method
        String text = "In the name of God";
        System.out.println(text);
    }
}

آنچه در مورد این نوع از کامنت ها بسیار جالب توجه است این است که چنانچه بخشی از برنامه شما دچار مشکل باشد و شما به اصطلاح بخواهید برنامه را Debug کنید، می توانید از این کامنت استفاده کنید به این صورت که نشانگر موس خود را روی بخشی از کد که تصور می کنید مشکل زا است قرار داده، سپس دکمه Ctrl و علامت / فشار دهید. خواهید دید که آن بخش از کد شما کامنت شده و به رنگ متفاوتی در خواهد آمد. حال می توانید برنامه را مجدد کامپایل کنید و ببینید که آیا مشکل رفع شده است یا خیر. چنانچه مشکل رفع شده بود متوجه خواهید شد که آن بخشی از کد که کامنت شده است دارای مشکل است پس نیاز است که آن را رفع نمایید. چنانچه رفع نشده بود مجدداً با انتخاب آن بخش از کد دکمه Ctrl و علامت / را فشار دهید تا از حالت کامنت درآید و این کار را می توانید برای مابقی بخش های سورس کد خود تا زمانی انجام دهید که مشکل برنامه خود را پیدا نمایید (اگر چه این نوع کامنت ها تحت عنوان کامنت های پایان خط معروف هستند، اما ما می توانیم آن ها را در ابتدای یک خط از کد نیز مورد استفاده قرار دهیم.)

نوع سوم از کامنت ها از نوع javadoc می باشند به این معنی که با قرار دادن علامت **/ در ابتدای خطی که تمایل داریم به کامنت تبدیل شود و قرار دادن علامت /* در انتهای خطی که کامنت ما به پایان می رسد، ما توضیحاتی را داخل سورس کد خود درج می کنیم که برای کسانی که می خواهند کد ما را در آینده مطالعه کنند ولی دانش زبان جاوا ندارند بسیار مفید خواهد بود به این صورت که از کلیه کامنت های برنامه خود که از نوع javadoc هستند خروجی HTML می گیریم و کلیه کامنت ها به صورت یک صفحه وب در اختیار علاقمندان قرار می گیرند (نحوه ایجاد javadoc برای برنامه نویسان مبتدی ضروری نیست بنابراین از توضیح در این باره خودداری می شود!)

class FirstProgram {
    /**
    * This is a javadoc comment for you!
    */
    public static void main(String[] args) {
        String text = "In the name of God";
        System.out.println(text);
    }
}

در آموزش بعدی با انواع متغیرها در زبان برنامه نویسی جاوا و نحوه اختصاص مقدار به آن ها و سایر مباحث مربوطه آشنا خواهیم شد.

لیست نظرات
کاربر میهمان
دیدگاه شما چیست؟
کاربر میهمان
matin sadr
matin sadr
ممنون خیلی خوب بود
amin
amin
خیلی ساده و روان توضیح دادید.
ممنون.
fighter
fighter
بسیار عالی
کاربر میهمان
کاربر میهمان
Awliye
mj.alijani
mj.alijani
سلام ، نمیدونم چرا سر ی چیز به این ساده ای مشکل دارم من ctrl و / فشار میدم اما کامنت نمیسازه !!!
عبدالحمید ارجمند
عبدالحمید ارجمندAndroid Developer - Java - عاشق گجتهای اپل و مایکــ
مشکل شما به یکی از شکلها حل میشه : 1- اینکه زبون دستگاهتون فعلا فارسی کردید و دارید این دستور رو اجرا میکنید ( برای رفعش : نیاز هست تا زبون رو به انگلیسی تغییر بدید ) 2- تایپ کردن اسلش را با بک اسلش اشتباه گرفته اید

در پاسخ به

ccc ccc
ccc ccc
سلام. اگر از اکلیپس استفاده می‌کنید این جور مشکلات طبیعه. گاهی اوقات پیش میاد. نمی‌دونم علت چیه!؟

در پاسخ به

حمیدرضا
حمیدرضا
سایت بسیار خوبی هست و مطالب خیلی خوب توضیح داده شده. خیلی خوشحالم که با شما آشنا شدم
hamid_r_9750
hamid_r_9750
بسیار عالی
javad
javad
روز خوش.بسیار عالی مثل همیشه
کاربر میهمان
کاربر میهمان
نه من منظورم کامنت آخر خط بود ، البته میشه خیلی راحت تایپش کرد ، ولی میخواستم بدونم چطوری میشه از HotKey استفاده کرد برای ایجاد کامنت آخر خط ُ من وقتی /+ctrl که میزنم علامت // ابتدای خط درج میشه و کل خط کامنت در نظر گرفته میشه
کاربر میهمان
کاربر میهمان
سلام ، بابت توضیحات ممنون و از اون مهمتر پاسخگویی سریعتون به نظرات و سوالات واقعا ستودنیه
من با مک کار میکنم ُ برای ایجاد کامنت آخر خط با مشکل مواجه شدم ، هر جا که اشاره گر رو ببرم و /+ctrl بزنم ، // اول خط درج میشه
ccc ccc
ccc ccc
سلام. خب اگه بخواین جاواداک تولید کنید باید Shift و هم نگه دارید.

در پاسخ به

Amin
Amin
آقا حل شد ، سوتی دادم :دی

در پاسخ به

کاربر میهمان
کاربر میهمان
نمیدونم چرا تایپ نمیشه تو صفحه شما علامت پرانتز نوک تیز منظورمه
کاربر میهمان
کاربر میهمان
سلام .بابت توضیحات خوبتون ممنون.ببخشید توی کامنتها از عبارتهایی داخل استفاده میشه مثلا .معنیش چیه؟ بازم ممنون
کاربر میهمان
کاربر میهمان
متشکرم
Federiko Askarzadeh
Federiko Askarzadeh
آقا واقعا دست شما درد نکنه . مطالبتون فوق العاده خوب و روون هستش. حتما تبلیغ سایتتون رو هرجا که بتونم میکنم. :*:*:*
ادمین سایت
ادمین سایت
نظر لطف شماست

در پاسخ به

کاربر میهمان
کاربر میهمان
عالی هستین!
من کلاس جاوا میرم هیچی نمیفهمم هنگ هنگ سر کلاس درو دیوار نگاه میکنم
اینجا رو که میخونم همهچیزو کامل میفهمم و یاد میگیرم
قلمتون پایدار
ادمین سایت
ادمین سایت
پیروز باشید

در پاسخ به

ccc ccc
ccc ccc
موفق باشید.

در پاسخ به

alireza bod
alireza bod
سلام جا داره یه خسته نباشید به تیم آکادمی بگم,واقعا کارتون عالی و بی نظیره.اینکه مطالبی با این سطح بالا رو رایگان منتشر میکنید چیزیه که شما رو متفاوت از بقیه میکنه
.بازم ممنون و امیدوارم این روند عالی در اینده ادامه داشته باشه
ادمین سایت
ادمین سایت
نظر لطف شماست

در پاسخ به

AliJCVD
AliJCVD
سلام
لطفا اگه مقدور هست نحوه ایجاد javadoc و خروجی html گرفتن ازش رو تو همین اموزش به صورت reply برای بنده توضیح بدین
ممنون میشم
ادمین سایت
ادمین سایت
سلام. لینک آموزش این کار به پیوست تقدیم می گردد:
http://www.codejava.net/ides/eclipse/how-to-generate-javadoc-in-eclipse

در پاسخ به

AliJCVD
AliJCVD
اقا دم شما گرم...ممنون بابت سایتی که معرفی کردین

در پاسخ به

ادمین سایت
ادمین سایت
سلامت باشید

در پاسخ به

نامشخص
نامشخص
سلام سایت چرا یهویی تغییر کرده نمیشه تو بخش اصلی آموزش ها نظر نوشت؟؟؟و اینکه من یه سوال در مقاله "مصاحبه با جادی " پرسیدم اما کسی جواب نداد میخواستم بدونم همون جا جواب میدین یا اینجا بپرسم؟؟
ادمین سایت
ادمین سایت
سلام
جهت آپدیت نگه داشتن آموزش ها، کلیه ی آموزش ها ی سایت به مرور از حالت پی دی اف خارج گشته و به صورت اچ تی ام ال در خواهند آمد. لذا کامنت گذاری فقط برای هر آموزش امکان پذیر خواهد بود. در مورد مصاحبه با جادی هم مجدد سوال خود را بفرمایید

با تشکر
ارادتمند
تیم سکان آکادمی

در پاسخ به

ccc ccc
ccc ccc
سلام
با نگه داشتن دکمه های ترکیبی: CTRL + SHIFT + / کامنت از نوع جاوا داک تولید میشه. البته فقط اون قسمتی که درگ شده تبدیل به کامنت میشه.