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
Map<String,GraphFactory>	graphFactories Graph name -> factory.
Map<String,Graph>	graphRegistry Graph name -> graph instance.
static ComponentName	NAME

Constructor Summary

Constructors

Constructor and Description
RelationService()

Method Summary

Methods

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,Serializable> 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.
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,Serializable> context) Gets a resource given a namespace and a serializable object.
Serializable	getResourceRepresentation(String namespace, Resource resource, Map<String,Serializable> 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.
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)
void	remove(String graphName, List<Statement> statements) Deprecated.
Long	size(String graphName) Deprecated.
void	unregisterContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
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, unregisterExtension

Methods inherited from class java.lang.Object

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

Field Detail

NAME

public static final ComponentName NAME

graphFactories

public final Map<String,GraphFactory> graphFactories

Graph name -> factory.

graphRegistry

public final Map<String,Graph> graphRegistry

Graph name -> graph instance.

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()

getGraphByName

public Graph getGraphByName(String name)
                     throws ClientException

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

Throws:

ClientException

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

getTransientGraph

public Graph getTransientGraph(String type)
                        throws ClientException

Description copied from interface: RelationManager

Gets a transient graph.

Specified by:

getTransientGraph in interface RelationManager

Parameters:

type - The graph type.

Returns:

the graph.

Throws:

ClientException

getResource

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

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

Throws:

ClientException

getAllResources

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

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

Throws:

ClientException

getResourceRepresentation

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

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

Throws:

ClientException

add

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

Deprecated.

Specified by:

add in interface RelationManager

Throws:

ClientException

See Also:

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

clear

@Deprecated
public void clear(String graphName)
           throws ClientException

Deprecated.

Specified by:

clear in interface RelationManager

Throws:

ClientException

See Also:

Graph.clear()

getObjects

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

Deprecated.

Specified by:

getObjects in interface RelationManager

Throws:

ClientException

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)
                         throws ClientException

Deprecated.

Specified by:

getPredicates in interface RelationManager

Throws:

ClientException

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)
                              throws ClientException

Deprecated.

Specified by:

getStatements in interface RelationManager

Throws:

ClientException

See Also:

Graph.getStatements()

getStatements

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

Deprecated.

Specified by:

getStatements in interface RelationManager

Throws:

ClientException

See Also:

Graph.getStatements()

getSubjects

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

Deprecated.

Specified by:

getSubjects in interface RelationManager

Throws:

ClientException

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)
                    throws ClientException

Deprecated.

Specified by:

hasResource in interface RelationManager

Throws:

ClientException

See Also:

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

hasStatement

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

Deprecated.

Specified by:

hasStatement in interface RelationManager

Throws:

ClientException

See Also:

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

query

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

Deprecated.

Specified by:

query in interface RelationManager

Throws:

ClientException

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)
             throws ClientException

Deprecated.

Specified by:

read in interface RelationManager

Throws:

ClientException

See Also:

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

remove

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

Deprecated.

Specified by:

remove in interface RelationManager

Throws:

ClientException

See Also:

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

size

@Deprecated
public Long size(String graphName)
          throws ClientException

Deprecated.

Specified by:

size in interface RelationManager

Throws:

ClientException

See Also:

Graph.size()

write

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

Deprecated.

Specified by:

write in interface RelationManager

Throws:

ClientException

See Also:

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

getGraphNames

public List<String> getGraphNames()
                           throws ClientException

Description copied from interface: RelationManager

Gets the list containing the graph names.

Specified by:

getGraphNames in interface RelationManager

Throws:

ClientException

applicationStarted

public void applicationStarted(ComponentContext context)
                        throws Exception

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

Throws:

Exception