Package net.bytebuddy.agent.builder

An agent builder is used to easily implement load-time class-transformations using a Java agent.

See: Description

Interface Summary

Interface	Description
AgentBuilder	An agent builder provides a convenience API for defining a Java agent.
AgentBuilder.BinaryLocator	A binary locator allows to specify how binary data is located by an AgentBuilder.
AgentBuilder.Default.BootstrapInjectionStrategy	An injection strategy for injecting classes into the bootstrap class loader.
AgentBuilder.Default.NativeMethodStrategy	A strategy for determining if a native method name prefix should be used when rebasing methods.
AgentBuilder.Default.Transformation	A transformation serves as a handler for modifying a class.
AgentBuilder.Default.Transformation.Resolution	A resolution to a transformation.
AgentBuilder.Identified	Describes an AgentBuilder which was handed a matcher for identifying types to instrumented in order to supply one or several AgentBuilder.Transformers.
AgentBuilder.Identified.Extendable	This interface is used to allow for optionally providing several AgentBuilder.Transformer to applied when a matcher identifies a type to be instrumented.
AgentBuilder.InitializationStrategy	An initialization strategy which determines the handling of LoadedTypeInitializers and the loading of auxiliary types.
AgentBuilder.InitializationStrategy.Dispatcher	A dispatcher for changing a class file to adapt a self-initialization strategy.
AgentBuilder.InitializationStrategy.Dispatcher.InjectorFactory	A factory for creating a ClassInjector only if it is required.
AgentBuilder.InitializationStrategy.SelfInjection.NexusAccessor.Dispatcher	A dispatcher for registering type initializers in the Nexus.
AgentBuilder.Listener	A listener that is informed about events that occur during an instrumentation process.
AgentBuilder.RawMatcher	A matcher that allows to determine if a AgentBuilder.Transformer should be applied during the execution of a ClassFileTransformer that was generated by an AgentBuilder.
AgentBuilder.RedefinitionStrategy.Collector	A collector is responsible for collecting classes that are to be considered for modification.
AgentBuilder.Transformer	A transformer allows to apply modifications to a DynamicType.
AgentBuilder.TypeStrategy	A type strategy is responsible for creating a type builder for a type that is being instrumented.

Class Summary

Class	Description
AgentBuilder.Default	The default implementation of an AgentBuilder.
AgentBuilder.Default.BootstrapInjectionStrategy.Enabled	An enabled bootstrap injection strategy.
AgentBuilder.Default.ExecutingTransformer	A ClassFileTransformer that implements the enclosing agent builder's configuration.
AgentBuilder.Default.NativeMethodStrategy.ForPrefix	A native method strategy that prefixes method names with a fixed value for supporting rebasing of native methods.
AgentBuilder.Default.Transformation.Compound	A compound transformation that applied several transformation in the given order and applies the first active transformation.
AgentBuilder.Default.Transformation.Resolution.Unresolved	A canonical implementation of a non-resolved resolution.
AgentBuilder.Default.Transformation.Simple	A simple, active transformation.
AgentBuilder.Default.Transformation.Simple.Resolution	A resolution that performs a type transformation.
AgentBuilder.Default.Transformation.Simple.Resolution.BootstrapClassLoaderCapableInjectorFactory	An injector factory that resolves to a bootstrap class loader injection if this is necessary and enabled.
AgentBuilder.InitializationStrategy.SelfInjection.Dispatcher	A dispatcher for a self-initialization strategy.
AgentBuilder.InitializationStrategy.SelfInjection.Dispatcher.Eager	A dispatcher for the AgentBuilder.InitializationStrategy.SelfInjection.EAGER strategy.
AgentBuilder.InitializationStrategy.SelfInjection.Dispatcher.InjectingInitializer	A type initializer that injects all auxiliary types of the instrumented type.
AgentBuilder.InitializationStrategy.SelfInjection.Dispatcher.Lazy	A dispatcher for the AgentBuilder.InitializationStrategy.SelfInjection.LAZY strategy.
AgentBuilder.InitializationStrategy.SelfInjection.Dispatcher.Split	A dispatcher for the AgentBuilder.InitializationStrategy.SelfInjection.SPLIT strategy.
AgentBuilder.InitializationStrategy.SelfInjection.NexusAccessor.Dispatcher.Available	An enabled dispatcher for registering a type initializer in a Nexus.
AgentBuilder.InitializationStrategy.SelfInjection.NexusAccessor.Dispatcher.Unavailable	A disabled dispatcher where a Nexus is not available.
AgentBuilder.InitializationStrategy.SelfInjection.NexusAccessor.InitializationAppender	A byte code appender for invoking a Nexus for initializing the instrumented type.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory	A factory that creates instances that represent lambda expressions.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.BridgeMethodImplementation	Implements an explicit bridge method for a lambda expression.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.BridgeMethodImplementation.Appender	An appender for implementing a bridge method for a lambda expression.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.ConstructorImplementation.Appender	An appender to implement the constructor.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.FactoryImplementation.Appender	An appender for a lambda expression factory.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.LambdaMethodImplementation	Implements a lambda expression's functional method.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.LambdaMethodImplementation.Appender	An appender for a lambda expression's functional method.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.SerializationImplementation	Implements the writeReplace method for serializable lambda expressions.
AgentBuilder.Listener.Compound	A compound listener that allows to group several listeners in one instance.
AgentBuilder.Listener.StreamWriting	A listener that writes events to a PrintStream.
AgentBuilder.RawMatcher.ForElementMatcherPair	A raw matcher implementation that checks a TypeDescription and its ClassLoader against two suitable matchers in order to determine if the matched type should be instrumented.
AgentBuilder.RedefinitionStrategy.Collector.ForRedefinition	A collector that applies a redefinition of already loaded classes.
AgentBuilder.RedefinitionStrategy.Collector.ForRedefinition.Entry	An entry describing a type redefinition.
AgentBuilder.RedefinitionStrategy.Collector.ForRetransformation	A collector that applies a retransformation of already loaded classes.
AgentBuilder.Transformer.Compound	A compound transformer that allows to group several AgentBuilder.Transformers as a single transformer.
LambdaFactory	This class serves as a dispatcher for creating lambda expression objects when Byte Buddy is configured to instrument the java.lang.invoke.LambdaMetafactory.
Nexus	This nexus is a global dispatcher for initializing classes with LoadedTypeInitializers.

