الرئيسية / Language / مُنشئ قانوني مضغوط
Language متوسط

مُنشئ قانوني مضغوط

تحقق من حقول Record ونظّمها دون تكرار قوائم المعاملات.

مقارنة الكود
✕ Java 16 
public record Person(String name,
                     List<String> pets) {
    // Full canonical constructor
    public Person(String name,
                  List<String> pets) {
        Objects.requireNonNull(name);
        this.name = name;
        this.pets = List.copyOf(pets);
    }
}
✓ Java 16+ 
public record Person(String name,
                     List<String> pets) {
    // Compact constructor
    public Person {
        Objects.requireNonNull(name);
        pets = List.copyOf(pets);
    }
}
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
✂️

تكرار أقل

لا حاجة لتكرار قائمة المعاملات أو إسناد كل حقل يدوياً.

🛡️

تحقق

مثالي للتحقق من null وتحقق النطاق والنسخ الدفاعية.

📖

نية أوضح

البنية المضغوطة تُبرز التحقق لا الكليشيه.

الأسلوب القديم
تحقق صريح في المُنشئ
الأسلوب الحديث
مُنشئ مضغوط
منذ JDK
16
الصعوبة
متوسط
دعم JDK
مُنشئ قانوني مضغوط
متاح

متاح على نطاق واسع منذ JDK 16 (مارس 2021)

كيف يعمل

يمكن لـ Records تصريح مُنشئ قانوني مضغوط يُهمل قائمة المعاملات وإسناد الحقول. يُسنِد المترجم المعاملات تلقائياً للحقول بعد تشغيل منطق التحقق. هذا مثالي لفحوصات الشروط المسبقة والنسخ الدفاعية والتطبيع.

توثيق ذو صلة
Record (Java 21) ↗ JEP 395: Records ↗
أنماط ذات صلة
Language مبتدئ

Records for data classes

Java 8
public class Point {
    private final int x, y;
    public Point(int x, int y) { ... }
    public int getX() { return x; }
    public int getY() { return y; }
    // equals, hashCode, toString
}
Java 16+
public record Point(int x, int y) {}
مرر للرؤية الحديث ←
JDK 16+ →
Language متوسط

Flexible constructor bodies

Java 8
class Square extends Shape {
    Square(double side) {
        super(side, side);
        // can't validate BEFORE super!
        if (side <= 0)
            throw new IAE("bad");
    }
}
Java 25+
class Square extends Shape {
    Square(double side) {
        if (side <= 0)
            throw new IAE("bad");
        super(side, side);
    }
}
مرر للرؤية الحديث ←
JDK 25+ →
Errors متوسط

Record-based error responses

Java 8
// Verbose error class
public class ErrorResponse {
    private final int code;
    private final String message;
    // constructor, getters, equals,
    // hashCode, toString...
}
Java 16+
public record ApiError(
    int code,
    String message,
    Instant timestamp
) {
    public ApiError(int code, String msg) {
        this(code, msg, Instant.now());
    }
}
مرر للرؤية الحديث ←
JDK 16+ →
مشاركة 𝕏 🦋 in ⬡