net.openhft.chronicle.core.io

Class DualReferenceCounted

java.lang.Object

net.openhft.chronicle.core.io.DualReferenceCounted

All Implemented Interfaces:

MonitorReferenceCounted, ReferenceCounted, ReferenceCountedTracer, ReferenceOwner

Deprecated.

@Deprecated
public class DualReferenceCounted
extends Object
implements MonitorReferenceCounted

Field Summary

Fields inherited from interface net.openhft.chronicle.core.io.ReferenceOwner

INIT, TMP

Constructor Summary

Constructors

Constructor and Description
DualReferenceCounted(MonitorReferenceCounted a, MonitorReferenceCounted b) Deprecated.

Method Summary

Modifier and Type	Method and Description
void	addReferenceChangeListener(ReferenceChangeListener referenceChangeListener) Deprecated. Adds a ReferenceChangeListener that will be notified whenever the reference count changes.
StackTrace	createdHere() Deprecated. Retrieves the stack trace of the point where the object was created.
int	refCount() Deprecated. Returns the current reference count of the resource.
int	referenceId() Deprecated. Returns a unique identifier (ID) for this reference owner.
String	referenceName() Deprecated. Returns a human-readable name for this reference owner.
void	release(ReferenceOwner id) Deprecated. Releases the resource by decrementing its reference count by one.
void	releaseLast(ReferenceOwner id) Deprecated. Releases the resource and ensures that this release is the last usage of the resource.
void	removeReferenceChangeListener(ReferenceChangeListener referenceChangeListener) Deprecated. Removes a ReferenceChangeListener previously added via ReferenceCounted.addReferenceChangeListener(ReferenceChangeListener).
void	reserve(ReferenceOwner id) Deprecated. Reserves the resource by incrementing its reference count by one.
boolean	reservedBy(ReferenceOwner owner) Deprecated.
void	reserveTransfer(ReferenceOwner from, ReferenceOwner to) Deprecated. Atomically transfers a reservation from one owner to another by incrementing the reference count for the new owner and decrementing it for the old owner.
void	throwExceptionIfNotReleased() Deprecated. Throws an exception if the object has not been released.
void	throwExceptionIfReleased() Deprecated. Throws an exception if the object has been released.
boolean	tryReserve(ReferenceOwner id) Deprecated. Attempts to reserve the resource and returns true if successful.
boolean	unmonitored() Deprecated.
void	unmonitored(boolean unmonitored) Deprecated. Sets the monitored state of the object.
void	warnAndReleaseIfNotReleased() Deprecated. Releases any remaining references and logs a warning if there were any references to release.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.core.io.ReferenceCountedTracer

onReleased

Methods inherited from interface net.openhft.chronicle.core.io.ReferenceCounted

releaseLast

Methods inherited from interface net.openhft.chronicle.core.io.ReferenceOwner

temporary

Constructor Detail

DualReferenceCounted

public DualReferenceCounted(MonitorReferenceCounted a,
                            MonitorReferenceCounted b)

Deprecated.

Method Detail

warnAndReleaseIfNotReleased

public void warnAndReleaseIfNotReleased()
                                 throws IllegalStateException

Deprecated.

Description copied from interface: ReferenceCountedTracer

Releases any remaining references and logs a warning if there were any references to release.

This method is intended to be called by a finalizer or in a test to confirm that references are being released correctly.

Note: This method will not trigger any ReferenceChangeListeners as it is mainly used for sanity checks.

Specified by:

warnAndReleaseIfNotReleased in interface ReferenceCountedTracer

Throws:

IllegalStateException - If the object hadn't been released.

throwExceptionIfNotReleased

public void throwExceptionIfNotReleased()
                                 throws IllegalStateException

Deprecated.

Description copied from interface: ReferenceCountedTracer

Throws an exception if the object has not been released.

Specified by:

throwExceptionIfNotReleased in interface ReferenceCountedTracer

Throws:

IllegalStateException - If the object has not been released (i.e., its reference count is greater than 0).

createdHere

public StackTrace createdHere()

Deprecated.

Description copied from interface: ReferenceCountedTracer

Retrieves the stack trace of the point where the object was created. This can be useful for debugging and tracking down the origin of the object.

Specified by:

createdHere in interface ReferenceCountedTracer

Returns:

The stack trace where the object was created.

addReferenceChangeListener

public void addReferenceChangeListener(ReferenceChangeListener referenceChangeListener)

Deprecated.

Description copied from interface: ReferenceCounted

Adds a ReferenceChangeListener that will be notified whenever the reference count changes. This can be used to monitor the usage of the resource and execute code when certain conditions are met.

Specified by:

addReferenceChangeListener in interface ReferenceCounted

Parameters:

referenceChangeListener - The listener that will receive notifications of reference count changes.

removeReferenceChangeListener

public void removeReferenceChangeListener(ReferenceChangeListener referenceChangeListener)

Deprecated.

Description copied from interface: ReferenceCounted

Removes a ReferenceChangeListener previously added via ReferenceCounted.addReferenceChangeListener(ReferenceChangeListener).

