Package se.liu.ida.hefquin.base.datastructures.impl

Class SolutionMappingsIndexForMixedUsage

java.lang.Object

se.liu.ida.hefquin.base.datastructures.impl.WrappingSolutionMappingsIndex

se.liu.ida.hefquin.base.datastructures.impl.SolutionMappingsIndexForMixedUsage

All Implemented Interfaces:

Iterable<SolutionMapping>, Collection<SolutionMapping>, SolutionMappingsIndex, StatsProvider

public class SolutionMappingsIndexForMixedUsage
extends WrappingSolutionMappingsIndex

Wraps another SolutionMappingsIndex and, for every method that returns an Iterable of solution mappings, this implementation copies the Iterable returned by the wrapped index into a new list and, then, returns that list. This class can be used for cases in which adding and probing into such an index may happen concurrently. In such cases, there can be conflicts when the index is updated by one thread while another thread is still consuming an Iterable returned by one of the methods. Returning a copy of the Iterable avoids such conflicts.

Field Summary

Fields inherited from class se.liu.ida.hefquin.base.datastructures.impl.WrappingSolutionMappingsIndex

wrappedIndex

Constructor Summary

Constructors

Constructor	Description
SolutionMappingsIndexForMixedUsage(SolutionMappingsIndex wrappedIndex)

Method Summary

Modifier and Type	Method	Description
static Iterable<SolutionMapping>	copy(Iterable<SolutionMapping> i)
Iterable<SolutionMapping>	findSolutionMappings(org.apache.jena.sparql.core.Var var, org.apache.jena.graph.Node value)	Returns an iterator over all solution mappings in this index that map the given variable to the given value.
Iterable<SolutionMapping>	findSolutionMappings(org.apache.jena.sparql.core.Var var1, org.apache.jena.graph.Node value1, org.apache.jena.sparql.core.Var var2, org.apache.jena.graph.Node value2)	Returns an iterator over all solution mappings in this index that map the first variable to the first value and the second variable to the second value.
Iterable<SolutionMapping>	findSolutionMappings(org.apache.jena.sparql.core.Var var1, org.apache.jena.graph.Node value1, org.apache.jena.sparql.core.Var var2, org.apache.jena.graph.Node value2, org.apache.jena.sparql.core.Var var3, org.apache.jena.graph.Node value3)	This method is a three-variables version of the method SolutionMappingsIndex.findSolutionMappings(Var, Node).
Iterable<SolutionMapping>	getAllSolutionMappings()	Returns all solution mappings currently in this index.
Iterable<SolutionMapping>	getJoinPartners(SolutionMapping sm)	Returns an iterator over all solution mappings in this index that are compatible with the given solution mappings.
<T> T[]	toArray(T[] a)

Methods inherited from class se.liu.ida.hefquin.base.datastructures.impl.WrappingSolutionMappingsIndex

add, addAll, clear, contains, containsAll, getStats, isEmpty, remove, removeAll, resetStats, retainAll, size, toArray

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface se.liu.ida.hefquin.base.datastructures.SolutionMappingsIndex

iterator

Constructor Details

SolutionMappingsIndexForMixedUsage

public SolutionMappingsIndexForMixedUsage(SolutionMappingsIndex wrappedIndex)

Method Details

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<SolutionMapping>

Overrides:

toArray in class WrappingSolutionMappingsIndex

getJoinPartners

public Iterable<SolutionMapping> getJoinPartners(SolutionMapping sm)
                                          throws UnsupportedOperationException

Description copied from interface: SolutionMappingsIndex

Returns an iterator over all solution mappings in this index that are compatible with the given solution mappings. Implementations may choose to support this method only for specific types of solution mappings (e.g., with specific variables), in which case an UnsupportedOperationException will be thrown if the method is called with an unsupported variable.

Specified by:

getJoinPartners in interface SolutionMappingsIndex

Overrides:

getJoinPartners in class WrappingSolutionMappingsIndex

Throws:

UnsupportedOperationException

findSolutionMappings

public Iterable<SolutionMapping> findSolutionMappings(org.apache.jena.sparql.core.Var var,
 org.apache.jena.graph.Node value)
                                               throws UnsupportedOperationException

Description copied from interface: SolutionMappingsIndex

Returns an iterator over all solution mappings in this index that map the given variable to the given value. Implementations may choose to support this method only for specific variables, in which case an UnsupportedOperationException will be thrown if the method is called with an unsupported variable. The result of this method should essentially be the same as the result of calling SolutionMappingsIndex.getJoinPartners(SolutionMapping) with a solution mapping that is defined only for the given variable and that maps this variable to the given value.

Specified by:

findSolutionMappings in interface SolutionMappingsIndex

Overrides:

findSolutionMappings in class WrappingSolutionMappingsIndex

Throws:

UnsupportedOperationException

findSolutionMappings

public Iterable<SolutionMapping> findSolutionMappings(org.apache.jena.sparql.core.Var var1,
 org.apache.jena.graph.Node value1,
 org.apache.jena.sparql.core.Var var2,
 org.apache.jena.graph.Node value2)
                                               throws UnsupportedOperationException

Description copied from interface: SolutionMappingsIndex

Returns an iterator over all solution mappings in this index that map the first variable to the first value and the second variable to the second value. Hence, this method is a two-variables version of the method SolutionMappingsIndex.findSolutionMappings(Var, Node).

Specified by:

findSolutionMappings in interface SolutionMappingsIndex

Overrides:

findSolutionMappings in class WrappingSolutionMappingsIndex

Throws:

UnsupportedOperationException

findSolutionMappings

public Iterable<SolutionMapping> findSolutionMappings(org.apache.jena.sparql.core.Var var1,
 org.apache.jena.graph.Node value1,
 org.apache.jena.sparql.core.Var var2,
 org.apache.jena.graph.Node value2,
 org.apache.jena.sparql.core.Var var3,
 org.apache.jena.graph.Node value3)
                                               throws UnsupportedOperationException

Description copied from interface: SolutionMappingsIndex

This method is a three-variables version of the method SolutionMappingsIndex.findSolutionMappings(Var, Node).

Specified by:

findSolutionMappings in interface SolutionMappingsIndex

Overrides:

findSolutionMappings in class WrappingSolutionMappingsIndex

Throws:

UnsupportedOperationException

getAllSolutionMappings

public Iterable<SolutionMapping> getAllSolutionMappings()

Description copied from interface: SolutionMappingsIndex

Returns all solution mappings currently in this index.

Specified by:

getAllSolutionMappings in interface SolutionMappingsIndex

Overrides:

getAllSolutionMappings in class WrappingSolutionMappingsIndex

copy

public static Iterable<SolutionMapping> copy(Iterable<SolutionMapping> i)