مرجع مفاهیم پایه Java برای تعریف کلاس، کنترل جریان، مجموعه‌ها و مدیریت خطا. ساختار برنامه را حول متدهای کوچک و مسئولیت روشن بچینید. ورودی را بررسی کنید و خطا را در همان لایه‌ای مدیریت کنید که امکان بازیابی از آن را دارد. نوع collection را بر اساس نیاز به ترتیب، یکتایی یا lookup انتخاب کنید. Streamها را برای تبدیل declarative به‌کار ببرید و عملیات جانبی را در زنجیره محدود کنید. از این صفحه به‌عنوان مرجع سریع استفاده کنید و مثال‌ها و نکته‌ها را با نسخهٔ ابزار، نیاز و شرایط واقعی پروژهٔ خود تطبیق دهید.
پیش‌شرط نامعتبر را زود رد کنید و مسیر اصلی را خوانا نگه دارید.
static int divide(int numerator, int denominator) { if (denominator == 0) { throw new IllegalArgumentException("denominator must not be zero"); } return numerator / denominator;}برای تبدیل یک مقدار به نتیجه از switch expression و شاخه‌های exhaustive استفاده کنید.
static String label(int status) { return switch (status) { case 200 -> "OK"; case 404 -> "Not found"; case 500 -> "Server error"; default -> "Unknown"; };}try-with-resources منبع را حتی هنگام خطا می‌بندد.
try (var reader = Files.newBufferedReader(path)) { String firstLine = reader.readLine(); System.out.println(firstLine);} catch (IOException error) { System.err.println("Could not read file: " + error.getMessage());}Stream pipeline داده را بدون تغییر مجموعهٔ ورودی پردازش می‌کند.
List<String> activeNames = users.stream() .filter(User::isActive) .map(User::name) .sorted() .toList();Collectors.groupingBy برای ساخت نقشه‌ای از گروه‌های مرتبط مناسب است.
Map<String, List<User>> byDepartment = users.stream() .collect(Collectors.groupingBy(User::department));Optional را در خروجی احتمالی متد استفاده و مقدار پیش‌فرض را نزدیک مصرف تعیین کنید.
String displayName = findUser(userId) .map(User::name) .filter(name -> !name.isBlank()) .orElse("Guest");record برای مقادیر سادهٔ داده‌ای boilerplate را کم می‌کند.
record Coordinate(double latitude, double longitude) { Coordinate { if (latitude < -90 || latitude > 90) { throw new IllegalArgumentException("invalid latitude"); } }}کد مصرف‌کننده را به قرارداد متصل کنید تا پیاده‌سازی قابل‌تعویض بماند.
interface PricePolicy { BigDecimal apply(BigDecimal basePrice);}final class DiscountPolicy implements PricePolicy { public BigDecimal apply(BigDecimal basePrice) { return basePrice.multiply(new BigDecimal("0.90")); }}CompletableFuture نتیجه را زنجیره می‌کند؛ exceptional path را نیز مشخص کنید.
CompletableFuture<String> result = CompletableFuture.supplyAsync(() -> loadName(userId)) .thenApply(String::trim) .exceptionally(error -> "Unavailable");ورودی برنامه معمولاً از public static void main(String[] args) آغاز می‌شود.
نوع متغیر را صریح مشخص کنید؛ برای مقدار ثابت از final استفاده کنید.
شرط و تکرار با if، switch، for و while.
کلاس، فیلد و متد را با سطح دسترسی متناسب تعریف کنید.
برای رشته‌ها از String و برای مقایسه محتوا از equals استفاده کنید.
از List، Set و Map بر اساس نیاز به ترتیب، یکتایی و کلید انتخاب کنید.
مدیریت خطا با exceptionهای مشخص و try-with-resources برای منابع.
Genericها را برای حفظ نوع عناصر collection به‌کار ببرید.
وابستگی‌ها و نسخه JDK پروژه را مشخص و یکسان نگه دارید.
ورودی بیرونی را اعتبارسنجی کنید و برای رفتارهای اصلی تست بنویسید.
منابع AutoCloseable را با try-with-resources ببندید تا حتی هنگام exception آزادسازی انجام شود.
برای collection، equals و hashCode سازگار پیاده کنید و mutable key را در map تغییر ندهید.