Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

A palavra-chave record

A palavra-chave record: Uma declaração record cria uma classe de dados nominal cujos componentes determinam campos private final, acessores e construtor canónico.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

record

Uma declaração record cria uma classe de dados nominal cujos componentes determinam campos private final, acessores e construtor canónico.

Usa record para valores transparentes; escreve o construtor canónico compacto como Name { ... } para validar ou normalizar antes da atribuição automática.

O construtor canónico compacto não tem lista de parâmetros nem pode atribuir explicitamente campos componentes; final superficial não congela objetos mutáveis.

Um record é implicitamente final e estende java.lang.Record; acessores ou equals próprios devem preservar o invariante e a semântica de valor.

O construtor canónico compacto cria Range[start=2, end=7], size=5 e components=2; invertido dá invalid=reversed.

Exemplos

public class Main { record Range(int start,int end){ Range { if(start>end)throw new IllegalArgumentException("reversed"); } int size(){return end-start;} } public static void main(String[] a){var r=new Range(2,7);System.out.println(r);System.out.println("size="+r.size());System.out.println("components="+Range.class.getRecordComponents().length);try{new Range(5,1);}catch(IllegalArgumentException e){System.out.println("invalid="+e.getMessage());}} }

Resultado

Range[start=2, end=7]
size=5
components=2
invalid=reversed

O construtor canónico compacto cria Range[start=2, end=7], size=5 e components=2; invertido dá invalid=reversed.

Fontes