net.fortytwo.stream.caching

Class Solution<T>

java.lang.Object

net.fortytwo.stream.caching.SolutionPattern

net.fortytwo.stream.caching.Solution<T>

public class Solution<T>
extends SolutionPattern

A solution mapping of variables to values. A complete solution contains all of the variables of a query, whereas a partial solution contains a subset of those variables. Logically, a SesameStream query index is a set of solutions associated with their queries.

Author:

Joshua Shinavier (http://fortytwo.net)

Nested Class Summary

Nested classes/interfaces inherited from class net.fortytwo.stream.caching.SolutionPattern

SolutionPattern.ContainmentRelation

Field Summary

Fields inherited from class net.fortytwo.stream.caching.SolutionPattern

expirationTime, matchedPatterns, remainingPatterns

Constructor Summary

Constructors

Constructor and Description
Solution(int totalPatterns, int index, Bindings<T> bindings, long expirationTime) Constructs a solution in which a single tuple pattern of a graph pattern has been matched
Solution(int totalPatterns, Solution<T> first, Solution<T> second)
Solution(Solution<T> other) Copy constructor
Solution(Solution<T> other, int index)
Solution(Solution<T> other, int index, Bindings<T> newBindings)

Method Summary

Modifier and Type	Method and Description
boolean	composableWith(Solution<T> other, Query.QueryVariables vars) Checks for non-overlapping patterns and compatible bindings between this solution and another solution, potentially reducing work and eliminating false positives from query results.
Bindings<T>	getBindings() Gets the variables bindings of this solution
void	setBindings(Bindings<T> bindings) Sets the variable bindings of this solution.

Methods inherited from class net.fortytwo.stream.caching.SolutionPattern

compareExpirationTimes, copyFrom, disjointWith, isComplete, isExpired, minExpirationTime, relateTo, setExpirationTime

Methods inherited from class java.lang.Object

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

Constructor Detail

Solution

public Solution(Solution<T> other)

Copy constructor

Parameters:

other - another solution from which to produce a shallow copy

Solution

public Solution(int totalPatterns,
                int index,
                Bindings<T> bindings,
                long expirationTime)

Constructs a solution in which a single tuple pattern of a graph pattern has been matched

Parameters:

totalPatterns - the total number of tuple patterns in the graph pattern

index - the index of the matched pattern (the first pattern having an index of 0)

bindings - the variable/term bindings created by the match

expirationTime - the expiration time of this solution in milliseconds since the Unix epoch (or 0 for infinite lifetime)

Solution

public Solution(Solution<T> other,
                int index)

Solution

public Solution(Solution<T> other,
                int index,
                Bindings<T> newBindings)

Solution

public Solution(int totalPatterns,
                Solution<T> first,
                Solution<T> second)

Method Detail

getBindings

public Bindings<T> getBindings()

Gets the variables bindings of this solution

Returns:

the variable bindings of this solution. When the solution is complete (i.e. when all patterns of the query have been matched) the bindings are the the actual query "answer".

setBindings

public void setBindings(Bindings<T> bindings)

Sets the variable bindings of this solution. This method is used internally, by the solution index.

Parameters:

bindings - the new variable bindings

composableWith

public boolean composableWith(Solution<T> other,
                              Query.QueryVariables vars)

Checks for non-overlapping patterns and compatible bindings between this solution and another solution, potentially reducing work and eliminating false positives from query results.

Parameters:

other - the other solution

vars - the query variables from which both solutions are drawn

Returns:

whether the solutions are both disjoint in patterns and compatible in bindings