org.apache.commons.lang.mutable
Interface Mutable

All Known Implementing Classes:

MutableBoolean, MutableByte, MutableDouble, MutableFloat, MutableInt, MutableLong, MutableObject, MutableShort

public interface Mutable

Provides mutable access to a value.

Mutable is used as a generic interface to the implementations in this package.

A typical use case would be to enable a primitive or string to be passed to a method and allow that method to effectively change the value of the primitive/string. Another use case is to store a frequently changing primitive in a collection (for example a total in a map) without needing to create new Integer/Long wrapper objects.

Since:

2.1

Version:

$Id: Mutable.java 618693 2008-02-05 16:33:29Z sebb $

Author:

Matthew Hawthorne

Method Summary

java.lang.Object	getValue() Gets the value of this mutable.
void	setValue(java.lang.Object value) Sets the value of this mutable.

Method Detail

getValue

public java.lang.Object getValue()

Gets the value of this mutable.

Returns:

the stored value

setValue

public void setValue(java.lang.Object value)

Sets the value of this mutable.

Parameters:

value - the value to store

Throws:

java.lang.NullPointerException - if the object is null and null is invalid

java.lang.ClassCastException - if the type is invalid