org.hibernate.type

Class EnumType

java.lang.Object

org.hibernate.type.EnumType

All Implemented Interfaces:

java.io.Serializable, EnhancedUserType, ParameterizedType, UserType

public class EnumType
extends java.lang.Object
implements EnhancedUserType, ParameterizedType, java.io.Serializable

Enum type mapper Try and find the appropriate SQL type depending on column metadata

TODO implements readobject/writeobject to recalculate the enumclasses

Author:

Emmanuel Bernard, Hardy Ferentschik

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CATALOG
static java.lang.String	COLUMN
static java.lang.String	ENUM
static java.lang.String	SCHEMA
static java.lang.String	TABLE
static java.lang.String	TYPE

Constructor Summary

Constructors

Constructor and Description
EnumType()

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	assemble(java.io.Serializable cached, java.lang.Object owner) Reconstruct an object from the cacheable representation.
java.lang.Object	deepCopy(java.lang.Object value) Return a deep copy of the persistent state, stopping at entities and at collections.
java.io.Serializable	disassemble(java.lang.Object value) Transform the object into its cacheable representation.
boolean	equals(java.lang.Object x, java.lang.Object y) Compare two instances of the class mapped by this type for persistence "equality".
java.lang.Object	fromXMLString(java.lang.String xmlValue) Parse a string representation of this value, as it appears in an XML document
int	hashCode(java.lang.Object x) Get a hashcode for the instance, consistent with persistence "equality"
boolean	isMutable() Are objects of this type mutable?
java.lang.Object	nullSafeGet(java.sql.ResultSet rs, java.lang.String[] names, java.lang.Object owner) Retrieve an instance of the mapped class from a JDBC resultset.
void	nullSafeSet(java.sql.PreparedStatement st, java.lang.Object value, int index) Write an instance of the mapped class to a prepared statement.
java.lang.String	objectToSQLString(java.lang.Object value) Return an SQL literal representation of the value
java.lang.Object	replace(java.lang.Object original, java.lang.Object target, java.lang.Object owner) During merge, replace the existing (target) value in the entity we are merging to with a new (original) value from the detached entity we are merging.
java.lang.Class<? extends java.lang.Enum>	returnedClass() The class returned by nullSafeGet().
void	setParameterValues(java.util.Properties parameters) Gets called by Hibernate to pass the configured type parameters to the implementation.
int[]	sqlTypes() Return the SQL type codes for the columns mapped by this type.
java.lang.String	toXMLString(java.lang.Object value) Return a string representation of this value, as it should appear in an XML document

Methods inherited from class java.lang.Object

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

Field Detail

ENUM

public static final java.lang.String ENUM

See Also:

Constant Field Values

SCHEMA

public static final java.lang.String SCHEMA

See Also:

Constant Field Values

CATALOG

public static final java.lang.String CATALOG

See Also:

Constant Field Values

TABLE

public static final java.lang.String TABLE

See Also:

Constant Field Values

COLUMN

public static final java.lang.String COLUMN

See Also:

Constant Field Values

TYPE

public static final java.lang.String TYPE

See Also:

Constant Field Values

Constructor Detail

EnumType

public EnumType()

Method Detail

sqlTypes

public int[] sqlTypes()

Description copied from interface: UserType

Return the SQL type codes for the columns mapped by this type. The codes are defined on java.sql.Types.

Specified by:

sqlTypes in interface UserType

Returns:

int[] the typecodes

See Also:

Types

returnedClass

public java.lang.Class<? extends java.lang.Enum> returnedClass()

Description copied from interface: UserType

The class returned by nullSafeGet().

Specified by:

returnedClass in interface UserType

Returns:

Class

equals

public boolean equals(java.lang.Object x,
             java.lang.Object y)
               throws HibernateException

Description copied from interface: UserType

Compare two instances of the class mapped by this type for persistence "equality". Equality of the persistent state.

Specified by:

equals in interface UserType

Returns:

boolean

Throws:

HibernateException

hashCode

public int hashCode(java.lang.Object x)
             throws HibernateException

Description copied from interface: UserType

Get a hashcode for the instance, consistent with persistence "equality"

Specified by:

hashCode in interface UserType

Throws:

