Module org.pojomatic

Package org.pojomatic.internal

Class BasePojomator<T>

java.lang.Object

org.pojomatic.internal.BasePojomator<T>

All Implemented Interfaces:

Pojomator<T>

public abstract class BasePojomator<T>
extends Object
implements Pojomator<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected Class<?>	pojoClass

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BasePojomator(Class<?> pojoClass, ClassProperties classProperties)

Method Summary

Modifier and Type	Method	Description
protected static boolean	areObjectValuesEqual(Object instanceValue, Object otherValue)	Compare two values of static type Object for equality.
protected static int	arrayHashCode(Object array, boolean deepArray)	Given an object which is of array type, compute it's hashCode by calling the appropriate signature of Arrays.hashCode()
protected static CallSite	bootstrap(MethodHandles.Lookup caller, String name, MethodType methodType, Class<?> pojomatorClass)	Construct a call site for a property accessor.
protected void	checkCompatibleForEquality(T instance, String label)
protected static <T> T	checkNotNull(T reference)
protected static <T> T	checkNotNull(T reference, String message)
protected static void	checkNotNullPop(Object reference)
protected static boolean	compareArrays(Object instanceValue, Object otherValue)	Compare two values of array type for equality.
boolean	isCompatibleForEquality(Class<?> otherClass)	Compute whether otherClass is compatible for equality with T.
String	toString()	Return a simple String representation of this Pojomator.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.pojomatic.Pojomator

doDiff, doEquals, doHashCode, doToString

Field Detail

pojoClass

protected final Class<?> pojoClass

Constructor Detail

BasePojomator

protected BasePojomator(Class<?> pojoClass,
                        ClassProperties classProperties)

Method Detail

isCompatibleForEquality

public boolean isCompatibleForEquality(Class<?> otherClass)

Description copied from interface: Pojomator

Compute whether otherClass is compatible for equality with T. Classes A and B are compatible for equality if they share a common superclass C, and for every class D which is a proper subclass of C and a superclass of A or B (including the classes A and B themselves), the following hold:

• D has not added additional properties for inclusion in the equals calculation, and
• D has not been annotated with OverridesEquals

If T is an interface or is annotated with SubclassCannotOverrideEquals, then all subclasses of T are automatically assumed by T's Pojomator to be compatible for equals with each other and with T. Note that in this case. to add an OverridesEquals annotation or additional properties for inclusion in equals to a subclass of T will result in a violation of the contract for Object.equals(Object).

Specified by:

isCompatibleForEquality in interface Pojomator<T>

Parameters:

otherClass - the class to check for compatibility for equality with T

Returns:

true if otherClass is compatible for equality with T, and false otherwise.

toString

public String toString()

Description copied from interface: Pojomator

Return a simple String representation of this Pojomator. This is meant to aid in debugging which properties are being used for which purposes. The contents and format of this representation are subject to change.

Specified by:

toString in interface Pojomator<T>

Overrides:

toString in class Object

Returns:

a simple String representation of this Pojomator.

bootstrap

protected static CallSite bootstrap(MethodHandles.Lookup caller,
                                    String name,
                                    MethodType methodType,
                                    Class<?> pojomatorClass)
                             throws Throwable

Construct a call site for a property accessor. Because pojoClass might not be a public class, the parameter in methodType cannot be pojoClass, but instead must be just Object.class. The pojoClass parameter will be stored as static field in the Pojomator class, and passed in from it's bootstrap method.

Parameters:

caller - A Lookup from the original call site.

name - the name of the dynamic method. This should either be "field_<fieldName>" or "method_<methodName>".

methodType - the type of the dynamic method; the return type should be the type of the aforementioned field or method

pojomatorClass - the type of the pojomator class

Returns:

a CallSite which invokes the method or gets the field value.

Throws:

Throwable - if there are reflection issues

areObjectValuesEqual

protected static boolean areObjectValuesEqual(Object instanceValue,
                                              Object otherValue)

Compare two values of static type Object for equality. If both values are arrays, then they will be considered equal iff they have the same class, and (recursively) an equal set of elements.

Parameters:

instanceValue - the first value to compare

otherValue - the second value to compare

Returns:

true if instanceValue and otherValue are equal to each other.

compareArrays

protected static boolean compareArrays(Object instanceValue,
                                       Object otherValue)

Compare two values of array type for equality. They will be considered equal iff they have the same class, and (recursively) an equal set of elements.

Parameters:

instanceValue - the first value to compare

otherValue - the second value to compare

Returns:

true if instanceValue and otherValue are equal to each other.

arrayHashCode

protected static int arrayHashCode(Object array,
                                   boolean deepArray)

Given an object which is of array type, compute it's hashCode by calling the appropriate signature of Arrays.hashCode()

Parameters:

array - the array

deepArray - whether to do a deep hashCode for Object arrays.

Returns:

the hashCode

checkNotNull

protected static <T> T checkNotNull(T reference)

checkNotNull

protected static <T> T checkNotNull(T reference,
                                    String message)

checkNotNullPop

protected static void checkNotNullPop(Object reference)

checkCompatibleForEquality

protected void checkCompatibleForEquality(T instance,
                                          String label)