org.nuxeo.ecm.platform.relations.services

Class RelationService

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.platform.relations.services.RelationService

All Implemented Interfaces:

Serializable, RelationManager, Adaptable, Component, Extensible, TimestampedService

public class RelationService
extends DefaultComponent
implements RelationManager

Relation service.

It handles a registry of graph instances through extension points.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,GraphDescription>	graphDescriptions Graph name -> description
Map<String,GraphFactory>	graphFactories Graph name -> factory.
Map<String,Graph>	graphRegistry Graph name -> graph instance.
protected Map<String,Class<?>>	graphTypes Graph type -> class.
static ComponentName	NAME
protected Map<String,String>	resourceAdapterRegistry

Fields inherited from class org.nuxeo.runtime.model.DefaultComponent

lastModified

Constructor Summary

Constructors

Constructor and Description
RelationService()

Method Summary

Modifier and Type	Method and Description
void	add(String graphName, List<Statement> statements) Deprecated.
void	applicationStarted(ComponentContext context) Notify the component that Nuxeo Framework finished starting all Nuxeo bundles.
void	clear(String graphName) Deprecated.
<T> T	getAdapter(Class<T> adapter) Returns an object which is an instance of the given class associated with this object.
Set<Resource>	getAllResources(Serializable object, Map<String,Object> context) Computes all resources corresponding to the given object.
Graph	getGraph(String name, CoreSession session) Gets a registered graph by name.
Graph	getGraphByName(String name) Gets a registered graph by name.
protected Graph	getGraphFromRegistries(GraphDescription graphDescription, CoreSession session) Gets the graph from the registries.
List<String>	getGraphNames() Gets the list containing the graph names.
List<String>	getGraphTypes()
List<Node>	getObjects(String graphName, Node subject, Node predicate) Deprecated.
List<Node>	getPredicates(String graphName, Node subject, Node object) Deprecated.
Resource	getResource(String namespace, Serializable object, Map<String,Object> context) Gets a resource given a namespace and a serializable object.
Serializable	getResourceRepresentation(String namespace, Resource resource, Map<String,Object> context) Gets an object representing this resource given a namespace.
List<Statement>	getStatements(String graphName) Deprecated.
List<Statement>	getStatements(String graphName, Statement statement) Deprecated.
List<Node>	getSubjects(String graphName, Node predicate, Node object) Deprecated.
Graph	getTransientGraph(String type) Gets a transient graph.
boolean	hasResource(String graphName, Resource resource) Deprecated.
boolean	hasStatement(String graphName, Statement statement) Deprecated.
protected Graph	newGraph(String className)
QueryResult	query(String graphName, String queryString, String language, String baseURI) Deprecated.
boolean	read(String graphName, InputStream in, String lang, String base) Deprecated.
void	registerContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
protected void	registerGraph(Object contribution) Registers a graph instance.
void	remove(String graphName, List<Statement> statements) Deprecated.
Long	size(String graphName) Deprecated.
void	unregisterContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
protected void	unregisterGraph(Object contribution) Unregisters a graph.
boolean	write(String graphName, OutputStream out, String lang, String base) Deprecated.

Methods inherited from class org.nuxeo.runtime.model.DefaultComponent

activate, deactivate, getApplicationStartedOrder, getLastModified, registerExtension, setLastModified, setModifiedNow, unregisterExtension

Methods inherited from class java.lang.Object

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

Field Detail

NAME

public static final ComponentName NAME

graphTypes

protected final Map<String,Class<?>> graphTypes

Graph type -> class.

graphDescriptions

protected final Map<String,GraphDescription> graphDescriptions

Graph name -> description

graphFactories

public final Map<String,GraphFactory> graphFactories

Graph name -> factory.

graphRegistry

public final Map<String,Graph> graphRegistry

Graph name -> graph instance.

resourceAdapterRegistry

protected final Map<String,String> resourceAdapterRegistry

Constructor Detail

RelationService

public RelationService()

Method Detail

registerContribution

public void registerContribution(Object contribution,
                                 String extensionPoint,
                                 ComponentInstance contributor)

Overrides:

registerContribution in class DefaultComponent

unregisterContribution

public void unregisterContribution(Object contribution,
                                   String extensionPoint,
                                   ComponentInstance contributor)

Overrides:

unregisterContribution in class DefaultComponent

getAdapter

public <T> T getAdapter(Class<T> adapter)

Description copied from interface: Adaptable

Returns an object which is an instance of the given class associated with this object. Returns null if no such object can be found.

Specified by:

getAdapter in interface Adaptable

Overrides:

getAdapter in class DefaultComponent

Parameters:

adapter - the adapter class to look up

Returns:

a object castable to the given class, or null if this object does not have an adapter for the given class

getGraphTypes

public List<String> getGraphTypes()

registerGraph

protected void registerGraph(Object contribution)

Registers a graph instance.

The graph has to be declared as using a type already registered in the graph type registry.

unregisterGraph

protected void unregisterGraph(Object contribution)

Unregisters a graph.

getGraphByName

public Graph getGraphByName(String name)

Description copied from interface: RelationManager

Gets a registered graph by name.

Specified by:

getGraphByName in interface RelationManager

Parameters:

name - string name of the graph used at registration

Returns:

the graph

getGraph

public Graph getGraph(String name,
                      CoreSession session)

Description copied from interface: RelationManager

Gets a registered graph by name.

A CoreSession should be passed to provide a context in which to store relations when using a "core" graph.

Specified by:

getGraph in interface RelationManager

