org.lacibus.storeaccess

Class DependentsSpec

java.lang.Object

org.lacibus.storeaccess.DependentsSpec

All Implemented Interfaces:

java.io.Serializable

public class DependentsSpec
extends java.lang.Object
implements java.io.Serializable

A specification of dependencies between items. When item I2 is dependent on item I1, and a change is made to I1, then a similar change should be made to I2. For example, if a page is deleted, then all the blocks on the page should be deleted. In the simplest case, the dependencies can be specified by a single verb, for example "Page Has Block", or set of verbs, for example {"Page Has Block", "Page Has Assignment"}. In more complex cases, there are items that are dependent on the dependent items, for example drafts of blocks. The specification therefore consists of a map whose keys are verbs and whose values are dependent specifications. In the simplest case, the values are null.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DependentsSpec()

Method Summary

Modifier and Type	Method and Description
void	add(DependentsSpec spec) Add dependencies.
void	addDependent(Item verb) Add a simple dependency
void	addDependent(Item verb, DependentsSpec subDependents) Add a complex dependency
java.util.Set<Item>	getImmediatelyDependentItems(Item subject, Item verb, TripleStore store, StoreSession session) Get the items that are the objects of triples with a given subject and verb.
DependentsSpec	getSubDependents(Item verb) Get the dependencies on the objects of a verb
java.util.Set<Item>	getVerbs() Get the verbs defining first-level dependencies

Methods inherited from class java.lang.Object

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

Constructor Detail

DependentsSpec

public DependentsSpec()

Method Detail

addDependent

public void addDependent(Item verb)

Add a simple dependency

Parameters:

verb - a verb whose objects have no items dependent on them.

addDependent

public void addDependent(Item verb,
                         DependentsSpec subDependents)

Add a complex dependency

Parameters:

verb - a verb whose objects have items dependent on them.

subDependents - a specification of the dependencies on the objects of the verb

getSubDependents

public DependentsSpec getSubDependents(Item verb)

Get the dependencies on the objects of a verb

Parameters:

verb - a verb

Returns:

the dependencies on the objects of the verb

getVerbs

public java.util.Set<Item> getVerbs()

Get the verbs defining first-level dependencies

Returns:

the verbs defining first-level dependencies

add

public void add(DependentsSpec spec)

Add dependencies. Existing dependencies are not duplicated.

Parameters:

spec - the dependencies to be added

getImmediatelyDependentItems

public java.util.Set<Item> getImmediatelyDependentItems(Item subject,
                                                        Item verb,
                                                        TripleStore store,
                                                        StoreSession session)
                                                 throws java.lang.Exception

Get the items that are the objects of triples with a given subject and verb.

Parameters:

subject - the given subject

verb - the given verb

store - the triple store containing the triples

session - the requesting store session

Returns:

the items that are objects of triples with the given subject and verb

Throws:

java.lang.Exception