Java中的record使用详解

 更新时间:2025年06月05日 11:39:54   作者:芦屋花绘  
record 是 Java 14 引入的一种新语法(在 Java 16 中成为正式功能),用于定义不可变的数据类,这篇文章给大家介绍Java中的record相关知识,感兴趣的朋友一起看看吧

1. 什么是 record?

定义record 是 Java 14 引入的一种新语法(在 Java 16 中成为正式功能),用于定义不可变的数据类。

  • 目的:简化那些主要用于存储数据的类的定义,减少样板代码。
  • 特点
    • 自动实现构造函数。
    • 自动生成 equals()hashCode()toString() 方法。
    • 字段默认是 private final,且不可修改。

2. 基本语法

public record ClassName(Type fieldName1, Type fieldName2, ...) {
    // 可选:可以添加额外的方法或逻辑
}

示例

public record Point(int x, int y) {
}

等价于以下传统类定义:

public final class Point {
    private final int x;
    private final int y;
    // 全参构造器
    public Point(int x, int y) {
        this.x = x;
        this.y = y;
    }
    // Getter 方法
    public int x() { return x; }
    public int y() { return y; }
    // 自动覆盖 equals 和 hashCode
    @Override
    public boolean equals(Object obj) {
        if (!(obj instanceof Point)) return false;
        Point other = (Point) obj;
        return this.x == other.x && this.y == other.y;
    }
    @Override
    public int hashCode() {
        return Objects.hash(x, y);
    }
    // 自动覆盖 toString
    @Override
    public String toString() {
        return "Point[x=" + x + ", y=" + y + "]";
    }
}

3. record 的核心特性

(1)字段不可变

  • record 的字段默认是 private final,且不能被修改。
  • 示例:
public record Point(int x, int y) {}
Point p = new Point(1, 2);
// p.x = 3; // 编译错误:x 是 final 的,不能修改

(2)自动生成方法

  • 构造函数:根据字段自动生成全参构造函数。
  • getter 方法:为每个字段生成对应的 getter 方法(名称与字段名相同)。
  • equals()hashCode()toString():根据字段自动生成这些方法。

示例

Point p1 = new Point(1, 2);
Point p2 = new Point(1, 2);
System.out.println(p1.equals(p2)); // 输出 true
System.out.println(p1.hashCode()); // 输出基于字段值的哈希码
System.out.println(p1);           // 输出 Point[x=1, y=2]

(3)简洁性

  • 不需要手动编写构造函数、getter 方法、equals()hashCode()toString()
  • 适合用来定义简单的数据载体类。

4. 使用场景

(1)封装简单数据结构

  • 当你需要一个类来表示一组不可变的数据时,可以使用 record
  • 示例:
public record User(String name, int age) {}
User user = new User("Alice", 25);
System.out.println(user.name()); // 输出 Alice

(2)配置类

  • 在 Spring Boot 等框架中,可以用 record 定义配置类。
  • 示例:
@ConfigurationProperties(prefix = "app")
public record AppProperties(String name, int port) {}

(3)DTO(数据传输对象)

  • 在微服务或前后端交互中,record 是一个很好的选择,用于定义 DTO。
  • 示例:
public record BookDto(String title, String author, double price) {}

5. 自定义行为

虽然 record 自动生成了许多方法,但你仍然可以对其进行扩展。

(1)添加额外方法

可以在 record 中定义额外的方法。

public record Point(int x, int y) {
    public double distanceFromOrigin() {
        return Math.sqrt(x * x + y * y);
    }
}
Point p = new Point(3, 4);
System.out.println(p.distanceFromOrigin()); // 输出 5.0

(2)自定义构造函数

你可以通过紧凑构造函数对字段进行验证或其他操作。

public record Point(int x, int y) {
    public Point {
        if (x < 0 || y < 0) {
            throw new IllegalArgumentException("Coordinates cannot be negative");
        }
    }
}
// Point p = new Point(-1, 2); // 抛出异常

