03. 《Lombok 实战 —— @toString & @EqualsAndHashCode》

本文详细介绍了Lombok库中的@toString和@EqualsAndHashCode两个注解的使用,从入门到深度研究,包括全局配置。@toString用于自动生成toString方法,@EqualsAndHashCode则用于简化equals和hashCode方法的实现。文章通过源码分析和示例代码展示了如何进行个性化配置,如排除字段、显示字段名、排序等。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

《Lombok 实战 —— @toString & @EqualsAndHashCode》

1. @toString

No need to start a debugger to see your fields: Just let lombok generate a toString for you!

1.1 入门使用@toString

任何类定义都可以用@ToString注释,让lombok生成toString()方法的实现。 默认情况下,它会按顺序打印类名和每个字段,并以逗号分隔,如下所示:

@Getter
@Setter
@ToString
public class User {
   
    private String username;
    private String password;
    private boolean isAdult;
}

// 编译后:
public class User {
   
    private String username;
    private String password;
    private boolean isAdult;
	// 其他省略
    public String toString() {
   
        return "User(username=" + this.getUsername() + 
        ", password=" + this.getPassword() + 
        ", isAdult=" + this.isAdult() + ")";
    }
}

在编译后地结果中可以看到,lombok默认使用的是getter方法进行设值,如this.getUsername(),但是我们实际并不需要通过getter的方式进行设置,lombok也知道我们有这样的需求,为我们提供了注解配置项,下面我们就来继续看看如何进行更个性化的配置@toString

1.2 深度研究@toString

深度研究一个东西,肯定少不了源码的分析,当然@toString的代码并不难,放一百个心,如下所示:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.SOURCE)
public @interface ToString {
   
	// 输出是否带字段名称
	boolean includeFieldNames() default true;
	// 排除字段,以 String[] 格式设置
	String[] exclude() default {
   };
	// 指定输出哪些字段,不过将来会被标注@deprecated,使用 @ToString.Include 替代
	String[] of() default {
   };
	// 是否调用父类的 toString() 方法
	boolean callSuper() default false;
	// 不使用 getter 方法获取字段值
	boolean doNotUseGetters() default false;
	// 是否只输出被 @ToString.Include 备注的属性,默认情况输出所有非静态字段
	boolean onlyExplicitlyIncluded() default false;
	
	// 标注不被输出的字段
	@Target(ElementType.FIELD)
	@Retention(RetentionPolicy.SOURCE)
	public @interface Exclude {
   }
	
	// 标注被输出的字段 @ToString.Include
	@Target({
   ElementType.FIELD, ElementType.METHOD})
	@Retention(RetentionPolicy.SOURCE)
	
### 关于 `@EqualsAndHashCode` 注解引发的 `toString` 方法报错问题 当使用 Lombok 的 `@EqualsAndHashCode` 注解时,如果未正确处理继承关系或者存在其他冲突情况,可能会导致生成的方法出现问题,比如 `toString()` 方法无法正常工作。以下是可能导致此问题的原因以及解决方案。 #### 1. 继承关系中的冲突 如果子类也定义了 `@EqualsAndHashCode` 并且设置了不同的参数(如 `callSuper=false`),这可能会与父类的行为发生冲突,从而影响到 `toString()` 方法的生成逻辑[^2]。 为了防止这种冲突,可以显式地设置 `callSuper=true` 或者调整注解的配置以保持一致性。 ```java // 父类 import lombok.EqualsAndHashCode; @EqualsAndHashCode public class ParentClass { private String parentField; } // 子类 import lombok.EqualsAndHashCode; @EqualsAndHashCode(callSuper = true) // 显式调用父类方法 public class ChildClass extends ParentClass { private String childField; } ``` #### 2. 配置文件的影响 通过 `lombok.config` 文件可以全局控制 Lombok 行为。如果在该文件中错误地设置了某些选项,也可能间接影响到 `toString()` 方法的生成。例如: - 如果 `config.stopBubbling=true` 被启用,则子目录下的配置不会被应用,可能导致不一致的行为[^1]。 - 如果指定了 `lombok.anyConstructor.addConstructorProperties=true`,则可能会影响构造器和其他辅助方法之间的协调。 因此,建议检查项目的根目录是否存在 `lombok.config` 文件,并确认其中的内容是否合理。例如: ```properties # lombok.config 示例 config.stopBubbling=true lombok.equalsAndHashCode.callSuper=call ``` 上述配置表示停止向上查找配置并强制调用父类的 `equals` 和 `hashCode` 方法。 #### 3. 手动排除特定字段 有时,某些字段不适合参与 `equals`、`hashCode` 或 `toString` 方法的计算。可以通过 `exclude` 参数手动排除这些字段。例如: ```java import lombok.EqualsAndHashCode; @EqualsAndHashCode(exclude = {"sensitiveField"}) public class ExampleClass { private int normalField; private String sensitiveField; // 不希望包含在此方法中 } ``` 这种方式能够有效避免因敏感数据或其他原因引起的潜在问题。 #### 4. 替代方案:单独使用 `@ToString` 如果仅需解决 `toString()` 方法的问题而不涉及 `equals` 和 `hashCode`,可以选择只添加 `@ToString` 注解而不是依赖 `@EqualsAndHashCode` 自动生成它。例如: ```java import lombok.ToString; @ToString public class AnotherExample { private String fieldA; private int fieldB; } ``` 这种方法更加灵活,允许开发者分别管理不同功能的需求。 --- ### 总结 针对由 `@EqualsAndHashCode` 导致的 `toString` 方法报错问题,可以从以下几个方面入手: - 检查是否有继承链上的冲突; - 审核 `lombok.config` 中的相关配置项; - 利用 `exclude` 属性屏蔽不必要的字段; - 单独引入更精确的功能注解(如 `@ToString`)替代整体性的 `@EqualsAndHashCode`。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

「已注销」

滚蛋吧,结核菌!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值