com.edorasware.commons.core.entity

Class Variable

java.lang.Object

com.edorasware.commons.core.entity.Variable

All Implemented Interfaces:

NamedValue, NamedValueWithSource, Identifiable

public class Variable
extends Object
implements NamedValueWithSource, Identifiable

Represents a single variable. A variable consists of a name, a value, and a source. The supported value types depend on the implementation of the variable persistence mechanism.

Constructor Summary

Constructors

Constructor and Description
Variable(String name, Object value) Creates a new variable with a mandatory name and optional value.
Variable(String name, Object value, String source) Creates a new variable with a mandatory name, optional value, and source.
Variable(String id, String name, Object value, String source) Creates a new variable with an optional id, name, optional value, and optional source.
Variable(ValueAccessor<T> name, T value) Creates a new variable with a mandatory name and optional value.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
static Variable	findByName(String name, Collection<Variable> variables) Finds the variable with the given name among the given variables.
String	getId() Returns the id of the variable.
String	getName() Returns the name of the variable.
String	getSource() Returns the source of the variable.
Object	getValue() Returns the value of the variable.
<S> S	getValue(Class<S> expectedType) Convenience method for returning the value of the variable cast to the expected type.
<S> S	getValue(com.google.common.reflect.TypeToken<S> expectedType) Convenience method for returning the value of the variable cast to the expected type.
int	hashCode()
String	toString()
Variable	withId(String id) Returns a new variable with the given id and the current name, value, and source.
Variable	withSource(String source) Returns a new variable with the given source and the current id, name, and value.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Variable

public Variable(ValueAccessor<T> name,
                T value)

Creates a new variable with a mandatory name and optional value.

Parameters:

name - the name of the variable

value - the value of the variable

Variable

public Variable(String name,
                Object value)

Creates a new variable with a mandatory name and optional value.

Parameters:

name - the name of the variable

value - the value of the variable

Variable

public Variable(String name,
                Object value,
                String source)

Creates a new variable with a mandatory name, optional value, and source.

Parameters:

name - the name of the variable

value - the value of the variable

source - the source of the variable

Variable

public Variable(String id,
                String name,
                Object value,
                String source)

Creates a new variable with an optional id, name, optional value, and optional source.

Parameters:

id - the id of the variable

name - the name of the variable

value - the value of the variable

source - the source of the variable

Method Detail

getId

public String getId()

Returns the id of the variable.

Specified by:

getId in interface Identifiable

Returns:

the variable id

getName

public String getName()

Returns the name of the variable.

Specified by:

getName in interface NamedValue

Returns:

the variable name

getValue

public Object getValue()

Returns the value of the variable.

Specified by:

getValue in interface NamedValue

Returns:

the variable value

getValue

public <S> S getValue(Class<S> expectedType)

Convenience method for returning the value of the variable cast to the expected type. If the variable value is not of the expected type and not null, an IllegalArgumentException is thrown.

Specified by:

getValue in interface NamedValue

Type Parameters:

S - the type of the value

Parameters:

expectedType - the expected type of the variable value

Returns:

the variable value

Throws:

IllegalArgumentException - thrown if the cast is not possible

getValue

public <S> S getValue(com.google.common.reflect.TypeToken<S> expectedType)

Convenience method for returning the value of the variable cast to the expected type. If the variable value is not of the expected type and not null, an IllegalArgumentException is thrown.

Specified by:

getValue in interface NamedValue

Type Parameters:

S - the type of the value

Parameters:

expectedType - the expected type of the variable value

Returns:

the variable value

Throws:

IllegalArgumentException - thrown if the cast is not possible

getSource

public String getSource()

Returns the source of the variable.

Specified by:

getSource in interface NamedValueWithSource

Returns:

the source of the variable

withId

public Variable withId(String id)

Returns a new variable with the given id and the current name, value, and source.

Parameters:

id - the new id of the variable

Returns:

the new variable

withSource

public Variable withSource(String source)

Returns a new variable with the given source and the current id, name, and value.

Parameters:

source - the source of the variable

Returns:

the new variable

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

findByName

public static Variable findByName(String name,
                                  Collection<Variable> variables)

Finds the variable with the given name among the given variables.

Parameters:

name - the name of the variable to find

variables - the variables to search

Returns:

the matching variable

Throws:

NoSuchElementException - thrown if there is no variable with the given name