net.fortytwo.stream.caching

Class Bindings<T>

java.lang.Object

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

public class Bindings<T>
extends java.lang.Object

A set of variable/value pairs representing a complete or partial query answer.

Author:

Joshua Shinavier (http://fortytwo.net)

Constructor Summary

Constructors

Constructor and Description
Bindings(java.util.Map<java.lang.String,T> map, Query.QueryVariables vars) Constructs a new set of bindings

Method Summary

Modifier and Type	Method and Description
boolean	compatibleWith(Bindings<T> other, Query.QueryVariables vars) Finds whether these bindings are compatible with another set of bindings.
java.util.Set<java.util.Map.Entry<java.lang.String,T>>	entrySet() The set of variable/value entries of these bindings
boolean	equals(java.lang.Object other)
static <T> Bindings<T>	from(Bindings<T> first, Bindings<T> second) Creates or returns a set of bindings which contains both sets of arguments.
T	get(java.lang.String variable) Gets the value associated with a variable in these bindings
int	getHash() Gets a hashing key guaranteed to be the same for identical bindings
int	hashCode()
int	size() Gets the number of bindings
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Bindings

public Bindings(java.util.Map<java.lang.String,T> map,
                Query.QueryVariables vars)

Constructs a new set of bindings

Parameters:

map - a map of keys to values. The keys must be drawn from the set of query variables

vars - the set of query variables referenced by these bindings

Method Detail

getHash

public int getHash()

Gets a hashing key guaranteed to be the same for identical bindings

Returns:

a hashing key generated from these bindings

from

public static <T> Bindings<T> from(Bindings<T> first,
                                   Bindings<T> second)

Creates or returns a set of bindings which contains both sets of arguments. A new object is only created if the result is not identical to one of the arguments; otherwise, an argument is returned.

Type Parameters:

T - the type of value bound

Parameters:

first - a component binding set

second - a component binding set

Returns:

the resulting set of bindings

get

public T get(java.lang.String variable)

Gets the value associated with a variable in these bindings

Parameters:

variable - the variable, as a key

Returns:

the associated value

entrySet

public java.util.Set<java.util.Map.Entry<java.lang.String,T>> entrySet()

The set of variable/value entries of these bindings

Returns:

a set of variable/value entries

size

public int size()

Gets the number of bindings

Returns:

the number of bindings

compatibleWith

public boolean compatibleWith(Bindings<T> other,
                              Query.QueryVariables vars)

Finds whether these bindings are compatible with another set of bindings. Two sets of bindings are compatible if, for each variable they have in common, they have identical values.

Parameters:

other - the other set of bindings to test

vars - the query variables from which both sets of bindings are drawn

Returns:

whether these bindings are compatible with the provided bindings

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object