Package net.bytebuddy.build
Class HashCodeAndEqualsPlugin
java.lang.Object
net.bytebuddy.build.HashCodeAndEqualsPlugin
- All Implemented Interfaces:
Closeable
,AutoCloseable
,Plugin
,Plugin.Factory
,ElementMatcher<TypeDescription>
- Direct Known Subclasses:
HashCodeAndEqualsPlugin.WithNonNullableFields
A build tool plugin that adds
Object.hashCode()
and Object.equals(Object)
methods to a class if the
HashCodeAndEqualsPlugin.Enhance
annotation is present and no explicit method declaration was added. This plugin does not need to be closed.-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprotected static enum
A comparator that arranges fields in the order ofHashCodeAndEqualsPlugin.Sorted
.static @interface
Instructs theHashCodeAndEqualsPlugin
to generateObject.hashCode()
andObject.equals(Object)
for the annotated class unless these methods are already declared explicitly.static @interface
Determines the sort order of fields for the equality check when implementing theObject.equals(Object)
method.static @interface
Determines how a field should be used within generated hash code and equality methods.protected static class
An element matcher for aHashCodeAndEqualsPlugin.ValueHandling
annotation.static class
A version of theHashCodeAndEqualsPlugin
that assumes that all fields are non-nullable unless they are explicitly marked.Nested classes/interfaces inherited from interface net.bytebuddy.matcher.ElementMatcher
ElementMatcher.Junction<S>
Nested classes/interfaces inherited from interface net.bytebuddy.build.Plugin
Plugin.Engine, Plugin.Factory, Plugin.ForElementMatcher, Plugin.NoOp, Plugin.WithPreprocessor
Nested classes/interfaces inherited from interface net.bytebuddy.build.Plugin.Factory
Plugin.Factory.Simple, Plugin.Factory.UsingReflection
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final MethodDescription.InDefinedShape
A description of theHashCodeAndEqualsPlugin.Enhance.includeSyntheticFields()
method.private static final MethodDescription.InDefinedShape
A description of theHashCodeAndEqualsPlugin.Enhance.invokeSuper()
method.private static final MethodDescription.InDefinedShape
A description of theHashCodeAndEqualsPlugin.Enhance.permitSubclassEquality()
method.private static final MethodDescription.InDefinedShape
A description of theHashCodeAndEqualsPlugin.Enhance.simpleComparisonsFirst()
method.private static final MethodDescription.InDefinedShape
A description of theHashCodeAndEqualsPlugin.Enhance.useTypeHashConstant()
method.private static final MethodDescription.InDefinedShape
A description of theHashCodeAndEqualsPlugin.Sorted.value()
method.private static final MethodDescription.InDefinedShape
A description of theHashCodeAndEqualsPlugin.ValueHandling.value()
method. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionapply
(DynamicType.Builder<?> builder, TypeDescription typeDescription, ClassFileLocator classFileLocator) Applies this plugin.void
close()
make()
Returns a plugin that can be used for a transformation and which is subsequently closed.boolean
matches
(TypeDescription target) Matches a target against this element matcher.protected ElementMatcher<FieldDescription>
nonNullable
(ElementMatcher<FieldDescription> matcher) Resolves the matcher to identify non-nullable fields.
-
Field Details
-
ENHANCE_INVOKE_SUPER
A description of theHashCodeAndEqualsPlugin.Enhance.invokeSuper()
method. -
ENHANCE_SIMPLE_COMPARISON_FIRST
A description of theHashCodeAndEqualsPlugin.Enhance.simpleComparisonsFirst()
method. -
ENHANCE_INCLUDE_SYNTHETIC_FIELDS
A description of theHashCodeAndEqualsPlugin.Enhance.includeSyntheticFields()
method. -
ENHANCE_PERMIT_SUBCLASS_EQUALITY
A description of theHashCodeAndEqualsPlugin.Enhance.permitSubclassEquality()
method. -
ENHANCE_USE_TYPE_HASH_CONSTANT
A description of theHashCodeAndEqualsPlugin.Enhance.useTypeHashConstant()
method. -
VALUE_HANDLING_VALUE
A description of theHashCodeAndEqualsPlugin.ValueHandling.value()
method. -
SORTED_VALUE
A description of theHashCodeAndEqualsPlugin.Sorted.value()
method.
-
-
Constructor Details
-
HashCodeAndEqualsPlugin
public HashCodeAndEqualsPlugin()
-
-
Method Details
-
make
Returns a plugin that can be used for a transformation and which is subsequently closed.- Specified by:
make
in interfacePlugin.Factory
- Returns:
- The plugin to use for type transformations.
-
matches
Matches a target against this element matcher.- Specified by:
matches
in interfaceElementMatcher<TypeDescription>
- Parameters:
target
- The instance to be matched.- Returns:
true
if the given element is matched by this matcher orfalse
otherwise.
-
apply
public DynamicType.Builder<?> apply(DynamicType.Builder<?> builder, TypeDescription typeDescription, ClassFileLocator classFileLocator) Applies this plugin.- Specified by:
apply
in interfacePlugin
- Parameters:
builder
- The builder to use as a basis for the applied transformation.typeDescription
- The type being transformed.classFileLocator
- A class file locator that can locate other types in the scope of the project.- Returns:
- The supplied builder with additional transformations registered.
-
nonNullable
Resolves the matcher to identify non-nullable fields.- Parameters:
matcher
- The matcher that identifies fields that are either nullable or non-nullable.- Returns:
- The actual matcher to identify non-nullable fields.
-
close
public void close()- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
-