Java Academy · Lekcja

Wprowadzenie do rekordów

Deklaruj rekordy jako zwięzłe, niezmienne kontenery danych i poznaj automatycznie generowane przez nie składowe.

Wprowadzenie do rekordów to bezpłatna lekcja Java Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Java Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Java Academy zawiera 4 lekcji w sumie.

Wprowadzenie do rekordów

Rekordy Java (Java 16+) to zwięzły sposób deklarowania niezmiennych klas będących nośnikami danych. Automatycznie generują kod pomocniczy: konstruktor, metody dostępowe, equals, hashCode i toString.

Deklarowanie rekordu

Użyj słowa kluczowego record, a następnie nazwy rekordu i listy komponentów. Każdy komponent staje się prywatnym polem final oraz publiczną metodą dostępową.

record Point(double x, double y) {}

Point p = new Point(3.0, 4.0);
System.out.println(p.x());      // 3.0 (accessor, not getX())
System.out.println(p.y());      // 4.0
System.out.println(p);          // Point[x=3.0, y=4.0]
System.out.println(p.equals(new Point(3.0, 4.0))); // true

Automatycznie generowane składowe

Kompilator automatycznie generuje dla każdego rekordu: konstruktor kanoniczny, publiczne metody dostępowe, equals(), hashCode() i toString(). Nie trzeba pisać ich ręcznie.

record Product(String name, double price, int stock) {}

Product p1 = new Product("Widget", 9.99, 100);
Product p2 = new Product("Widget", 9.99, 100);

System.out.println(p1.name());          // Widget
System.out.println(p1.price());         // 9.99
System.out.println(p1.equals(p2));      // true (structural)
System.out.println(p1.hashCode() == p2.hashCode()); // true
System.out.println(p1);                 // Product[name=Widget, price=9.99, stock=100]

Rekordy są niezmienne

Komponenty rekordu są oznaczone jako final. Po utworzeniu rekordu nie można ich modyfikować — rekordy modelują niezmienne obiekty wartości.

record Money(long cents, String currency) {}

Money price = new Money(999, "USD");
// price.cents = 500; // Compile error — final field!

// To "update" a record, create a new one
Money discounted = new Money(price.cents() - 100, price.currency());
System.out.println(discounted); // Money[cents=899, currency=USD]

Rekordy rozszerzają tylko Object

Rekordy niejawnie rozszerzają java.lang.Record i nie mogą rozszerzać innych klas. Mogą implementować interfejsy.

interface Describable { String describe(); }

record Circle(double radius) implements Describable {
    public String describe() {
        return String.format("Circle with radius %.1f", radius);
    }

    public double area() {
        return Math.PI * radius * radius;
    }
}

Circle c = new Circle(5.0);
System.out.println(c.describe()); // Circle with radius 5.0
System.out.printf("Area: %.2f%n", c.area()); // Area: 78.54

Rekordy w kolekcjach

Ponieważ rekordy prawidłowo implementują equals i hashCode na podstawie wszystkich komponentów, mogą być poprawnie używane jako klucze Map i elementy Set.

import java.util.*;

record Coordinate(int row, int col) {}

Map<Coordinate, String> grid = new HashMap<>();
grid.put(new Coordinate(0, 0), "Origin");
grid.put(new Coordinate(1, 2), "Target");

// Lookup with equal-valued record works correctly
System.out.println(grid.get(new Coordinate(0, 0))); // Origin
System.out.println(grid.get(new Coordinate(1, 2))); // Target

Set<Coordinate> visited = new HashSet<>();
visited.add(new Coordinate(3, 3));
System.out.println(visited.contains(new Coordinate(3, 3))); // true

Rekordy jako DTO

Rekordy doskonale nadają się do reprezentowania obiektów transferu danych (DTO) w interfejsach REST — przenoszą dane między warstwami bez zawierania logiki.

record CreateUserRequest(String email, String displayName, String plan) {}

record UserResponse(long id, String email, String displayName,
                    String plan, String createdAt) {}

// Simulating a service call
static UserResponse createUser(CreateUserRequest req) {
    long id = 42L;
    return new UserResponse(id, req.email(), req.displayName(),
        req.plan(), java.time.Instant.now().toString());
}

CreateUserRequest req = new CreateUserRequest("alice@example.com", "Alice", "PRO");
UserResponse resp = createUser(req);
System.out.println(resp);

