一、简介
在lombok v0.11.4中，@Value被作为实验性功能引入。
自lombok v0.11.8以来，@Value不再意味着@With。
自lombok v0.12.0以来，@Value被提升为lombok主包。
@Value是@Data的不可更改变体；默认情况下，所有字段都是private和final的，并且不会生成setter。默认情况下，类本身也是final的，因为不可变性不是可以强加给子类的东西。与@Data一样，还生成了有用的toString()、equals()和hashCode()方法，每个字段都得到一个getter方法，并且还生成了一个覆盖每个参数（除了在字段声明中初始化的final字段）的构造函数。
实际上，@Value是以下内容的缩写：final @ToString @EqualsAndHashCode @AllArgsConstructor @FieldDefaults(makeFinal = true, level = AccessLevel.PRIVATE) @Getter，除了明确包括任何相关方法的实现，只是意味着该部分不会被生成，也不会发出警告。例如，如果你写了你自己的toString，不会发生错误，lombok也不会生成toString。另外，任何显式构造函数，无论参数列表如何，都意味着lombok不会生成一个构造函数。如果你确实想让lombok生成所有参数的构造函数，请在类中添加@AllArgsConstructor。注意，如果@Builder和@Value都在一个类上，@Builder想做的包的私有所有参数构造函数会 "胜过"@Value想做的公共构造函数。你可以用@lombok.experimental.Tolerate来标记任何构造函数或方法，以便从lombok中隐藏它们。
我们可以使用字段上的显式访问级别或者使用 @NonFinal 或 @PackagePrivate 注解来覆盖 final-by-default 和 private-by-default 行为。@NonFinal也可以在一个类上使用，以删除final关键字。
可以通过明确使用该注解来覆盖构成@Value的任何 "零件"的任何默认行为。
二、示例比较
1. Lombok 写法
import lombok.AccessLevel;
import lombok.experimental.NonFinal;
import lombok.experimental.Value;
import lombok.experimental.With;
import lombok.ToString;
@Value public class ValueExample {
String name;
@With(AccessLevel.PACKAGE) @NonFinal int age;
double score;
protected String[] tags;
@ToString(includeFieldNames=true)
@Value(staticConstructor="of")
public static class Exercise<T> {
String name;
T value;
}
}
2. Java 标准写法
import java.util.Arrays;
public final class ValueExample {
private final String name;
private int age;
private final double score;
protected final String[] tags;
@java.beans.ConstructorProperties({"name", "age", "score", "tags"})
public ValueExample(String name, int age, double score, String[] tags) {
this.name = name;
this.age = age;
this.score = score;
this.tags = tags;
}
public String getName() {
return this.name;
}
public int getAge() {
return this.age;
}
public double getScore() {
return this.score;
}
public String[] getTags() {
return this.tags;
}
@java.lang.Override
public boolean equals(Object o) {
if (o == this) return true;
if (!(o instanceof ValueExample)) return false;
final ValueExample other = (ValueExample)o;
final Object this$name = this.getName();
final Object other$name = other.getName();
if (this$name == null ? other$name != null : !this$name.equals(other$name)) return false;
if (this.getAge() != other.getAge()) return false;
if (Double.compare(this.getScore(), other.getScore()) != 0) return false;
if (!Arrays.deepEquals(this.getTags(), other.getTags())) return false;
return true;
}
@java.lang.Override
public int hashCode() {
final int PRIME = 59;
int result = 1;
final Object $name = this.getName();
result = result * PRIME + ($name == null ? 43 : $name.hashCode());
result = result * PRIME + this.getAge();
final long $score = Double.doubleToLongBits(this.getScore());
result = result * PRIME + (int)($score >>> 32 ^ $score);
result = result * PRIME + Arrays.deepHashCode(this.getTags());
return result;
}
@java.lang.Override
public String toString() {
return "ValueExample(name=" + getName() + ", age=" + getAge() + ", score=" + getScore() + ", tags=" + Arrays.deepToString(getTags()) + ")";
}
ValueExample withAge(int age) {
return this.age == age ? this : new ValueExample(name, age, score, tags);
}
public static final class Exercise<T> {
private final String name;
private final T value;
private Exercise(String name, T value) {
this.name = name;
this.value = value;
}
public static <T> Exercise<T> of(String name, T value) {
return new Exercise<T>(name, value);
}
public String getName() {
return this.name;
}
public T getValue() {
return this.value;
}
@java.lang.Override
public boolean equals(Object o) {
if (o == this) return true;
if (!(o instanceof ValueExample.Exercise)) return false;
final Exercise<?> other = (Exercise<?>)o;
final Object this$name = this.getName();
final Object other$name = other.getName();
if (this$name == null ? other$name != null : !this$name.equals(other$name)) return false;
final Object this$value = this.getValue();
final Object other$value = other.getValue();
if (this$value == null ? other$value != null : !this$value.equals(other$value)) return false;
return true;
}
@java.lang.Override
public int hashCode() {
final int PRIME = 59;
int result = 1;
final Object $name = this.getName();
result = result * PRIME + ($name == null ? 43 : $name.hashCode());
final Object $value = this.getValue();
result = result * PRIME + ($value == null ? 43 : $value.hashCode());
return result;
}
@java.lang.Override
public String toString() {
return "ValueExample.Exercise(name=" + getName() + ", value=" + getValue() + ")";
}
}
}
三、支持的配置项
lombok.value.flagUsage = [warning | error] (默认: not set)
Lombok将@Value的任何用法标记为警告或错误（如果已配置）。
lombok.noArgsConstructor.extraPrivate = [true | false] (默认: false)
如果为true，lombok将为任何@Value注释类生成一个私有的无参数构造函数，该构造函数将所有字段设置为默认值（null/0/false）。
四、附属说明
查找有关@Value的“零件”的文档：@ToString、@EqualsAndHashCode、@AllArgsConstructor、@FieldDefaults 和 @Getter。
对于具有泛型的类，将静态方法用作构造函数是很有用的，因为通过静态方法推断泛型参数在 java6 中有效并且避免了必须使用菱形运算符。虽然您可以通过应用显式 @AllArgsConstructor(staticConstructor="of") 注释来强制执行此操作，但还有 @Value(staticConstructor="of") 功能，它将使生成的所有参数构造函数私有，并生成公共静态名为 of 的方法是此私有构造函数的包装器。
各种众所周知的关于空性的注解会导致插入空检查并将其复制到相关位置（例如 getter 的方法，以及构造函数和 setter 的参数）。有关更多信息，请参阅 Getter/Setter 文档的附属说明。
@Value 是一个从 v0.11.4 到 v0.11.9 的实验性功能（如@lombok.experimental.Value）。它已被移至核心包中。旧注释仍然存在（并且是别名）。不过，它最终会在未来的版本中被删除。
无法使用@FieldDefaults来“undo”注释类中字段的 private-by-default 和final-by-default方面。在类中的字段上使用@NonFinal和@PackagePrivate来重写此行为。
参考文献
【1】@Value | Immutable classes made very easy.
Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。
它的内容包括：
- 大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
- 原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
- 持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
- 覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
- 不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
- 宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
- 宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
- 宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw
目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：
想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询
同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】 即可免费领取。
