作者简介:大家好,我是smart哥,前中兴通讯、美团架构师,现某互联网公司CTO
联系qq:184480602,加我进群,大家一起学习,一起进步,一起对抗互联网寒冬
学习必须往深处挖,挖的越深,基础越扎实!
阶段1、深入多线程
阶段2、深入多线程设计模式
阶段3、深入juc源码解析
码哥源码部分
码哥讲源码-原理源码篇【2024年最新大厂关于线程池使用的场景题】
码哥讲源码-原理源码篇【揭秘join方法的唤醒本质上决定于jvm的底层析构函数】
码哥源码-原理源码篇【Doug Lea为什么要将成员变量赋值给局部变量后再操作?】
码哥讲源码【谁再说Spring不支持多线程事务,你给我抽他!】
打脸系列【020-3小时讲解MESI协议和volatile之间的关系,那些将x86下的验证结果当作最终结果的水货们请闭嘴】
一、实验性功能说明
@UtilityClass
是在lombok v1.16.2
中作为实验性功能引入的。
实验因为:
- 关于其是否常见到足以算作模板的问题,存在一些争议。
当前状态:积极-目前我们认为该功能可能很快脱离实验状态,不会有任何或微小的变化。
二、简介
一个实用工具类是一个只是函数命名空间的类。它的实例不可能存在,而且它的所有成员都是静态的。例如,java.lang.Math
和java.util.Collections
是著名的实用工具类。这个注解会自动将被注解的类变成一个这样的类。
一个实用工具类不能被实例化。通过用@UtilityClass
标记你的类,lombok
会自动生成一个抛出异常的私有构造函数,将你添加的任何显式构造函数标记为错误,并将该类标记为final
。如果该类是一个内部类,该类也被标记为static
。
实用工具类的所有成员都被自动标记为静态。甚至是字段和内部类。
三、示例比较
1. Lombok 写法
import lombok.experimental.UtilityClass;
@UtilityClass
public class UtilityClassExample {
private final int CONSTANT = 5;
public int addSomething(int in) {
return in + CONSTANT;
}
}
2. Java 标准写法
public final class UtilityClassExample {
private static final int CONSTANT = 5;
private UtilityClassExample() {
throw new java.lang.UnsupportedOperationException("This is a utility class and cannot be instantiated");
}
public static int addSomething(int in) {
return in + CONSTANT;
}
}
四、支持的配置项
lombok.utilityClass.flagUsage
= [warning
| error
] (默认: not set
)Lombok
将@UtilityClass
的任何使用标记为警告或错误(如果已配置)。
五、附属说明
目前还没有任何方法来创建非静态成员,或者定义你自己的构造函数。如果你想实例化实用工具类,即使只是作为一个内部实现,也不能使用@UtilityClass
。
由于javac
处理静态导入的方式很特别,试图对@UtilityClass
的任何成员进行非星形静态导入都不会成功。要么使用星形静态导入:import static TypeMarkedWithUtilityClass.*;
或者不要静态导入任何成员。
参考文献
【1】@UtilityClass | Utility, metility, wetility! Utility classes for the masses.