net.openhft.chronicle.core.io

Class TracingReferenceCounted

java.lang.Object

net.openhft.chronicle.core.io.TracingReferenceCounted

All Implemented Interfaces:

MonitorReferenceCounted, ReferenceCounted, ReferenceCountedTracer, ReferenceOwner

public final class TracingReferenceCounted
extends Object
implements MonitorReferenceCounted

Field Summary

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

INIT, TMP

Method Summary

Modifier and Type	Method and Description
StackTrace	createdHere()
int	refCount() Returns the reference count for this resource.
@NotNull List<String>	referencesAsString()
void	release(ReferenceOwner id) Releases a resource.
void	releaseLast(ReferenceOwner id) Releases a resource and checks this is the last usage.
void	reserve(ReferenceOwner id) Reserves a resource or throws an Exception.
boolean	reservedBy(ReferenceOwner owner) Best effort check the owner has reserved it.
void	throwExceptionIfNotReleased()
void	throwExceptionIfReleased()
@NotNull String	toString()
boolean	tryReserve(ReferenceOwner id) Tries to reserve a resource and returns if the resource could be successfully reserved.
boolean	unmonitored()
void	unmonitored(boolean unmonitored)
void	warnAndReleaseIfNotReleased()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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, reserveTransfer

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

referenceId, referenceName, temporary

Method Detail

createdHere

public StackTrace createdHere()

Specified by:

createdHere in interface ReferenceCountedTracer

reservedBy

public boolean reservedBy(ReferenceOwner owner)
                   throws IllegalStateException

Description copied from interface: ReferenceCounted

Best effort check the owner has reserved it. Returns true if not sure.

Specified by:

reservedBy in interface ReferenceCounted

Parameters:

owner - to check

Returns:

false if the owner definitely doesn't own it.

Throws:

IllegalStateException

reserve

public void reserve(ReferenceOwner id)
             throws IllegalStateException

Description copied from interface: ReferenceCounted

Reserves a resource or throws an Exception.

Each invocation of this method increases the reference count by one.

Specified by:

reserve in interface ReferenceCounted

Parameters:

id - unique id for this reserve

Throws:

IllegalStateException - if the resource has already been freed. I.e. its reference counter has as some point reached zero.

tryReserve

public boolean tryReserve(ReferenceOwner id)
                   throws IllegalStateException,
                          IllegalArgumentException

Description copied from interface: ReferenceCounted

Tries to reserve a resource and returns if the resource could be successfully reserved.

Each invocation of this method increases the reference count by one.

Specified by:

tryReserve in interface ReferenceCounted

Parameters:

id - unique id for this reserve

Throws:

IllegalStateException - if the resource has already been freed. I.e. its reference counter has as some point reached zero.

IllegalArgumentException

release

public void release(ReferenceOwner id)
             throws IllegalStateException

Description copied from interface: ReferenceCounted

Releases a resource.

Each invocation of this method decreases the reference count by one.

Specified by:

release in interface ReferenceCounted

Parameters:

id - unique id for the reserve to be released

Throws:

IllegalStateException - if the resource has already been freed. I.e. its reference counter has as some point reached zero.

referencesAsString

@NotNull
public @NotNull List<String> referencesAsString()

releaseLast

public void releaseLast(ReferenceOwner id)
                 throws IllegalStateException

Description copied from interface: ReferenceCounted

Releases a resource and checks this is the last usage.

Each invocation of this method decreases the reference count by one.

Specified by:

releaseLast in interface ReferenceCounted

Parameters:

id - unique id for the reserve to be released

Throws:

IllegalStateException - if the resource has already been freed. I.e. its reference counter has as some point reached zero.

refCount

public int refCount()

Description copied from interface: ReferenceCounted

Returns the reference count for this resource.

Specified by:

refCount in interface ReferenceCounted

Returns:

the reference count for this resource

toString

@NotNull
public @NotNull String toString()

Overrides:

toString in class Object

throwExceptionIfNotReleased

public void throwExceptionIfNotReleased()
                                 throws IllegalStateException

Specified by:

throwExceptionIfNotReleased in interface ReferenceCountedTracer

Throws:

IllegalStateException

throwExceptionIfReleased

public void throwExceptionIfReleased()
                              throws ClosedIllegalStateException

Specified by:

throwExceptionIfReleased in interface ReferenceCountedTracer

Throws:

ClosedIllegalStateException

warnAndReleaseIfNotReleased

public void warnAndReleaseIfNotReleased()

Specified by:

warnAndReleaseIfNotReleased in interface ReferenceCountedTracer

unmonitored

public void unmonitored(boolean unmonitored)

Specified by:

unmonitored in interface MonitorReferenceCounted

unmonitored

public boolean unmonitored()

Specified by:

unmonitored in interface MonitorReferenceCounted