Package org.hibernate.type.descriptor.java

Class JdbcTimeJavaType

java.lang.Object

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

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

org.hibernate.type.descriptor.java.JdbcTimeJavaType

All Implemented Interfaces:

Serializable, BasicJavaType<Date>, JavaType<Date>, TemporalJavaType<Date>

public class JdbcTimeJavaType
extends AbstractTemporalJavaType<Date>

Descriptor for Time handling.

See Also:

Serialized Form

Implementation Specification:

Unlike most JavaType implementations, can handle 2 different "domain representations" (most map just a single type): general Date values in addition to Time values. This capability is shared with JdbcDateJavaType and JdbcTimestampJavaType.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	JdbcTimeJavaType.TimeMutabilityPlan

Nested classes/interfaces inherited from interface org.hibernate.type.descriptor.java.JavaType

JavaType.CoercionContext

Field Summary

Fields

Modifier and Type	Field	Description
static JdbcTimeJavaType	INSTANCE
static DateTimeFormatter	LITERAL_FORMATTER
static DateTimeFormatter	LOGGABLE_FORMATTER	Alias for DateTimeFormatter.ISO_LOCAL_TIME.
static String	TIME_FORMAT

Constructor Summary

Constructors

Constructor	Description
JdbcTimeJavaType()

Method Summary

Modifier and Type	Method	Description
void	appendEncodedString(SqlAppender sb, Date value)	Appends the value to the SqlAppender in an encoded format that can be decoded again by JavaType.fromEncodedString(CharSequence, int, int).
boolean	areEqual(Date one, Date another)	Determine if two instances are equal
Date	coerce(Object value, JavaType.CoercionContext coercionContext)
int	extractHashCode(Date value)	Extract a proper hash code for the given value.
protected <X> TemporalJavaType<X>	forTimePrecision(TypeConfiguration typeConfiguration)
Date	fromEncodedString(CharSequence charSequence, int start, int end)	Reads the encoded value from the char sequence start index until the end index and returns the decoded value.
Date	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?
String	toString(Date value)
Object	unwrap(Date value, Class type, WrapperOptions options)	Unwrap an instance of our handled Java type into the requested type.
Date	wrap(Object value, WrapperOptions options)	Wrap a value as our handled Java type.

Methods inherited from class org.hibernate.type.descriptor.java.AbstractTemporalJavaType

forDatePrecision, forTimestampPrecision, resolveTypeForPrecision, toString

Methods inherited from class org.hibernate.type.descriptor.java.AbstractClassJavaType

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hibernate.type.descriptor.java.JavaType

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

Methods inherited from interface org.hibernate.type.descriptor.java.TemporalJavaType

isTemporalType

Field Detail

INSTANCE

public static final JdbcTimeJavaType INSTANCE

TIME_FORMAT

public static final String TIME_FORMAT

See Also:

Constant Field Values

LITERAL_FORMATTER

public static final DateTimeFormatter LITERAL_FORMATTER

LOGGABLE_FORMATTER

public static final DateTimeFormatter LOGGABLE_FORMATTER

Alias for DateTimeFormatter.ISO_LOCAL_TIME. Intended for use with logging

See Also:

LITERAL_FORMATTER

Constructor Detail

JdbcTimeJavaType

public JdbcTimeJavaType()

Method Detail

getPrecision

public TemporalType getPrecision()

Description copied from interface: TemporalJavaType

The precision represented by this type

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.

extractHashCode

public int extractHashCode(Date value)

Description copied from interface: JavaType

Extract a proper hash code for the given value.

Specified by:

extractHashCode in interface JavaType<Date>

Overrides:

extractHashCode in class AbstractClassJavaType<Date>

Parameters:

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

Returns:

The extracted hash code.

areEqual

public boolean areEqual(Date one,
                        Date another)

Description copied from interface: JavaType

Determine if two instances are equal

Specified by:

areEqual in interface JavaType<Date>

Overrides:

areEqual in class AbstractClassJavaType<Date>

Parameters:

one - One instance

another - The other instance

Returns:

True if the two are considered equal; false otherwise.

coerce

public Date coerce(Object value,
                   JavaType.CoercionContext coercionContext)

unwrap

public Object unwrap(Date value,
                     Class 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.

Parameters:

value - The value to unwrap

type - The type as which to unwrap

options - The options

Returns:

The unwrapped value.

wrap

public Date wrap(Object value,
                 WrapperOptions options)

Description copied from interface: JavaType

Wrap a value as our handled Java type.

Intended use is during ResultSet extraction.

Parameters:

value - The value to wrap.

options - The options

Returns:

The wrapped value.

toString

public String toString(Date value)

fromString

public Date fromString(CharSequence string)

fromEncodedString

public Date fromEncodedString(CharSequence charSequence,
                              int start,
                              int end)

Description copied from interface: JavaType

Reads the encoded value from the char sequence start index until the end index and returns the decoded value. Implementers do not need to care about escaping. This is similar to JavaType.fromString(CharSequence), with the difference that the aim of this method is decoding from a range within an existing char sequence.

appendEncodedString

public void appendEncodedString(SqlAppender sb,
                                Date value)

Description copied from interface: JavaType

Appends the value to the SqlAppender in an encoded format that can be decoded again by JavaType.fromEncodedString(CharSequence, int, int). Implementers do not need to care about escaping. This is similar to JavaType.toString(Object), with the difference that the aim of this method is encoding to the appender.

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.

Parameters:

context - Contextual information

Returns:

The recommended SQL type descriptor

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.

Returns:

Size.DEFAULT_PRECISION unless overridden

forTimePrecision

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

Overrides:

forTimePrecision in class AbstractTemporalJavaType<Date>