org.springframework.data.cassandra.core.convert

Class MappingCassandraConverter

java.lang.Object

org.springframework.data.cassandra.core.convert.AbstractCassandraConverter

org.springframework.data.cassandra.core.convert.MappingCassandraConverter

All Implemented Interfaces:

Aware, BeanClassLoaderAware, InitializingBean, ApplicationContextAware, CassandraConverter, EntityConverter<CassandraPersistentEntity<?>,CassandraPersistentProperty,Object,Object>, EntityReader<Object,Object>, EntityWriter<Object,Object>

public class MappingCassandraConverter
extends AbstractCassandraConverter
implements ApplicationContextAware, BeanClassLoaderAware

CassandraConverter that uses a MappingContext to do sophisticated mapping of domain objects to Row.

Author:

Alex Shvid, Matthew T. Adams, Oliver Gierke, Mark Paluch, Antoine Toulme, John Blum, Christoph Strobl, Frank Spitulski

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	MappingCassandraConverter.ConversionContext Conversion context holding references to simple ValueConverter and ContainerValueConverter.

Constructor Summary

Constructors

Constructor and Description
MappingCassandraConverter() Create a new MappingCassandraConverter with a CassandraMappingContext.
MappingCassandraConverter(CassandraMappingContext mappingContext) Create a new MappingCassandraConverter with the given CassandraMappingContext.

Method Summary

Modifier and Type	Method and Description
Object	convertToColumnType(Object obj) Converts the given object into a value Cassandra will be able to store natively in a column.
Object	convertToColumnType(Object value, ColumnType columnType) Converts the given object into a value Cassandra will be able to store natively in a column.
protected <S> S	doReadEntity(MappingCassandraConverter.ConversionContext context, CassandraValueProvider valueProvider, TypeInformation<? extends S> typeHint) Conversion method to materialize an object from a Row, TupleValue, or UdtValue.
com.datastax.oss.driver.api.core.type.codec.registry.CodecRegistry	getCodecRegistry() Returns the configured CodecRegistry.
ColumnTypeResolver	getColumnTypeResolver() Returns the ColumnTypeResolver to resolve ColumnType for properties, TypeInformation, and values.
protected MappingCassandraConverter.ConversionContext	getConversionContext() Creates a new MappingCassandraConverter.ConversionContext given ObjectPath.
Object	getId(Object object, CassandraPersistentEntity<?> entity) Returns the Id for an entity.
CassandraMappingContext	getMappingContext()
protected Object	getPotentiallyConvertedSimpleRead(Object value, TypeInformation<?> target) Checks whether we have a custom conversion for the given simple object.
UserTypeResolver	getUserTypeResolver() Returns the configured UserTypeResolver.
<R> R	read(Class<R> type, Object row)
protected Object	readCollectionOrArray(MappingCassandraConverter.ConversionContext context, Collection<?> source, TypeInformation<?> targetType) Reads the given Collection into a collection of the given TypeInformation.
protected Object	readMap(MappingCassandraConverter.ConversionContext context, Map<?,?> source, TypeInformation<?> targetType) Reads the given Map into a map of the given TypeInformation.
<R> R	readRow(Class<R> type, com.datastax.oss.driver.api.core.cql.Row row) Read a Row into the requested target type.
void	setApplicationContext(ApplicationContext applicationContext)
void	setBeanClassLoader(ClassLoader classLoader)
void	setCodecRegistry(com.datastax.oss.driver.api.core.type.codec.registry.CodecRegistry codecRegistry) Sets the CodecRegistry.
void	setUserTypeResolver(UserTypeResolver userTypeResolver) Sets the UserTypeResolver.
void	write(Object source, Object sink)
void	write(Object source, Object sink, CassandraPersistentEntity<?> entity) Converts and writes a source object into a sink using the given CassandraPersistentEntity.

Methods inherited from class org.springframework.data.cassandra.core.convert.AbstractCassandraConverter

afterPropertiesSet, getConversionService, getCustomConversions, setCustomConversions, setInstantiators

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.data.cassandra.core.convert.CassandraConverter

convertToColumnType

Constructor Detail

MappingCassandraConverter

public MappingCassandraConverter()

Create a new MappingCassandraConverter with a CassandraMappingContext.

MappingCassandraConverter

public MappingCassandraConverter(CassandraMappingContext mappingContext)

Create a new MappingCassandraConverter with the given CassandraMappingContext.

Parameters:

mappingContext - must not be null.

Method Detail

getConversionContext

protected MappingCassandraConverter.ConversionContext getConversionContext()

Creates a new MappingCassandraConverter.ConversionContext given ObjectPath.

Parameters:

path - the current ObjectPath, must not be null.

Returns:

the MappingCassandraConverter.ConversionContext.

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)
                           throws BeansException

Specified by:

setApplicationContext in interface ApplicationContextAware

Throws:

BeansException

setBeanClassLoader

public void setBeanClassLoader(ClassLoader classLoader)

Specified by:

setBeanClassLoader in interface BeanClassLoaderAware

setCodecRegistry

