org.apache.commons.lang.mutable

Interface Mutable

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
ObjectgetValue()
Gets the value of this mutable.
voidsetValue(Object value)
Sets the value of this mutable.

Method Detail

getValue

public Object getValue()
Gets the value of this mutable.

Returns: the stored value

setValue

public void setValue(Object value)
Sets the value of this mutable.

Parameters: value the value to store

Throws: NullPointerException if the object is null and null is invalid ClassCastException if the type is invalid

Copyright © 2001-2010 - Apache Software Foundation