org.lacibus.storeaccess

Class Join

java.lang.Object

org.lacibus.storeaccess.Join

public class Join
extends java.lang.Object

An instance of this class applies a set of constraints to the triples in a triple store to obtain a set of constrained triples.

Field Summary

Fields

Modifier and Type	Field and Description
static int	limitSizeMultiplier Constant used to determine the join limit size

Constructor Summary

Constructors

Constructor and Description
Join(JoinConstraint[] constraints) Create a join

Method Summary

Modifier and Type	Method and Description
static Join	copy(Join join) Copy a join
java.util.List<ConstrainedTriples>	extend(JoinConstraint[] newConstraints, TripleStore store, StoreSession session) Extend the join by adding new constraints, and make the extended join.
ConstrainedTriples	getConstrainedTriples(Triple[] triples, StoreSession session) Get a constrained triples record from a triples array.
java.util.List<ConstrainedTriples>	make(TripleStore store, StoreSession session) Make the join
java.util.List<ConstrainedTriples>	make(TripleStore store, StoreSession session, boolean test)

Methods inherited from class java.lang.Object

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

Field Detail

limitSizeMultiplier

public static final int limitSizeMultiplier

Constant used to determine the join limit size

See Also:

Constant Field Values

Constructor Detail

Join

public Join(JoinConstraint[] constraints)
     throws TripleStoreNonFatalException

Create a join

Parameters:

constraints - the constraints that are applied in the join

Throws:

TripleStoreNonFatalException

Method Detail

copy

public static Join copy(Join join)
                 throws TripleStoreNonFatalException

Copy a join

Parameters:

join - the join to be copied

Returns:

a copy of the join

Throws:

TripleStoreNonFatalException

make

public java.util.List<ConstrainedTriples> make(TripleStore store,
                                               StoreSession session)
                                        throws JoinException,
                                               TripleStoreNonFatalException,
                                               TripleStoreFatalException,
                                               SourceConnectorException,
                                               NotInOperationException

Make the join

Parameters:

store - the triple store to whose triples the constraints are to be applied

session - the requesting store session.

Returns:

a list of the constrained triples resulting from the join

Throws:

JoinException

TripleStoreNonFatalException

TripleStoreFatalException

SourceConnectorException

NotInOperationException

make

public java.util.List<ConstrainedTriples> make(TripleStore store,
                                               StoreSession session,
                                               boolean test)
                                        throws JoinException,
                                               TripleStoreNonFatalException,
                                               TripleStoreFatalException,
                                               SourceConnectorException,
                                               NotInOperationException

Throws:

JoinException

TripleStoreNonFatalException

TripleStoreFatalException

SourceConnectorException

NotInOperationException

extend

public java.util.List<ConstrainedTriples> extend(JoinConstraint[] newConstraints,
                                                 TripleStore store,
                                                 StoreSession session)
                                          throws JoinException,
                                                 TripleStoreNonFatalException,
                                                 TripleStoreFatalException,
                                                 SourceConnectorException,
                                                 NotInOperationException

Extend the join by adding new constraints, and make the extended join.

Parameters:

newConstraints - new constraints to be added to the join

store - the triple store in which the join is being extended

session - the requesting store session

Returns:

a list of the constrained triples resulting from the extended join. Each of these will be an extension of a constrained triples from the original join. Some constrained triples from the original join may not have extensions that are present in the extended join.

Throws:

JoinException

TripleStoreNonFatalException

TripleStoreFatalException

SourceConnectorException

NotInOperationException

getConstrainedTriples

public ConstrainedTriples getConstrainedTriples(Triple[] triples,
                                                StoreSession session)
                                         throws TripleStoreNonFatalException,
                                                TripleStoreFatalException,
                                                SourceConnectorException,
                                                NotInOperationException

Get a constrained triples record from a triples array. This is done by checking that the triples in the given array satisfy the constraints and creating an assignments map for them.

Parameters:

triples - an array of triples that correspond to the constraints of the join.

session - the requesting store session

Returns:

an instance of the constrained triples class with the given array of triples and the assignment of values to unknowns that it implies, or null if there is no implied assignment of values to unknowns.

Throws:

TripleStoreNonFatalException

TripleStoreFatalException

SourceConnectorException

NotInOperationException