Note: Object equality is used to determine which listener to remove, so be cautious if the listener implements the equals method in a non-standard way.

Specified by:

removeReferenceChangeListener in interface ReferenceCounted

Parameters:

referenceChangeListener - The listener to remove.

reservedBy

@Deprecated
public boolean reservedBy(ReferenceOwner owner)
                               throws ClosedIllegalStateException

Deprecated.

Description copied from interface: ReferenceCounted

Checks if the resource is reserved by the specified owner. Returns true if unsure.

This method provides a best-effort check and may not be accurate.

Specified by:

reservedBy in interface ReferenceCounted

Parameters:

owner - The unique identifier representing the owner to check.

Returns:

false if it is certain that the owner does not have the resource reserved; true otherwise.

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

reserve

public void reserve(ReferenceOwner id)
             throws ClosedIllegalStateException

Deprecated.

Description copied from interface: ReferenceCounted

Reserves the resource by incrementing its reference count by one.

It is required to reserve a resource before using it to prevent it from being freed.

Specified by:

reserve in interface ReferenceCounted

Parameters:

id - The unique identifier representing the owner reserving the resource.

Throws:

ClosedIllegalStateException - If the resource has been released or closed. I.e. its reference counter has as some point reached zero.

tryReserve

public boolean tryReserve(ReferenceOwner id)
                   throws IllegalStateException,
                          IllegalArgumentException

Deprecated.

Description copied from interface: ReferenceCounted

Attempts to reserve the resource and returns true if successful. Unlike ReferenceCounted.reserve(ReferenceOwner), this method will not throw an exception if the resource is already freed.

Specified by:

tryReserve in interface ReferenceCounted

Parameters:

id - The unique identifier representing the owner attempting to reserve the resource.

Returns:

true if the resource was successfully reserved, false otherwise.

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalArgumentException - If the reference owner is invalid.

IllegalStateException

release

public void release(ReferenceOwner id)
             throws IllegalStateException

Deprecated.

Description copied from interface: ReferenceCounted

Releases the resource by decrementing its reference count by one. When the reference count reaches zero, the resource is freed.

Specified by:

release in interface ReferenceCounted

Parameters:

id - The unique identifier representing the owner releasing the resource.

Throws:

ClosedIllegalStateException - If the resource has been released or closed. I.e. its reference counter has as some point reached zero.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

releaseLast

public void releaseLast(ReferenceOwner id)
                 throws IllegalStateException

Deprecated.

Description copied from interface: ReferenceCounted

Releases the resource and ensures that this release is the last usage of the resource. The reference count is decremented and checked to be zero after this release.

Specified by:

releaseLast in interface ReferenceCounted

Parameters:

id - The unique identifier representing the owner releasing the resource.

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

refCount

public int refCount()

Deprecated.

Description copied from interface: ReferenceCounted

Returns the current reference count of the resource. The reference count indicates the number of owners currently holding reservations to the resource.

Specified by:

refCount in interface ReferenceCounted

Returns:

The current reference count of the resource.

throwExceptionIfReleased

public void throwExceptionIfReleased()
                              throws ClosedIllegalStateException

Deprecated.

Description copied from interface: ReferenceCountedTracer

Throws an exception if the object has been released.

Specified by:

throwExceptionIfReleased in interface ReferenceCountedTracer

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

reserveTransfer

public void reserveTransfer(ReferenceOwner from,
                            ReferenceOwner to)
                     throws IllegalStateException

Deprecated.

Description copied from interface: ReferenceCounted

Atomically transfers a reservation from one owner to another by incrementing the reference count for the new owner and decrementing it for the old owner.

Specified by:

reserveTransfer in interface ReferenceCounted

Parameters:

from - The unique identifier representing the owner releasing the reservation.

to - The unique identifier representing the owner acquiring the reservation.

Throws:

ClosedIllegalStateException - If the resource has been released or closed.

ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException

referenceId

public int referenceId()

Deprecated.

Description copied from interface: ReferenceOwner

Returns a unique identifier (ID) for this reference owner. The ID can be used for tracking and managing resources owned by this instance.

The default implementation uses the identity hash code of this reference owner instance as the ID.

Specified by:

referenceId in interface ReferenceOwner

Returns:

An integer representing the unique reference ID of this owner.

referenceName

public String referenceName()

Deprecated.

Description copied from interface: ReferenceOwner

Returns a human-readable name for this reference owner. This name can be used for identification, debugging, and logging purposes.

The default implementation generates a name using the simple class name of the reference owner, followed by '@', and then the reference ID encoded in base 36.

Specified by:

referenceName in interface ReferenceOwner

Returns:

A string representing the human-readable name of this reference owner.

unmonitored

public void unmonitored(boolean unmonitored)

Deprecated.

Description copied from interface: MonitorReferenceCounted

Sets the monitored state of the object.

Specified by:

unmonitored in interface MonitorReferenceCounted

Parameters:

unmonitored - true to set the object as unmonitored, false to set it as monitored.

unmonitored

public boolean unmonitored()

Deprecated.

Specified by:

unmonitored in interface MonitorReferenceCounted

Returns:

true if the object is unmonitored, false if it is monitored.