org.springframework.data.mongodb.core.convert
Class MappingMongoConverter

java.lang.Object
  org.springframework.data.mongodb.core.convert.AbstractMongoConverter
      org.springframework.data.mongodb.core.convert.MappingMongoConverter

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.InitializingBean, org.springframework.context.ApplicationContextAware, org.springframework.data.convert.EntityConverter<MongoPersistentEntity<?>,MongoPersistentProperty,Object,com.mongodb.DBObject>, org.springframework.data.convert.EntityReader<Object,com.mongodb.DBObject>, org.springframework.data.convert.EntityWriter<Object,com.mongodb.DBObject>, MongoConverter, MongoWriter<Object>

public class MappingMongoConverter
extends AbstractMongoConverter
implements org.springframework.context.ApplicationContextAware

MongoConverter that uses a MappingContext to do sophisticated mapping of domain objects to DBObject.

Author:

Oliver Gierke, Jon Brisbin

Field Summary

protected org.springframework.context.ApplicationContext	applicationContext
protected QueryMapper	idMapper
protected static org.apache.commons.logging.Log	log
protected org.springframework.data.mapping.context.MappingContext<? extends MongoPersistentEntity<?>,MongoPersistentProperty>	mappingContext
protected MongoDbFactory	mongoDbFactory
protected org.springframework.expression.spel.standard.SpelExpressionParser	spelExpressionParser
protected MongoTypeMapper	typeMapper
protected boolean	useFieldAccessOnly

Fields inherited from class org.springframework.data.mongodb.core.convert.AbstractMongoConverter

conversions, conversionService

Constructor Summary

MappingMongoConverter(MongoDbFactory mongoDbFactory, org.springframework.data.mapping.context.MappingContext<? extends MongoPersistentEntity<?>,MongoPersistentProperty> mappingContext)
Creates a new MappingMongoConverter given the new MongoDbFactory and MappingContext.

Method Summary

protected void	addCustomTypeKeyIfNecessary(org.springframework.data.util.TypeInformation<?> type, Object value, com.mongodb.DBObject dbObject) Adds custom type information to the given DBObject if necessary.
Object	convertToMongoType(Object obj) Converts the given object into one Mongo will be able to store natively.
protected com.mongodb.DBObject	createCollection(Collection<?> collection, MongoPersistentProperty property) Writes the given Collection using the given MongoPersistentProperty information.
protected com.mongodb.DBRef	createDBRef(Object target, DBRef dbref)
org.springframework.data.mapping.context.MappingContext<? extends MongoPersistentEntity<?>,MongoPersistentProperty>	getMappingContext()
protected Object	getValueInternal(MongoPersistentProperty prop, com.mongodb.DBObject dbo, org.springframework.expression.spel.support.StandardEvaluationContext ctx, String spelExpr)
com.mongodb.BasicDBList	maybeConvertList(Iterable<?> source)
<S> S	read(Class<S> clazz, com.mongodb.DBObject dbo)
protected <S> S	read(org.springframework.data.util.TypeInformation<S> type, com.mongodb.DBObject dbo)
protected Map<Object,Object>	readMap(org.springframework.data.util.TypeInformation<?> type, com.mongodb.DBObject dbObject) Reads the given DBObject into a Map. will recursively resolve nested Maps as well.
void	setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
void	setTypeMapper(MongoTypeMapper typeMapper) Configures the MongoTypeMapper to be used to add type information to DBObjects created by the converter and how to lookup type information from DBObjects when reading them.
void	setUseFieldAccessOnly(boolean useFieldAccessOnly) Configures whether to use field access only for entity mapping.
protected <T> List<?>	unwrapList(com.mongodb.BasicDBList dbList, org.springframework.data.util.TypeInformation<T> targetType)
void	write(Object obj, com.mongodb.DBObject dbo) Root entry method into write conversion.
protected void	writeInternal(Object obj, com.mongodb.DBObject dbo, MongoPersistentEntity<?> entity)
protected void	writeInternal(Object obj, com.mongodb.DBObject dbo, org.springframework.data.util.TypeInformation<?> typeHint) Internal write conversion method which should be used for nested invocations.
protected com.mongodb.DBObject	writeMapInternal(Map<Object,Object> obj, com.mongodb.DBObject dbo, org.springframework.data.util.TypeInformation<?> propertyType) Writes the given Map to the given DBObject considering the given TypeInformation.
protected void	writePropertyInternal(Object obj, com.mongodb.DBObject dbo, MongoPersistentProperty prop)

Methods inherited from class org.springframework.data.mongodb.core.convert.AbstractMongoConverter

afterPropertiesSet, getConversionService, setCustomConversions

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static final org.apache.commons.logging.Log log

mappingContext

protected final org.springframework.data.mapping.context.MappingContext<? extends MongoPersistentEntity<?>,MongoPersistentProperty> mappingContext

spelExpressionParser

protected final org.springframework.expression.spel.standard.SpelExpressionParser spelExpressionParser

mongoDbFactory

protected final MongoDbFactory mongoDbFactory

idMapper

protected final QueryMapper idMapper

applicationContext

protected org.springframework.context.ApplicationContext applicationContext

useFieldAccessOnly

protected boolean useFieldAccessOnly

typeMapper

protected MongoTypeMapper typeMapper

