Package org.djutils.event.reference

Class StrongReference<T extends Serializable>

java.lang.Object
org.djutils.event.reference.Reference<T>
org.djutils.event.reference.StrongReference<T>
Type Parameters:
T - the type of the reference
All Implemented Interfaces:
Serializable
public class StrongReference<T extends Serializable> extends Reference<T>
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

Copyright (c) 2002-2024 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information https://djutils.org. The DJUTILS project is distributed under a three-clause BSD-style license, which can be found at https://djutils.org/docs/license.html. This class was originally part of the DSOL project, see https://simulation.tudelft.nl/dsol/manual.

Author:
Peter Jacobs , Alexander Verbraeck
See Also:

  • Constructor Details

    • StrongReference

      public StrongReference(T referent)
      Creates a new strong reference that refers to the given object. The new reference is not registered with any queue.
      Parameters:
      referent - T; object the new strong reference will refer to

  • Method Details

    • get

      public final T 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<T extends Serializable>
      Returns:
      The object to which this reference refers, or null if this reference object has been cleared.