Class CalendarJavaType

java.lang.Object

org.hibernate.type.descriptor.java.AbstractClassJavaType<Calendar>

org.hibernate.type.descriptor.java.AbstractTemporalJavaType<Calendar>

org.hibernate.type.descriptor.java.CalendarJavaType

All Implemented Interfaces:

Serializable, BasicJavaType<Calendar>, JavaType<Calendar>, TemporalJavaType<Calendar>, VersionJavaType<Calendar>

public class CalendarJavaType
extends AbstractTemporalJavaType<Calendar>
implements VersionJavaType<Calendar>

Descriptor for Calendar handling.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CalendarJavaType.CalendarMutabilityPlan

Nested classes/interfaces inherited from interface JavaType

JavaType.CoercionContext

Field Summary

Fields

Modifier and Type	Field	Description
static final CalendarJavaType	INSTANCE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CalendarJavaType()

Method Summary

Modifier and Type	Method	Description
boolean	areEqual(Calendar one, Calendar another)	Determine if two instances are equal
Calendar	cast(Object value)	Apply a simple type cast to the given value, without attempting any sort of coercion or wrapping.
Calendar	coerce(Object value)	Coerce the given value to this type, if possible.
int	extractHashCode(Calendar value)	Extract a proper hash code for the given value.
protected <X> TemporalJavaType<X>	forDatePrecision(TypeConfiguration typeConfiguration)
protected <X> TemporalJavaType<X>	forTimePrecision(TypeConfiguration typeConfiguration)
protected <X> TemporalJavaType<X>	forTimestampPrecision(TypeConfiguration typeConfiguration)
Calendar	fromString(CharSequence string)
int	getDefaultSqlPrecision(Dialect dialect, JdbcType jdbcType)	The default column precision when this Java type is mapped to a SQL data type which is parametrized by precision, for example Types.DECIMAL.
TemporalType	getPrecision()	The precision represented by this type
JdbcType	getRecommendedJdbcType(JdbcTypeIndicators context)	Obtain the "recommended" SQL type descriptor for this Java type.
boolean	isInstance(Object value)	Is the given value an instance of the described type?
boolean	isWider(JavaType<?> javaType)	Determines if this Java type is wider than the given Java type, that is, if the given type can be safely widened to this type.
Calendar	next(Calendar current, Long length, Integer precision, Integer scale, SharedSessionContractImplementor session)	Increment the version.
Calendar	seed(Long length, Integer precision, Integer scale, SharedSessionContractImplementor session)	Generate an initial version.
String	toString(Calendar value)
<X> X	unwrap(Calendar value, Class<X> type, WrapperOptions options)	Unwrap an instance of our handled Java type into the requested type.
<X> Calendar	wrap(X value, WrapperOptions options)	Wrap a value as our handled Java type.

Methods inherited from class AbstractTemporalJavaType

resolveTypeForPrecision, toString

Methods inherited from class AbstractClassJavaType

extractLoggableRepresentation, getComparator, getJavaType, getJavaTypeClass, getMutabilityPlan, unknownUnwrap, unknownWrap

Methods inherited from class Object

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

Methods inherited from interface JavaType

appendEncodedString, createJavaType, extractLoggableRepresentation, fromEncodedString, fromEncodedString, getCheckCondition, getComparator, getDefaultSqlLength, getDefaultSqlScale, getDefaultValue, getJavaType, getJavaTypeClass, getLongSqlLength, getMutabilityPlan, getReplacement, getTypeName, useObjectEqualsHashCode

Methods inherited from interface TemporalJavaType

isTemporalType

Field Details

INSTANCE

public static final CalendarJavaType INSTANCE

Constructor Details

CalendarJavaType

protected CalendarJavaType()

Method Details

getPrecision

public TemporalType getPrecision()

Description copied from interface: TemporalJavaType

The precision represented by this type

Specified by:

getPrecision in interface TemporalJavaType<Calendar>

getRecommendedJdbcType

public JdbcType getRecommendedJdbcType(JdbcTypeIndicators context)

Description copied from interface: BasicJavaType

Obtain the "recommended" SQL type descriptor for this Java type. Often, but not always, the source of this recommendation is the JDBC specification.

Specified by:

getRecommendedJdbcType in interface BasicJavaType<Calendar>

Specified by:

getRecommendedJdbcType in interface JavaType<Calendar>

Parameters:

context - Contextual information

Returns:

The recommended SQL type descriptor

forTimestampPrecision

protected <X> TemporalJavaType<X> forTimestampPrecision(TypeConfiguration typeConfiguration)

Overrides:

forTimestampPrecision in class AbstractTemporalJavaType<Calendar>

forDatePrecision

protected <X> TemporalJavaType<X> forDatePrecision(TypeConfiguration typeConfiguration)

Overrides:

forDatePrecision in class AbstractTemporalJavaType<Calendar>

forTimePrecision

protected <X> TemporalJavaType<X> forTimePrecision(TypeConfiguration typeConfiguration)

