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

@HashCodeAndEqualsPlugin.Enhance
public class HashCodeAndEqualsPlugin
extends Object
implements Plugin, Plugin.Factory

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 Classes

Modifier and Type	Class and Description
protected static class	HashCodeAndEqualsPlugin.AnnotationOrderComparator A comparator that arranges fields in the order of HashCodeAndEqualsPlugin.Sorted.
static interface	HashCodeAndEqualsPlugin.Enhance Instructs the HashCodeAndEqualsPlugin to generate Object.hashCode() and Object.equals(Object) for the annotated class unless these methods are already declared explicitly.
static interface	HashCodeAndEqualsPlugin.Sorted Determines the sort order of fields for the equality check when implementing the Object.equals(Object) method.
static interface	HashCodeAndEqualsPlugin.ValueHandling Determines how a field should be used within generated hash code and equality methods.
protected static class	HashCodeAndEqualsPlugin.ValueMatcher An element matcher for a HashCodeAndEqualsPlugin.ValueHandling annotation.
static class	HashCodeAndEqualsPlugin.WithNonNullableFields A version of the HashCodeAndEqualsPlugin that assumes that all fields are non-nullable unless they are explicitly marked.

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.matcher.ElementMatcher

ElementMatcher.Junction<S>

Nested classes/interfaces inherited from interface net.bytebuddy.build.Plugin.Factory

Plugin.Factory.Simple, Plugin.Factory.UsingReflection

Constructor Summary

Constructors

Constructor and Description
HashCodeAndEqualsPlugin()

Method Summary

Modifier and Type	Method and Description
DynamicType.Builder<?>	apply(DynamicType.Builder<?> builder, TypeDescription typeDescription, ClassFileLocator classFileLocator) Applies this plugin.
void	close()
Plugin	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.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HashCodeAndEqualsPlugin

public HashCodeAndEqualsPlugin()

Method Detail

make

public Plugin make()

Returns a plugin that can be used for a transformation and which is subsequently closed.

Specified by:

make in interface Plugin.Factory

Returns:

The plugin to use for type transformations.

matches

public boolean matches(TypeDescription target)

Matches a target against this element matcher.

Specified by:

matches in interface ElementMatcher<TypeDescription>

Parameters:

target - The instance to be matched.

Returns:

true if the given element is matched by this matcher or false otherwise.

apply

public DynamicType.Builder<?> apply(DynamicType.Builder<?> builder,
                                    TypeDescription typeDescription,
                                    ClassFileLocator classFileLocator)

Applies this plugin.

Specified by:

apply in interface Plugin

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

protected ElementMatcher<FieldDescription> nonNullable(ElementMatcher<FieldDescription> matcher)

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 interface Closeable

Specified by:

close in interface AutoCloseable