public void setCodecRegistry(com.datastax.oss.driver.api.core.type.codec.registry.CodecRegistry codecRegistry)

Sets the CodecRegistry.

Parameters:

codecRegistry - must not be null.

Since:

3.0

getCodecRegistry

public com.datastax.oss.driver.api.core.type.codec.registry.CodecRegistry getCodecRegistry()

Returns the configured CodecRegistry.

Specified by:

getCodecRegistry in interface CassandraConverter

Returns:

the configured CodecRegistry.

Since:

3.0

setUserTypeResolver

public void setUserTypeResolver(UserTypeResolver userTypeResolver)

Sets the UserTypeResolver.

Parameters:

userTypeResolver - must not be null.

getUserTypeResolver

public UserTypeResolver getUserTypeResolver()

Returns the configured UserTypeResolver.

Returns:

the configured UserTypeResolver.

Since:

3.0

getMappingContext

public CassandraMappingContext getMappingContext()

Specified by:

getMappingContext in interface CassandraConverter

Specified by:

getMappingContext in interface EntityConverter<CassandraPersistentEntity<?>,CassandraPersistentProperty,Object,Object>

getColumnTypeResolver

public ColumnTypeResolver getColumnTypeResolver()

Description copied from interface: CassandraConverter

Returns the ColumnTypeResolver to resolve ColumnType for properties, TypeInformation, and values.

Specified by:

getColumnTypeResolver in interface CassandraConverter

Returns:

the ColumnTypeResolver

read

public <R> R read(Class<R> type,
                  Object row)

Specified by:

read in interface EntityReader<Object,Object>

readRow

public <R> R readRow(Class<R> type,
                     com.datastax.oss.driver.api.core.cql.Row row)

Read a Row into the requested target type.

Parameters:

type - must not be null.

row - must not be null.

Returns:

the converted valued.

doReadEntity

protected <S> S doReadEntity(MappingCassandraConverter.ConversionContext context,
                             CassandraValueProvider valueProvider,
                             TypeInformation<? extends S> typeHint)

Conversion method to materialize an object from a Row, TupleValue, or UdtValue. Can be overridden by subclasses.

Parameters:

context - must not be null

valueProvider - must not be null

typeHint - the TypeInformation to be used to unmarshall this Row.

Returns:

the converted object, will never be null.

convertToColumnType

public Object convertToColumnType(Object obj)

Description copied from interface: CassandraConverter

Converts the given object into a value Cassandra will be able to store natively in a column.

Specified by:

convertToColumnType in interface CassandraConverter

Parameters:

obj - Object to convert; must not be null.

Returns:

the result of the conversion.

convertToColumnType

public Object convertToColumnType(Object value,
                                  ColumnType columnType)

Description copied from interface: CassandraConverter

Converts the given object into a value Cassandra will be able to store natively in a column.

Specified by:

convertToColumnType in interface CassandraConverter

Parameters:

value - Object to convert; must not be null.

columnType - ColumnType used to describe the object type; must not be null.

Returns:

the result of the conversion.

write

public void write(Object source,
                  Object sink)

Specified by:

write in interface EntityWriter<Object,Object>

write

public void write(Object source,
                  Object sink,
                  CassandraPersistentEntity<?> entity)

Description copied from interface: CassandraConverter

Converts and writes a source object into a sink using the given CassandraPersistentEntity.

Specified by:

write in interface CassandraConverter

Parameters:

source - the source, must not be null.

sink - must not be null.

entity - must not be null.

getId

public Object getId(Object object,
                    CassandraPersistentEntity<?> entity)

Description copied from interface: CassandraConverter

Returns the Id for an entity. It can return:

• A singular value if for a simple Id or PrimaryKey Id
• A MapId for composite PrimaryKeyColumn Id's
• A the composite primary key for PrimaryKey using a PrimaryKeyClass

Specified by:

getId in interface CassandraConverter

Parameters:

object - must not be null.

entity - must not be null.

Returns:

the id value or null, if the id is not set.

getPotentiallyConvertedSimpleRead

protected Object getPotentiallyConvertedSimpleRead(Object value,
                                                   TypeInformation<?> target)

Checks whether we have a custom conversion for the given simple object. Converts the given value if so, applies Enum handling or returns the value as is. Can be overridden by subclasses.

Since:

3.2

readCollectionOrArray

protected Object readCollectionOrArray(MappingCassandraConverter.ConversionContext context,
                                       Collection<?> source,
                                       TypeInformation<?> targetType)

Reads the given Collection into a collection of the given TypeInformation. Will recursively resolve nested Lists as well. Can be overridden by subclasses.

Parameters:

source - must not be null.

targetType - must not be null.

Returns:

the converted Collection or array, will never be null.

readMap

protected Object readMap(MappingCassandraConverter.ConversionContext context,
                         Map<?,?> source,
                         TypeInformation<?> targetType)

Reads the given Map into a map of the given TypeInformation. Will recursively resolve nested Maps as well. Can be overridden by subclasses.

Parameters:

source - must not be null.

targetType - must not be null.

Returns:

the converted Collection or array, will never be null.