Package org.springframework.data.jdbc.core.convert

Class MappingJdbcConverter

java.lang.Object

org.springframework.data.relational.core.conversion.AbstractRelationalConverter

org.springframework.data.relational.core.conversion.MappingRelationalConverter

org.springframework.data.jdbc.core.convert.MappingJdbcConverter

All Implemented Interfaces:

Aware, ApplicationContextAware, JdbcConverter, RelationalConverter

Direct Known Subclasses:

BasicJdbcConverter

public class MappingJdbcConverter
extends MappingRelationalConverter
implements JdbcConverter, ApplicationContextAware

RelationalConverter that uses a MappingContext to apply conversion of relational values to property values.

Conversion is configurable by providing a customized CustomConversions.

Since:

3.2

Author:

Mark Paluch, Jens Schauder, Christoph Strobl, Myeonghyeon Lee, Chirag Tailor

See Also:

• MappingContext
• SimpleTypeHolder
• CustomConversions

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.data.relational.core.conversion.MappingRelationalConverter

MappingRelationalConverter.AggregatePathValueProvider, MappingRelationalConverter.ConversionContext, MappingRelationalConverter.DefaultConversionContext, MappingRelationalConverter.DocumentValueProvider, MappingRelationalConverter.ProjectingConversionContext, MappingRelationalConverter.RelationalPropertyValueProvider

Constructor Summary

Constructors

Constructor	Description
MappingJdbcConverter(RelationalMappingContext context, RelationResolver relationResolver)	Creates a new MappingJdbcConverter given MappingContext and a no-op type factory throwing UnsupportedOperationException on type creation.
MappingJdbcConverter(RelationalMappingContext context, RelationResolver relationResolver, CustomConversions conversions, JdbcTypeFactory typeFactory)	Creates a new MappingJdbcConverter given MappingContext.

Method Summary

Modifier and Type	Method	Description
Class<?>	getColumnType(RelationalPersistentProperty property)	The type to be used to store this property in the database.
SQLType	getTargetSqlType(RelationalPersistentProperty property)	The SQL type constant used when using this property as a parameter for a SQL statement.
protected MappingRelationalConverter.RelationalPropertyValueProvider	newValueProvider(RowDocumentAccessor documentAccessor, SpELExpressionEvaluator evaluator, MappingRelationalConverter.ConversionContext context)
<R> R	readAndResolve(Class<R> type, RowDocument source, Identifier identifier)	Read a RowDocument into the requested aggregate type and resolve references by looking these up from RelationResolver.
Object	readValue(Object value, TypeInformation<?> type)	Read a relational value into the desired destination type.
JdbcValue	writeJdbcValue(Object value, Class<?> columnType, SQLType sqlType)	Convert a property value into a JdbcValue that contains the converted value and information how to bind it to JDBC parameters.
Object	writeValue(Object value, TypeInformation<?> type)	Write a property value into a relational type that can be stored natively.

Methods inherited from class org.springframework.data.relational.core.conversion.MappingRelationalConverter

createInstance, doReadProjection, getConversionContext, getPotentiallyConvertedSimpleRead, getPropertyAccessor, introspectProjection, newProjectingConversionContext, project, read, read, readAggregate, readAggregate, readCollectionOrArray, readMap, setApplicationContext

Methods inherited from class org.springframework.data.relational.core.conversion.AbstractRelationalConverter

getConversions, getConversionService, getEntityInstantiators, getMappingContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.context.ApplicationContextAware

setApplicationContext

Methods inherited from interface org.springframework.data.jdbc.core.convert.JdbcConverter

getMappingContext, mapRow, mapRow, readAndResolve

Methods inherited from interface org.springframework.data.relational.core.conversion.RelationalConverter

createInstance, getConversionService, getEntityInstantiators, getPropertyAccessor, introspectProjection, project, read

Constructor Details

MappingJdbcConverter

public MappingJdbcConverter(RelationalMappingContext context,
 RelationResolver relationResolver)

