Package org.springframework.data.mongodb.core.mapping

Class BasicMongoPersistentProperty

java.lang.Object

org.springframework.data.mapping.model.AbstractPersistentProperty<P>

org.springframework.data.mapping.model.AnnotationBasedPersistentProperty<MongoPersistentProperty>

org.springframework.data.mongodb.core.mapping.BasicMongoPersistentProperty

All Implemented Interfaces:

PersistentProperty<MongoPersistentProperty>, MongoPersistentProperty

Direct Known Subclasses:

CachingMongoPersistentProperty

public class BasicMongoPersistentProperty
extends AnnotationBasedPersistentProperty<MongoPersistentProperty>
implements MongoPersistentProperty

MongoDB specific PersistentProperty implementation.

Author:

Oliver Gierke, Patryk Wasik, Thomas Darimont, Christoph Strobl, Mark Paluch, Divya Srivastava

Nested Class Summary

Nested classes/interfaces inherited from interface org.springframework.data.mongodb.core.mapping.MongoPersistentProperty

MongoPersistentProperty.PropertyToFieldNameConverter

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ID_FIELD_NAME

Constructor Summary

Constructors

Constructor	Description
BasicMongoPersistentProperty(Property property, MongoPersistentEntity<?> owner, SimpleTypeHolder simpleTypeHolder, FieldNamingStrategy fieldNamingStrategy)	Creates a new BasicMongoPersistentProperty.

Method Summary

Modifier and Type	Method	Description
protected Association<MongoPersistentProperty>	createAssociation()
protected MongoField	doGetMongoField()
DBRef	getDBRef()	Returns the DBRef if the property is a reference.
DocumentReference	getDocumentReference()	Returns the DocumentReference if the property is a reference.
Collection<Object>	getEncryptionKeyIds()
EvaluationContext	getEvaluationContext(Object rootObject)	Obtain the EvaluationContext for a specific root object.
String	getFieldName()	Returns the key to be used to store the value of the property inside a Mongo Document.
int	getFieldOrder()	Returns the order of the field if defined.
Class<?>	getFieldType()	Returns the Java FieldType of the field a property is persisted to.
MongoField	getMongoField()
boolean	hasExplicitFieldName()	Returns whether the property uses an annotated field name through Field.
boolean	isDbReference()	Returns whether the property is a DBRef.
boolean	isDocumentReference()	Returns whether the property is a DocumentReference.
boolean	isExplicitIdProperty()	Returns whether the property is explicitly marked as an identifier property of the owning PersistentEntity.
boolean	isExplicitLanguageProperty()	Returns true when property being annotated with Language.
boolean	isIdProperty()	Also considers fields as id that are of supported id type and name.
boolean	isLanguageProperty()	Returns true whether the property indicates the documents language either by having a MongoPersistentProperty.getFieldName() equal to language or being annotated with Language.
boolean	isTextScoreProperty()	Returns whether the property holds the documents score calculated by text search.
protected void	validate()
boolean	writeNullValues()	Returns whether the property should be written to the database if its value is null.

Methods inherited from class org.springframework.data.mapping.model.AnnotationBasedPersistentProperty

findAnnotation, findPropertyOrOwnerAnnotation, getAssociationTargetTypeInformation, getSpelExpression, isAnnotationPresent, isAssociation, isTransient, isVersionProperty, isWritable, toString, usePropertyAccess

Methods inherited from class org.springframework.data.mapping.model.AbstractPersistentProperty

equals, getActualType, getActualTypeInformation, getAssociation, getAssociationTargetType, getComponentType, getField, getGetter, getMapValueType, getName, getOwner, getPersistentEntityTypeInformation, getProperty, getRawType, getSetter, getType, getTypeInformation, getWither, hashCode, isArray, isCollectionLike, isEntity, isImmutable, isMap, isReadable

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.data.mongodb.core.mapping.MongoPersistentProperty

hasExplicitWriteTarget, isUnwrapped, usePropertyAccess

Methods inherited from interface org.springframework.data.mapping.PersistentProperty

findAnnotation, findPropertyOrOwnerAnnotation, getAccessorForOwner, getActualType, getAssociation, getAssociationTargetType, getAssociationTargetTypeInformation, getComponentType, getField, getGetter, getMapValueType, getName, getOwner, getPersistentEntityTypeInformation, getRawType, getRequiredAnnotation, getRequiredAssociation, getRequiredField, getRequiredGetter, getRequiredSetter, getRequiredWither, getSetter, getSpelExpression, getType, getTypeInformation, getWither, hasActualTypeAnnotation, isAnnotationPresent, isArray, isAssociation, isCollectionLike, isEntity, isImmutable, isMap, isReadable, isTransient, isVersionProperty, isWritable

Field Details

ID_FIELD_NAME

public static final String ID_FIELD_NAME

Constructor Details

BasicMongoPersistentProperty

public BasicMongoPersistentProperty(Property property,
 MongoPersistentEntity<?> owner,
 SimpleTypeHolder simpleTypeHolder,
 @Nullable
 FieldNamingStrategy fieldNamingStrategy)

Creates a new BasicMongoPersistentProperty.

