在上一篇文章实战 Java 16 值类型 Record - 1. Record 的默认方法使用以及基于预编译生成相关字节码的底层实现中,我们详细分析了 Record 自带的属性以及方法和底层字节码与实现。这一篇我们来详细说明 Record 类的用法。

声明一个 Record

Record 可以单独作为一个文件的顶级类,即:

User.java 文件:

public record User(long id, String name, int age) {}

也可以作为一个成员类,即:

public class RecordTest {
public record User(long id, String name, int age) {}
}

也可以作为一个本地类,即:

public class RecordTest {
public void test() {
record Mail (long id, String content){}
Mail mail = new Mail(10, "content");
}
}

不能用 abstract 修饰 Record 类,会有编译错误。

可以用 final 修饰 Record 类,但是这其实是没有必要的,因为 Record 类本身就是 final 的

成员 Record 类,还有本地 Record 类,本身就是 static 的,也可以用 static 修饰,但是没有必要。

和普通类一样,Record 类可以被 public, protected, private 修饰,也可以不带这些修饰,这样就是 package-private 的。

和一般类不同的是,Record 类的直接父类不是 java.lang.Object 而是 java.lang.Record。但是,Record 类不能使用 extends,因为 Record 类不能继承任何类。

Record 类的属性

一般,在 Record 类声明头部指定这个 Record 类有哪些属性

public record User(long id, String name, int age) {}

同时,可以在头部的属性列表中运用注解:

