Package org.eclipse.rdf4j.query.algebra.evaluation.iterator

Class SPARQLMinusIteration<X extends Exception>

java.lang.Object

org.eclipse.rdf4j.common.iteration.AbstractCloseableIteration<E,X>

org.eclipse.rdf4j.common.iteration.IterationWrapper<E,X>

org.eclipse.rdf4j.common.iteration.FilterIteration<BindingSet,X>

org.eclipse.rdf4j.query.algebra.evaluation.iterator.SPARQLMinusIteration<X>

All Implemented Interfaces:

AutoCloseable, CloseableIteration<BindingSet,X>, Iteration<BindingSet,X>

public class SPARQLMinusIteration<X extends Exception>
extends FilterIteration<BindingSet,X>

An Iteration that returns the results of an Iteration (the left argument) MINUS any results that are compatible with results of another Iteration (the right argument) or that have no shared variables. This iteration uses the formal definition of the SPARQL 1.1 MINUS operator to determine which BindingSets to return.

Author:

Jeen

See Also:

• SPARQL Algebra Documentation

Field Summary

Fields inherited from class org.eclipse.rdf4j.common.iteration.IterationWrapper

wrappedIter

Constructor Summary

Constructors

Constructor	Description
SPARQLMinusIteration(Iteration<BindingSet,X> leftArg, Iteration<BindingSet,X> rightArg)	Creates a new MinusIteration that returns the results of the left argument minus the results of the right argument.
SPARQLMinusIteration(Iteration<BindingSet,X> leftArg, Iteration<BindingSet,X> rightArg, boolean distinct)	Deprecated, for removal: This API element is subject to removal in a future version.

Method Summary

Modifier and Type	Method	Description
protected boolean	accept(BindingSet object)	Tests whether or not the specified object should be returned by this Iteration.
protected long	clearExcludeSet()
protected Iteration<BindingSet,X>	getRightArg()
protected void	handleClose()	Closes this Iteration and also closes the wrapped Iteration if it is a CloseableIteration.
protected Set<BindingSet>	makeSet()
protected Set<String>	makeSet(Set<String> set)
protected Set<BindingSet>	makeSet(Iteration<BindingSet,X> rightArg2)

Methods inherited from class org.eclipse.rdf4j.common.iteration.FilterIteration

hasNext, next

Methods inherited from class org.eclipse.rdf4j.common.iteration.IterationWrapper

remove

Methods inherited from class org.eclipse.rdf4j.common.iteration.AbstractCloseableIteration

close, isClosed

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.rdf4j.common.iteration.Iteration

stream

Constructor Details

SPARQLMinusIteration

public SPARQLMinusIteration(Iteration<BindingSet,X> leftArg,
 Iteration<BindingSet,X> rightArg)

Creates a new MinusIteration that returns the results of the left argument minus the results of the right argument. By default, duplicates are not filtered from the results.

Parameters:

leftArg - An Iteration containing the main set of elements.

rightArg - An Iteration containing the set of elements that should be filtered from the main set.

SPARQLMinusIteration

@Deprecated(since="4.0.0",
            forRemoval=true)
public SPARQLMinusIteration(Iteration<BindingSet,X> leftArg,
 Iteration<BindingSet,X> rightArg,
 boolean distinct)

Deprecated, for removal: This API element is subject to removal in a future version.

Creates a new MinusIteration that returns the results of the left argument minus the results of the right argument.

Parameters:

leftArg - An Iteration containing the main set of elements.

rightArg - An Iteration containing the set of elements that should be filtered from the main set.

distinct - This argument is ignored

Method Details

accept

protected boolean accept(BindingSet object)
                  throws X

Description copied from class: FilterIteration

Tests whether or not the specified object should be returned by this Iteration. All objects from the wrapped Iteration pass through this method in the same order as they are coming from the wrapped Iteration.

Specified by:

accept in class FilterIteration<BindingSet,X extends Exception>

Parameters:

object - The object to be tested.

Returns:

true if the object should be returned, false otherwise.

Throws:

X

makeSet

protected Set<BindingSet> makeSet()
                           throws X

Throws:

X extends Exception

makeSet

protected Set<String> makeSet(Set<String> set)
                       throws X

Throws:

X extends Exception

makeSet

protected Set<BindingSet> makeSet(Iteration<BindingSet,X> rightArg2)
                           throws X

Throws:

X extends Exception

handleClose

protected void handleClose()
                    throws X

Description copied from class: IterationWrapper

Closes this Iteration and also closes the wrapped Iteration if it is a CloseableIteration.

Overrides:

handleClose in class FilterIteration<BindingSet,X extends Exception>

Throws:

X

getRightArg

protected Iteration<BindingSet,X> getRightArg()

Returns:

Returns the rightArg.

clearExcludeSet

protected long clearExcludeSet()