Class ForwardingObject
-
- com.google.common.collect.ForwardingObject
-
- Direct Known Subclasses:
ForwardingCache
,ForwardingCollection
,ForwardingExecutorService
,ForwardingFuture
,ForwardingIterator
,ForwardingMap
,ForwardingMapEntry
,ForwardingMultimap
,ForwardingTable
@GwtCompatible public abstract class ForwardingObject extends
An abstract base class for implementing the . Thedelegate()
method must be overridden to return the instance being decorated.This class does not forward the
hashCode
andequals
methods through to the backing object, but relies onObject
's implementation. This is necessary to preserve the symmetry ofequals
. Custom definitions of equality are usually based on an interface, such asSet
orList
, so that the implementation ofequals
can cast the object being tested for equality to the custom interface.ForwardingObject
implements no such custom interfaces directly; they are implemented only in subclasses. Therefore, forwardingequals
would break symmetry, as the forwarding object might consider itself equal to the object being tested, but the reverse could not be true. This behavior is consistent with the JDK's collection wrappers, such as . Use an interface-specific subclass ofForwardingObject
, such asForwardingList
, to preserve equality behavior, or overrideequals
directly.The
toString
method is forwarded to the delegate. Although this class does not implement , a serializable subclass may be created since this class has a parameter-less constructor.- Since:
- 2.0
- Author:
- Mike Bostock
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
ForwardingObject()
Constructor for use by subclasses.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected abstract
delegate()
Returns the backing delegate instance that methods are forwarded to.toString()
Returns the string representation generated by the delegate'stoString
method.
-
-
-
Constructor Detail
-
ForwardingObject
protected ForwardingObject()
Constructor for use by subclasses.
-
-
Method Detail
-
delegate
protected abstract delegate()
Returns the backing delegate instance that methods are forwarded to. Abstract subclasses generally override this method with an abstract method that has a more specific return type, such asForwardingSet.delegate()
. Concrete subclasses override this method to supply the instance being decorated.
-
toString
public toString()
Returns the string representation generated by the delegate'stoString
method.- Overrides:
in class
- Returns:
- a string representation of the object.
-
-