ModifiableInteger class wraps a value of the primitive type
* int in an object, similarly to {@link java.lang.Integer}. An
* object of type ModifiableInteger contains a single field whose
* type is int.
*
* Unlike java.lang.Integer, the int value which the
* ModifiableInteger represents can be modified. It becomes useful when used
* together with the collection framework. For example, if you want to have a
* {@link java.util.List} of counters. You could use Integer but
* that would have became wasteful and inefficient if you frequently had to
* update the counters.
WARNING: Because instances of this class are mutable, great care must be
* exercised if used as keys of a {@link java.util.Map} or as values in a {@link
* java.util.Set} in a manner that affects equals comparisons while the
* instances are keys in the map (or values in the set). For more see
* documentation of Map and Set.
ModifiableInteger.
*/
public int value;
//~ Constructors -----------------------------------------------------------
/**
* !!! DON'T USE - Use the {@link #ModifiableInteger(int)} constructor
* instead !!!
*
* This constructor is for the use of java.beans.XMLDecoder * deserialization. The constructor is marked as 'deprecated' to indicate to * the programmer against using it by mistake.
* * @deprecated not really deprecated, just marked so to avoid mistaken use. */ @Deprecated public ModifiableInteger() { } /** * Constructs a newly allocatedModifiableInteger object that
* represents the specified int value.
*
* @param value the value to be represented by the
* ModifiableInteger object.
*/
public ModifiableInteger(int value)
{
this.value = value;
}
//~ Methods ----------------------------------------------------------------
/**
* Sets a new value for this modifiable integer.
*
* @param value the new value to set.
*/
public void setValue(int value)
{
this.value = value;
}
/**
* Returns the value of this object, similarly to {@link #intValue()}. This
* getter is NOT redundant. It is used for serialization by
* java.beans.XMLEncoder.
*
* @return the value.
*/
public int getValue()
{
return this.value;
}
/**
* Adds one to the value of this modifiable integer.
*/
public void increment()
{
this.value++;
}
/**
* Subtracts one from the value of this modifiable integer.
*/
public void decrement()
{
this.value--;
}
/**
* Compares two ModifiableInteger objects numerically.
*
* @param anotherInteger the ModifiableInteger to be compared.
*
* @return the value 0 if this ModifiableInteger
* is equal to the argument ModifiableInteger; a value less
* than 0 if this ModifiableInteger is numerically
* less than the argument ModifiableInteger; and a value
* greater than 0 if this ModifiableInteger is
* numerically greater than the argument ModifiableInteger
* (signed comparison).
*/
public int compareTo(ModifiableInteger anotherInteger)
{
int thisVal = this.value;
int anotherVal = anotherInteger.value;
return (thisVal < anotherVal) ? -1 : ((thisVal == anotherVal) ? 0 : 1);
}
/**
* @see Number#doubleValue()
*/
public double doubleValue()
{
return this.value;
}
/**
* Compares this object to the specified object. The result is
* true if and only if the argument is not null and is
* an ModifiableInteger object that contains the same
* int value as this object.
*
* @param o the object to compare with.
*
* @return true if the objects are the same; false
* otherwise.
*/
public boolean equals(Object o)
{
if (o instanceof ModifiableInteger) {
return this.value == ((ModifiableInteger) o).value;
}
return false;
}
/**
* @see Number#floatValue()
*/
public float floatValue()
{
return this.value;
}
/**
* Returns a hash code for this ModifiableInteger.
*
* @return a hash code value for this object, equal to the primitive
* int value represented by this ModifiableInteger
* object.
*/
public int hashCode()
{
return this.value;
}
/**
* @see Number#intValue()
*/
public int intValue()
{
return this.value;
}
/**
* @see Number#longValue()
*/
public long longValue()
{
return this.value;
}
/**
* Returns an Integer object representing this
* ModifiableInteger's value.
*
* @return an Integer representation of the value of this
* object.
*/
public Integer toInteger()
{
return Integer.valueOf(this.value);
}
/**
* Returns a String object representing this
* ModifiableInteger's value. The value is converted to signed
* decimal representation and returned as a string, exactly as if the
* integer value were given as an argument to the {@link
* java.lang.Integer#toString(int)} method.
*
* @return a string representation of the value of this object in
* base 10.
*/
public String toString()
{
return String.valueOf(this.value);
}
}
// End ModifiableInteger.java