visual-studio-code

راه‌اندازی (Setup)

یک IDE (محیط توسعه یکپارچه) به شما امکان می‌دهد برنامه‌ها را به‌سرعت با فراهم کردن ابزارهای متعدد برای توسعه کد، تست، دیباگ و غیره بسازید. با توجه به محبوبیت روزافزون Visual Studio Code به‌عنوان یک IDE همه‌کاره، می‌توانید به‌راحتی اولین پروژه جاوا را با نصب Oracle Java Platform Extension توسعه دهید.

افزونه Oracle Java Platform در Visual Studio Code Marketplace موجود است. از طریق منوی Code > Settings > Extensions نصب کنید.

از Command Palette برای ایجاد پروژه جدید استفاده کنید: View > Command Palette > Java: New Project و گزینه Java with Maven را انتخاب کنید. نام پروژه و Package را وارد کنید. افزونه یک pom.xml پایه و ساختار دایرکتوری Maven ایجاد می‌کند.

نکته: افزونه حداقل به JDK 11 نیاز دارد.

افزونه در مکان‌های زیر به دنبال JDK می‌گردد:

• jdk.jdkhome
• java.home
• متغیر محیطی JDK_HOME
• متغیر محیطی JAVA_HOME
• مسیر سیستم فعلی

---

اکسپلورر پروژه (Project Explorer)

علاوه بر اکسپلورر VS Code، افزونه Oracle Java Platform اکسپلورر Project Explorer را ارائه می‌دهد که نمای کلی از ساختار پروژه و ناوبری ساختار Package جاوا دارد. با آن می‌توانید پروژه‌های Maven/Gradle خود را پاکسازی، کامپایل، تست، دیباگ و اجرا کنید.

---

دیباگر و پیکربندی اجرا

افزونه Oracle Java Platform از اجرای و دیباگ برنامه‌های جاوا با JDK11 یا جدیدتر پشتیبانی می‌کند. از Run main | Debug main یا پنل Run and Debug فراخوانی کنید.

هر دو پیکربندی از اعمال زیر پشتیبانی می‌کنند: Pause، Step over، Step into، Step out، Restart، Stop/Disconnect.

در Run and Debug می‌توانید پیکربندی‌ها را سفارشی کنید، به فرآیندهای موجود متصل شوید یا پورت اتصال به JVM با JDWP را وارد کنید. در ویندوز Attach to Shared Memory هم موجود است.

از پنل Run Configuration برای تغییر آرگومان‌های برنامه، گزینه‌های VM، متغیرهای محیطی یا دایرکتوری کاری استفاده کنید.

---

بازآفرینی کد (Code Refactoring)

نگهداری برنامه جاوا شامل بهبود کد داخلی با تغییرات کوچک بدون تغییر عملکرد است. مثلاً با JDK 21 یا جدیدتر، .get(0) را با Change all occurrences به متد getFirst() از SequencedCollection تغییر دهید. مشابه آن، get(list1.size() - 1) را به getLast() تبدیل کنید.

برای تسریع توسعه، می‌توانید متدها را از منوی Source Action context ایجاد کنید. این منو سازماندهی import‌ها را هم پشتیبانی می‌کند. تنظیمات jdk در Extensions > Java:

• Count For Using Star Import — تعداد کلاس‌ها برای star-import (پیش‌فرض: ۹۹۹)
• Count For Using Static Star Import — تعداد اعضا برای static star-import (پیش‌فرض: ۹۹۹)
• Groups — گروه‌های دستورات import و ترتیب مرتب‌سازی

سازماندهی import‌ها هنگام ذخیره: Preferences:Open User Settings > Extensions > Java > On Save: Organize Imports

پیشنهادات بازآفرینی بیشتر از طریق Show code lightbulb و منوی Refactor:

• بازآفرینی آرگومان‌های Constructor و Method
• ایجاد hashCode/equals و toString()
• اختصاص عبارت به متغیر محلی
• استخراج عبارت به متغیر محلی
• جداسازی تعریف و اختصاص
• بالا/پایین بردن عضو کلاس
• حذف متغیر اضافی
• انتقال کلاس به Package دیگر
• استخراج Interface/Method
• تبدیل import ثابت/متد به static import
• بازآفرینی بلوک‌های for/try-catch/switch()/while()

---

کد تست

از Show code lightbulb و Source Actions... > Generate Tests... یک تست ایجاد کنید. نام کلاس و متدهای مورد تست را تأیید کنید. کلاس تست تولیدشده متدهای خالی یا ناموفق دارد. با @Disabled برخی متدها را رد کنید.

افزونه نمای Test Explorer را ارائه می‌دهد: اجرای تمام تست‌ها، بررسی نتایج، مراجعه به کد منبع و اجرای تست خاص.

---

مستندسازی کد

/** را بالای امضای متد تایپ کنید و IDE پیشنهاد تکمیل JavaDoc را می‌دهد. این عمل نظر JavaDoc با تمام آرگومان‌های آماده ایجاد می‌کند.

---

توسعه پروژه

اگر پروژه‌ای با نسخه‌های مختلف جاوا دارید، برای هر Runtime یک Profile اختصاص دهید. پس از ایجاد Profile، settings.json آن را سفارشی کرده و jdk.jdkhome را تعریف کنید.

افزونه Oracle Java Platform یک پروژه متن‌باز است. راهنمای مشارکت را ببینید.