Parameters:

name - string name of the graph used at registration

session - the core session

Returns:

the graph

getGraphFromRegistries

protected Graph getGraphFromRegistries(GraphDescription graphDescription,
                                       CoreSession session)

Gets the graph from the registries.

newGraph

protected Graph newGraph(String className)

getTransientGraph

public Graph getTransientGraph(String type)

Description copied from interface: RelationManager

Gets a transient graph.

Specified by:

getTransientGraph in interface RelationManager

Parameters:

type - The graph type.

Returns:

the graph.

getResource

public Resource getResource(String namespace,
                            Serializable object,
                            Map<String,Object> context)

Description copied from interface: RelationManager

Gets a resource given a namespace and a serializable object.

There can be several resources with different namespaces associated to an incoming object. A document can for instance be used to refer to itself as a precise version as well as to the set of all versions.

Context can hold any object useful for the adapters, like a CoreSession.

Specified by:

getResource in interface RelationManager

getAllResources

public Set<Resource> getAllResources(Serializable object,
                                     Map<String,Object> context)

Description copied from interface: RelationManager

Computes all resources corresponding to the given object.

Context can hold any object useful for the adapters, like a CoreSession.

Specified by:

getAllResources in interface RelationManager

Returns:

the resources as a set

getResourceRepresentation

public Serializable getResourceRepresentation(String namespace,
                                              Resource resource,
                                              Map<String,Object> context)

Description copied from interface: RelationManager

Gets an object representing this resource given a namespace.

Context can hold any object useful for the adapters, like a CoreSession.

Specified by:

getResourceRepresentation in interface RelationManager

add

@Deprecated
public void add(String graphName,
                            List<Statement> statements)

Deprecated.

Specified by:

add in interface RelationManager

See Also:

Graph.add(org.nuxeo.ecm.platform.relations.api.Statement)

clear

@Deprecated
public void clear(String graphName)

Deprecated.

Specified by:

clear in interface RelationManager

See Also:

Graph.clear()

getObjects

@Deprecated
public List<Node> getObjects(String graphName,
                                         Node subject,
                                         Node predicate)

Deprecated.

Specified by:

getObjects in interface RelationManager

See Also:

Graph.getObjects(org.nuxeo.ecm.platform.relations.api.Node, org.nuxeo.ecm.platform.relations.api.Node)

getPredicates

@Deprecated
public List<Node> getPredicates(String graphName,
                                            Node subject,
                                            Node object)

Deprecated.

Specified by:

getPredicates in interface RelationManager

See Also:

Graph.getPredicates(org.nuxeo.ecm.platform.relations.api.Node, org.nuxeo.ecm.platform.relations.api.Node)

getStatements

@Deprecated
public List<Statement> getStatements(String graphName,
                                                 Statement statement)

Deprecated.

Specified by:

getStatements in interface RelationManager

See Also:

Graph.getStatements()

getStatements

@Deprecated
public List<Statement> getStatements(String graphName)

Deprecated.

Specified by:

getStatements in interface RelationManager

See Also:

Graph.getStatements()

getSubjects

@Deprecated
public List<Node> getSubjects(String graphName,
                                          Node predicate,
                                          Node object)

Deprecated.

Specified by:

getSubjects in interface RelationManager

See Also:

Graph.getSubjects(org.nuxeo.ecm.platform.relations.api.Node, org.nuxeo.ecm.platform.relations.api.Node)

hasResource

@Deprecated
public boolean hasResource(String graphName,
                                       Resource resource)

Deprecated.

Specified by:

hasResource in interface RelationManager

See Also:

Graph.hasResource(org.nuxeo.ecm.platform.relations.api.Resource)

hasStatement

@Deprecated
public boolean hasStatement(String graphName,
                                        Statement statement)

Deprecated.

Specified by:

hasStatement in interface RelationManager

See Also:

Graph.hasStatement(org.nuxeo.ecm.platform.relations.api.Statement)

query

@Deprecated
public QueryResult query(String graphName,
                                     String queryString,
                                     String language,
                                     String baseURI)

Deprecated.

Specified by:

query in interface RelationManager

See Also:

Graph.query(java.lang.String, java.lang.String, java.lang.String)

read

@Deprecated
public boolean read(String graphName,
                                InputStream in,
                                String lang,
                                String base)

Deprecated.

Specified by:

read in interface RelationManager

See Also:

Graph.read(java.lang.String, java.lang.String, java.lang.String)

remove

@Deprecated
public void remove(String graphName,
                               List<Statement> statements)

Deprecated.

Specified by:

remove in interface RelationManager

See Also:

Graph.remove(org.nuxeo.ecm.platform.relations.api.Statement)

size

@Deprecated
public Long size(String graphName)

Deprecated.

Specified by:

size in interface RelationManager

See Also:

Graph.size()

write

@Deprecated
public boolean write(String graphName,
                                 OutputStream out,
                                 String lang,
                                 String base)

Deprecated.

Specified by:

write in interface RelationManager

See Also:

Graph.write(java.lang.String, java.lang.String, java.lang.String)

getGraphNames

public List<String> getGraphNames()

Description copied from interface: RelationManager

Gets the list containing the graph names.

Specified by:

getGraphNames in interface RelationManager

applicationStarted

public void applicationStarted(ComponentContext context)

Description copied from interface: Component

Notify the component that Nuxeo Framework finished starting all Nuxeo bundles.

Specified by:

applicationStarted in interface Component

Overrides:

applicationStarted in class DefaultComponent