紧凑构造函数 是 record 提供的一种简洁语法,用于在不手动写构造参数和赋值的前提下,插入自定义逻辑(如校验),简洁高效,专为不可变数据对象设计。

6. 注意事项

(1)字段不可变

  • record 的字段默认是 final,不能被修改。
  • 如果需要可变字段,不能使用 record

(2)继承限制

  • record 不能继承其他类(因为它是隐式 final 的)。
  • 它的本质是一种语法糖,编译器帮你自动生成如下内容:
public final class Point extends java.lang.Record {
    private final int x;
    private final int y;
    // 自动生成构造方法、getters、toString、equals、hashCode 等
}

record 可以实现接口。

public record Point(int x, int y) implements Serializable {}

(3)不适合复杂逻辑

record 主要用于简单的数据载体,不适合包含复杂的业务逻辑。

(4)兼容性

  • record 需要 JDK 14 或更高版本。
  • 如果你的项目需要兼容低版本 JDK,则不能使用 record

7. 总结

优点

  • 减少样板代码。
  • 提高代码可读性和维护性。自动生成常用方法(如 equals()hashCode()toString())。

适用场景

  • 封装简单数据结构。
  • 配置类。
  • DTO(数据传输对象)。

限制

  • 字段不可变。
  • 不能继承其他类。
  • 不适合复杂逻辑。

到此这篇关于Java中的record详解的文章就介绍到这了,更多相关Java record内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Spring中的@Scheduled定时任务注解详解

    Spring中的@Scheduled定时任务注解详解

    这篇文章主要介绍了Spring中的@Scheduled定时任务注解详解,要使用@Scheduled注解,首先需要在启动类添加@EnableScheduling,启用Spring的计划任务执行功能,这样可以在容器中的任何Spring管理的bean上检测@Scheduled注解,执行计划任务,需要的朋友可以参考下
    2023-09-09
  • mybatis的动态SQL以及连接池详解

    mybatis的动态SQL以及连接池详解

    这篇文章主要介绍了mybatis的动态SQL以及连接池详解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-02-02
  • mybatis插入数据不返回主键id的可能原因及解决方式

    mybatis插入数据不返回主键id的可能原因及解决方式

    这篇文章主要介绍了mybatis插入数据不返回主键id的可能原因及解决方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-08-08
  • Java之哈夫曼压缩原理案例讲解

    Java之哈夫曼压缩原理案例讲解

    这篇文章主要介绍了Java之哈夫曼压缩原理案例讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
    2021-08-08
  • IDEA 程序包不存在,找不到符号但是明明存在对应的jar包(问题分析及解决方案)

    IDEA 程序包不存在,找不到符号但是明明存在对应的jar包(问题分析及解决方案)

    这篇文章主要介绍了IDEA 程序包不存在,找不到符号但是明明存在对应的jar包 的解决方案,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • MultipartFile文件判断是否存在的操作

    MultipartFile文件判断是否存在的操作

    这篇文章主要介绍了MultipartFile文件判断是否存在的操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-07-07
  • kafka 消息队列中点对点与发布订阅的区别说明

    kafka 消息队列中点对点与发布订阅的区别说明

    这篇文章主要介绍了kafka 消息队列中点对点与发布订阅的区别说明,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-05-05
  • Java中父类强制转换子类问题解决

    Java中父类强制转换子类问题解决

    在Java编程中继承是基础,但父类转换为子类时需谨慎,正确的转换要求父类引用实际指向子类对象,错误转换可能引发ClassCastException,解决方案包括使用instanceof关键字检查、利用泛型避免转换、以及通过多态性避免直接转换,感兴趣的可以了解一下
    2024-11-11
  • Java将byte[]转图片存储到本地的案例

    Java将byte[]转图片存储到本地的案例

    这篇文章主要介绍了Java将byte[]转图片存储到本地的案例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-10-10
  • Springboot Apollo配置yml的问题及解决方案

    Springboot Apollo配置yml的问题及解决方案

    这篇文章主要介绍了Springboot Apollo配置yml的问题及解决方案,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-06-06

最新评论