org.apache.ratis.util

接口 ReferenceCountedObject<T>

类型参数:

T - The object type.

public interface ReferenceCountedObject<T>

A reference-counted object can be retained for later use and then be released for returning the resource. - When the object is retained, the reference count is incremented by 1. - When the object is released, the reference count is decremented by 1. - If the object is retained, it must be released afterward. Otherwise, the object will not be returned, and it will cause a resource leak. - If the object is retained multiple times, it must be released the same number of times. - If the object has been retained and then completely released (i.e. the reference count becomes 0), it must not be retained/released/accessed anymore since it may have been allocated for other use.

方法概要

限定符和类型	方法和说明
T	get()
boolean	release() Release the object.
T	retain() Retain the object for later use.
static <V> ReferenceCountedObject<V>	wrap(V value) The same as wrap(value, EMPTY, EMPTY), where EMPTY is an empty method.
static <V> ReferenceCountedObject<V>	wrap(V value, Runnable retainMethod, Runnable releaseMethod) Wrap the given value as a ReferenceCountedObject.

方法详细资料

get

T get()

返回:

the object.

retain

T retain()

Retain the object for later use. The reference count will be increased by 1. The release() method must be invoked afterward. Otherwise, the object is not returned, and it will cause a resource leak.

返回:

the object.

release

boolean release()

Release the object. The reference count will be decreased by 1.

返回:

true if the object is completely released (i.e. reference count becomes 0); otherwise, return false.

wrap

static <V> ReferenceCountedObject<V> wrap(V value)

The same as wrap(value, EMPTY, EMPTY), where EMPTY is an empty method.

wrap

static <V> ReferenceCountedObject<V> wrap(V value,
                                          Runnable retainMethod,
                                          Runnable releaseMethod)

Wrap the given value as a ReferenceCountedObject.

类型参数:

V - The value type.

参数:

value - the value being wrapped.

retainMethod - a method to run when retain() is invoked.

releaseMethod - a method to run when release() is invoked.

返回:

the wrapped reference-counted object.