com.bigdata.rdf.sparql.ast

Class PathNode

java.lang.Object

com.bigdata.bop.CoreBaseBOp

com.bigdata.bop.ModifiableBOpBase

com.bigdata.rdf.sparql.ast.ASTBase

com.bigdata.rdf.sparql.ast.PathNode

All Implemented Interfaces:

BOp, IPropertySet, Serializable, Cloneable

public class PathNode
extends ASTBase

AST Node used to represent a property path. See http://www.w3.org/TR/sparql11-query/#rTriplesSameSubjectPath for details. This class corresponds to "VerbPath". A VerbPath (PathNode) has one Path. VerbPath ::= Path A Path has one PathAlternative. Path ::= PathAlt A PathAlternative has one or more PathSequences. PathAlternative ::= PathSequence ( '|' PathSequence )* A PathSequence has one or more PathEltOrInverses. PathSequence ::= PathEltOrInverse ( '/' PathEltOrInverse )* A PathEltOrInverse has one PathElt and a boolean flag for inverse ('^'). PathEltOrInverse ::= PathElt | '^' PathElt A PathElt has a PathPrimary and an optional PathMod. PathElt ::= PathPrimary PathMod? A PathPrimary has either an iri, a PathNegatedPropertySet, or a nested Path. PathPrimary ::= iri | '!' PathNegatedPropertySet | '(' Path ')' A PathMod is one from the enumeration '?', '*', or '+'. '?' means zero or one (simple optional), '+' means one or more (fixed point), and '*' means zero or more (optional fixed point). PathMod ::= '?' | '*' | '+' A PathNegatedPropertySet is zero or more PathOneInPropertySets. PathNegatedPropertySet ::= PathOneInPropertySet | '(' (PathOneInPropertySet ( '|' PathOneInPropertySet )* )? ')' A PathOneInPropertySet is an iri and a boolean flag for inverse ('^'). PathOneInPropertySet ::= iri | '^' iri This model is actually flattened a bit by Sesame, so I followed Sesame's model instead of the grammar. In Sesame's model, the top level is PathAlternative, which contains one or more PathSequences. Each PathSequence contains one or more PathElt. Each PathElt has two modifiers - the PathMod (for arbitrary length and zero length paths) and the inverse modifier. It also has the actual element - one of either a TermNode, a nested path (a PathAlternative), a NegatedPropertySet, or a zero length path.

Author:

mikepersonick

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PathNode.PathAlternative Used to signify an OR (UNION) of multiple possible subpaths.
static class	PathNode.PathElt A specific path element.
static class	PathNode.PathMod
static class	PathNode.PathNegatedPropertySet
static class	PathNode.PathOneInPropertySet
static class	PathNode.PathSequence A sequence of paths (JOINS).

Nested classes/interfaces inherited from class com.bigdata.rdf.sparql.ast.ASTBase

ASTBase.Annotations

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
PathNode(BOp[] args, Map<String,Object> anns) Required shallow copy constructor.
PathNode(PathNode.PathAlternative arg)
PathNode(PathNode op) Constructor required for com.bigdata.bop.BOpUtility#deepCopy(FilterNode).

Method Summary

Methods

Modifier and Type	Method and Description
PathNode.PathAlternative	getPathAlternative() The root of the property path is always a PathAlternative.

Methods inherited from class com.bigdata.rdf.sparql.ast.ASTBase

addExplainHint, getExplainHints, getQueryHint, getQueryHint, getQueryHintAsBoolean, getQueryHintAsBoolean, getQueryHintAsInteger, getQueryHints, replaceAllWith, setQueryHint, setQueryHints

Methods inherited from class com.bigdata.bop.ModifiableBOpBase

addArg, addArg, addArgIfAbsent, annotations, annotationsEqual, argIterator, args, arity, clearProperty, copyAll, get, getProperty, indexOf, removeArg, replaceWith, setArg, setArgs, setId, setProperty, setUnboundProperty, toArray, toArray

Methods inherited from class com.bigdata.bop.CoreBaseBOp

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

Methods inherited from class java.lang.Object

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

Constructor Detail

PathNode

public PathNode(PathNode op)

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

PathNode

public PathNode(BOp[] args,
        Map<String,Object> anns)

Required shallow copy constructor.

PathNode

public PathNode(PathNode.PathAlternative arg)

Method Detail

getPathAlternative

public PathNode.PathAlternative getPathAlternative()

The root of the property path is always a PathAlternative.