org.apache.marmotta.ldpath.api.selectors

Interface NodeSelector<Node>

All Superinterfaces:

LDPathConstruct<Node>

All Known Implementing Classes:

FunctionSelector, GroupedSelector, IntersectionSelector, PathSelector, PropertySelector, RecursivePathSelector, ReversePropertySelector, SelfSelector, StringConstantSelector, TestingSelector, UnionSelector, WildcardSelector

public interface NodeSelector<Node>
extends LDPathConstruct<Node>

A node selector takes as argument a KiWiNode and returns a collection of selected

Author: Sebastian Schaffert

Method Summary

Methods

Modifier and Type	Method and Description
String	getName(NodeBackend<Node> backend) Return a name for this selector to be used as the name for the whole path if not explicitly specified.
Collection<Node>	select(RDFBackend<Node> backend, Node context, List<Node> path, Map<Node,List<Node>> resultPaths) Apply the selector to the context node passed as argument and return the collection of selected nodes in appropriate order.

Methods inherited from interface org.apache.marmotta.ldpath.api.LDPathConstruct

getPathExpression

Method Detail

select

Collection<Node> select(RDFBackend<Node> backend,
                      Node context,
                      List<Node> path,
                      Map<Node,List<Node>> resultPaths)

Apply the selector to the context node passed as argument and return the collection of selected nodes in appropriate order.

Parameters:

context - the node where to start the selection

path - the path leading to and including the context node in the current evaluation of LDPath; may be null, in which case path tracking is disabled

resultPaths - a map where each of the result nodes maps to a path leading to the result node in the LDPath evaluation; if null, path tracking is disabled and the path argument is ignored

Returns:

the collection of selected nodes

getName

String getName(NodeBackend<Node> backend)

Return a name for this selector to be used as the name for the whole path if not explicitly specified. In complex selector expressions, this is typically delegated to the first occurrence of an atomic selector.

Implementations can throw UnsupportedOperationException in case returning a name is not reasonable or ambiguous.

Throws:

UnsupportedOperationException - in case returning a name is not reasonable