CKTIS / Java
Record класове и агрегатни стойности в Java
Record класове и агрегатни стойности в Java: Record в Java 21 е номинален, плитко неизменяем агрегатен клас: списъкът с компоненти определя private final полета, публични методи за достъп, каноничен конструктор, equals, hashCode и toString.
Версия: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Синтаксис
records aggregatesRecord в Java 21 е номинален, плитко неизменяем агрегатен клас: списъкът с компоненти определя private final полета, публични методи за достъп, каноничен конструктор, equals, hashCode и toString.
Използвай record за стойности, съобщения и ключове, чието състояние е фиксиран набор компоненти; валидирай и нормализирай в каноничния или компактния конструктор.
Референцията на компонент е final, но обектът може да остане изменяем; компонент масив използва identity-based equals на масива, а не Arrays.equals.
Record е неявно final и наследява директно java.lang.Record; полетата на компактния конструктор се присвояват след тялото и не може да се присвояват явно в него, а вложен record е неявно static.
Record извежда Point[x=2, y=3], equal=true и sum=5; защитните копия запазват snapshot=[1, 2], а equals на масив дава same-contents-equal=false.
Примери
import java.util.Arrays;
public class Main {
record Point(int x, int y) {
Point {
if (x < 0 || y < 0) throw new IllegalArgumentException("negative");
}
int sum() { return x + y; }
}
record Snapshot(String name, int[] values) {
Snapshot { values = values.clone(); }
@Override public int[] values() { return values.clone(); }
}
public static void main(String[] args) {
var point = new Point(2, 3);
System.out.println(point);
System.out.println("equal=" + point.equals(new Point(2, 3)));
System.out.println("sum=" + point.sum());
int[] source = {1, 2};
var snapshot = new Snapshot("v1", source);
source[0] = 9;
snapshot.values()[1] = 8;
System.out.println("snapshot=" + Arrays.toString(snapshot.values()));
System.out.println("same-contents-equal=" + snapshot.equals(new Snapshot("v1", new int[]{1, 2})));
}
}
Резултат
Point[x=2, y=3] equal=true sum=5 snapshot=[1, 2] same-contents-equal=false
Record извежда Point[x=2, y=3], equal=true и sum=5; защитните копия запазват snapshot=[1, 2], а equals на масив дава same-contents-equal=false.