Records.txt

****** Records ******

Начиная с версии Java 16 в язык была добавлена новая функциональность - Records
(на русском нередко называют "записями"). Records представляют классы, которые
предназначены для создания контейнеров неизменяемых данных. Кроме того, records
позволяют упростить разработку, сократив объем кода.

Для определения классов record применяется ключевое слово record, после которого
идет название и далее в круглых скобках список полей record:

********************************************************************************
record название (поле1, поле2,...полеN){
    // тело record
}
********************************************************************************
Date.valueOf(ticket.departureDate().toLocalDate())
Для начала рассмотрим следующий пример:

********************************************************************************
import java.util.Objects;

public class Program{

    public static void main (String args[]){

        Person tom = new Person("Tom", 36);
        System.out.println(tom.toString());
    }
}

class Person {
    private final String name;
    private final int age;

    Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    String name() { return name; }
    int age() { return age; }

    public boolean equals(Object o) {
        if (!(o instanceof Person)) return false;
        Person other = (Person) o;
        return other.name == name && other.age == age;
    }

    public int hashCode() {
        return Objects.hash(name, age);
    }

    public String toString() {
        return String.format("Person[name=%s, age=%d]", name, age);
    }
}
********************************************************************************

Здесь определен класс Person, который определяет две константы - name и age:

********************************************************************************
private final String name;
private final int age;
********************************************************************************

Их значения устанавливаются в конструкторе. Больше никак их установить мы не
можем. Таким образом, после создания объекта Person они будут хранить
неизменяемые данные.

Для получения значений name и age предусмотрены одноименные методы без
префикса *.get... :

********************************************************************************
String name() { return name; }
int age() { return age; }
********************************************************************************

Кроме того, здесь переопределены унаследованные от класса Object методы
equals(), hashCode() и toString().

В методе main создаем один объект класса Person и выводит на консоль его
текстовое представление:

********************************************************************************
Person tom = new Person("Tom", 36);
 System.out.println(tom.toString());
********************************************************************************

В итоге на экране мы увидим: Person[name=Tom, age=36]

Теперь посмотрим, что нам предлагают Records - определим record, которая будет
полностью аналогична вышеопределенному классу:

********************************************************************************
public class Program{

    public static void main (String args[]){

        Person tom = new Person("Tom", 36);
        System.out.println(tom.toString());
    }
}

record Person(String name, int age) { }

********************************************************************************

Records определяются с помощью ключевого слова record, за которым следует название
записи. Дальше идет список полей записи. То есть в данном случае определяется два
поля - name и age. Причем по умолчанию все они будут приватными и иметь
модификатор final.

Также будет создаваться конструктор с двумя параметрами name и age. У каждого поля
автоматически будет создаваться одноименный общедоступный метод для получения
значения это поля. Например, для поля name создается метод name(), который
возвращает значение поля name.

И также автоматически будут создаваться методы equals, hashCode и toString. В общем,
данная record будет полностью аналогична вышеопределенному классу, но при этом
содержит гораздо меньше кода.

При необходимости мы можем вызывать все имеющиеся методы:

********************************************************************************
public class Program{

    public static void main (String args[]){

        Person tom = new Person("Tom",  36);

        System.out.println(tom.name());     // Tom
        System.out.println(tom.age());      // 36
        System.out.println(tom.hashCode());

        Person bob = new Person("Bob", 21);
        Person tomas = new Person("Tom", 36);
        System.out.println(tom.equals(bob));    // false
        System.out.println(tom.equals(tomas));  // true
    }
}

record Person(String name, int age){ }

********************************************************************************

****** Конструктор record и его переопределение ******

В примере, выше, применялась форма record:

********************************************************************************
record Person(String name, int age) { }
********************************************************************************

Которая фактически создавала конструктор:

********************************************************************************
Person(String name, int age) {
    this.name = name;
    this.age = age;
}
********************************************************************************

Этот конструктор называется каноническим. Он принимает параметры, которые
называются также, как и поля record, и передает полям значения соответствующих
параметров.

Тем не менее при необходимости мы можем изменить логику конструктора. Например,
что если при создании объекта будет передан невалидный возраст? Предусмотрим
эту ситуацию, переопределив логику конструктора:

********************************************************************************
public class Program{

    public static void main (String args[]){

        Person tom = new Person("Tom", -116);
        System.out.println(tom.toString());
    }
}

record Person(String name, int age) {

    Person{

        if(age<1 || age > 110){
            age = 18;
        }
    }
}
********************************************************************************

В данном случае если передано невалидное значение, то применяем некоторое значение
по умолчанию (число 18). В итоге фактически мы получим конструктор со следующим
действием:

********************************************************************************
Person(String name, int age) {
    if(age<1 || age > 110){
        age = 18;
    }
    this.name = name;
    this.age = age;
}
********************************************************************************

В итоге программа выведет на экран следующее: Person[name=Tom, age=18]

Мы можем полностью переопределить канонический конструктор:

********************************************************************************
public class Program{

    public static void main (String args[]){

        Person tom = new Person("Tom",  36);
        System.out.println(tom.toString());
        System.out.println(tom.name());
    }
}

record Person(String name, int age) {

    Person(String name, int age){

        if(age < 0 || age > 120) age = 18;

        this.name = name;
        this.age = age;
    }
}
********************************************************************************

Также мы можем определять какие-то другие конструкторы, но все они должны вызывать
канонический конструктор:

********************************************************************************
public class Program{

    public static void main (String args[]){

        Person tom = new Person("Tom", "Smith",  36);
        System.out.println(tom.toString());
    }
}

record Person(String name, int age) {

    Person(String firstName, String lastName, int age){

        this(firstName + " " + lastName, age);

    }
}
********************************************************************************

Здесь определен конструктор, который условно принимает имя, фамилию и возраст
пользователя. Этот конструктор вызывает канонический конструктор, передавая ему
значения для полей name и age: this(firstName + " " + lastName, age).

Вывод программы на экран будет: Person[name=Tom Smith, age=36]

****** Переопределение методов ******

Также мы можем переопределить методы, которые имеет record по умолчанию. А это
методы equals(), hashCode() и toString() и методы которые называются также, как
и поля записи, и которые возвращают значения соответствующих полей.

Например, переопределим для записи Person методы toString() и name():

********************************************************************************
public class Program{

    public static void main (String args[]){

        Person tom = new Person("Tom", 36);
        System.out.println(tom.toString());
        System.out.println(tom.name());
    }
}

record Person(String name, int age) {

    public String name() { return "Mister " + name; }

    public String toString() {
        return String.format("Person %s, Age: %d", name, age);
    }
}
********************************************************************************

Вывод программы на экран:

********************************************************************************
Person Tom, Age: 36
Mister Tom
********************************************************************************

****** Ограничения records ******

Следует учитывать, что мы не можем наследовать запись record от других классов.
Также нельзя наследовать классы от records. Однако классы record могут реализовать
интерфейсы. Кроме того, классы record не могут быть абстрактными.

В record нельзя явным образом определять нестатические поля и инициализаторы. Но
можно определять статические переменные и инициализаторы, также как статические и
нестатические методы:

********************************************************************************
record Person(String name, int age){

    static int minAge;
    static{
        minAge = 18;
        System.out.println("Static initializer");
    }
}
********************************************************************************