Overrides:

forTimePrecision in class AbstractTemporalJavaType<Calendar>

toString

public String toString(Calendar value)

Specified by:

toString in interface JavaType<Calendar>

fromString

public Calendar fromString(CharSequence string)

Specified by:

fromString in interface BasicJavaType<Calendar>

Specified by:

fromString in interface JavaType<Calendar>

areEqual

public boolean areEqual(Calendar one,
 Calendar another)

Description copied from interface: JavaType

Determine if two instances are equal

Specified by:

areEqual in interface JavaType<Calendar>

Overrides:

areEqual in class AbstractClassJavaType<Calendar>

Parameters:

one - One instance

another - The other instance

Returns:

True if the two are considered equal; false otherwise.

extractHashCode

public int extractHashCode(Calendar value)

Description copied from interface: JavaType

Extract a proper hash code for the given value.

Specified by:

extractHashCode in interface JavaType<Calendar>

Overrides:

extractHashCode in class AbstractClassJavaType<Calendar>

Parameters:

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

Returns:

The extracted hash code.

isInstance

public boolean isInstance(Object value)

Description copied from interface: JavaType

Is the given value an instance of the described type?

Usually just getJavaTypeClass().isInstance(value), but some descriptors need specialized semantics, for example, the descriptors for java.sql.Date, java.sql.Time, and java.sql.Timestamp.

For EntityJavaType, this method handles proxies in a semantically correct way, by checking the entity instance underlying the proxy object.

Specified by:

isInstance in interface JavaType<Calendar>

cast

public Calendar cast(Object value)

Description copied from interface: JavaType

Apply a simple type cast to the given value, without attempting any sort of coercion or wrapping. This method is provided as a convenient way to avoid an unchecked cast to a type variable. Use javaType.cast(value) instead of (T) value wherever possible.

Usually just getJavaTypeClass().cast(value), but overridden in some cases as an "optimization". This optimization is almost certainly unnecessary, and might even indeed be harmful, since Class.cast() is an intrinsic.

Specified by:

cast in interface JavaType<Calendar>

coerce

public Calendar coerce(Object value)

Description copied from interface: JavaType

Coerce the given value to this type, if possible.

This method differs from wrap() in that it allows simple, basic, implicit type conversions, and does not require WrapperOptions. The wrap() method may be thought of as offering explicitly requested type conversions driven by a choice of JdbcType.

An implementation of this method reports failure in one of two ways, by:

• throwing CoercionException, or
• simply returning the given uncoerced value.

Therefore, this method is declared to return Object. In case immediate coercion is required, the following idiom may be used:

javaType.cast(javaType.coerce(value))

Specified by:

coerce in interface JavaType<Calendar>

Parameters:

value - The value to coerce

Returns:

The coerced value, or the given value if no coercion was possible

unwrap

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

Description copied from interface: JavaType

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

As an example, if this is a JavaType<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.

Specified by:

unwrap in interface JavaType<Calendar>

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

public <X> Calendar wrap(X value,
 WrapperOptions options)

Description copied from interface: JavaType

Wrap a value as our handled Java type.

Intended use is during ResultSet extraction.

Specified by:

wrap in interface JavaType<Calendar>

Type Parameters:

X - The conversion type.

Parameters:

value - The value to wrap.

options - The options

Returns:

The wrapped value.

isWider

public boolean isWider(JavaType<?> javaType)

Description copied from interface: JavaType

Determines if this Java type is wider than the given Java type, that is, if the given type can be safely widened to this type.

Specified by:

isWider in interface JavaType<Calendar>

getDefaultSqlPrecision

public int getDefaultSqlPrecision(Dialect dialect,
 JdbcType jdbcType)

Description copied from interface: JavaType

The default column precision when this Java type is mapped to a SQL data type which is parametrized by precision, for example Types.DECIMAL.

Specified by:

getDefaultSqlPrecision in interface JavaType<Calendar>

Returns:

Size.DEFAULT_PRECISION unless overridden

next

public Calendar next(Calendar current,
 Long length,
 Integer precision,
 Integer scale,
 SharedSessionContractImplementor session)

Description copied from interface: VersionJavaType

Increment the version.

Specified by:

next in interface VersionJavaType<Calendar>

Parameters:

current - the current version

length - The length of the type

precision - The precision of the type

scale - The scale of the type

session - The session from which this request originates.

Returns:

an instance of the type

seed

public Calendar seed(Long length,
 Integer precision,
 Integer scale,
 SharedSessionContractImplementor session)

Description copied from interface: VersionJavaType

Generate an initial version.

Note that this operation is only used when the program sets a null or negative number as the value of the entity version field. It is not called when the program sets the version field to a sensible-looking version.

Specified by:

seed in interface VersionJavaType<Calendar>

Parameters:

length - The length of the type

precision - The precision of the type

scale - The scale of the type

session - The session from which this request originates.

Returns:

an instance of the type