@Target({ ElementType.RECORD_COMPONENT})
@Retention(RetentionPolicy.RUNTIME)
public @interface A {}
@Target({ ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface B {} public record User(@A @B long id, String name, int age) {}

但是,需要注意一点,这里通过反射获取 id 的注解的时候,需要通过对应的方式进行获取,否则获取不到,即 ElementType.FIELD 通过 Field 获取,ElementType.RECORD_COMPONENT 通过 RecordComponent 获取:

Field[] fields = User.class.getDeclaredFields();
Annotation[] annotations = fields[0].getAnnotations(); // 获取到注解 @B RecordComponent[] recordComponents = User.class.getRecordComponents();
annotations = recordComponents[0].getAnnotations(); // 获取到注解 @A

Record 类体

Record 类属性必须在头部声明,在 Record 类体只能声明静态属性

public record User(long id, String name, int age) {
static long anotherId;
}

Record 类体可以声明成员方法和静态方法,和一般类一样。但是不能声明 abstract 或者 native 方法

public record User(long id, String name, int age) {
public void test(){}
public static void test2(){}
}

Record 类体也不能包含实例初始化块,例如:

public record User(@A @B long id, String name, int age) {
{
System.out.println(); //编译异常
}
}

Record 成员

Record 的所有成员属性,都是 public final 非 static 的,对于每一个属性,都有一个对应的无参数返回类型为属性类型方法名称为属性名称的方法,即这个属性的 accessor。前面说这个方法是 getter 方法其实不太准确,因为方法名称中并没有 get 或者 is 而是只是纯属性名称作为方法名。

这个方法如果我们自己指定了,就不会自动生成:

public record User(long id) {
@Override
public long id() {
return id;
}
}

如果没有自己指定,则会自动生成这样一个方法:

  1. 方法名就是属性名称
  2. 返回类型就是对应的属性类型
  3. 是一个 public 方法,并且没有声明抛出任何异常
  4. 方法体就是返回对应属性
  5. 如果属性上面有任何注解,那么这个注解如果能加到方法上那么也会自动加到这个方法上。例如:
public record User(@A @B long id, String name, int age) {}
@Target({
ElementType.RECORD_COMPONENT,
ElementType.METHOD,
})
@Retention(RetentionPolicy.RUNTIME)
public @interface A {}
@Target({ ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface B {}

下面获取 id() 这个方法的注解则会获取到注解 @A

Method id = User.class.getDeclaredMethod("id");
Annotation[] idAnnotations = id.getAnnotations(); //@A

由于会自动生成这些方法,所以 Record 成员的名称不能和 Object 的某些不符合上述条件(即上面提到的 6 条)的方法的名称一样,例如:

public record User(
int wait, //编译错误
int hashcode, //这个不会有错误,因为 hashcode() 方法符合自动生成的 accessor 的限制条件。
int toString, //编译错误
int finalize //编译错误) {
}

Record 类如果没有指定,则默认会生成实现 java.lang.Record 的抽象方法,即hashcode(), equals(), toStrng() 这三个方法。这三个方法的实现方式,在第一节已经详细分析过,这里简单回顾下要点:

  1. hashcode() 在编译的时候自动生成字节码实现,核心逻辑基于 ObjectMethodsmakeHashCode 方法,里面的逻辑是对于每一个属性的哈希值移位组合起来。注意这里的所有调用(包括对于 ObjectMethods 的方法调用以及获取每个属性)都是利用 MethodHandle 实现的近似于直接调用的方式调用的。
  2. equals() 在编译的时候自动生成字节码实现,核心逻辑基于 ObjectMethodsmakeEquals 方法,里面的逻辑是对于两个 Record 对象每一个属性判断是否相等(对于引用类型用Objects.equals(),原始类型使用 ==),注意这里的所有调用(包括对于 ObjectMethods 的方法调用以及获取每个属性)都是利用 MethodHandle 实现的近似于直接调用的方式调用的。
  3. toString() 在编译的时候自动生成字节码实现,核心逻辑基于 ObjectMethodsmakeToString 方法,里面的逻辑是对于每一个属性的值组合起来构成字符串。注意这里的所有调用(包括对于 ObjectMethods 的方法调用以及获取每个属性)都是利用 MethodHandle 实现的近似于直接调用的方式调用的。

Record 构造器

如果没有指定构造器,Record 类会自动生成一个以所有属性为参数并且给每个属性赋值的构造器。我们可以通过两种方式自己声明构造器:

第一种是明确声明以所有属性为参数并且给每个属性赋值的构造器,这个构造器需要满足:

  1. 构造器参数需要包括所有属性(同名同类型),并按照 Record 类头的声明顺序。
  2. 不能声明抛出任何异常(不能使用 throws)
  3. 不能调用其他构造器(即不能使用 this(xxx))
  4. 构造器需要对于每个属性进行赋值。

对于其他构造器,需要明确调用这个包含所有属性的构造器

public record User(long id, String name, int age) {
public User(int age, long id) {
this(id, "name", age);
}
public User(long id, String name, int age) {
this.id = id;
this.name = name;
this.age = age;
}
}

第二种是简略方式声明,例如:

public record User(long id, String name, int age) {
public User {
System.out.println("initialized");
id = 1000 + id;
name = "prefix_" + name;
age = 1 + age;
//在这之后,对每个属性赋值
}
}

这种方式相当于省略了参数以及对于每个属性赋值,相当于对这种构造器的开头插入代码。

微信搜索“我的编程喵”关注公众号,每日一刷,轻松提升技术,斩获各种offer

实战 Java 16 值类型 Record - 2. Record 的基本用法的更多相关文章

  1. JAVA中值类型和引用类型的不同(面试常考)

    转载:https://www.cnblogs.com/1ming/p/5227944.html 1. JAVA中值类型和引用类型的不同? [定义] 引用类型表示你操作的数据是同一个,也就是说当你传一个 ...

  2. 【转】Java 有值类型吗?

    Java 有值类型吗? 有人看了我之前的文章『Swift 语言的设计错误』,问我:“你说 Java 只有引用类型(reference type),但是根据 Java 的官方文档,Java 也有值类型( ...

  3. java中值类型和引用类型的区别

    [定义] 引用类型表示你操作的数据是同一个,也就是说当你传一个参数给另一个方法时,你在另一个方法中改变这个变量的值,那么调用这个方法是传入的变量的值也将改变. 值类型表示复制一个当前变量传给方法,当你 ...

  4. java中值类型与引用类型的关系

    值类型:就是java的基本类型.byte.short.int.long.float.char.double.boolean 引用类型:类(class).接口(Interface).数组(Array) ...

  5. Java的值类型和引用类型

    一.问题描述 前几天因为一个需求出现了Bug.说高级点也挺高级,说白点也很简单.其实也就是一个很简单的Java基础入门时候的值类型和引用类型的区别.只是开发的时候由于自己的问题,导致小问题的出现.还好 ...

  6. Controller 中Action 返回值类型 及其 页面跳转的用法

        •Controller 中Action 返回值类型 View – 返回  ViewResult,相当于返回一个View 页面. -------------------------------- ...

  7. 学习记录 java 值类型和引用类型的知识

    1. Java中值类型和引用类型的不同? [定义] 引用类型表示你操作的数据是同一个,也就是说当你传一个参数给另一个方法时,你在另一个方法中改变这个变量的值, 那么调用这个方法是传入的变量的值也将改变 ...

  8. java包装类和值类型的关系

    java包装类总是让人疑惑 它与值类型到底是怎么样一种关系? 本文将以int和Integer为例来探讨它们的关系 java值类型有int short char boolean byte long fl ...

  9. PL/SQL集合(一):记录类型(TYPE 类型名称 IS RECORD)

    记录类型 利用记录类型可以实现复合数据类型的定义: 记录类型允许嵌套: 可以直接利用记录类型更新数据. 传统操作的问题 对于Oracle数据类型,主要使用的是VARCHAR2.NUMBER.DATE等 ...

  10. Java中引用类型变量,对象,值类型,值传递,引用传递 区别与定义

    一.Java中什么叫做引用类型变量?引用:就是按内存地址查询       比如:String s = new String();这个其实是在栈内存里分配一块内存空间为s,在堆内存里new了一个Stri ...

随机推荐

  1. D.T SOFTWARE (1) 软件架构直播答疑课程

    今晚的d.t课程 1项目需求 PPTP服务搭建完成PPTP服务器的搭建,用户重新拨号获得新IP后,要求拔PPTP VPN成功时,也获取到新的公网IP,而且能通过代理上网.VNC服务安装用户可以通过VN ...

  2. nsx-edge虚拟机抓包实践

    Edge抓包 今天在客户端进行故障排除时,我需要在环境中的一个边缘服务网关上执行包捕获.在诊断一系列不同的问题时,执行包捕获通常非常有用. 要启动包捕获,您可以跳到ESG的控制台,或者像我在本例中所做 ...

  3. hnsdfz -- 6.20 -- day5

    今天子贞的题...... 比前两天充实多了……肝了一个线段树,还玩了一个题答…… 虽然线段树不知道为什么50->25,题答题数据太水全场90+... 感觉也没想出来啥思路,无脑肝线段树,无脑玩题 ...

  4. XOR+base64加密

    1.xor运算 1^0=1 0^0=0 1^1=0 23^32=55 55^32=23 23对32进行异或两次运算结果为23 2.XOR加密 设key=[]byte{1,2,3,4,5,6},src= ...

  5. tp5生成小程序推广二维码

    //获取用户经销商信息 及生成推广二维码 public function qrcode() { //拿到openid 查找用户表内是否有该用户 没有则拒绝生成二维码 有则查看是否已生成二维码 有生成则 ...

  6. svn -- svn安装与配置

    1.SVN分为服务器端与客户端 l 服务器端:VisualSVN   SubVersion l 客户端:TortoiseSVN server http://www.visualsvn.com/ cli ...

  7. Warning: Data truncated for column 'xxxx' at row 1

    The problem was that I changed the column's length only in the program.I had to do either change the ...

  8. Python 常见的字符串操作

    1.strip.lstrip和rstrip 描述: 用于移除字符串左右两边.左边.右边指定的字符(默认为空白符,例如:/n, /r, /t, ' ')或字符序列. 语法: str.strip([cha ...

  9. python 输入 与如何查看文档 小结

    Python 2 中的输入小结 转载请声明本文的引用出处:仰望大牛的小清新 1.raw_input(prompt = None)与input(prompt = None) 两个都是默认参数类型,这个参 ...

  10. 46. Permutations 排列数

    46. Permutations 题目 Given a collection of distinct numbers, return all possible permutations. For ex ...