Dekonstrukcja rekordów

Rekordy dobrze współpracują z dopasowywaniem wzorców. Można je dekonstruować w wyrażeniach switch (Java 21+).

sealed interface Shape permits Circle, Rectangle, Triangle {}
record Circle(double radius) implements Shape {}
record Rectangle(double width, double height) implements Shape {}
record Triangle(double base, double height) implements Shape {}

static double area(Shape s) {
    return switch (s) {
        case Circle(double r)            -> Math.PI * r * r;
        case Rectangle(double w, double h) -> w * h;
        case Triangle(double b, double h) -> 0.5 * b * h;
    };
}

System.out.printf("%.2f%n", area(new Circle(5)));         // 78.54
System.out.printf("%.2f%n", area(new Rectangle(4, 6)));   // 24.00

Serializacja rekordów

Rekordy naturalnie implementują Serializable, gdy zostaną tak zadeklarowane. Od razu dobrze współpracują z bibliotekami JSON, takimi jak Jackson i Gson.

// With Jackson (add @JsonProperty if needed)
import com.fasterxml.jackson.databind.ObjectMapper;

record OrderSummary(String orderId, double total, String status) {}

ObjectMapper mapper = new ObjectMapper();
OrderSummary order = new OrderSummary("ORD-001", 149.99, "SHIPPED");

String json = mapper.writeValueAsString(order);
System.out.println(json);
// {"orderId":"ORD-001","total":149.99,"status":"SHIPPED"}

OrderSummary restored = mapper.readValue(json, OrderSummary.class);
System.out.println(order.equals(restored)); // true

Zagnieżdżone rekordy

Rekordy mogą zawierać inne rekordy jako komponenty, umożliwiając budowanie rozbudowanych, niezmiennych grafów obiektów.

record Address(String street, String city, String country) {}
record Customer(long id, String name, Address address) {}

Address addr = new Address("123 Main St", "New York", "US");
Customer customer = new Customer(1L, "Alice", addr);

System.out.println(customer.name());              // Alice
System.out.println(customer.address().city());   // New York
System.out.println(customer);                    // Customer[id=1, name=Alice, address=Address[street=123 Main St, city=New York, country=US]]

Ograniczenia rekordów

Rekordy mają pewne ograniczenia, o których należy pamiętać:

Nie mogą rozszerzać innych klas (niejawnie rozszerzają klasę Record)
Komponenty są zawsze final — nie można przechowywać zmiennego stanu
Nie można deklarować pól instancji poza listą komponentów
Nie mogą być abstrakcyjne

// Records CAN have static fields and methods
record Temperature(double celsius) {
    static final double ABSOLUTE_ZERO = -273.15;

    public double toFahrenheit() {
        return celsius * 9.0/5.0 + 32;
    }

    public static Temperature fromFahrenheit(double f) {
        return new Temperature((f - 32) * 5.0/9.0);
    }
}
System.out.println(Temperature.fromFahrenheit(98.6)); // Temperature[celsius=37.0]

Szybkie sprawdzenie

Jakie składowe kompilator Java automatycznie generuje dla rekordu?

Podsumowanie: wprowadzenie do rekordów

Najważniejsze informacje:

Rekordy deklarują niezmienne nośniki danych przy minimalnej ilości kodu pomocniczego
Automatycznie generowane składowe: konstruktor kanoniczny, metody dostępowe, equals, hashCode i toString
Komponenty są final — rekordy są z założenia niezmienne
Rekordy mogą implementować interfejsy, ale nie mogą rozszerzać klas
Doskonale nadają się do DTO, obiektów wartości i odpowiedzi API
Dzięki równości strukturalnej prawidłowo działają jako klucze HashMap i elementy HashSet

Często zadawane pytania

Czy lekcja „Wprowadzenie do rekordów” jest bezpłatna?

Tak — pełny tekst „Wprowadzenie do rekordów” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Java Academy, przejdź na CoddyKit PRO. Kurs Java Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Wprowadzenie do rekordów”?

Deklaruj rekordy jako zwięzłe, niezmienne kontenery danych i poznaj automatycznie generowane przez nie składowe. Ćwiczysz Java Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Java Academy?

Nie wymagamy żadnego doświadczenia. Java Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Wprowadzenie do rekordów”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Java Academy?

Tak. Każda lekcja Java Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Java Academy