nl.tudelft.simulation.event.ref

Class StrongReference

java.lang.Object

nl.tudelft.simulation.event.ref.Reference

nl.tudelft.simulation.event.ref.StrongReference

All Implemented Interfaces:

Serializable

public class StrongReference
extends Reference

A StrongReference class represents a normal pointer relation to a reference. This class is created to complete the java.lang.ref package. This class ensures that references can be used without casting to either an object or a reference. Strong references are not created to be cleaned by the garbage collector. Since they represent normal pointer relations, they are the only ones which might be serialized. This class therefore implements java.io.Serializable

(c) copyright 2002-2005 Delft University of Technology , the Netherlands.

See for project information www.simulation.tudelft.nl/event
License of use: Lesser General Public License (LGPL) , no warranty

Since:

1.0

Version:

$Revision: 1.1 $ $Date: 2007/01/06 13:24:36 $

Author:

Peter Jacobs

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StrongReference(Object referent) Creates a new strong reference that refers to the given object.

Method Summary

Methods

Modifier and Type	Method and Description
Object	get() Returns this reference object's referent.
protected void	set(Object value) sets the value of the reference

Methods inherited from class java.lang.Object

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

Constructor Detail

StrongReference

public StrongReference(Object referent)

Creates a new strong reference that refers to the given object. The new reference is not registered with any queue.

Parameters:

referent - object the new strong reference will refer to

Method Detail

get

public Object get()

Description copied from class: Reference

Returns this reference object's referent. If this reference object has been cleared, either by the program or by the garbage collector, then this method returns null.

Specified by:

get in class Reference

Returns:

The object to which this reference refers, or null if this reference object has been cleared

See Also:

Reference.get()

set

protected void set(Object value)

Description copied from class: Reference

sets the value of the reference

Specified by:

set in class Reference

See Also:

Reference.set(java.lang.Object)