org.spongepowered.api.data.property

Class AbstractProperty<K,V>

java.lang.Object

org.spongepowered.api.data.property.AbstractProperty<K,V>

All Implemented Interfaces:

Comparable<Property<?,?>>, Property<K,V>

Direct Known Subclasses:

ApplicableEffectProperty, ArmorTypeProperty, BooleanProperty, DisplacementProperty, DominantHandProperty, DoubleProperty, EquipmentProperty, EyeLocationProperty, HarvestingProperty, HeldItemProperty, InstrumentProperty, IntProperty, MatterProperty, RecordProperty, ToolTypeProperty

public abstract class AbstractProperty<K,V>
extends Object
implements Property<K,V>

Nested Class Summary

Nested classes/interfaces inherited from interface org.spongepowered.api.data.Property

Property.Operator

Field Summary

Fields

Modifier and Type	Field and Description
protected Property.Operator	operator Operator for comparing to other properties.
protected V	value The value.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractProperty() Initialise internal values to defaults, use this ctor if you plan to override getKey() and getValue() yourself.
protected	AbstractProperty(K key, V value) Use the specified key and value and set operator to the default.
protected	AbstractProperty(K key, V value, Property.Operator op)
protected	AbstractProperty(V value) Initialise key to default, and value to the supplied value.
protected	AbstractProperty(V value, Property.Operator op) Initialise the value to the specified value and use the specified operator, use the default key.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
protected K	getDefaultKey(V value) Gets the default value for key, used in case null is passed in (since we can't have a null key).
protected Property.Operator	getDefaultOperator(K key, V value) Return the default operator to use, based on the supplied key and value.
K	getKey() Gets the key for this property.
Property.Operator	getOperator() Gets the operator to use when comparing another property with this property.
V	getValue() Gets the "value" of this property.
int	hashCode()
protected int	hashCodeOf(Object value) Convenience method to avoid null-checking.
boolean	matches(Property<?,?> other) Compares this property to other using this property's operator.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

operator

protected final Property.Operator operator

Operator for comparing to other properties. Operators should always be applied by consumers in a <this> <OPERATOR> <other> pattern

value

@Nullable
protected V value

The value.

Constructor Detail

AbstractProperty

protected AbstractProperty()

Initialise internal values to defaults, use this ctor if you plan to override getKey() and getValue() yourself.

AbstractProperty

protected AbstractProperty(@Nullable
                           V value)

Initialise key to default, and value to the supplied value.

Parameters:

value - The value of the property

AbstractProperty

protected AbstractProperty(@Nullable
                           V value,
                           @Nullable
                           Property.Operator op)

Initialise the value to the specified value and use the specified operator, use the default key.

Parameters:

value - The property value

op - The operator for the property

AbstractProperty

protected AbstractProperty(@Nullable
                           K key,
                           @Nullable
                           V value)

Use the specified key and value and set operator to the default.

Parameters:

key - The key identifying the property

value - The property value

AbstractProperty

protected AbstractProperty(@Nullable
                           K key,
                           @Nullable
                           V value,
                           @Nullable
                           Property.Operator op)

Method Detail

getDefaultKey

protected K getDefaultKey(@Nullable
                          V value)

Gets the default value for key, used in case null is passed in (since we can't have a null key). In general this should return the class name of the property itself but subclasses are free to alter this behaviour if they wish.

Parameters:

value - Value passed in to the ctor, supplied in case a subclass wants to return a specific default key based on the value

Returns:

default key to use. Must not be null!

getDefaultOperator

protected Property.Operator getDefaultOperator(K key,
                                               @Nullable
                                               V value)

Return the default operator to use, based on the supplied key and value.

Parameters:

key - Property key

value - Property initial value, may be null

Returns:

operator to use

getKey

public K getKey()

Description copied from interface: Property

Gets the key for this property. Key is only used if an item stack can have more than one property of a particular type. If the property has no specific key, the property class name is returned so that properties of the same type are implicitly comparable.

Specified by:

getKey in interface Property<K,V>

Returns:

the key for this property

getValue

public V getValue()

Description copied from interface: Property

Gets the "value" of this property. "Value" may have different meanings depending on the exact type of this property.

Specified by:

getValue in interface Property<K,V>

Returns:

the value of this property

getOperator

public Property.Operator getOperator()

Description copied from interface: Property

Gets the operator to use when comparing another property with this property.

Specified by:

getOperator in interface Property<K,V>

Returns:

the operator to use when comparing another property with this property

matches

public boolean matches(@Nullable
                       Property<?,?> other)

Description copied from interface: Property

Compares this property to other using this property's operator. This is equivalent to the code:

thisObject.getOperator().compare(thisObject, other);

The order of the operands is important, since Property.Operator treats its type as infix between the two operands, and thus (for example) if this property's operator is set to GREATER, then when calling this method we want to know whether this is GREATER than other and must pass in the operands in the corresponding order.

Specified by:

matches in interface Property<K,V>

Parameters:

other - Property to compare to

Returns:

true if the other property matches this one according to the rules defined by this property's Property.getOperator()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

hashCodeOf

protected int hashCodeOf(@Nullable
                         Object value)

Convenience method to avoid null-checking. Returns 0 if value is null.

Parameters:

value - The value to get the hashcode of

Returns:

The hashcode value