Top Description Inners Fields Constructors Methods
io.smallrye.common.ref

public final Class References

extends Object
Class Inheritance
Annotations
@SuppressWarnings:removal
Imports
java.lang.ref.ReferenceQueue, java.security.AccessController, .PrivilegedAction, org.graalvm.nativeimage.ImageInfo, io.smallrye.common.constraint.Assert
A set of utility methods for reference types.

Nested and Inner Type Summary

Modifier and TypeClass and Description
pack-priv static class
References.BuildTimeHolder

pack-priv static class
References.ReaperThread

Field Summary

Modifier and TypeField and Description
private static final Reference<?, ?>
NULL

Constructor Summary

AccessConstructor and Description
private
References()

Method Summary

Modifier and TypeMethod and Description
public static <
the reference value type
T,
the reference attachment type
A> Reference<T, A>

Returns:

the reference
create(Reference.Type
the reference type
type, T
the reference value
value, A
the attachment value
attachment, Reaper<T, A>
the reaper to use, if any
reaper)

Create a reference of a given type with the provided value and attachment.

public static <
the reference value type
T,
the reference attachment type
A> Reference<T, A>

Returns:

the reference
create(Reference.Type
the reference type
type, T
the reference value
value, A
the attachment value
attachment, ReferenceQueue<? super T>
the reference queue to use, if any
referenceQueue)

Create a reference of a given type with the provided value and attachment.

public static <
the reference value type
T,
the reference attachment type
A> Reference<T, A>

Returns:

the reference
create(Reference.Type
the reference type
type, T
the reference value
value, A
the attachment value
attachment)

Create a reference of a given type with the provided value and attachment.

public static <
the reference value type
T,
the attachment value type
A> Reference<T, A>

Returns:

the null reference
getNullReference()

Get a null reference.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

NULLback to summary
private static final Reference<?, ?> NULL

Constructor Detail

Referencesback to summary
private References()

Method Detail

createback to summary
public static <T, A> Reference<T, A> create(Reference.Type type, T value, A attachment, Reaper<T, A> reaper)

Create a reference of a given type with the provided value and attachment. If the reference type is Reference.Type#STRONG or Reference.Type#NULL then the reaper argument is ignored. If the reference type is Reference.Type#NULL then the value and attachment arguments are ignored.

Parameters
<T>
the reference value type
<A>
the reference attachment type
type:Reference.Type

the reference type

value:T

the reference value

attachment:A

the attachment value

reaper:Reaper<T, A>

the reaper to use, if any

Returns:Reference<T, A>

the reference

createback to summary
public static <T, A> Reference<T, A> create(Reference.Type type, T value, A attachment, ReferenceQueue<? super T> referenceQueue)

Create a reference of a given type with the provided value and attachment. If the reference type is Reference.Type#STRONG or Reference.Type#NULL then the reference queue argument is ignored. If the reference type is Reference.Type#NULL then the value and attachment arguments are ignored.

Parameters
<T>
the reference value type
<A>
the reference attachment type
type:Reference.Type

the reference type

value:T

the reference value

attachment:A

the attachment value

referenceQueue:ReferenceQueue<? super T>

the reference queue to use, if any

Returns:Reference<T, A>

the reference

createback to summary
public static <T, A> Reference<T, A> create(Reference.Type type, T value, A attachment)

Create a reference of a given type with the provided value and attachment. If the reference type is Reference.Type#PHANTOM then this method will return a null reference because such references are not constructable without a queue or reaper. If the reference type is Reference.Type#NULL then the value and attachment arguments are ignored.

Parameters
<T>
the reference value type
<A>
the reference attachment type
type:Reference.Type

the reference type

value:T

the reference value

attachment:A

the attachment value

Returns:Reference<T, A>

the reference

getNullReferenceback to summary
public static <T, A> Reference<T, A> getNullReference()

Get a null reference. This reference type is always cleared and does not retain an attachment; as such there is only one single instance of it.

Parameters
<T>
the reference value type
<A>
the attachment value type
Returns:Reference<T, A>

the null reference

Annotations
@SuppressWarnings:unchecked
io.smallrye.common.ref back to summary

pack-priv final Class References.BuildTimeHolder

extends Object
Class Inheritance

Field Summary

Modifier and TypeField and Description
pack-priv static final ReferenceQueue<Object>
REAPER_QUEUE

Constructor Summary

AccessConstructor and Description
pack-priv
BuildTimeHolder()

Method Summary

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

REAPER_QUEUEback to summary
pack-priv static final ReferenceQueue<Object> REAPER_QUEUE

Constructor Detail

BuildTimeHolderback to summary
pack-priv BuildTimeHolder()
io.smallrye.common.ref back to summary

pack-priv final Class References.ReaperThread

extends Thread
Class Inheritance

Field Summary

Inherited from java.lang.Thread:
MAX_PRIORITYMIN_PRIORITYNORM_PRIORITY

Constructor Summary

AccessConstructor and Description
pack-priv
ReaperThread()

Method Summary

Modifier and TypeMethod and Description
pack-priv static ReferenceQueue<Object>
getReaperQueue()

private static boolean
isBuildTime()

private static <T, A> void
reap(final Reapable<T, A> reapable)

public void
run()

Overrides java.lang.Thread.run.

Implements java.lang.Runnable.run.

This method is run by the thread when it executes.

private static Void
startThreadAction(int id)

Inherited from java.lang.Thread:
activeCountcheckAccessclonecurrentThreaddumpStackenumerategetAllStackTracesgetContextClassLoadergetDefaultUncaughtExceptionHandlergetIdgetNamegetPrioritygetStackTracegetStategetThreadGroupgetUncaughtExceptionHandlerholdsLockinterruptinterruptedisAliveisDaemonisInterruptedisVirtualjoinjoinjoinjoinofPlatformofVirtualonSpinWaitsetContextClassLoadersetDaemonsetDefaultUncaughtExceptionHandlersetNamesetPrioritysetUncaughtExceptionHandlersleepsleepsleepstartstartVirtualThreadstopthreadIdtoStringyield

Constructor Detail

ReaperThreadback to summary
pack-priv ReaperThread()

Method Detail

getReaperQueueback to summary
pack-priv static ReferenceQueue<Object> getReaperQueue()
isBuildTimeback to summary
private static boolean isBuildTime()
reapback to summary
private static <T, A> void reap(final Reapable<T, A> reapable)
Annotations
@SuppressWarnings:unchecked
runback to summary
public void run()

Overrides java.lang.Thread.run.

Implements java.lang.Runnable.run.

Doc from java.lang.Thread.run.

This method is run by the thread when it executes. Subclasses of Thread may override this method.

This method is not intended to be invoked directly. If this thread is a platform thread created with a Runnable task then invoking this method will invoke the task's run method. If this thread is a virtual thread then invoking this method directly does nothing.

startThreadActionback to summary
private static Void startThreadAction(int id)