org.hibernate.type.descriptor.java

Interface JavaTypeDescriptor<T>

All Superinterfaces:

Serializable

All Known Subinterfaces:

BasicJavaDescriptor<T>

All Known Implementing Classes:

AbstractTypeDescriptor, BigDecimalTypeDescriptor, BigIntegerTypeDescriptor, BlobTypeDescriptor, BooleanTypeDescriptor, ByteArrayTypeDescriptor, ByteTypeDescriptor, CalendarDateTypeDescriptor, CalendarTimeTypeDescriptor, CalendarTypeDescriptor, CharacterArrayTypeDescriptor, CharacterTypeDescriptor, ClassTypeDescriptor, ClobTypeDescriptor, CurrencyTypeDescriptor, DateTypeDescriptor, DoubleTypeDescriptor, DurationJavaDescriptor, EnumJavaTypeDescriptor, FloatTypeDescriptor, InstantJavaDescriptor, IntegerTypeDescriptor, JavaTypeDescriptorRegistry.FallbackJavaTypeDescriptor, JdbcDateTypeDescriptor, JdbcTimestampTypeDescriptor, JdbcTimeTypeDescriptor, LocalDateJavaDescriptor, LocalDateTimeJavaDescriptor, LocaleTypeDescriptor, LocalTimeJavaDescriptor, LongTypeDescriptor, NClobTypeDescriptor, OffsetDateTimeJavaDescriptor, OffsetTimeJavaDescriptor, PrimitiveByteArrayTypeDescriptor, PrimitiveCharacterArrayTypeDescriptor, RowVersionTypeDescriptor, SerializableTypeDescriptor, ShortTypeDescriptor, StringTypeDescriptor, TimeZoneTypeDescriptor, UrlTypeDescriptor, UUIDTypeDescriptor, ZonedDateTimeJavaDescriptor

public interface JavaTypeDescriptor<T>
extends Serializable

Descriptor for the Java side of a value mapping.

Author:

Steve Ebersole

Method Summary

Modifier and Type	Method and Description
default boolean	areEqual(T one, T another) Determine if two instances are equal
default int	extractHashCode(T value) Extract a proper hash code for this value.
default String	extractLoggableRepresentation(T value) Extract a loggable representation of the value.
T	fromString(String string)
default Comparator<T>	getComparator() Retrieve the natural comparator for this type.
default Class<T>	getJavaType() Get the Java type described
Class<T>	getJavaTypeClass() Deprecated. Use getJavaType() instead
default MutabilityPlan<T>	getMutabilityPlan() Retrieve the mutability plan for this Java type.
default String	toString(T value)
<X> X	unwrap(T value, Class<X> type, WrapperOptions options) Unwrap an instance of our handled Java type into the requested type.
<X> T	wrap(X value, WrapperOptions options) Wrap a value as our handled Java type.

Method Detail

getJavaTypeClass

@Deprecated
Class<T> getJavaTypeClass()

Deprecated. Use getJavaType() instead

Retrieve the Java type handled here.

Returns:

The Java type.

getJavaType

default Class<T> getJavaType()

Get the Java type described

getMutabilityPlan

default MutabilityPlan<T> getMutabilityPlan()

Retrieve the mutability plan for this Java type.

getComparator

default Comparator<T> getComparator()

Retrieve the natural comparator for this type.

extractHashCode

default int extractHashCode(T value)

Extract a proper hash code for this value.

Parameters:

value - The value for which to extract a hash code.

Returns:

The extracted hash code.

areEqual

default boolean areEqual(T one,
                         T another)

Determine if two instances are equal

Parameters:

one - One instance

another - The other instance

Returns:

True if the two are considered equal; false otherwise.

extractLoggableRepresentation

default String extractLoggableRepresentation(T value)

Extract a loggable representation of the value.

Parameters:

value - The value for which to extract a loggable representation.

Returns:

The loggable representation

toString

default String toString(T value)

fromString

T fromString(String string)

unwrap

<X> X unwrap(T value,
             Class<X> type,
             WrapperOptions options)

Unwrap an instance of our handled Java type into the requested type.

As an example, if this is a JavaTypeDescriptor<Integer> and we are asked to unwrap the Integer value as a Long we would return something like Long.valueOf( value.longValue() ).

Intended use is during PreparedStatement binding.

Type Parameters:

X - The conversion type.

Parameters:

value - The value to unwrap

type - The type as which to unwrap

options - The options

Returns:

The unwrapped value.

wrap

<X> T wrap(X value,
           WrapperOptions options)

Wrap a value as our handled Java type.

Intended use is during ResultSet extraction.

Type Parameters:

X - The conversion type.

Parameters:

value - The value to wrap.

options - The options

Returns:

The wrapped value.