Package groovy.lang

# Class Reference<T>

java.lang.Object
groovy.lang.GroovyObjectSupport
groovy.lang.Reference<T>

All Implemented Interfaces:
  `GroovyObject`, `Serializable`

Direct Known Subclasses:
  `ScriptReference`

public class Reference<T> extends GroovyObjectSupport implements Serializable
Represents a reference to a value

See Also:
  - Serialized Form

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `Reference()`
  Creates an empty reference.
  `Reference(T value)`
  Creates a reference initialized with the supplied value.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `T`
  `get()`
  Returns the referenced value.
  `Object`
  `getProperty(String property)`
  Retrieves a property value.
  `Object`
  `invokeMethod(String name, Object args)`
  Invokes the given method.
  `void`
  `set(T value)`
  Updates the referenced value.
  `void`
  `setProperty(String property, Object newValue)`
  Sets the given property to the new value.

  ### Methods inherited from class groovy.lang.GroovyObjectSupport

  `getMetaClass, setMetaClass`

  ### Methods inherited from class java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Constructor Details

  - ### Reference

    public Reference()
    Creates an empty reference.

  - ### Reference

    public Reference(T value)
    Creates a reference initialized with the supplied value.
    Parameters:
      `value` - the initial value

- ## Method Details

  - ### getProperty

    public Object getProperty(String property)
    Retrieves a property value.
    Specified by:
      `getProperty` in interface `GroovyObject`
    Parameters:
      `property` - the name of the property of interest
    Returns:
      the given property

  - ### setProperty

    public void setProperty(String property, Object newValue)
    Sets the given property to the new value.
    Specified by:
      `setProperty` in interface `GroovyObject`
    Parameters:
      `property` - the name of the property of interest
      `newValue` - the new value for the property

  - ### invokeMethod

    public Object invokeMethod(String name, Object args)
    Invokes the given method.
    Specified by:
      `invokeMethod` in interface `GroovyObject`
    Parameters:
      `name` - the name of the method to call
      `args` - the arguments to use for the method call
    Returns:
      the result of invoking the method

  - ### get

    public T get()
    Returns the referenced value.
    Returns:
      the referenced value

  - ### set

    public void set(T value)
    Updates the referenced value.
    Parameters:
      `value` - the new value