Parameters:

property - the source property.

owner - the owing entity.

simpleTypeHolder - must not be null.

fieldNamingStrategy - can be null.

Method Details

isIdProperty

public boolean isIdProperty()

Also considers fields as id that are of supported id type and name.

Specified by:

isIdProperty in interface PersistentProperty<MongoPersistentProperty>

Overrides:

isIdProperty in class AnnotationBasedPersistentProperty<MongoPersistentProperty>

See Also:

• SUPPORTED_ID_PROPERTY_NAMES

isExplicitIdProperty

public boolean isExplicitIdProperty()

Description copied from interface: MongoPersistentProperty

Returns whether the property is explicitly marked as an identifier property of the owning PersistentEntity. A property is an explicit id property if it is annotated with @see Id.

Specified by:

isExplicitIdProperty in interface MongoPersistentProperty

Returns:

getFieldName

public String getFieldName()

Returns the key to be used to store the value of the property inside a Mongo Document.

Specified by:

getFieldName in interface MongoPersistentProperty

Returns:

getFieldType

public Class<?> getFieldType()

Description copied from interface: MongoPersistentProperty

Returns the Java FieldType of the field a property is persisted to.

Specified by:

getFieldType in interface MongoPersistentProperty

Returns:

See Also:

• FieldType

hasExplicitFieldName

public boolean hasExplicitFieldName()

Description copied from interface: MongoPersistentProperty

Returns whether the property uses an annotated field name through Field.

Specified by:

hasExplicitFieldName in interface MongoPersistentProperty

Returns:

true if Field having non blank Field.value() present.

Since:

1.7

getFieldOrder

public int getFieldOrder()

Description copied from interface: MongoPersistentProperty

Returns the order of the field if defined. Will return -1 if undefined.

Specified by:

getFieldOrder in interface MongoPersistentProperty

Returns:

writeNullValues

public boolean writeNullValues()

Description copied from interface: MongoPersistentProperty

Returns whether the property should be written to the database if its value is null.

Specified by:

writeNullValues in interface MongoPersistentProperty

Returns:

See Also:

• Field.Write

createAssociation

protected Association<MongoPersistentProperty> createAssociation()

Specified by:

createAssociation in class AbstractPersistentProperty<MongoPersistentProperty>

isDbReference

public boolean isDbReference()

Description copied from interface: MongoPersistentProperty

Returns whether the property is a DBRef. If this returns true you can expect MongoPersistentProperty.getDBRef() to return an non-null value.

Specified by:

isDbReference in interface MongoPersistentProperty

Returns:

isDocumentReference

public boolean isDocumentReference()

Description copied from interface: MongoPersistentProperty

Returns whether the property is a DocumentReference. If this returns true you can expect MongoPersistentProperty.getDocumentReference() to return an non-null value.

Specified by:

isDocumentReference in interface MongoPersistentProperty

Returns:

getDBRef

@Nullable
public DBRef getDBRef()

Description copied from interface: MongoPersistentProperty

Returns the DBRef if the property is a reference.

Specified by:

getDBRef in interface MongoPersistentProperty

Returns:

See Also:

• MongoPersistentProperty.isDbReference()

getDocumentReference

@Nullable
public DocumentReference getDocumentReference()

Description copied from interface: MongoPersistentProperty

Returns the DocumentReference if the property is a reference.

Specified by:

getDocumentReference in interface MongoPersistentProperty

Returns:

null if not present.

See Also:

• MongoPersistentProperty.isDocumentReference()

isLanguageProperty

public boolean isLanguageProperty()

Description copied from interface: MongoPersistentProperty

Returns true whether the property indicates the documents language either by having a MongoPersistentProperty.getFieldName() equal to language or being annotated with Language.

Specified by:

isLanguageProperty in interface MongoPersistentProperty

Returns:

isExplicitLanguageProperty

public boolean isExplicitLanguageProperty()

Description copied from interface: MongoPersistentProperty

Returns true when property being annotated with Language.

Specified by:

isExplicitLanguageProperty in interface MongoPersistentProperty

Returns:

isTextScoreProperty

public boolean isTextScoreProperty()

Description copied from interface: MongoPersistentProperty

Returns whether the property holds the documents score calculated by text search.
It's marked with TextScore.

Specified by:

isTextScoreProperty in interface MongoPersistentProperty

Returns:

getEvaluationContext

public EvaluationContext getEvaluationContext(@Nullable
 Object rootObject)

Obtain the EvaluationContext for a specific root object.

Parameters:

rootObject - can be null.

Returns:

never null.

Since:

3.3

getMongoField

public MongoField getMongoField()

Specified by:

getMongoField in interface MongoPersistentProperty

Returns:

the MongoField representing the raw field to read/write in a MongoDB document.

getEncryptionKeyIds

public Collection<Object> getEncryptionKeyIds()

Specified by:

getEncryptionKeyIds in interface MongoPersistentProperty

Returns:

the resolved encryption keyIds if applicable. An empty Collection if no keyIds specified. null no Encrypted annotation found.

doGetMongoField

protected MongoField doGetMongoField()

validate

protected void validate()