Modifier and Type	Class and Description
private static class	ReferenceCountUtil.ReleasingTask Releases the objects when the thread that called `releaseLater(Object)` has been terminated.

Modifier and Type	Field and Description
private static final InternalLogger	logger

Access	Constructor and Description
private	ReferenceCountUtil()

Method Summary

Modifier and Type	Method and Description
public static int	refCnt(Object msg) Returns reference count of a `ReferenceCounted` object.
public static boolean	release(Object msg) Try to call `ReferenceCounted#release()` if the specified message implements `ReferenceCounted`.
public static boolean	release(Object msg, int decrement) Try to call `ReferenceCounted#release(int)` if the specified message implements `ReferenceCounted`.
public static <T> T	releaseLater(T msg) Deprecated this may introduce a lot of memory usage so it is generally preferable to manually release objects. Schedules the specified object to be released when the caller thread terminates.
public static <T> T	releaseLater(T msg, int decrement) Deprecated this may introduce a lot of memory usage so it is generally preferable to manually release objects. Schedules the specified object to be released when the caller thread terminates.
public static <T> T	retain(T msg) Try to call `ReferenceCounted#retain()` if the specified message implements `ReferenceCounted`.
public static <T> T	retain(T msg, int increment) Try to call `ReferenceCounted#retain(int)` if the specified message implements `ReferenceCounted`.
public static void	safeRelease(Object msg) Try to call `ReferenceCounted#release()` if the specified message implements `ReferenceCounted`.
public static void	safeRelease(Object msg, int decrement) Try to call `ReferenceCounted#release(int)` if the specified message implements `ReferenceCounted`.
public static <T> T	touch(T msg) Tries to call `ReferenceCounted#touch()` if the specified message implements `ReferenceCounted`.
public static <T> T	touch(T msg, Object hint) Tries to call `ReferenceCounted#touch(Object)` if the specified message implements `ReferenceCounted`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

logger	back to summary
private static final InternalLogger logger

Constructor Detail

ReferenceCountUtil	back to summary
private ReferenceCountUtil()

Method Detail

refCnt	back to summary
public static int refCnt(Object msg) Returns reference count of a `ReferenceCounted` object. If object is not type of `ReferenceCounted`, `-1` is returned.

release	back to summary
public static boolean release(Object msg) Try to call `ReferenceCounted#release()` if the specified message implements `ReferenceCounted`. If the specified message doesn't implement `ReferenceCounted`, this method does nothing.

release	back to summary
public static boolean release(Object msg, int decrement) Try to call `ReferenceCounted#release(int)` if the specified message implements `ReferenceCounted`. If the specified message doesn't implement `ReferenceCounted`, this method does nothing.

releaseLater	back to summary
public static <T> T releaseLater(T msg) Deprecated this may introduce a lot of memory usage so it is generally preferable to manually release objects. Schedules the specified object to be released when the caller thread terminates. Note that this operation is intended to simplify reference counting of ephemeral objects during unit tests. Do not use it beyond the intended use case. Annotations @Deprecated

releaseLater

back to summary

public static <T> T releaseLater(T msg)

Deprecated

this may introduce a lot of memory usage so it is generally preferable to manually release objects.

Schedules the specified object to be released when the caller thread terminates. Note that this operation is intended to simplify reference counting of ephemeral objects during unit tests. Do not use it beyond the intended use case.

Annotations

@Deprecated

releaseLater	back to summary
public static <T> T releaseLater(T msg, int decrement) Deprecated this may introduce a lot of memory usage so it is generally preferable to manually release objects. Schedules the specified object to be released when the caller thread terminates. Note that this operation is intended to simplify reference counting of ephemeral objects during unit tests. Do not use it beyond the intended use case. Annotations @Deprecated

releaseLater

back to summary

public static <T> T releaseLater(T msg, int decrement)

Deprecated

this may introduce a lot of memory usage so it is generally preferable to manually release objects.

Annotations

@Deprecated

retain back to summary

retain	back to summary
public static <T> T retain(T msg) Try to call `ReferenceCounted#retain()` if the specified message implements `ReferenceCounted`. If the specified message doesn't implement `ReferenceCounted`, this method does nothing. Annotations @SuppressWarnings:unchecked

public static <T> T retain(T msg)

Try to call ReferenceCounted#retain() if the specified message implements ReferenceCounted. If the specified message doesn't implement ReferenceCounted, this method does nothing.

Annotations

@SuppressWarnings:unchecked

retain back to summary

retain	back to summary
public static <T> T retain(T msg, int increment) Try to call `ReferenceCounted#retain(int)` if the specified message implements `ReferenceCounted`. If the specified message doesn't implement `ReferenceCounted`, this method does nothing. Annotations @SuppressWarnings:unchecked

