Class JdbcTimeJavaType

java.lang.Object
org.hibernate.type.descriptor.java.AbstractClassJavaType<Date>
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:
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.

  • Field Details

  • Constructor Details

    • JdbcTimeJavaType

      public JdbcTimeJavaType()

  • Method Details

    • getPrecision

      public TemporalType getPrecision()
      Description copied from interface: TemporalJavaType
      The precision represented by this type

    • getJavaType

      public Class<Date> getJavaType()
      Description copied from interface: JavaType
      Get the Java type (a Type object) described by this JavaType.
      Specified by:
      getJavaType in interface JavaType<Date>
      Overrides:
      getJavaType in class AbstractClassJavaType<Date>
      See Also:

    • 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.

    • cast

      public Date 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.

    • 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)
      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:

      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))
      Parameters:
      value - The value to coerce
      Returns:
      The coerced value, or the given value if no coercion was possible

    • unwrap

      public <X> X unwrap(Date 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.

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