Creates a new MappingJdbcConverter given MappingContext and a no-op type factory throwing UnsupportedOperationException on type creation. Use MappingJdbcConverter(RelationalMappingContext, RelationResolver, CustomConversions, JdbcTypeFactory) (MappingContext, RelationResolver, JdbcTypeFactory)} to convert arrays and large objects into JDBC-specific types.

Parameters:

context - must not be null.

relationResolver - used to fetch additional relations from the database. Must not be null.

MappingJdbcConverter

public MappingJdbcConverter(RelationalMappingContext context,
 RelationResolver relationResolver,
 CustomConversions conversions,
 JdbcTypeFactory typeFactory)

Creates a new MappingJdbcConverter given MappingContext.

Parameters:

context - must not be null.

relationResolver - used to fetch additional relations from the database. Must not be null.

typeFactory - must not be null

Method Details

getTargetSqlType

public SQLType getTargetSqlType(RelationalPersistentProperty property)

Description copied from interface: JdbcConverter

The SQL type constant used when using this property as a parameter for a SQL statement.

Specified by:

getTargetSqlType in interface JdbcConverter

Returns:

Must not be null.

See Also:

• Types

getColumnType

public Class<?> getColumnType(RelationalPersistentProperty property)

Description copied from interface: JdbcConverter

The type to be used to store this property in the database. Multidimensional arrays are unwrapped to reflect a top-level array type (e.g. String[][] returns String[]).

Specified by:

getColumnType in interface JdbcConverter

Returns:

a Class that is suitable for usage with JDBC drivers.

See Also:

• JdbcUtil.targetSqlTypeFor(Class)

readValue

@Nullable
public Object readValue(@Nullable
 Object value,
 TypeInformation<?> type)

Description copied from interface: RelationalConverter

Read a relational value into the desired destination type.

Specified by:

readValue in interface RelationalConverter

Overrides:

readValue in class MappingRelationalConverter

Parameters:

value - a value as it is returned by the driver accessing the persistence store. May be null.

type - TypeInformation into which the value is to be converted. Must not be null.

Returns:

The converted value. May be null.

writeValue

@Nullable
public Object writeValue(@Nullable
 Object value,
 TypeInformation<?> type)

Description copied from interface: RelationalConverter

Write a property value into a relational type that can be stored natively.

Specified by:

writeValue in interface RelationalConverter

Overrides:

writeValue in class MappingRelationalConverter

Parameters:

value - a value as it is used in the object model. May be null.

type - TypeInformation into which the value is to be converted. Must not be null.

Returns:

The converted value. May be null.

writeJdbcValue

public JdbcValue writeJdbcValue(@Nullable
 Object value,
 Class<?> columnType,
 SQLType sqlType)

Description copied from interface: JdbcConverter

Convert a property value into a JdbcValue that contains the converted value and information how to bind it to JDBC parameters.

Specified by:

writeJdbcValue in interface JdbcConverter

Parameters:

value - a value as it is used in the object model. May be null.

columnType - Class into which the value is to be converted. Must not be null.

sqlType - the SQLType to be used if non is specified by a converter.

Returns:

The converted value wrapped in a JdbcValue. Guaranteed to be not null.

readAndResolve

public <R> R readAndResolve(Class<R> type,
 RowDocument source,
 Identifier identifier)

Description copied from interface: JdbcConverter

Read a RowDocument into the requested aggregate type and resolve references by looking these up from RelationResolver.

Specified by:

readAndResolve in interface JdbcConverter

Type Parameters:

R - aggregate type.

Parameters:

type - target aggregate type.

source - source RowDocument.

identifier - identifier chain.

Returns:

the converted object.

See Also:

• RelationalConverter.read(Class, RowDocument)

newValueProvider

protected MappingRelationalConverter.RelationalPropertyValueProvider newValueProvider(RowDocumentAccessor documentAccessor,
 SpELExpressionEvaluator evaluator,
 MappingRelationalConverter.ConversionContext context)

Overrides:

newValueProvider in class MappingRelationalConverter