org.neo4j.ogm.compiler

Class CypherContext

java.lang.Object

org.neo4j.ogm.compiler.CypherContext

All Implemented Interfaces:

org.neo4j.ogm.compiler.CompileContext

public class CypherContext
extends Object
implements org.neo4j.ogm.compiler.CompileContext

Maintains contextual information throughout the process of compiling Cypher statements to persist a graph of objects.

Author:

Mark Angrish, Vince Bickers, Luanne Misquitta

Constructor Summary

Constructors

Constructor and Description
CypherContext(org.neo4j.ogm.compiler.Compiler compiler)

Method Summary

Methods

Modifier and Type	Method and Description
void	deregister(org.neo4j.ogm.compiler.NodeBuilder nodeBuilder)
boolean	deregisterIncomingRelationships(Long tgt, String relationshipType, Class endNodeType, boolean relationshipEntity) Invoked when the mapper wishes to mark a set of incoming relationships to a specific type like (a)<-[:T]-(*) as deleted, prior to possibly re-establishing them individually as it traverses the entity graph.
boolean	deregisterOutgoingRelationships(Long src, String relationshipType, Class endNodeType) Invoked when the mapper wishes to mark a set of outgoing relationships to a specific type like (a)-[:T]->(*) as deleted, prior to possibly re-establishing them individually as it traverses the entity graph.
org.neo4j.ogm.compiler.Compiler	getCompiler()
Object	getNewObject(Long id)
Long	newNodeId(Long reference)
void	register(Object object)
void	registerNewNodeId(Long reference, Long id)
void	registerNewObject(Long reference, Object relationshipEntity)
void	registerRelationship(org.neo4j.ogm.context.Mappable mappedRelationship)
Collection<Object>	registry()
boolean	removeRegisteredRelationship(org.neo4j.ogm.context.Mappable mappedRelationship)
void	visit(Long identity, org.neo4j.ogm.compiler.NodeBuilder nodeBuilder)
boolean	visited(Long obj)
org.neo4j.ogm.compiler.NodeBuilder	visitedNode(Long identity)
boolean	visitedRelationshipEntity(Long relationshipEntity)
void	visitRelationshipEntity(Long relationshipEntity)

Methods inherited from class java.lang.Object

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

Constructor Detail

CypherContext

public CypherContext(org.neo4j.ogm.compiler.Compiler compiler)

Method Detail

visited

public boolean visited(Long obj)

Specified by:

visited in interface org.neo4j.ogm.compiler.CompileContext

visit

public void visit(Long identity,
         org.neo4j.ogm.compiler.NodeBuilder nodeBuilder)

Specified by:

visit in interface org.neo4j.ogm.compiler.CompileContext

registerRelationship

public void registerRelationship(org.neo4j.ogm.context.Mappable mappedRelationship)

Specified by:

registerRelationship in interface org.neo4j.ogm.compiler.CompileContext

removeRegisteredRelationship

public boolean removeRegisteredRelationship(org.neo4j.ogm.context.Mappable mappedRelationship)

Specified by:

removeRegisteredRelationship in interface org.neo4j.ogm.compiler.CompileContext

visitedNode

public org.neo4j.ogm.compiler.NodeBuilder visitedNode(Long identity)

Specified by:

visitedNode in interface org.neo4j.ogm.compiler.CompileContext

registerNewObject

public void registerNewObject(Long reference,
                     Object relationshipEntity)

Specified by:

registerNewObject in interface org.neo4j.ogm.compiler.CompileContext

getNewObject

public Object getNewObject(Long id)

Specified by:

getNewObject in interface org.neo4j.ogm.compiler.CompileContext

register

public void register(Object object)

Specified by:

register in interface org.neo4j.ogm.compiler.CompileContext

registry

public Collection<Object> registry()

Specified by:

registry in interface org.neo4j.ogm.compiler.CompileContext

deregisterOutgoingRelationships

public boolean deregisterOutgoingRelationships(Long src,
                                      String relationshipType,
                                      Class endNodeType)

Invoked when the mapper wishes to mark a set of outgoing relationships to a specific type like (a)-[:T]->(*) as deleted, prior to possibly re-establishing them individually as it traverses the entity graph. There are two reasons why a set of relationships might not be be able to be marked deleted: 1) the request to mark them as deleted has already been made 2) the relationship is not persisted in the graph (i.e. its a new relationship) Only case 1) is considered to be a failed request, because this context is only concerned about pre-existing relationships in the graph. In order to distinguish between the two cases, we also maintain a list of successfully deleted relationships, so that if we try to delete an already-deleted set of relationships we can signal the error and undelete it.

Specified by:

deregisterOutgoingRelationships in interface org.neo4j.ogm.compiler.CompileContext

Parameters:

src - the identity of the node at the start of the relationship

relationshipType - the type of the relationship

endNodeType - the class type of the entity at the end of the relationship

Returns:

true if the relationship was deleted or doesn't exist in the graph, false otherwise

deregisterIncomingRelationships

public boolean deregisterIncomingRelationships(Long tgt,
                                      String relationshipType,
                                      Class endNodeType,
                                      boolean relationshipEntity)

Invoked when the mapper wishes to mark a set of incoming relationships to a specific type like (a)<-[:T]-(*) as deleted, prior to possibly re-establishing them individually as it traverses the entity graph. There are two reasons why a set of relationships might not be be able to be marked deleted: 1) the request to mark them as deleted has already been made 2) the relationship is not persisted in the graph (i.e. its a new relationship) Only case 1) is considered to be a failed request, because this context is only concerned about pre-existing relationships in the graph. In order to distinguish between the two cases, we also maintain a list of successfully deleted relationships, so that ff we try to delete an already-deleted set of relationships we can signal the error and undelete it.

Specified by:

deregisterIncomingRelationships in interface org.neo4j.ogm.compiler.CompileContext

Parameters:

tgt - the identity of the node at the pointy end of the relationship

relationshipType - the type of the relationship

endNodeType - the class type of the entity at the other end of the relationship

Returns:

true if the relationship was deleted or doesn't exist in the graph, false otherwise

visitRelationshipEntity

public void visitRelationshipEntity(Long relationshipEntity)

Specified by:

visitRelationshipEntity in interface org.neo4j.ogm.compiler.CompileContext

visitedRelationshipEntity

public boolean visitedRelationshipEntity(Long relationshipEntity)

Specified by:

visitedRelationshipEntity in interface org.neo4j.ogm.compiler.CompileContext

getCompiler

public org.neo4j.ogm.compiler.Compiler getCompiler()

Specified by:

getCompiler in interface org.neo4j.ogm.compiler.CompileContext

newNodeId

public Long newNodeId(Long reference)

Specified by:

newNodeId in interface org.neo4j.ogm.compiler.CompileContext

registerNewNodeId

public void registerNewNodeId(Long reference,
                     Long id)

Specified by:

registerNewNodeId in interface org.neo4j.ogm.compiler.CompileContext

deregister

public void deregister(org.neo4j.ogm.compiler.NodeBuilder nodeBuilder)

Specified by:

deregister in interface org.neo4j.ogm.compiler.CompileContext