Enum Summary

Enum	Description
AgentBuilder.BinaryLocator.ClassLoading	A binary locator that loads referenced classes instead of describing unloaded versions.
AgentBuilder.BinaryLocator.Default	A default implementation of a AgentBuilder.BinaryLocator that is using a TypePool.Default with a TypePool.CacheProvider.Simple and a ClassFileLocator.ForClassLoader.
AgentBuilder.Default.BootstrapInjectionStrategy.Disabled	A disabled bootstrap injection strategy.
AgentBuilder.Default.NativeMethodStrategy.Disabled	A native method strategy that suffixes method names with a random suffix and disables native method rebasement.
AgentBuilder.Default.Transformation.Ignored	A transformation that does not attempt to transform any type.
AgentBuilder.InitializationStrategy.Minimal	An initialization strategy that loads auxiliary types before loading the instrumented type.
AgentBuilder.InitializationStrategy.NoOp	A non-initializing initialization strategy.
AgentBuilder.InitializationStrategy.SelfInjection	An initialization strategy that adds a code block to an instrumented type's type initializer which then calls a specific class that is responsible for the explicit initialization.
AgentBuilder.InitializationStrategy.SelfInjection.NexusAccessor	An accessor for making sure that the accessed Nexus is the class that is loaded by the system class loader.
AgentBuilder.LambdaInstrumentationStrategy	Implements the instrumentation of the LambdaMetafactory if this feature is enabled.
AgentBuilder.LambdaInstrumentationStrategy.AlternativeMetaFactoryRedirection	Implements the alternative lambda meta factory.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.ConstructorImplementation	Implements a lambda class's constructor.
AgentBuilder.LambdaInstrumentationStrategy.LambdaInstanceFactory.FactoryImplementation	An implementation of a instance factory for a lambda expression's class.
AgentBuilder.LambdaInstrumentationStrategy.MetaFactoryRedirection	Implements the regular lambda meta factory.
AgentBuilder.Listener.NoOp	A no-op implementation of a AgentBuilder.Listener.
AgentBuilder.RedefinitionStrategy	A redefinition strategy regulates how already loaded classes are modified by a built agent.
AgentBuilder.Transformer.NoOp	A no-op implementation of a AgentBuilder.Transformer that does not modify the supplied dynamic type.
AgentBuilder.TypeStrategy.Default	Default implementations of type strategies.

Package net.bytebuddy.agent.builder Description

An agent builder is used to easily implement load-time class-transformations using a Java agent. The API builds on Java's ClassFileTransformer and Instrumentation but offers higher-level APIs in order to allow for the implementation of very readable transformations using ByteBuddy.