io.netty.util

Interface ReferenceCounted

All Known Subinterfaces:

AddressedEnvelope<M,A>, Attribute, BinaryMemcacheMessage, BinaryMemcacheRequest, BinaryMemcacheResponse, ByteBufHolder, FileRegion, FileUpload, FullBinaryMemcacheRequest, FullBinaryMemcacheResponse, FullHttpMessage, FullHttpRequest, FullHttpResponse, FullMemcacheMessage, HttpContent, HttpData, InterfaceHttpData, LastHttpContent, LastMemcacheContent, LastStompContentSubframe, MemcacheContent, MemcacheMessage, SpdyDataFrame, StompContentSubframe, StompFrame

All Known Implementing Classes:

AbstractBinaryMemcacheMessage, AbstractByteBuf, AbstractDerivedByteBuf, AbstractDiskHttpData, AbstractHttpData, AbstractMemoryHttpData, AbstractReferenceCounted, AbstractReferenceCountedByteBuf, BinaryWebSocketFrame, ByteBuf, CloseWebSocketFrame, CompositeByteBuf, ContinuationWebSocketFrame, DatagramPacket, DefaultAddressedEnvelope, DefaultBinaryMemcacheRequest, DefaultBinaryMemcacheResponse, DefaultByteBufHolder, DefaultFileRegion, DefaultFullBinaryMemcacheRequest, DefaultFullBinaryMemcacheResponse, DefaultFullHttpRequest, DefaultFullHttpResponse, DefaultHttpContent, DefaultLastHttpContent, DefaultLastMemcacheContent, DefaultLastStompContentSubframe, DefaultMemcacheContent, DefaultSpdyDataFrame, DefaultStompContentSubframe, DefaultStompFrame, DiskAttribute, DiskFileUpload, DnsMessage, DnsQuery, DnsResource, DnsResponse, DuplicatedByteBuf, EmptyByteBuf, HttpServerUpgradeHandler.UpgradeEvent, MemoryAttribute, MemoryFileUpload, MixedAttribute, MixedFileUpload, MqttPublishMessage, PingWebSocketFrame, PongWebSocketFrame, ReadOnlyByteBuf, SctpMessage, SlicedByteBuf, SwappedByteBuf, TextWebSocketFrame, UdtMessage, UnpooledDirectByteBuf, UnpooledHeapByteBuf, UnpooledUnsafeDirectByteBuf, WebSocketFrame, WrappedByteBuf

public interface ReferenceCounted

A reference-counted object that requires explicit deallocation.

When a new ReferenceCounted is instantiated, it starts with the reference count of 1. retain() increases the reference count, and release() decreases the reference count. If the reference count is decreased to 0, the object will be deallocated explicitly, and accessing the deallocated object will usually result in an access violation.

If an object that implements ReferenceCounted is a container of other objects that implement ReferenceCounted, the contained objects will also be released via release() when the container's reference count becomes 0.

Method Summary

Methods

Modifier and Type	Method and Description
int	refCnt() Returns the reference count of this object.
boolean	release() Decreases the reference count by 1 and deallocates this object if the reference count reaches at 0.
boolean	release(int decrement) Decreases the reference count by the specified decrement and deallocates this object if the reference count reaches at 0.
ReferenceCounted	retain() Increases the reference count by 1.
ReferenceCounted	retain(int increment) Increases the reference count by the specified increment.
ReferenceCounted	touch() Records the current access location of this object for debugging purposes.
ReferenceCounted	touch(Object hint) Records the current access location of this object with an additonal arbitrary information for debugging purposes.

Method Detail

refCnt

int refCnt()

Returns the reference count of this object. If 0, it means this object has been deallocated.

retain

ReferenceCounted retain()

Increases the reference count by 1.

retain

ReferenceCounted retain(int increment)

Increases the reference count by the specified increment.

touch

ReferenceCounted touch()

Records the current access location of this object for debugging purposes. If this object is determined to be leaked, the information recorded by this operation will be provided to you via ResourceLeakDetector. This method is a shortcut to touch(null).

touch

ReferenceCounted touch(Object hint)

Records the current access location of this object with an additonal arbitrary information for debugging purposes. If this object is determined to be leaked, the information recorded by this operation will be provided to you via ResourceLeakDetector.

release

boolean release()

Decreases the reference count by 1 and deallocates this object if the reference count reaches at 0.

Returns:

true if and only if the reference count became 0 and this object has been deallocated

release

boolean release(int decrement)

Decreases the reference count by the specified decrement and deallocates this object if the reference count reaches at 0.

Returns:

true if and only if the reference count became 0 and this object has been deallocated