com.bigdata.rdf.spo

Class SPOStarJoin

java.lang.Object

com.bigdata.bop.CoreBaseBOp

com.bigdata.bop.BOpBase

com.bigdata.bop.AbstractAccessPathOp<E>

com.bigdata.bop.ap.Predicate<ISPO>

com.bigdata.rdf.spo.SPOPredicate

com.bigdata.rdf.spo.SPOStarJoin

All Implemented Interfaces:

BOp, IPredicate<ISPO>, IStarJoin<ISPO>, IPropertySet, Serializable, Cloneable

public class SPOStarJoin
extends SPOPredicate
implements IStarJoin<ISPO>, Serializable

Implementation of a star join for SPOs. See IStarJoin.

Author:

Mike Personick

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SPOStarJoin.Annotations
static class	SPOStarJoin.SPOStarConstraint Implementation of a star constraint for SPOs.

Nested classes/interfaces inherited from interface com.bigdata.relation.rule.IStarJoin

IStarJoin.IStarConstraint<E>

Field Summary

Fields inherited from class com.bigdata.bop.CoreBaseBOp

DEFAULT_INITIAL_CAPACITY

Fields inherited from interface com.bigdata.bop.BOp

NOANNS, NOARGS

Constructor Summary

Constructors

Constructor and Description
SPOStarJoin(BOp[] values, Map<String,Object> annotations) Required shallow copy constructor.
SPOStarJoin(SPOPredicate pred) Construct an SPO star join from a normal SPO predicate.
SPOStarJoin(SPOStarJoin op) Constructor required for com.bigdata.bop.BOpUtility#deepCopy(FilterNode).

Method Summary

Methods

Modifier and Type	Method and Description
void	addStarConstraint(IStarJoin.IStarConstraint<ISPO> constraint) Add an SPO star constraint to this star join.
SPOPredicate	asBound(IBindingSet bindingSet) Return an as-bound version of this star join and its star contraints using the supplied binding set.
Iterator<IVariable>	getConstraintVariables() Return an iterator over the constraint variables for this star join.
int	getNumStarConstraints() Return the number of star constraints for this star join.
Iterator<IStarJoin.IStarConstraint<ISPO>>	getStarConstraints() Return an iterator over the SPO star constraints for this star join.
String	toString(IBindingSet bindingSet) Representation of the predicate with variable bindings.

Methods inherited from class com.bigdata.rdf.spo.SPOPredicate

c, clone, includeHistory, o, p, s, sid

Methods inherited from class com.bigdata.bop.ap.Predicate

_asBound, addAccessPathFilter, addIndexLocalFilter, asBound, asBound, checkArgs, clearAnnotations, get, get, getAccessPathExpander, getAccessPathFilter, getIndexLocalFilter, getKeyOrder, getOnlyRelationName, getPartitionId, getRelationCount, getRelationName, getTimestamp, getVariableCount, getVariableCount, isFullyBound, isOptional, isRemoteAccessPath, range, setArg, setBOpId, setPartitionId, setRelationName, setTimestamp, toString

Methods inherited from class com.bigdata.bop.BOpBase

__replaceArg, _clearProperty, _set, _setProperty, annotations, annotationsCopy, annotationsEqual, annotationsRef, argIterator, args, argsCopy, arity, clearProperty, deepCopy, deepCopy, getProperty, setArg, setProperty, setUnboundProperty, toArray, toArray

Methods inherited from class com.bigdata.bop.CoreBaseBOp

annotationsEqual, annotationsToString, annotationsToString, annotationValueToString, equals, getEvaluationContext, getId, getProperty, getRequiredProperty, hashCode, indent, isController, mutation, shortenName, toShortString, toString

Methods inherited from class java.lang.Object

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.bigdata.bop.IPredicate

asBound, asBound, equals, get, get, getAccessPathExpander, getAccessPathFilter, getIndexLocalFilter, getKeyOrder, getOnlyRelationName, getPartitionId, getRelationCount, getRelationName, getTimestamp, getVariableCount, getVariableCount, hashCode, isFullyBound, isOptional, isRemoteAccessPath, setArg, setBOpId, setPartitionId, setRelationName, toString

Methods inherited from interface com.bigdata.bop.BOp

annotations, argIterator, args, arity, clone, getEvaluationContext, getId, getProperty, getRequiredProperty, isController, setProperty, toArray, toArray, toShortString, toString

Methods inherited from interface cutthecrap.utils.striterators.IPropertySet

getProperty

Constructor Detail

SPOStarJoin

public SPOStarJoin(BOp[] values,
           Map<String,Object> annotations)

Required shallow copy constructor.

SPOStarJoin

public SPOStarJoin(SPOStarJoin op)

Constructor required for com.bigdata.bop.BOpUtility#deepCopy(FilterNode).

SPOStarJoin

public SPOStarJoin(SPOPredicate pred)

Construct an SPO star join from a normal SPO predicate. The star join will have a triple pattern of (S,?,?) instead of the (S,P,O) from the original SPO predicate. This way all SPOs for the common subject are considered. SPO star constraints must be added later to make this star join selective.

Parameters:

pred - the normal SPO predicate from which to pull the S

Method Detail

addStarConstraint

public void addStarConstraint(IStarJoin.IStarConstraint<ISPO> constraint)

Add an SPO star constraint to this star join.

Specified by:

addStarConstraint in interface IStarJoin<ISPO>

Parameters:

constraint - the star constraint

getStarConstraints

public Iterator<IStarJoin.IStarConstraint<ISPO>> getStarConstraints()

Return an iterator over the SPO star constraints for this star join.

Specified by:

getStarConstraints in interface IStarJoin<ISPO>

Returns:

the star constraints iterator

getNumStarConstraints

public int getNumStarConstraints()

Return the number of star constraints for this star join.

Specified by:

getNumStarConstraints in interface IStarJoin<ISPO>

Returns:

the number of star constraints

getConstraintVariables

public Iterator<IVariable> getConstraintVariables()

Return an iterator over the constraint variables for this star join.

Specified by:

getConstraintVariables in interface IStarJoin<ISPO>

Returns:

the star constraints' variables iterator

asBound

public SPOPredicate asBound(IBindingSet bindingSet)

Return an as-bound version of this star join and its star contraints using the supplied binding set.

Specified by:

asBound in interface IPredicate<ISPO>

Overrides:

asBound in class SPOPredicate

Parameters:

bindingSet - The binding set.

Returns:

The as-bound IPredicate -or- null if the IPredicate can not be unified with the IBindingSet.

See Also:

(RDR query does too much work)

toString

public String toString(IBindingSet bindingSet)

Description copied from interface: IPredicate

Representation of the predicate with variable bindings.

Specified by:

toString in interface IPredicate<ISPO>

Overrides:

toString in class Predicate<ISPO>

Parameters:

bindingSet - The variable bindings