omero.cmd.graphs

Class GraphHelper

java.lang.Object

omero.cmd.graphs.GraphHelper

public class GraphHelper
extends Object

Factors common code out of GraphQuery implementations for reuse.

Since:

5.2.3

Author:

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

Constructor Summary

Constructors

Constructor and Description
GraphHelper(Helper helper, GraphPathBean graphPathBean) Construct a helper for a graph request instance.

Method Summary

Modifier and Type	Method and Description
Set<Class<? extends IObject>>	getClassesFromNames(Collection<String> classNames) Given class names provided by the user, find the corresponding set of actual classes.
com.google.common.collect.SetMultimap<String,Long>	getTargetMultimap(Set<Class<? extends IObject>> legalClasses, Map<String,List<Long>> targetObjects) Converts the Ice StringLongListMap to a multimap.
Set<String>	getTargetSet(Set<Class<? extends IObject>> legalClasses, Collection<String> targetClasses) Converts the Ice StringSet to a set.
Set<String>	getTopLevelNames(Iterable<Class<? extends IObject>> modelClasses) Get the simple names of the top-level superclasses of the given classes.
GraphTraversal	prepareGraphTraversal(List<omero.cmd.graphs.ChildOption> childOptions, Set<GraphPolicy.Ability> requiredPermissions, GraphPolicy graphPolicy, Iterable<com.google.common.base.Function<GraphPolicy,GraphPolicy>> graphPolicyAdjusters, ACLVoter aclVoter, SystemTypes systemTypes, GraphPathBean graphPathBean, com.google.common.collect.SetMultimap<String,String> unnullable, GraphTraversal.Processor processor, boolean dryRun) Deprecated. from OMERO 5.4 the systemTypes argument is no longer included
void	publishEventLog(ApplicationContext context, String action, String className, Collection<Long> ids) Publish database changes to the event log.

Methods inherited from class java.lang.Object

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

Constructor Detail

GraphHelper

public GraphHelper(Helper helper,
                   GraphPathBean graphPathBean)

Construct a helper for a graph request instance.

Parameters:

helper - the general request helper for the graph request instance

graphPathBean - the graph path bean

Method Detail

getClassesFromNames

public Set<Class<? extends IObject>> getClassesFromNames(Collection<String> classNames)

Given class names provided by the user, find the corresponding set of actual classes.

Parameters:

classNames - names of model object classes

Returns:

the named classes

prepareGraphTraversal

public GraphTraversal prepareGraphTraversal(List<omero.cmd.graphs.ChildOption> childOptions,
                                            Set<GraphPolicy.Ability> requiredPermissions,
                                            GraphPolicy graphPolicy,
                                            Iterable<com.google.common.base.Function<GraphPolicy,GraphPolicy>> graphPolicyAdjusters,
                                            ACLVoter aclVoter,
                                            SystemTypes systemTypes,
                                            GraphPathBean graphPathBean,
                                            com.google.common.collect.SetMultimap<String,String> unnullable,
                                            GraphTraversal.Processor processor,
                                            boolean dryRun)

Deprecated. from OMERO 5.4 the systemTypes argument is no longer included

Construct a graph traversal manager for a GraphQuery request.

Parameters:

childOptions - the child options set on the request

requiredPermissions - the abilities that the user must have to operate upon an object for it to be included

graphPolicy - the graph policy for the request

graphPolicyAdjusters - the adjusters to be applied to the graph policy

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

processor - how to operate on the resulting target object graph

dryRun - if the request should skip the actual model object updates

Returns:

the new graph traversal manager

getTargetSet

public Set<String> getTargetSet(Set<Class<? extends IObject>> legalClasses,
                                Collection<String> targetClasses)

Converts the Ice StringSet to a set.

Parameters:

legalClasses - legal target object classes

targetClasses - the actual target object classes

Returns:

a set of the legal model objects to process

Throws:

InternalException - if any of the target classes are illegal

getTargetMultimap

public com.google.common.collect.SetMultimap<String,Long> getTargetMultimap(Set<Class<? extends IObject>> legalClasses,
                                                                            Map<String,List<Long>> targetObjects)

Converts the Ice StringLongListMap to a multimap.

Parameters:

legalClasses - legal target object classes

targetObjects - the model objects to process

Returns:

a multimap of the legal model objects to process

Throws:

InternalException - if any of the target object classes are illegal

getTopLevelNames

public Set<String> getTopLevelNames(Iterable<Class<? extends IObject>> modelClasses)

Get the simple names of the top-level superclasses of the given classes.

Parameters:

modelClasses - some model classes

Returns:

the simple names of their top-level classes

publishEventLog

public void publishEventLog(ApplicationContext context,
                            String action,
                            String className,
                            Collection<Long> ids)

Publish database changes to the event log.

Parameters:

context - the context for publishing the application event

action - the name of the change action

className - the class of objects that were changed

ids - the IDs of the objects that were changed