public static <T> T retain(T msg, int increment)

Try to call ReferenceCounted#retain(int) if the specified message implements ReferenceCounted. If the specified message doesn't implement ReferenceCounted, this method does nothing.

Annotations

@SuppressWarnings:unchecked

safeRelease back to summary

safeRelease	back to summary
public static void safeRelease(Object msg) Try to call `ReferenceCounted#release()` if the specified message implements `ReferenceCounted`. If the specified message doesn't implement `ReferenceCounted`, this method does nothing. Unlike `release(Object)` this method catches an exception raised by `ReferenceCounted#release()` and logs it, rather than rethrowing it to the caller. It is usually recommended to use `release(Object)` instead, unless you absolutely need to swallow an exception.

public static void safeRelease(Object msg)

Try to call ReferenceCounted#release() if the specified message implements ReferenceCounted. If the specified message doesn't implement ReferenceCounted, this method does nothing. Unlike release(Object) this method catches an exception raised by ReferenceCounted#release() and logs it, rather than rethrowing it to the caller. It is usually recommended to use release(Object) instead, unless you absolutely need to swallow an exception.

safeRelease back to summary

safeRelease	back to summary
public static void safeRelease(Object msg, int decrement) Try to call `ReferenceCounted#release(int)` if the specified message implements `ReferenceCounted`. If the specified message doesn't implement `ReferenceCounted`, this method does nothing. Unlike `release(Object)` this method catches an exception raised by `ReferenceCounted#release(int)` and logs it, rather than rethrowing it to the caller. It is usually recommended to use `release(Object, int)` instead, unless you absolutely need to swallow an exception.

public static void safeRelease(Object msg, int decrement)

Try to call ReferenceCounted#release(int) if the specified message implements ReferenceCounted. If the specified message doesn't implement ReferenceCounted, this method does nothing. Unlike release(Object) this method catches an exception raised by ReferenceCounted#release(int) and logs it, rather than rethrowing it to the caller. It is usually recommended to use release(Object, int) instead, unless you absolutely need to swallow an exception.

touch back to summary

touch	back to summary
public static <T> T touch(T msg) Tries to call `ReferenceCounted#touch()` if the specified message implements `ReferenceCounted`. If the specified message doesn't implement `ReferenceCounted`, this method does nothing. Annotations @SuppressWarnings:unchecked

public static <T> T touch(T msg)

Tries to call ReferenceCounted#touch() if the specified message implements ReferenceCounted. If the specified message doesn't implement ReferenceCounted, this method does nothing.

Annotations

@SuppressWarnings:unchecked

touch back to summary

touch	back to summary
public static <T> T touch(T msg, Object hint) Tries to call `ReferenceCounted#touch(Object)` if the specified message implements `ReferenceCounted`. If the specified message doesn't implement `ReferenceCounted`, this method does nothing. Annotations @SuppressWarnings:unchecked

public static <T> T touch(T msg, Object hint)

Tries to call ReferenceCounted#touch(Object) if the specified message implements ReferenceCounted. If the specified message doesn't implement ReferenceCounted, this method does nothing.

Annotations

@SuppressWarnings:unchecked

io.netty.util back to summary

private final Class ReferenceCountUtil.ReleasingTask

Class Inheritance

extends Object
implements Runnable

java.lang.Object
io.netty.util.ReferenceCountUtil.ReleasingTask

All Implemented Interfaces

java.lang.Runnable

Releases the objects when the thread that called releaseLater(Object) has been terminated.

Field Summary

Modifier and Type	Field and Description
private final int	decrement
private final ReferenceCounted	obj

Constructor Summary

Access	Constructor and Description
pack-priv	ReleasingTask(ReferenceCounted obj, int decrement)

Method Summary

Modifier and Type	Method and Description
public void	run() Implements java.lang.Runnable.run. Runs this operation.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

decrement	back to summary
private final int decrement

obj	back to summary
private final ReferenceCounted obj

Constructor Detail

ReleasingTask	back to summary
pack-priv ReleasingTask(ReferenceCounted obj, int decrement)

Method Detail

run	back to summary
public void run() Implements java.lang.Runnable.run. Doc from java.lang.Runnable.run. Runs this operation. Annotations @Override

run

back to summary

public void run()

Implements java.lang.Runnable.run.

Doc from java.lang.Runnable.run.

Runs this operation.

Annotations

@Override

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Returns:String a string representation of the object Annotations @Override

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object

Annotations

@Override

public final Class ReferenceCountUtil

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class ReferenceCountUtil.ReleasingTask

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail