Class Neo4jMappingContext

java.lang.Object

org.springframework.data.mapping.context.AbstractMappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>

org.springframework.data.neo4j.core.mapping.Neo4jMappingContext

All Implemented Interfaces:

Aware, BeanFactoryAware, InitializingBean, ApplicationContextAware, ApplicationEventPublisherAware, EnvironmentAware, MappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>, Schema

@API(status=STABLE,
     since="6.0")
public final class Neo4jMappingContext
extends AbstractMappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>
implements Schema

An implementation of both a Schema as well as a Neo4j version of Spring Data's MappingContext. It is recommended to provide the initial set of classes through AbstractMappingContext.setInitialEntitySet(Set).

Since:

6.0

Author:

Michael J. Simons, Gerrit Meier

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Neo4jMappingContext.Builder	A builder for creating custom instances of a Neo4jMappingContext.

Constructor Summary

Constructors

Constructor	Description
Neo4jMappingContext()
Neo4jMappingContext(Neo4jConversions neo4jConversions)

Method Summary

Modifier and Type	Method	Description
Optional<Neo4jPersistentEntity<?>>	addPersistentEntity(TypeInformation<?> typeInformation)
static Neo4jMappingContext.Builder	builder()
protected <T> Neo4jPersistentEntity<?>	createPersistentEntity(TypeInformation<T> typeInformation)
protected Neo4jPersistentProperty	createPersistentProperty(Property property, Neo4jPersistentEntity<?> owner, SimpleTypeHolder simpleTypeHolder)
CreateRelationshipStatementHolder	createStatementForImperativeRelationshipsWithPropertiesBatch(boolean isNew, Neo4jPersistentEntity<?> neo4jPersistentEntity, RelationshipDescription relationshipDescription, Object relatedValues, List<Map<String,Object>> relationshipPropertiesRows, boolean canUseElementId)
CreateRelationshipStatementHolder	createStatementForImperativeSimpleRelationshipBatch(Neo4jPersistentEntity<?> neo4jPersistentEntity, RelationshipDescription relationshipDescription, List<Object> plainRelationshipRows, boolean canUseElementId)
CreateRelationshipStatementHolder	createStatementForSingleRelationship(Neo4jPersistentEntity<?> neo4jPersistentEntity, RelationshipDescription relationshipContext, Object relatedValue, boolean isNewRelationship, boolean canUseElementId)
Neo4jConversionService	getConversionService()
Neo4jEntityConverter	getEntityConverter()	Returns the (reading and writing) converter used to read records into entities and write entities into maps.
<T extends IdGenerator<?>> Optional<T>	getIdGenerator(String reference)
EntityInstantiator	getInstantiatorFor(PersistentEntity<?,?> entity)
@Nullable NodeDescription<?>	getNodeDescription(Class<?> underlyingClass)	Retrieves a node's description by its underlying class.
@Nullable NodeDescription<?>	getNodeDescription(String primaryLabel)	Retrieves a node's description by its primary label.
<T extends IdGenerator<?>> T	getOrCreateIdGeneratorOfType(Class<T> idGeneratorType)	Creates or retrieves an instance of the given id generator class.
@Nullable Neo4jPersistentEntity<?>	getPersistentEntity(TypeInformation<?> typeInformation)
boolean	hasCustomWriteTarget(Class<?> targetType)
<T> T	invokePostLoad(Neo4jPersistentEntity<T> entity, T instance)	Executes all post load methods of the given instance.
void	setApplicationContext(ApplicationContext applicationContext)
void	setStrict(boolean strict)	We need to set the context to non-strict in case we must dynamically add parent classes.

Methods inherited from class AbstractMappingContext

addPersistentEntity, afterPropertiesSet, doFindPersistentPropertyPaths, findPersistentPropertyPaths, getManagedTypes, getPersistentEntities, getPersistentEntity, getPersistentEntity, getPersistentPropertyPath, getPersistentPropertyPath, getPersistentPropertyPath, hasPersistentEntityFor, initialize, setApplicationEventPublisher, setBeanFactory, setEnvironment, setInitialEntitySet, setManagedTypes, setSimpleTypeHolder, shouldCreatePersistentEntityFor, shouldCreateProperties

Methods inherited from class Object

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

Methods inherited from interface MappingContext

getRequiredPersistentEntity, getRequiredPersistentEntity, getRequiredPersistentEntity

Methods inherited from interface Schema

getRequiredBinderFunctionFor, getRequiredMappingFunctionFor, getRequiredNodeDescription, getRequiredNodeDescription

Constructor Details

Neo4jMappingContext

public Neo4jMappingContext()

Neo4jMappingContext

public Neo4jMappingContext(Neo4jConversions neo4jConversions)

Method Details

builder

public static Neo4jMappingContext.Builder builder()

setStrict

public void setStrict(boolean strict)

We need to set the context to non-strict in case we must dynamically add parent classes. As there is no way to access the original value without reflection, we track its change.

Overrides:

setStrict in class AbstractMappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>

Parameters:

strict - the new value for the strict setting

getEntityConverter

public Neo4jEntityConverter getEntityConverter()

Description copied from interface: Schema

Returns the (reading and writing) converter used to read records into entities and write entities into maps.

Specified by:

getEntityConverter in interface Schema

Returns:

the entity converter for the schema

getConversionService

public Neo4jConversionService getConversionService()

getInstantiatorFor

public EntityInstantiator getInstantiatorFor(PersistentEntity<?,?> entity)

hasCustomWriteTarget

public boolean hasCustomWriteTarget(Class<?> targetType)

createPersistentEntity

protected <T> Neo4jPersistentEntity<?> createPersistentEntity(TypeInformation<T> typeInformation)

Specified by:

createPersistentEntity in class AbstractMappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>

createPersistentProperty

protected Neo4jPersistentProperty createPersistentProperty(Property property,
 Neo4jPersistentEntity<?> owner,
 SimpleTypeHolder simpleTypeHolder)

Specified by:

createPersistentProperty in class AbstractMappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>

getNodeDescription

public @Nullable NodeDescription<?> getNodeDescription(String primaryLabel)

Description copied from interface: Schema

Retrieves a node's description by its primary label.

Specified by:

getNodeDescription in interface Schema

Parameters:

primaryLabel - the primary label under which the node is described

Returns:

the description if any, null otherwise

getNodeDescription

public @Nullable NodeDescription<?> getNodeDescription(Class<?> underlyingClass)

Description copied from interface: Schema

Retrieves a node's description by its underlying class.

Specified by:

getNodeDescription in interface Schema

Parameters:

underlyingClass - the underlying class of the node description to be retrieved

Returns:

the description if any, null otherwise

getPersistentEntity

public @Nullable Neo4jPersistentEntity<?> getPersistentEntity(TypeInformation<?> typeInformation)

Specified by:

getPersistentEntity in interface MappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>

Overrides:

getPersistentEntity in class AbstractMappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>

addPersistentEntity

public Optional<Neo4jPersistentEntity<?>> addPersistentEntity(TypeInformation<?> typeInformation)

Overrides:

addPersistentEntity in class AbstractMappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>

getOrCreateIdGeneratorOfType

public <T extends IdGenerator<?>> T getOrCreateIdGeneratorOfType(Class<T> idGeneratorType)

Description copied from interface: Schema

Creates or retrieves an instance of the given id generator class. During the lifetime of the schema, this method returns the same instance of reoccurring requests of the same type.

Specified by:

getOrCreateIdGeneratorOfType in interface Schema

Type Parameters:

T - the class type

Parameters:

idGeneratorType - the type of the ID generator to return

Returns:

the id generator.

getIdGenerator

public <T extends IdGenerator<?>> Optional<T> getIdGenerator(String reference)

Specified by:

getIdGenerator in interface Schema

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)
                           throws BeansException

Specified by:

setApplicationContext in interface ApplicationContextAware

Overrides:

setApplicationContext in class AbstractMappingContext<Neo4jPersistentEntity<?>, Neo4jPersistentProperty>

Throws:

BeansException

createStatementForImperativeSimpleRelationshipBatch

public CreateRelationshipStatementHolder createStatementForImperativeSimpleRelationshipBatch(Neo4jPersistentEntity<?> neo4jPersistentEntity,
 RelationshipDescription relationshipDescription,
 List<Object> plainRelationshipRows,
 boolean canUseElementId)

createStatementForImperativeRelationshipsWithPropertiesBatch

public CreateRelationshipStatementHolder createStatementForImperativeRelationshipsWithPropertiesBatch(boolean isNew,
 Neo4jPersistentEntity<?> neo4jPersistentEntity,
 RelationshipDescription relationshipDescription,
 Object relatedValues,
 List<Map<String,Object>> relationshipPropertiesRows,
 boolean canUseElementId)

createStatementForSingleRelationship

public CreateRelationshipStatementHolder createStatementForSingleRelationship(Neo4jPersistentEntity<?> neo4jPersistentEntity,
 RelationshipDescription relationshipContext,
 Object relatedValue,
 boolean isNewRelationship,
 boolean canUseElementId)

invokePostLoad

public <T> T invokePostLoad(Neo4jPersistentEntity<T> entity,
 T instance)

Executes all post load methods of the given instance.

Type Parameters:

T - type of the entity

Parameters:

entity - the entity definition

instance - the instance whose post load methods should be executed

Returns:

the instance