net.openhft.chronicle.core.io

Class DualReferenceCounted

java.lang.Object

net.openhft.chronicle.core.io.DualReferenceCounted

All Implemented Interfaces:

MonitorReferenceCounted, ReferenceCounted, ReferenceCountedTracer, ReferenceOwner

public class DualReferenceCounted
extends Object
implements MonitorReferenceCounted

Field Summary

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

INIT

Constructor Summary

Constructors

Constructor and Description
DualReferenceCounted(ReferenceCountedTracer a, ReferenceCountedTracer b)

Method Summary

Modifier and Type	Method and Description
StackTrace	createdHere()
int	refCount() Returns the reference count for this resource.
int	referenceId()
String	referenceName()
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	reserveTransfer(ReferenceOwner from, ReferenceOwner to)
void	throwExceptionIfNotReleased()
void	throwExceptionIfReleased()
boolean	tryReserve(ReferenceOwner id) Tries to reserve a resource and returns if the resource could be successfully reserved.
void	warnAndReleaseIfNotReleased()

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, 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(ReferenceCountedTracer a,
                            ReferenceCountedTracer b)

Method Detail

warnAndReleaseIfNotReleased

public void warnAndReleaseIfNotReleased()

Specified by:

warnAndReleaseIfNotReleased in interface ReferenceCountedTracer

throwExceptionIfNotReleased

public void throwExceptionIfNotReleased()

Specified by:

throwExceptionIfNotReleased in interface ReferenceCountedTracer

createdHere

public StackTrace createdHere()

Specified by:

createdHere in interface ReferenceCountedTracer

reservedBy

public boolean reservedBy(ReferenceOwner owner)

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.

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

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.

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.

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

throwExceptionIfReleased

public void throwExceptionIfReleased()
                              throws IllegalStateException

Specified by:

throwExceptionIfReleased in interface ReferenceCountedTracer

Throws:

IllegalStateException

reserveTransfer

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

Specified by:

reserveTransfer in interface ReferenceCounted

Throws:

IllegalStateException

referenceId

public int referenceId()

Specified by:

referenceId in interface ReferenceOwner

referenceName

public String referenceName()

Specified by:

referenceName in interface ReferenceOwner