Modifier and Type	Class and Description
protected static interface	NexusAccessor.Dispatcher A dispatcher for registering type initializers in the `Nexus`.
public static class	NexusAccessor.InitializationAppender An initialization appender that looks up a loaded type initializer from Byte Buddy's `Nexus`.

Modifier and Type	Field and Description
private static final NexusAccessor.Dispatcher	DISPATCHER The dispatcher to use.
private final ReferenceQueue<? super ClassLoader>	referenceQueue The reference queue that is notified upon a GC eligible `Nexus` entry or `null` if no such queue should be notified.

Access	Constructor and Description
public	NexusAccessor() Creates a new accessor for the `Nexus` without any active management of stale references within a nexus.
public	NexusAccessor(ReferenceQueue<? super ClassLoader> The reference queue onto which stale references should be enqueued or `null` if no reference queue should be notified. referenceQueue) Creates a new accessor for a `Nexus` where any GC eligible are enqueued to the supplied reference queue.

Modifier and Type	Method and Description
public static void	clean(Reference<? extends ClassLoader> The reference to remove. References are collected via a reference queue that is supplied to the `NexusAccessor`. reference) Removes a stale entries that are registered in the `Nexus`.
private static < The type of the action's resolved value. T> T	Returns: The action's resolved value. doPrivileged(PrivilegedAction<T> The action to execute from a privileged context. action) A proxy for `java.security.AccessController#doPrivileged` that is activated if available.
public static boolean	Returns: `true` if this accessor is alive. isAlive() Checks if this `NexusAccessor` is capable of registering loaded type initializers.
public void	register(String The binary name of the class. name, ClassLoader The class's class loader. classLoader, int The id used for identifying the loaded type initializer that was added to the `Nexus`. identification, LoadedTypeInitializer The loaded type initializer to make available via the `Nexus`. loadedTypeInitializer) Registers a loaded type initializer in Byte Buddy's `Nexus` which is injected into the system class loader.

DISPATCHER	back to summary
private static final NexusAccessor.Dispatcher DISPATCHER The dispatcher to use.

referenceQueue	back to summary
private final ReferenceQueue<? super ClassLoader> referenceQueue The reference queue that is notified upon a GC eligible `Nexus` entry or `null` if no such queue should be notified. Annotations @MaybeNull @ValueHandling:REVERSE_NULLABILITY

NexusAccessor	back to summary
public NexusAccessor() Creates a new accessor for the `Nexus` without any active management of stale references within a nexus.

NexusAccessor	back to summary
public NexusAccessor(ReferenceQueue<? super ClassLoader> referenceQueue) Creates a new accessor for a `Nexus` where any GC eligible are enqueued to the supplied reference queue. Any such enqueued reference can be explicitly removed from the nexus via the `NexusAccessor#clean(Reference)` method. Nexus entries can become stale if a class loader is garbage collected after a class was loaded but before a class was initialized. Parameters referenceQueue:ReferenceQueue<? super ClassLoader> The reference queue onto which stale references should be enqueued or `null` if no reference queue should be notified.

clean	back to summary
public static void clean(Reference<? extends ClassLoader> reference) Removes a stale entries that are registered in the `Nexus`. Entries can become stale if a class is loaded but never initialized prior to its garbage collection. As all class loaders within a nexus are only referenced weakly, such class loaders are always garbage collected. However, the initialization data stored by Byte Buddy does not become eligible which is why it needs to be cleaned explicitly. Parameters reference:Reference<? extends ClassLoader> The reference to remove. References are collected via a reference queue that is supplied to the `NexusAccessor`.

doPrivileged	back to summary
private static <T> T doPrivileged(PrivilegedAction<T> action) A proxy for `java.security.AccessController#doPrivileged` that is activated if available. Parameters <T> The type of the action's resolved value. action:PrivilegedAction<T> The action to execute from a privileged context. Returns:T The action's resolved value. Annotations @Enhance

isAlive	back to summary
public static boolean isAlive() Checks if this `NexusAccessor` is capable of registering loaded type initializers. Returns:boolean `true` if this accessor is alive.

register	back to summary
public void register(String name, ClassLoader classLoader, int identification, LoadedTypeInitializer loadedTypeInitializer) Registers a loaded type initializer in Byte Buddy's `Nexus` which is injected into the system class loader. Parameters name:String The binary name of the class. classLoader:ClassLoader The class's class loader. identification:int The id used for identifying the loaded type initializer that was added to the `Nexus`. loadedTypeInitializer:LoadedTypeInitializer The loaded type initializer to make available via the `Nexus`.

protected Interface NexusAccessor.Dispatcher

Known Direct Implementers: net.bytebuddy.dynamic.NexusAccessor.Dispatcher.Available, net.bytebuddy.dynamic.NexusAccessor.Dispatcher.Unavailable

A dispatcher for registering type initializers in the Nexus.

Nested and Inner Type Summary

Modifier and Type	Class and Description
public static class	NexusAccessor.Dispatcher.Available An enabled dispatcher for registering a type initializer in a `Nexus`.
public static enum	NexusAccessor.Dispatcher.CreationAction Creates a new dispatcher for accessing a `Nexus`.
public static class	NexusAccessor.Dispatcher.Unavailable A disabled dispatcher where a `Nexus` is not available.

Method Summary

Modifier and Type	Method and Description
public void	clean(Reference<? extends ClassLoader> The reference to remove. reference) Cleans any dead entries of the system class loader's `Nexus`.
public boolean	Returns: `true` if this dispatcher is alive. isAlive() Returns `true` if this dispatcher is alive.
public void	register(String The name of a type for which a loaded type initializer is registered. name, ClassLoader The class loader for which a loaded type initializer is registered. classLoader, ReferenceQueue<? super ClassLoader> A reference queue to notify about stale nexus entries or `null` if no queue should be referenced. referenceQueue, int An identification for the initializer to run. identification, LoadedTypeInitializer The loaded type initializer to be registered. loadedTypeInitializer) Registers a type initializer with the system class loader's nexus.

Method Detail

clean back to summary

clean	back to summary
public void clean(Reference<? extends ClassLoader> reference) Cleans any dead entries of the system class loader's `Nexus`. Parameters reference:Reference<? extends ClassLoader> The reference to remove.

public void clean(Reference<? extends ClassLoader> reference)

Cleans any dead entries of the system class loader's Nexus.

Parameters

reference:Reference<? extends ClassLoader>: The reference to remove.

isAlive back to summary

isAlive	back to summary
public boolean isAlive() Returns `true` if this dispatcher is alive. Returns:boolean `true` if this dispatcher is alive.

public boolean isAlive()

Returns true if this dispatcher is alive.

Returns:boolean: true if this dispatcher is alive.

register	back to summary
public void register(String name, ClassLoader classLoader, ReferenceQueue<? super ClassLoader> referenceQueue, int identification, LoadedTypeInitializer loadedTypeInitializer) Registers a type initializer with the system class loader's nexus. Parameters name:String The name of a type for which a loaded type initializer is registered. classLoader:ClassLoader The class loader for which a loaded type initializer is registered. referenceQueue:ReferenceQueue<? super ClassLoader> A reference queue to notify about stale nexus entries or `null` if no queue should be referenced. identification:int An identification for the initializer to run. loadedTypeInitializer:LoadedTypeInitializer The loaded type initializer to be registered.

public void register(String name, ClassLoader classLoader, ReferenceQueue<? super ClassLoader> referenceQueue, int identification, LoadedTypeInitializer loadedTypeInitializer)

Registers a type initializer with the system class loader's nexus.

Parameters

name:String: The name of a type for which a loaded type initializer is registered.
classLoader:ClassLoader: The class loader for which a loaded type initializer is registered.
referenceQueue:ReferenceQueue<? super ClassLoader>: A reference queue to notify about stale nexus entries or null if no queue should be referenced.
identification:int: An identification for the initializer to run.
loadedTypeInitializer:LoadedTypeInitializer: The loaded type initializer to be registered.

net.bytebuddy.dynamic back to summary

public Class NexusAccessor.Dispatcher.Available

Class Inheritance

extends Object
implements Dispatcher

java.lang.Object
net.bytebuddy.dynamic.NexusAccessor.Dispatcher.Available

All Implemented Interfaces

net.bytebuddy.dynamic.NexusAccessor.Dispatcher

Annotations

@Enhance

An enabled dispatcher for registering a type initializer in a Nexus.

Field Summary

Modifier and Type	Field and Description
private final Method	clean The `Nexus#clean(Reference)` method.
private final Method	register The `Nexus#register(String, ClassLoader, ReferenceQueue, int, Object)` method.

Constructor Summary

Access	Constructor and Description
protected	Available(Method The `Nexus#register(String, ClassLoader, ReferenceQueue, int, Object)` method. register, Method The `Nexus#clean(Reference)` method. clean) Creates a new dispatcher.

Method Summary

Modifier and Type	Method and Description
public void	clean(Reference<? extends ClassLoader> The reference to remove. reference) Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean. Cleans any dead entries of the system class loader's `Nexus`.
public boolean	isAlive() Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive. Returns `true` if this dispatcher is alive.
public void	register(String The name of a type for which a loaded type initializer is registered. name, ClassLoader The class loader for which a loaded type initializer is registered. classLoader, ReferenceQueue<? super ClassLoader> A reference queue to notify about stale nexus entries or `null` if no queue should be referenced. referenceQueue, int An identification for the initializer to run. identification, LoadedTypeInitializer The loaded type initializer to be registered. loadedTypeInitializer) Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register. Registers a type initializer with the system class loader's nexus.

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

Field Detail

clean	back to summary
private final Method clean The `Nexus#clean(Reference)` method.

register	back to summary
private final Method register The `Nexus#register(String, ClassLoader, ReferenceQueue, int, Object)` method.

Constructor Detail

Available back to summary

Available	back to summary
protected Available(Method register, Method clean) Creates a new dispatcher. Parameters register:Method The `Nexus#register(String, ClassLoader, ReferenceQueue, int, Object)` method. clean:Method The `Nexus#clean(Reference)` method.

protected Available(Method register, Method clean)

Creates a new dispatcher.

Parameters

register:Method: The Nexus#register(String, ClassLoader, ReferenceQueue, int, Object) method.
clean:Method: The Nexus#clean(Reference) method.

Method Detail

clean back to summary

clean	back to summary
public void clean(Reference<? extends ClassLoader> reference) Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean. Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean. Cleans any dead entries of the system class loader's `Nexus`. Parameters reference:Reference<? extends ClassLoader> The reference to remove.

public void clean(Reference<? extends ClassLoader> reference)

Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean.

Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean.

Cleans any dead entries of the system class loader's Nexus.

Parameters

reference:Reference<? extends ClassLoader>: The reference to remove.

isAlive back to summary

isAlive	back to summary
public boolean isAlive() Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive. Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive. Returns `true` if this dispatcher is alive. Returns:boolean `true` if this dispatcher is alive.

public boolean isAlive()

Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive.

Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive.

Returns true if this dispatcher is alive.

Returns:boolean: true if this dispatcher is alive.

register	back to summary
public void register(String name, ClassLoader classLoader, ReferenceQueue<? super ClassLoader> referenceQueue, int identification, LoadedTypeInitializer loadedTypeInitializer) Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register. Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register. Registers a type initializer with the system class loader's nexus. Parameters name:String The name of a type for which a loaded type initializer is registered. classLoader:ClassLoader The class loader for which a loaded type initializer is registered. referenceQueue:ReferenceQueue<? super ClassLoader> A reference queue to notify about stale nexus entries or `null` if no queue should be referenced. identification:int An identification for the initializer to run. loadedTypeInitializer:LoadedTypeInitializer The loaded type initializer to be registered.

public void register(String name, ClassLoader classLoader, ReferenceQueue<? super ClassLoader> referenceQueue, int identification, LoadedTypeInitializer loadedTypeInitializer)

Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register.

Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register.

Registers a type initializer with the system class loader's nexus.

Parameters

name:String: The name of a type for which a loaded type initializer is registered.
classLoader:ClassLoader: The class loader for which a loaded type initializer is registered.
referenceQueue:ReferenceQueue<? super ClassLoader>: A reference queue to notify about stale nexus entries or null if no queue should be referenced.
identification:int: An identification for the initializer to run.
loadedTypeInitializer:LoadedTypeInitializer: The loaded type initializer to be registered.

net.bytebuddy.dynamic back to summary

public final Enum NexusAccessor.Dispatcher.CreationAction

Class Inheritance

extends Enum<NexusAccessor.Dispatcher.CreationAction>
implements PrivilegedAction<NexusAccessor.Dispatcher>

java.lang.Object
java.lang.Enum
net.bytebuddy.dynamic.NexusAccessor.Dispatcher.CreationAction

All Implemented Interfaces

java.security.PrivilegedAction

Creates a new dispatcher for accessing a Nexus.

Field Summary

Modifier and Type	Field and Description
public static final NexusAccessor.Dispatcher.CreationAction	INSTANCE The singleton instance.

Constructor Summary

Access	Constructor and Description
private	CreationAction()

Method Summary

Modifier and Type	Method and Description
public NexusAccessor.Dispatcher	run() Implements java.security.PrivilegedAction.run. Performs the computation.
public static NexusAccessor.Dispatcher.CreationAction	valueOf(String name)
public static NexusAccessor.Dispatcher.CreationAction[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

INSTANCE	back to summary
public static final NexusAccessor.Dispatcher.CreationAction INSTANCE The singleton instance.

Constructor Detail

CreationAction	back to summary
private CreationAction()

Method Detail

run back to summary

run	back to summary
public NexusAccessor.Dispatcher run() Implements java.security.PrivilegedAction.run. Doc from java.security.PrivilegedAction.run. Performs the computation. This method will be called by `AccessController.doPrivileged` after enabling privileges. Returns:NexusAccessor.Dispatcher a class-dependent value that may represent the results of the computation. Each class that implements `PrivilegedAction` should document what (if anything) this value represents. Annotations @SuppressFBWarnings:REC_CATCH_EXCEPTION justification:Exception should not be rethrown but trigger a fallback.

public NexusAccessor.Dispatcher run()

Implements java.security.PrivilegedAction.run.

Doc from java.security.PrivilegedAction.run.

Performs the computation. This method will be called by AccessController.doPrivileged after enabling privileges.

Returns:NexusAccessor.Dispatcher

a class-dependent value that may represent the results of the computation. Each class that implements PrivilegedAction should document what (if anything) this value represents.

Annotations

@SuppressFBWarnings:REC_CATCH_EXCEPTION
justification:Exception should not be rethrown but trigger a fallback.

valueOf	back to summary
public static NexusAccessor.Dispatcher.CreationAction valueOf(String name)

values	back to summary
public static NexusAccessor.Dispatcher.CreationAction[] values()

net.bytebuddy.dynamic back to summary

public Class NexusAccessor.Dispatcher.Unavailable

Class Inheritance

extends Object
implements Dispatcher

java.lang.Object
net.bytebuddy.dynamic.NexusAccessor.Dispatcher.Unavailable

All Implemented Interfaces

net.bytebuddy.dynamic.NexusAccessor.Dispatcher

Annotations

@Enhance

A disabled dispatcher where a Nexus is not available.

Field Summary

Modifier and Type	Field and Description
private final String	message The reason for the dispatcher being unavailable.

Constructor Summary

Access	Constructor and Description
protected	Unavailable(String The reason for the dispatcher being unavailable. message) Creates a new unavailable dispatcher.

Method Summary

Modifier and Type	Method and Description
public void	clean(Reference<? extends ClassLoader> The reference to remove. reference) Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean. Cleans any dead entries of the system class loader's `Nexus`.
public boolean	isAlive() Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive. Returns `true` if this dispatcher is alive.
public void	register(String The name of a type for which a loaded type initializer is registered. name, ClassLoader The class loader for which a loaded type initializer is registered. classLoader, ReferenceQueue<? super ClassLoader> A reference queue to notify about stale nexus entries or `null` if no queue should be referenced. referenceQueue, int An identification for the initializer to run. identification, LoadedTypeInitializer The loaded type initializer to be registered. loadedTypeInitializer) Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register. Registers a type initializer with the system class loader's nexus.

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

Field Detail

message	back to summary
private final String message The reason for the dispatcher being unavailable.

Constructor Detail

Unavailable	back to summary
protected Unavailable(String message) Creates a new unavailable dispatcher. Parameters message:String The reason for the dispatcher being unavailable.

Unavailable

back to summary

protected Unavailable(String message)

Creates a new unavailable dispatcher.

Parameters

message:String: The reason for the dispatcher being unavailable.

Method Detail

clean back to summary

clean	back to summary
public void clean(Reference<? extends ClassLoader> reference) Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean. Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean. Cleans any dead entries of the system class loader's `Nexus`. Parameters reference:Reference<? extends ClassLoader> The reference to remove.

public void clean(Reference<? extends ClassLoader> reference)

Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean.

Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.clean.

Cleans any dead entries of the system class loader's Nexus.

Parameters

reference:Reference<? extends ClassLoader>: The reference to remove.

isAlive back to summary

isAlive	back to summary
public boolean isAlive() Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive. Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive. Returns `true` if this dispatcher is alive. Returns:boolean `true` if this dispatcher is alive.

public boolean isAlive()

Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive.

Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.isAlive.

Returns true if this dispatcher is alive.

Returns:boolean: true if this dispatcher is alive.

register	back to summary
public void register(String name, ClassLoader classLoader, ReferenceQueue<? super ClassLoader> referenceQueue, int identification, LoadedTypeInitializer loadedTypeInitializer) Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register. Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register. Registers a type initializer with the system class loader's nexus. Parameters name:String The name of a type for which a loaded type initializer is registered. classLoader:ClassLoader The class loader for which a loaded type initializer is registered. referenceQueue:ReferenceQueue<? super ClassLoader> A reference queue to notify about stale nexus entries or `null` if no queue should be referenced. identification:int An identification for the initializer to run. loadedTypeInitializer:LoadedTypeInitializer The loaded type initializer to be registered.

public void register(String name, ClassLoader classLoader, ReferenceQueue<? super ClassLoader> referenceQueue, int identification, LoadedTypeInitializer loadedTypeInitializer)

Implements net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register.

Doc from net.bytebuddy.dynamic.NexusAccessor.Dispatcher.register.

Registers a type initializer with the system class loader's nexus.

Parameters

name:String: The name of a type for which a loaded type initializer is registered.
classLoader:ClassLoader: The class loader for which a loaded type initializer is registered.
referenceQueue:ReferenceQueue<? super ClassLoader>: A reference queue to notify about stale nexus entries or null if no queue should be referenced.
identification:int: An identification for the initializer to run.
loadedTypeInitializer:LoadedTypeInitializer: The loaded type initializer to be registered.

public Class NexusAccessor

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

protected Interface NexusAccessor.Dispatcher

Nested and Inner Type Summary

Method Summary

Method Detail

public Class NexusAccessor.Dispatcher.Available

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum NexusAccessor.Dispatcher.CreationAction

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class NexusAccessor.Dispatcher.Unavailable

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class NexusAccessor.InitializationAppender

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail