net.openhft.chronicle.core.io

Interface ReferenceChangeListener

public interface ReferenceChangeListener

An interface to be notified when references to a ReferenceCounted are added, removed, or transferred. Implement this interface to receive notifications about changes in the reference counts of objects.

Method Summary

Modifier and Type	Method and Description
default void	onReferenceAdded(ReferenceCounted referenceCounted, ReferenceOwner referenceOwner) Called when a reference is added to a ReferenceCounted object.
default void	onReferenceRemoved(@Nullable ReferenceCounted referenceCounted, ReferenceOwner referenceOwner) Called when a reference is removed from a ReferenceCounted object.
default void	onReferenceTransferred(ReferenceCounted referenceCounted, ReferenceOwner fromOwner, ReferenceOwner toOwner) Called when a reference is transferred from one owner to another for a ReferenceCounted object.

Method Detail

onReferenceAdded

default void onReferenceAdded(ReferenceCounted referenceCounted,
                              ReferenceOwner referenceOwner)

Called when a reference is added to a ReferenceCounted object.

WARNING: This may be called from a synchronized block in DualReferenceCounted, so be careful what you do here that might introduce a deadlock!

Parameters:

referenceCounted - The ReferenceCounted to which the reference was added

referenceOwner - The owner of the reference added

onReferenceRemoved

default void onReferenceRemoved(@Nullable
                                @Nullable ReferenceCounted referenceCounted,
                                ReferenceOwner referenceOwner)

Called when a reference is removed from a ReferenceCounted object.

WARNING: This may be called from a synchronized block in DualReferenceCounted, so be careful what you do here that might introduce a deadlock!

Parameters:

referenceCounted - The ReferenceCounted to which the reference was removed

referenceOwner - The owner whose reference was removed, or null if that is not known

onReferenceTransferred

default void onReferenceTransferred(ReferenceCounted referenceCounted,
                                    ReferenceOwner fromOwner,
                                    ReferenceOwner toOwner)

Called when a reference is transferred from one owner to another for a ReferenceCounted object.

WARNING: This may be called from a synchronized block in DualReferenceCounted, so be careful what you do here that might introduce a deadlock!

Parameters:

referenceCounted - The ReferenceCounted object on which the reference was transferred.

fromOwner - The previous owner from whom the reference was transferred.

toOwner - The new owner to whom the reference was transferred.