org.lacibus.storeaccess

Class StoreAccess

java.lang.Object

org.lacibus.storeaccess.StoreAccess

public class StoreAccess
extends java.lang.Object

The methods of this class implement specific operations using basic generic triple store methods.

Constructor Summary

Constructors

Constructor and Description
StoreAccess()

Method Summary

Modifier and Type	Method and Description
static boolean	ensureNoMatchingTriples(Item subject, Item verb, TripleStore store, StoreSession session) Ensure that there are no triples with a given subject and verb
static Item[]	getSubjects(java.util.Collection<Triple> triples) Get the subjects of a collection of triples
static java.lang.Boolean	getUniqueBooleanObject(Item subject, Item verb, TripleStore store, StoreSession session) Get the boolean that is the unique object with a given subject and verb.
static java.lang.Long	getUniqueIntegralObject(Item subject, Item verb, TripleStore store, StoreSession session) Get the integer that is the unique object with a given subject and verb.
static Datum	getUniqueObject(Item subject, Item verb, TripleStore store, StoreSession session) Get the object of the unique triple with a given subject and verb.
static Item	getUniqueSubject(Item verb, Datum object, TripleStore store, StoreSession session) Get the unique item in a triple store that is the subject of a triple with a given verb and object
static java.lang.String	getUniqueTextObject(Item subject, Item verb, TripleStore store, StoreSession session) Get the string that is the unique object with a given subject and verb.
static Triple	setUniqueObject(Item subject, Item verb, Datum object, TripleStore store, StoreSession session) Ensure that there is a unique triple with a given subject and verb, and that it has a given object.
static Triple	setUniqueTriple(Item subject, Item verb, Datum object, TripleStore store, StoreSession session) Set a unique triple with a given subject, verb and object.
static Item	uniqueItemObject(Item subject, Item verb, long sourceNr, AccessLevel onlyReadLevel, AccessLevel readOrWriteLevel, TripleStore store, StoreSession session) Get the item that is the unique object with a given subject and verb, creating it and the appropriate triple if it does not exist.
static Item	uniqueSubject(long sourceNr, AccessLevel onlyReadLevel, AccessLevel readOrWriteLevel, Item verb, Datum object, TripleStore store, StoreSession session) Get the unique subject with a given verb and object.

Methods inherited from class java.lang.Object

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

Constructor Detail

StoreAccess

public StoreAccess()

Method Detail

getSubjects

public static Item[] getSubjects(java.util.Collection<Triple> triples)

Get the subjects of a collection of triples

Parameters:

triples - a collection of triples

Returns:

an array containing the triples' subjects

uniqueSubject

public static Item uniqueSubject(long sourceNr,
                                 AccessLevel onlyReadLevel,
                                 AccessLevel readOrWriteLevel,
                                 Item verb,
                                 Datum object,
                                 TripleStore store,
                                 StoreSession session)
                          throws java.lang.Exception

Get the unique subject with a given verb and object. creating it if it does not exist.

Parameters:

sourceNr - the identification number of the source in which the subject is to be created if it does not exist.

onlyReadLevel - the only-read level of the subject if it is to be created because it does not exist.

readOrWriteLevel - the read-or-write level of the subject if it is to be created because it does not exist.

verb - a verb

object - an object

store - the triple store containing the subject, verb, object, and unique triple with that subject, verb, and object

session - the requesting session

Returns:

the subject of the unique triple with the given verb and object, if it exists or can be created, otherwise null. If the subject already exists then it need not have the given source or access levels. If there are multiple triples with the given verb and object, then null is returned.

Throws:

java.lang.Exception

getUniqueSubject

public static Item getUniqueSubject(Item verb,
                                    Datum object,
                                    TripleStore store,
                                    StoreSession session)
                             throws java.lang.Exception

Get the unique item in a triple store that is the subject of a triple with a given verb and object

Parameters:

verb - the given verb

object - the given object

store - the triple store

session - the requesting store session

Returns:

the unique item in the triple store that is the subject of a triple with the given verb and object

Throws:

java.lang.Exception

uniqueItemObject

public static Item uniqueItemObject(Item subject,
                                    Item verb,
                                    long sourceNr,
                                    AccessLevel onlyReadLevel,
                                    AccessLevel readOrWriteLevel,
                                    TripleStore store,
                                    StoreSession session)
                             throws java.lang.Exception

Get the item that is the unique object with a given subject and verb, creating it and the appropriate triple if it does not exist.

Parameters:

subject - the given subject

verb - the given verb

sourceNr - the identification number of the source in which the object is to be created if it does not exist.

onlyReadLevel - the only-read level of the object if it is to be created because it does not exist.