Constructor Detail

MappingMongoConverter

public MappingMongoConverter(MongoDbFactory mongoDbFactory,
                             org.springframework.data.mapping.context.MappingContext<? extends MongoPersistentEntity<?>,MongoPersistentProperty> mappingContext)

Creates a new MappingMongoConverter given the new MongoDbFactory and MappingContext.

Parameters:

mongoDbFactory - must not be null.

mappingContext - must not be null.

Method Detail

setTypeMapper

public void setTypeMapper(MongoTypeMapper typeMapper)

Configures the MongoTypeMapper to be used to add type information to DBObjects created by the converter and how to lookup type information from DBObjects when reading them. Uses a DefaultMongoTypeMapper by default. Setting this to null will reset the TypeMapper to the default one.

Parameters:

typeMapper - the typeMapper to set

getMappingContext

public org.springframework.data.mapping.context.MappingContext<? extends MongoPersistentEntity<?>,MongoPersistentProperty> getMappingContext()

Specified by:

getMappingContext in interface org.springframework.data.convert.EntityConverter<MongoPersistentEntity<?>,MongoPersistentProperty,Object,com.mongodb.DBObject>

setUseFieldAccessOnly

public void setUseFieldAccessOnly(boolean useFieldAccessOnly)

Configures whether to use field access only for entity mapping. Setting this to true will force the MongoConverter to not go through getters or setters even if they are present for getting and setting property values.

Parameters:

useFieldAccessOnly -

setApplicationContext

public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
                           throws org.springframework.beans.BeansException

Specified by:

setApplicationContext in interface org.springframework.context.ApplicationContextAware

Throws:

org.springframework.beans.BeansException

read

public <S> S read(Class<S> clazz,
                  com.mongodb.DBObject dbo)

Specified by:

read in interface org.springframework.data.convert.EntityReader<Object,com.mongodb.DBObject>

read

protected <S> S read(org.springframework.data.util.TypeInformation<S> type,
                     com.mongodb.DBObject dbo)

write

public void write(Object obj,
                  com.mongodb.DBObject dbo)

Root entry method into write conversion. Adds a type discriminator to the DBObject. Shouldn't be called for nested conversions.

Specified by:

write in interface org.springframework.data.convert.EntityWriter<Object,com.mongodb.DBObject>

See Also:

org.springframework.data.mongodb.core.core.convert.MongoWriter#write(java.lang.Object, com.mongodb.DBObject)

writeInternal

protected void writeInternal(Object obj,
                             com.mongodb.DBObject dbo,
                             org.springframework.data.util.TypeInformation<?> typeHint)

Internal write conversion method which should be used for nested invocations.

Parameters:

obj -

dbo -

writeInternal

protected void writeInternal(Object obj,
                             com.mongodb.DBObject dbo,
                             MongoPersistentEntity<?> entity)

writePropertyInternal

protected void writePropertyInternal(Object obj,
                                     com.mongodb.DBObject dbo,
                                     MongoPersistentProperty prop)

createCollection

protected com.mongodb.DBObject createCollection(Collection<?> collection,
                                                MongoPersistentProperty property)

Writes the given Collection using the given MongoPersistentProperty information.

Parameters:

collection - must not be null.

property - must not be null.

Returns:

writeMapInternal

protected com.mongodb.DBObject writeMapInternal(Map<Object,Object> obj,
                                                com.mongodb.DBObject dbo,
                                                org.springframework.data.util.TypeInformation<?> propertyType)

Writes the given Map to the given DBObject considering the given TypeInformation.

Parameters:

obj - must not be null.

dbo - must not be null.

propertyType - must not be null.

Returns:

addCustomTypeKeyIfNecessary

protected void addCustomTypeKeyIfNecessary(org.springframework.data.util.TypeInformation<?> type,
                                           Object value,
                                           com.mongodb.DBObject dbObject)

Adds custom type information to the given DBObject if necessary. That is if the value is not the same as the one given. This is usually the case if you store a subtype of the actual declared type of the property.

Parameters:

type -

value - must not be null.

dbObject - must not be null.

createDBRef

protected com.mongodb.DBRef createDBRef(Object target,
                                        DBRef dbref)

getValueInternal

protected Object getValueInternal(MongoPersistentProperty prop,
                                  com.mongodb.DBObject dbo,
                                  org.springframework.expression.spel.support.StandardEvaluationContext ctx,
                                  String spelExpr)

readMap

protected Map<Object,Object> readMap(org.springframework.data.util.TypeInformation<?> type,
                                     com.mongodb.DBObject dbObject)

Reads the given DBObject into a Map. will recursively resolve nested Maps as well.

Parameters:

type - the Map TypeInformation to be used to unmarshall this DBObject.

dbObject -

Returns:

unwrapList

protected <T> List<?> unwrapList(com.mongodb.BasicDBList dbList,
                                 org.springframework.data.util.TypeInformation<T> targetType)

convertToMongoType

public Object convertToMongoType(Object obj)

Description copied from interface: MongoWriter

Converts the given object into one Mongo will be able to store natively. If the given object can already be stored as is, no conversion will happen.

Specified by:

convertToMongoType in interface MongoWriter<Object>

Returns:

maybeConvertList

public com.mongodb.BasicDBList maybeConvertList(Iterable<?> source)