AbstractStandardBasicType
approach instead@Deprecated public abstract class NullableType extends AbstractType implements StringRepresentableType, XmlRepresentableType
LEGACY_DEFAULT_SIZE, LEGACY_DICTATED_SIZE
Constructor and Description |
---|
NullableType()
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
Size |
defaultSize()
Deprecated.
A convenience form of
defaultSizes(org.hibernate.engine.spi.Mapping) , returning just a single size since we are explicitly dealing with
single column mappings here. |
Size[] |
defaultSizes(Mapping mapping)
Deprecated.
Defines the column sizes to use according to this type if the user did not explicitly say (and if no
Type.dictatedSizes(org.hibernate.engine.spi.Mapping) were given). |
Size |
dictatedSize()
Deprecated.
A convenience form of
dictatedSizes(org.hibernate.engine.spi.Mapping) , returning just a single size since we are explicitly dealing with
single column mappings here. |
Size[] |
dictatedSizes(Mapping mapping)
Deprecated.
Return the column sizes dictated by this type.
|
abstract Object |
fromStringValue(String xml)
Deprecated.
Consume the given string representation back into this types java form.
|
Object |
fromXMLNode(org.dom4j.Node xml,
Mapping factory)
Deprecated.
Parse the XML representation of an instance.
|
Object |
fromXMLString(String xml,
Mapping factory)
Deprecated.
|
abstract Object |
get(ResultSet rs,
String name)
Deprecated.
Get a column value from a result set, without worrying about the
possibility of null values.
|
int |
getColumnSpan(Mapping session)
Deprecated.
How many columns are used to persist this type.
|
boolean |
isDirty(Object old,
Object current,
boolean[] checkable,
SessionImplementor session)
Deprecated.
Should the parent be considered dirty, given both the old and current value?
|
boolean |
isEqual(Object x,
Object y)
Deprecated.
Compare two instances of the class mapped by this type for persistence "equality" (equality of persistent
state).
|
Object |
nullSafeGet(ResultSet rs,
String name)
Deprecated.
|
Object |
nullSafeGet(ResultSet rs,
String[] names)
Deprecated.
|
Object |
nullSafeGet(ResultSet rs,
String[] names,
SessionImplementor session,
Object owner)
Deprecated.
Extract a value of the
mapped class from the JDBC result set. |
Object |
nullSafeGet(ResultSet rs,
String name,
SessionImplementor session,
Object owner)
Deprecated.
Extract a value of the
mapped class from the JDBC result set. |
void |
nullSafeSet(PreparedStatement st,
Object value,
int index)
Deprecated.
|
void |
nullSafeSet(PreparedStatement st,
Object value,
int index,
boolean[] settable,
SessionImplementor session)
Deprecated.
Bind a value represented by an instance of the
mapped class to the JDBC prepared
statement, ignoring some columns as dictated by the 'settable' parameter. |
void |
nullSafeSet(PreparedStatement st,
Object value,
int index,
SessionImplementor session)
Deprecated.
Bind a value represented by an instance of the
mapped class to the JDBC prepared
statement. |
String |
nullSafeToString(Object value)
Deprecated.
A null-safe version of
toString(Object) . |
abstract void |
set(PreparedStatement st,
Object value,
int index)
Deprecated.
Set a parameter value without worrying about the possibility of null
values.
|
void |
setToXMLNode(org.dom4j.Node xml,
Object value,
SessionFactoryImplementor factory)
Deprecated.
A representation of the value to be embedded in an XML element.
|
abstract int |
sqlType()
Deprecated.
A convenience form of
sqlTypes(org.hibernate.engine.spi.Mapping) , returning
just a single type value since these are explicitly dealing with single column
mappings. |
int[] |
sqlTypes(Mapping session)
Deprecated.
Return the JDBC types codes (per
Types ) for the columns mapped by this type. |
boolean[] |
toColumnNullness(Object value,
Mapping mapping)
Deprecated.
Given an instance of the type, return an array of boolean, indicating
which mapped columns would be null.
|
String |
toLoggableString(Object value,
SessionFactoryImplementor factory)
Deprecated.
Generate a representation of the value for logging purposes.
|
abstract String |
toString(Object value)
Deprecated.
Render the value to the string representation.
|
String |
toXMLString(Object value,
SessionFactoryImplementor pc)
Deprecated.
|
assemble, beforeAssemble, compare, disassemble, getHashCode, getHashCode, getSemiResolvedType, hydrate, isAnyType, isAssociationType, isCollectionType, isComponentType, isDirty, isEntityType, isEqual, isModified, isSame, isXMLElement, replace, replaceNode, resolve, semiResolve
public abstract int sqlType()
sqlTypes(org.hibernate.engine.spi.Mapping)
, returning
just a single type value since these are explicitly dealing with single column
mappings.Types
mapping value.public Size dictatedSize()
dictatedSizes(org.hibernate.engine.spi.Mapping)
, returning just a single size since we are explicitly dealing with
single column mappings here.Types
mapping value.public Size defaultSize()
defaultSizes(org.hibernate.engine.spi.Mapping)
, returning just a single size since we are explicitly dealing with
single column mappings here.Types
mapping value.public abstract Object get(ResultSet rs, String name) throws HibernateException, SQLException
nullSafeGet(java.sql.ResultSet, java.lang.String[], org.hibernate.engine.spi.SessionImplementor, java.lang.Object)
after
nullness checks have been performed.rs
- The result set from which to extract the value.name
- The name of the value to extract.HibernateException
- Generally some form of mismatch error.SQLException
- Indicates problem making the JDBC call(s).public abstract void set(PreparedStatement st, Object value, int index) throws HibernateException, SQLException
nullSafeSet(java.sql.PreparedStatement, java.lang.Object, int, boolean[], org.hibernate.engine.spi.SessionImplementor)
after nullness checks have
been performed.st
- The statement into which to bind the parameter value.value
- The parameter value to bind.index
- The position or index at which to bind the param value.HibernateException
- Generally some form of mismatch error.SQLException
- Indicates problem making the JDBC call(s).public String nullSafeToString(Object value) throws HibernateException
toString(Object)
. Specifically we are
worried about null safeness in regards to the incoming value parameter,
not the return.value
- The value to convert to a string representation; may be null.HibernateException
- Thrown by toString(Object)
, which this calls.public abstract String toString(Object value) throws HibernateException
StringRepresentableType
toString
in interface StringRepresentableType
value
- The value to render to string.HibernateException
- Problem renderingpublic abstract Object fromStringValue(String xml) throws HibernateException
StringRepresentableType
fromStringValue
in interface StringRepresentableType
xml
- The string representation to be consumed.HibernateException
- Problem consumingpublic final void nullSafeSet(PreparedStatement st, Object value, int index, boolean[] settable, SessionImplementor session) throws HibernateException, SQLException
Type
mapped class
to the JDBC prepared
statement, ignoring some columns as dictated by the 'settable' parameter. Implementors should handle the
possibility of null values. A multi-column type should bind parameters starting from index.nullSafeSet
in interface Type
st
- The JDBC prepared statement to which to bindvalue
- the object to writeindex
- starting parameter bind indexsettable
- an array indicating which columns to bind/ignoresession
- The originating sessionHibernateException
- An error from HibernateSQLException
- An error from the JDBC driverpublic final void nullSafeSet(PreparedStatement st, Object value, int index, SessionImplementor session) throws HibernateException, SQLException
Type
mapped class
to the JDBC prepared
statement. Implementors should handle possibility of null values. A multi-column type should bind parameters
starting from index.nullSafeSet
in interface Type
st
- The JDBC prepared statement to which to bindvalue
- the object to writeindex
- starting parameter bind indexsession
- The originating sessionHibernateException
- An error from HibernateSQLException
- An error from the JDBC driverpublic final void nullSafeSet(PreparedStatement st, Object value, int index) throws HibernateException, SQLException
HibernateException
SQLException
public final Object nullSafeGet(ResultSet rs, String[] names, SessionImplementor session, Object owner) throws HibernateException, SQLException
Type
mapped class
from the JDBC result set. Implementors
should handle possibility of null values.nullSafeGet
in interface Type
rs
- The result set from which to extract value.names
- the column names making up this type value (use to read from result set)session
- The originating sessionowner
- the parent entityHibernateException
- An error from HibernateSQLException
- An error from the JDBC driveralternative, 2-phase property initialization
public final Object nullSafeGet(ResultSet rs, String[] names) throws HibernateException, SQLException
HibernateException
SQLException
public final Object nullSafeGet(ResultSet rs, String name) throws HibernateException, SQLException
HibernateException
SQLException
public final Object nullSafeGet(ResultSet rs, String name, SessionImplementor session, Object owner) throws HibernateException, SQLException
Type
mapped class
from the JDBC result set. Implementors
should handle possibility of null values. This form might be called if the type is known to be a
single-column type.nullSafeGet
in interface Type
rs
- The result set from which to extract value.name
- the column name making up this type value (use to read from result set)session
- The originating sessionowner
- the parent entityHibernateException
- An error from HibernateSQLException
- An error from the JDBC driverpublic final String toXMLString(Object value, SessionFactoryImplementor pc) throws HibernateException
toXMLString
in interface XmlRepresentableType
HibernateException
public final Object fromXMLString(String xml, Mapping factory) throws HibernateException
fromXMLString
in interface XmlRepresentableType
HibernateException
public final int getColumnSpan(Mapping session)
Type
sqlTypes(mapping).length
getColumnSpan
in interface Type
session
- The mapping object :/public final int[] sqlTypes(Mapping session)
Type
Types
) for the columns mapped by this type.
NOTE: The number of elements in this array matches the return from Type.getColumnSpan(org.hibernate.engine.spi.Mapping)
.public Size[] dictatedSizes(Mapping mapping) throws MappingException
Type
char
/Character
would
have a dictated length limit of 1; for a string-based UUID
would have a size limit of 36; etc.
NOTE: The number of elements in this array matches the return from Type.getColumnSpan(org.hibernate.engine.spi.Mapping)
.dictatedSizes
in interface Type
mapping
- The mapping object :/MappingException
- Generally indicates an issue accessing the passed mapping object.public Size[] defaultSizes(Mapping mapping) throws MappingException
Type
Type.dictatedSizes(org.hibernate.engine.spi.Mapping)
were given).
NOTE: The number of elements in this array matches the return from Type.getColumnSpan(org.hibernate.engine.spi.Mapping)
.defaultSizes
in interface Type
mapping
- The mapping object :/MappingException
- Generally indicates an issue accessing the passed mapping object.public boolean isEqual(Object x, Object y)
Type
isEqual
in interface Type
isEqual
in class AbstractType
x
- The first valuey
- The second valuepublic String toLoggableString(Object value, SessionFactoryImplementor factory)
Type
toLoggableString
in interface Type
value
- The value to be loggedfactory
- The session factorypublic Object fromXMLNode(org.dom4j.Node xml, Mapping factory) throws HibernateException
Type
fromXMLNode
in interface Type
xml
- The XML node from which to read the valuefactory
- The session factorymapped class
HibernateException
- An error from Hibernatepublic void setToXMLNode(org.dom4j.Node xml, Object value, SessionFactoryImplementor factory) throws HibernateException
Type
setToXMLNode
in interface Type
xml
- The XML node to which to write the valuevalue
- The value to writefactory
- The session factoryHibernateException
- An error from Hibernatepublic boolean[] toColumnNullness(Object value, Mapping mapping)
Type
toColumnNullness
in interface Type
value
- an instance of the typemapping
- The mapping abstractionpublic boolean isDirty(Object old, Object current, boolean[] checkable, SessionImplementor session) throws HibernateException
Type
isDirty
in interface Type
old
- the old valuecurrent
- the current valuecheckable
- An array of booleans indicating which columns making up the value are actually checkablesession
- The session from which the request originated.HibernateException
- A problem occurred performing the checkingCopyright © 2001-2013 Red Hat, Inc. All Rights Reserved.