readOrWriteLevel - the read-or-write level of the object if it is to be created because it does not exist.

store - the triple store containing the subject, verb, object, and unique triple with that subject, verb, and object

session - the requesting session

Returns:

the item that is the object of the unique triple with the given subject and verb, if it exists or can be created, otherwise null. If the item already exists then it need not have the given source or access levels. If there are multiple triples with given subject and verb, or a single triple but which has an object that is not an item, then null is returned.

Throws:

java.lang.Exception

getUniqueTextObject

public static java.lang.String getUniqueTextObject(Item subject,
                                                   Item verb,
                                                   TripleStore store,
                                                   StoreSession session)
                                            throws java.lang.Exception

Get the string that is the unique object with a given subject and verb.

Parameters:

subject - the given subject

verb - the given verb

store - the triple store containing the subject and verb, and unique triple with that subject and verb

session - the requesting session

Returns:

the string that is the object of the unique triple with the given subject and verb if it exists, otherwise null. If there are multiple triples with given subject and verb, or a single triple but which has an object that is not a text value, then null is returned.

Throws:

java.lang.Exception

getUniqueIntegralObject

public static java.lang.Long getUniqueIntegralObject(Item subject,
                                                     Item verb,
                                                     TripleStore store,
                                                     StoreSession session)
                                              throws java.lang.Exception

Get the integer that is the unique object with a given subject and verb.

Parameters:

subject - the given subject

verb - the given verb

store - the triple store containing the subject and verb, and unique triple with that subject and verb

session - the requesting session

Returns:

the integer that is the object of the unique triple with the given subject and verb if it exists, otherwise null. If there are multiple triples with given subject and verb, or a single triple but which has an object that is not an integer, then null is returned.

Throws:

java.lang.Exception

getUniqueBooleanObject

public static java.lang.Boolean getUniqueBooleanObject(Item subject,
                                                       Item verb,
                                                       TripleStore store,
                                                       StoreSession session)
                                                throws java.lang.Exception

Get the boolean that is the unique object with a given subject and verb.

Parameters:

subject - the given subject

verb - the given verb

store - the triple store containing the subject and verb, and unique triple with that subject and verb

session - the requesting session

Returns:

the boolean that is the object of the unique triple with the given subject and verb if it exists, otherwise null. If there are multiple triples with given subject and verb, or a single triple but which has an object that is not a boolean, then null is returned.

Throws:

java.lang.Exception

getUniqueObject

public static Datum getUniqueObject(Item subject,
                                    Item verb,
                                    TripleStore store,
                                    StoreSession session)
                             throws java.lang.Exception

Get the object of the unique triple with a given subject and verb.

Parameters:

subject - the given subject

verb - the given verb

store - the triple store containing the subject and verb, and unique triple with that subject and verb

session - the requesting session

Returns:

the object of the unique triple with the given subject and verb if it exists, otherwise null. If there are multiple triples with given subject and verb, then null is returned.

Throws:

java.lang.Exception

setUniqueTriple

public static Triple setUniqueTriple(Item subject,
                                     Item verb,
                                     Datum object,
                                     TripleStore store,
                                     StoreSession session)
                              throws java.lang.Exception

Set a unique triple with a given subject, verb and object.

Parameters:

subject - the given subject

verb - the given verb

object - the given object

store - the triple store containing the subject verb, and object, and which contains or will contain the unique triple.

session - the requesting session

Returns:

the unique triple with a given subject, verb and object if it exists or can be created

Throws:

java.lang.Exception

setUniqueObject

public static Triple setUniqueObject(Item subject,
                                     Item verb,
                                     Datum object,
                                     TripleStore store,
                                     StoreSession session)
                              throws java.lang.Exception

Ensure that there is a unique triple with a given subject and verb, and that it has a given object.

Parameters:

subject - the given subject

verb - the given verb

object - the given object

store - the triple store containing the subject verb, and object, and which contains or will contain the unique triple.

session - the requesting session

Returns:

the unique triple with a given subject and verb, and that has the given object, if it exists or can be created

Throws:

java.lang.Exception

ensureNoMatchingTriples

public static boolean ensureNoMatchingTriples(Item subject,
                                              Item verb,
                                              TripleStore store,
                                              StoreSession session)
                                       throws java.lang.Exception

Ensure that there are no triples with a given subject and verb

Parameters:

subject - the subject

verb - the verb

store - the triple store containing the subject and verb.

session - the requesting store session

Returns:

true if there were no matching triples or all matching triples have been deleted, false if there were matching triples that could not be deleted. If false is returned then no triples will have been deleted.

Throws:

java.lang.Exception