HibernateException

nullSafeGet

public java.lang.Object nullSafeGet(java.sql.ResultSet rs,
                           java.lang.String[] names,
                           java.lang.Object owner)
                             throws HibernateException,
                                    java.sql.SQLException

Description copied from interface: UserType

Retrieve an instance of the mapped class from a JDBC resultset. Implementors should handle possibility of null values.

Specified by:

nullSafeGet in interface UserType

Parameters:

rs - a JDBC result set

names - the column names

owner - the containing entity

Returns:

Object

Throws:

HibernateException

java.sql.SQLException

nullSafeSet

public void nullSafeSet(java.sql.PreparedStatement st,
               java.lang.Object value,
               int index)
                 throws HibernateException,
                        java.sql.SQLException

Description copied from interface: UserType

Write an instance of the mapped class to a prepared statement. Implementors should handle possibility of null values. A multi-column type should be written to parameters starting from index.

Specified by:

nullSafeSet in interface UserType

Parameters:

st - a JDBC prepared statement

value - the object to write

index - statement parameter index

Throws:

HibernateException

java.sql.SQLException

deepCopy

public java.lang.Object deepCopy(java.lang.Object value)
                          throws HibernateException

Description copied from interface: UserType

Return a deep copy of the persistent state, stopping at entities and at collections. It is not necessary to copy immutable objects, or null values, in which case it is safe to simply return the argument.

Specified by:

deepCopy in interface UserType

Parameters:

value - the object to be cloned, which may be null

Returns:

Object a copy

Throws:

HibernateException

isMutable

public boolean isMutable()

Description copied from interface: UserType

Are objects of this type mutable?

Specified by:

isMutable in interface UserType

Returns:

boolean

disassemble

public java.io.Serializable disassemble(java.lang.Object value)
                                 throws HibernateException

Description copied from interface: UserType

Transform the object into its cacheable representation. At the very least this method should perform a deep copy if the type is mutable. That may not be enough for some implementations, however; for example, associations must be cached as identifier values. (optional operation)

Specified by:

disassemble in interface UserType

Parameters:

value - the object to be cached

Returns:

a cachable representation of the object

Throws:

HibernateException

assemble

public java.lang.Object assemble(java.io.Serializable cached,
                        java.lang.Object owner)
                          throws HibernateException

Description copied from interface: UserType

Reconstruct an object from the cacheable representation. At the very least this method should perform a deep copy if the type is mutable. (optional operation)

Specified by:

assemble in interface UserType

Parameters:

cached - the object to be cached

owner - the owner of the cached object

Returns:

a reconstructed object from the cachable representation

Throws:

HibernateException

replace

public java.lang.Object replace(java.lang.Object original,
                       java.lang.Object target,
                       java.lang.Object owner)
                         throws HibernateException

Description copied from interface: UserType

During merge, replace the existing (target) value in the entity we are merging to with a new (original) value from the detached entity we are merging. For immutable objects, or null values, it is safe to simply return the first parameter. For mutable objects, it is safe to return a copy of the first parameter. For objects with component values, it might make sense to recursively replace component values.

Specified by:

replace in interface UserType

Parameters:

original - the value from the detached entity being merged

target - the value in the managed entity

Returns:

the value to be merged

Throws:

HibernateException

setParameterValues

public void setParameterValues(java.util.Properties parameters)

Description copied from interface: ParameterizedType

Gets called by Hibernate to pass the configured type parameters to the implementation.

Specified by:

setParameterValues in interface ParameterizedType

objectToSQLString

public java.lang.String objectToSQLString(java.lang.Object value)

Description copied from interface: EnhancedUserType

Return an SQL literal representation of the value

Specified by:

objectToSQLString in interface EnhancedUserType

toXMLString

public java.lang.String toXMLString(java.lang.Object value)

Description copied from interface: EnhancedUserType

Return a string representation of this value, as it should appear in an XML document

Specified by:

toXMLString in interface EnhancedUserType

fromXMLString

public java.lang.Object fromXMLString(java.lang.String xmlValue)

Description copied from interface: EnhancedUserType

Parse a string representation of this value, as it appears in an XML document

Specified by:

fromXMLString in interface EnhancedUserType