ome.services.graphs

Class GraphTraversal

java.lang.Object

ome.services.graphs.GraphTraversal

public class GraphTraversal
extends Object

An alternative implementation of model object graph traversal, relying on SELECTing in advance for making decisions, instead of rolling back to savepoints to recover from failed attempts to act.

Since:

5.1.0

Author:

m.t.b.carroll@dundee.ac.uk

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	GraphTraversal.Processor Executes the planned operation.

Constructor Summary

Constructors

Constructor and Description
GraphTraversal(org.hibernate.Session session, EventContext eventContext, ACLVoter aclVoter, SystemTypes systemTypes, GraphPathBean graphPathBean, com.google.common.collect.SetMultimap<String,String> unnullable, GraphPolicy policy, GraphTraversal.Processor processor) Construct a new instance of a graph traversal manager.

Method Summary

Methods

Modifier and Type	Method and Description
Map.Entry<Collection<ome.model.IObject>,Collection<ome.model.IObject>>	planOperation(org.hibernate.Session session, Collection<? extends ome.model.IObject> objectInstances, boolean include) Traverse model object graph to determine steps for the proposed operation.
Map.Entry<com.google.common.collect.SetMultimap<String,Long>,com.google.common.collect.SetMultimap<String,Long>>	planOperation(org.hibernate.Session session, com.google.common.collect.SetMultimap<String,Long> objects, boolean include) Traverse model object graph to determine steps for the proposed operation.
void	processTargets() Process the targeted model objects.
void	unlinkTargets(boolean isUnlinkIncludeFromExclude) Remove links between the targeted model objects and the remainder of the model object graph.

Methods inherited from class java.lang.Object

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

Constructor Detail

GraphTraversal

public GraphTraversal(org.hibernate.Session session,
              EventContext eventContext,
              ACLVoter aclVoter,
              SystemTypes systemTypes,
              GraphPathBean graphPathBean,
              com.google.common.collect.SetMultimap<String,String> unnullable,
              GraphPolicy policy,
              GraphTraversal.Processor processor)

Construct a new instance of a graph traversal manager.

Parameters:

session - the Hibernate session

eventContext - the current event context

aclVoter - ACL voter for permissions checking

systemTypes - for identifying the system types

graphPathBean - the graph path bean

unnullable - properties that, while nullable, may not be nulled by a graph traversal operation

policy - how to determine which related objects to include in the operation

processor - how to operate on the resulting target object graph

Method Detail

planOperation

public Map.Entry<com.google.common.collect.SetMultimap<String,Long>,com.google.common.collect.SetMultimap<String,Long>> planOperation(org.hibernate.Session session,
                                                                                                                             com.google.common.collect.SetMultimap<String,Long> objects,
                                                                                                                             boolean include)
                                                                                                                               throws GraphException

Traverse model object graph to determine steps for the proposed operation.

Parameters:

session - the Hibernate session to use for HQL queries

objects - the model objects to process

if - the given model objects are to be included (instead of just deleted)

Returns:

the model objects included in the operation, and the deleted objects

Throws:

GraphException - if the model objects were not as expected

planOperation

public Map.Entry<Collection<ome.model.IObject>,Collection<ome.model.IObject>> planOperation(org.hibernate.Session session,
                                                                                   Collection<? extends ome.model.IObject> objectInstances,
                                                                                   boolean include)
                                                                                     throws GraphException

Traverse model object graph to determine steps for the proposed operation.

Parameters:

session - the Hibernate session to use for HQL queries

objectInstances - the model objects to process, may be unloaded with ID only

if - the given model objects are to be included (instead of just deleted)

Returns:

the model objects included in the operation, and the deleted objects, may be unloaded with ID only

Throws:

GraphException - if the model objects were not as expected

unlinkTargets

public void unlinkTargets(boolean isUnlinkIncludeFromExclude)
                   throws GraphException

Remove links between the targeted model objects and the remainder of the model object graph.

Parameters:

isUnlinkIncludeFromExclude - if GraphPolicy.Action.EXCLUDE objects must be unlinked from GraphPolicy.Action.INCLUDE objects and vice versa

Throws:

GraphException - if the user does not have permission to unlink the targets

processTargets

public void processTargets()
                    throws GraphException

Process the targeted model objects.

Throws:

GraphException - if the user does not have permission to process the targets or if a cycle is detected in the model object graph