<#import "../_features.html" as f> <@f.scaffold title="@UtilityClass" logline="Utility, metility, wetility! Utility classes for the masses."> <@f.history>

@UtilityClass was introduced as an experimental feature in lombok v1.16.2.

<@f.experimental> Current status: negative - Currently we feel this feature cannot move out of experimental status due to fundamental issues with non-star static imports. <@f.overview>

A utility class is a class that is just a namespace for functions. No instances of it can exist, and all its members are static. For example, java.lang.Math and java.util.Collections are well known utility classes. This annotation automatically turns the annotated class into one.

A utility class cannot be instantiated. By marking your class with @UtilityClass, lombok will automatically generate a private constructor that throws an exception, flags as error any explicit constructors you add, and marks the class final. If the class is an inner class, the class is also marked static.

All members of a utility class are automatically marked as static. Even fields and inner classes.

<@f.snippets name="experimental/UtilityClass" /> <@f.confKeys>
lombok.utilityClass.flagUsage = [warning | error] (default: not set)
Lombok will flag any usage of @UtilityClass as a warning or error if configured.
<@f.smallPrint>

There isn't currently any way to create non-static members, or to define your own constructor. If you want to instantiate the utility class, even only as an internal implementation detail, @UtilityClass cannot be used.

Due to a peculiar way javac processes static imports, trying to do a non-star static import of any of the members of a `@UtilityClass` won't work. Either use a star static import: `import static TypeMarkedWithUtilityClass.*;` or don't statically import any of the members.