T - The type that is produced by chaining a matcher.protected abstract class AgentBuilder.Default.Delegator<T extends AgentBuilder.Matchable<T>> extends AgentBuilder.Matchable.AbstractBase<T> implements AgentBuilder
AgentBuilder.CircularityLock, AgentBuilder.Default, AgentBuilder.DescriptionStrategy, AgentBuilder.FallbackStrategy, AgentBuilder.Identified, AgentBuilder.Ignored, AgentBuilder.InitializationStrategy, AgentBuilder.InstallationListener, AgentBuilder.LambdaInstrumentationStrategy, AgentBuilder.Listener, AgentBuilder.LocationStrategy, AgentBuilder.Matchable<T extends AgentBuilder.Matchable<T>>, AgentBuilder.PoolStrategy, AgentBuilder.RawMatcher, AgentBuilder.RedefinitionListenable, AgentBuilder.RedefinitionStrategy, AgentBuilder.Transformer, AgentBuilder.TypeStrategyAgentBuilder.Matchable.AbstractBase<S extends AgentBuilder.Matchable<S>>| Modifier | Constructor and Description |
|---|---|
protected |
Delegator() |
| Modifier and Type | Method and Description |
|---|---|
AgentBuilder |
assureReadEdgeFromAndTo(Instrumentation instrumentation,
Class<?>... type)
Assures that all modules of the supplied types are read by the module of any instrumented type and vice versa.
|
AgentBuilder |
assureReadEdgeFromAndTo(Instrumentation instrumentation,
Collection<? extends JavaModule> modules)
Assures that all supplied modules are read by the module of any instrumented type and vice versa.
|
AgentBuilder |
assureReadEdgeFromAndTo(Instrumentation instrumentation,
JavaModule... module)
Assures that all supplied modules are read by the module of any instrumented type and vice versa.
|
AgentBuilder |
assureReadEdgeTo(Instrumentation instrumentation,
Class<?>... type)
Assures that all modules of the supplied types are read by the module of any instrumented type.
|
AgentBuilder |
assureReadEdgeTo(Instrumentation instrumentation,
Collection<? extends JavaModule> modules)
Assures that all supplied modules are read by the module of any instrumented type.
|
AgentBuilder |
assureReadEdgeTo(Instrumentation instrumentation,
JavaModule... module)
Assures that all supplied modules are read by the module of any instrumented type.
|
AgentBuilder |
disableBootstrapInjection()
Disables injection of auxiliary classes into the bootstrap class path.
|
AgentBuilder |
disableClassFormatChanges()
Disables all implicit changes on a class file that Byte Buddy would apply for certain instrumentations.
|
AgentBuilder |
disableNativeMethodPrefix()
Disables the use of a native method prefix for instrumented methods.
|
AgentBuilder |
enableBootstrapInjection(Instrumentation instrumentation,
File folder)
Enables class injection of auxiliary classes into the bootstrap class loader.
|
AgentBuilder |
enableNativeMethodPrefix(String prefix)
Enables the use of the given native method prefix for instrumented methods.
|
AgentBuilder |
enableUnsafeBootstrapInjection()
Enables class injection of auxiliary classes into the bootstrap class loader which relies on
sun.misc.Unsafe. |
AgentBuilder.Ignored |
ignore(AgentBuilder.RawMatcher rawMatcher)
Excludes any type that is matched by the raw matcher provided to this method.
|
AgentBuilder.Ignored |
ignore(ElementMatcher<? super TypeDescription> ignoredTypes)
Excludes any type that is matched by the provided matcher from instrumentation and considers types by all
ClassLoaders. |
AgentBuilder.Ignored |
ignore(ElementMatcher<? super TypeDescription> ignoredTypes,
ElementMatcher<? super ClassLoader> ignoredClassLoaders)
Excludes any type that is matched by the provided matcher and is loaded by a class loader matching the second matcher.
|
AgentBuilder.Ignored |
ignore(ElementMatcher<? super TypeDescription> typeMatcher,
ElementMatcher<? super ClassLoader> classLoaderMatcher,
ElementMatcher<? super JavaModule> moduleMatcher)
Excludes any type that is matched by the provided matcher and is loaded by a class loader matching the second matcher.
|
ResettableClassFileTransformer |
installOn(Instrumentation instrumentation)
Creates and installs a
ClassFileTransformer that implements the configuration of
this agent builder with a given Instrumentation. |
ResettableClassFileTransformer |
installOnByteBuddyAgent()
Creates and installs a
ClassFileTransformer that implements the configuration of
this agent builder with the Byte Buddy-agent which must be installed prior to calling this method. |
ClassFileTransformer |
makeRaw()
Creates a
ClassFileTransformer that implements the configuration of this
agent builder. |
protected abstract AgentBuilder |
materialize()
Materializes the currently described
AgentBuilder. |
AgentBuilder.Identified.Narrowable |
type(AgentBuilder.RawMatcher matcher)
Matches a type being loaded in order to apply the supplied
AgentBuilder.Transformers before loading this type. |
AgentBuilder.Identified.Narrowable |
type(ElementMatcher<? super TypeDescription> typeMatcher)
Matches a type being loaded in order to apply the supplied
AgentBuilder.Transformers before loading this type. |
AgentBuilder.Identified.Narrowable |
type(ElementMatcher<? super TypeDescription> typeMatcher,
ElementMatcher<? super ClassLoader> classLoaderMatcher)
Matches a type being loaded in order to apply the supplied
AgentBuilder.Transformers before loading this type. |
AgentBuilder.Identified.Narrowable |
type(ElementMatcher<? super TypeDescription> typeMatcher,
ElementMatcher<? super ClassLoader> classLoaderMatcher,
ElementMatcher<? super JavaModule> moduleMatcher)
Matches a type being loaded in order to apply the supplied
AgentBuilder.Transformers before loading this type. |
AgentBuilder |
with(AgentBuilder.CircularityLock circularityLock)
Defines a circularity lock that is acquired upon executing code that potentially loads new classes.
|
AgentBuilder |
with(AgentBuilder.DescriptionStrategy descriptionStrategy)
Specifies a strategy to be used for resolving
TypeDescription for any type handled by the created transformer. |
AgentBuilder |
with(AgentBuilder.FallbackStrategy fallbackStrategy)
Specifies a fallback strategy to that this agent builder applies upon installing an agent and during class file transformation.
|
AgentBuilder |
with(AgentBuilder.InitializationStrategy initializationStrategy)
Defines a given initialization strategy to be applied to generated types.
|
AgentBuilder |
with(AgentBuilder.InstallationListener installationListener)
Adds an installation listener that is notified during installation events.
|
AgentBuilder |
with(AgentBuilder.LambdaInstrumentationStrategy lambdaInstrumentationStrategy)
Enables or disables management of the JVM's
LambdaMetafactory which is responsible for creating classes that
implement lambda expressions. |
AgentBuilder |
with(AgentBuilder.Listener listener)
Defines the given
AgentBuilder.Listener to be notified by the created agent. |
AgentBuilder |
with(AgentBuilder.LocationStrategy locationStrategy)
Defines the use of the given location strategy for locating binary data to given class names.
|
AgentBuilder |
with(AgentBuilder.PoolStrategy poolStrategy)
Defines the use of the given type locator for locating a
TypeDescription for an instrumented type. |
AgentBuilder.RedefinitionListenable.WithoutBatchStrategy |
with(AgentBuilder.RedefinitionStrategy redefinitionStrategy)
Specifies a strategy for modifying types that were already loaded prior to the installation of this transformer.
|
AgentBuilder |
with(AgentBuilder.TypeStrategy typeStrategy)
Defines how types should be transformed, e.g.
|
AgentBuilder |
with(ByteBuddy byteBuddy)
Defines the given
ByteBuddy instance to be used by the created agent. |
and, and, and, or, or, orclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitand, orprotected abstract AgentBuilder materialize()
AgentBuilder.public AgentBuilder with(ByteBuddy byteBuddy)
AgentBuilderByteBuddy instance to be used by the created agent.with in interface AgentBuilderbyteBuddy - The Byte Buddy instance to be used.byteBuddy instance.public AgentBuilder with(AgentBuilder.Listener listener)
AgentBuilderAgentBuilder.Listener to be notified by the created agent.
The given listener is notified after any other listener that is already registered. If a listener is registered
twice, it is also notified twice.with in interface AgentBuilderlistener - The listener to be notified.public AgentBuilder with(AgentBuilder.CircularityLock circularityLock)
AgentBuilderAgentBuilder.CircularityLock to avoid that any classes that are required to execute an agent
causes a ClassCircularityError.with in interface AgentBuildercircularityLock - The circularity lock to use.public AgentBuilder with(AgentBuilder.TypeStrategy typeStrategy)
AgentBuilderwith in interface AgentBuildertypeStrategy - The type strategy to use.public AgentBuilder with(AgentBuilder.PoolStrategy poolStrategy)
AgentBuilderTypeDescription for an instrumented type.with in interface AgentBuilderpoolStrategy - The type locator to use.public AgentBuilder with(AgentBuilder.LocationStrategy locationStrategy)
AgentBuilderwith in interface AgentBuilderlocationStrategy - The location strategy to use.public AgentBuilder with(AgentBuilder.InitializationStrategy initializationStrategy)
AgentBuilderwith in interface AgentBuilderinitializationStrategy - The initialization strategy to use.public AgentBuilder.RedefinitionListenable.WithoutBatchStrategy with(AgentBuilder.RedefinitionStrategy redefinitionStrategy)
AgentBuilderSpecifies a strategy for modifying types that were already loaded prior to the installation of this transformer.
Note: Defining a redefinition strategy resets any refinements of a previously set redefinition strategy.
Important: Most JVMs do not support changes of a class's structure after a class was already
loaded. Therefore, it is typically required that this class file transformer was built while enabling
AgentBuilder.disableClassFormatChanges().
with in interface AgentBuilderredefinitionStrategy - The redefinition strategy to apply.public AgentBuilder with(AgentBuilder.LambdaInstrumentationStrategy lambdaInstrumentationStrategy)
AgentBuilder
Enables or disables management of the JVM's LambdaMetafactory which is responsible for creating classes that
implement lambda expressions. Without this feature enabled, classes that are represented by lambda expressions are
not instrumented by the JVM such that Java agents have no effect on them when a lambda expression's class is loaded
for the first time.
When activating this feature, Byte Buddy instruments the LambdaMetafactory and takes over the responsibility
of creating classes that represent lambda expressions. In doing so, Byte Buddy has the opportunity to apply the built
class file transformer. If the current VM does not support lambda expressions, activating this feature has no effect.
Important: If this feature is active, it is important to release the built class file transformer when
deactivating it. Normally, it is sufficient to call Instrumentation.removeTransformer(ClassFileTransformer).
When this feature is enabled, it is however also required to invoke
AgentBuilder.LambdaInstrumentationStrategy.release(ClassFileTransformer, Instrumentation). Otherwise, the executing VMs class
loader retains a reference to the class file transformer what can cause a memory leak.
with in interface AgentBuilderlambdaInstrumentationStrategy - true if this feature should be enabled.public AgentBuilder with(AgentBuilder.DescriptionStrategy descriptionStrategy)
AgentBuilderTypeDescription for any type handled by the created transformer.with in interface AgentBuilderdescriptionStrategy - The description strategy to use.public AgentBuilder with(AgentBuilder.FallbackStrategy fallbackStrategy)
AgentBuilderwith in interface AgentBuilderfallbackStrategy - The fallback strategy to be used.public AgentBuilder with(AgentBuilder.InstallationListener installationListener)
AgentBuilderResettableClassFileTransformer's reset methods.with in interface AgentBuilderinstallationListener - The installation listener to register.public AgentBuilder enableBootstrapInjection(Instrumentation instrumentation, File folder)
AgentBuilderenableBootstrapInjection in interface AgentBuilderinstrumentation - The instrumentation instance that is used for appending jar files to the
bootstrap class path.folder - The folder in which jar files of the injected classes are to be stored.public AgentBuilder enableUnsafeBootstrapInjection()
AgentBuildersun.misc.Unsafe.enableUnsafeBootstrapInjection in interface AgentBuilderpublic AgentBuilder disableBootstrapInjection()
AgentBuilderdisableBootstrapInjection in interface AgentBuilderpublic AgentBuilder enableNativeMethodPrefix(String prefix)
AgentBuilderInstrumentation.enableNativeMethodPrefix in interface AgentBuilderprefix - The prefix to be used.public AgentBuilder disableNativeMethodPrefix()
AgentBuilderdisableNativeMethodPrefix in interface AgentBuilderpublic AgentBuilder disableClassFormatChanges()
AgentBuilderDisables all implicit changes on a class file that Byte Buddy would apply for certain instrumentations. When using this option, it is no longer possible to rebase a method, i.e. intercepted methods are fully replaced. Furthermore, it is no longer possible to implicitly apply loaded type initializers for explicitly initializing the generated type.
This is equivalent to setting AgentBuilder.InitializationStrategy.NoOp and AgentBuilder.TypeStrategy.Default.REDEFINE_FROZEN
as well as configuring the underlying ByteBuddy instance to use a Implementation.Context.Disabled.
Using this strategy also configures Byte Buddy to create frozen instrumented types and discards any explicit configuration.
disableClassFormatChanges in interface AgentBuilderpublic AgentBuilder assureReadEdgeTo(Instrumentation instrumentation, Class<?>... type)
AgentBuilderassureReadEdgeTo in interface AgentBuilderinstrumentation - The instrumentation instance that is used for adding a module read-dependency.type - The types for which to assure their module-visibility from any instrumented class.AgentBuilder.Listener.ModuleReadEdgeCompletingpublic AgentBuilder assureReadEdgeTo(Instrumentation instrumentation, JavaModule... module)
AgentBuilderassureReadEdgeTo in interface AgentBuilderinstrumentation - The instrumentation instance that is used for adding a module read-dependency.module - The modules for which to assure their module-visibility from any instrumented class.AgentBuilder.Listener.ModuleReadEdgeCompletingpublic AgentBuilder assureReadEdgeTo(Instrumentation instrumentation, Collection<? extends JavaModule> modules)
AgentBuilderassureReadEdgeTo in interface AgentBuilderinstrumentation - The instrumentation instance that is used for adding a module read-dependency.modules - The modules for which to assure their module-visibility from any instrumented class.AgentBuilder.Listener.ModuleReadEdgeCompletingpublic AgentBuilder assureReadEdgeFromAndTo(Instrumentation instrumentation, Class<?>... type)
AgentBuilderassureReadEdgeFromAndTo in interface AgentBuilderinstrumentation - The instrumentation instance that is used for adding a module read-dependency.type - The types for which to assure their module-visibility from and to any instrumented class.AgentBuilder.Listener.ModuleReadEdgeCompletingpublic AgentBuilder assureReadEdgeFromAndTo(Instrumentation instrumentation, JavaModule... module)
AgentBuilderassureReadEdgeFromAndTo in interface AgentBuilderinstrumentation - The instrumentation instance that is used for adding a module read-dependency.module - The modules for which to assure their module-visibility from and to any instrumented class.AgentBuilder.Listener.ModuleReadEdgeCompletingpublic AgentBuilder assureReadEdgeFromAndTo(Instrumentation instrumentation, Collection<? extends JavaModule> modules)
AgentBuilderassureReadEdgeFromAndTo in interface AgentBuilderinstrumentation - The instrumentation instance that is used for adding a module read-dependency.modules - The modules for which to assure their module-visibility from and to any instrumented class.AgentBuilder.Listener.ModuleReadEdgeCompletingpublic AgentBuilder.Identified.Narrowable type(ElementMatcher<? super TypeDescription> typeMatcher)
AgentBuilder
Matches a type being loaded in order to apply the supplied AgentBuilder.Transformers before loading this type.
If several matchers positively match a type only the latest registered matcher is considered for transformation.
If this matcher is chained with additional subsequent matchers, this matcher is always executed first whereas the following matchers are
executed in the order of their execution. If any matcher indicates that a type is to be matched, none of the following matchers is still queried.
This behavior can be changed by AgentBuilder.Identified.Extendable.asDecorator() where subsequent type matchers are also applied.
Note: When applying a matcher, regard the performance implications by AgentBuilder.ignore(ElementMatcher). The former
matcher is applied first such that it makes sense to ignore name spaces that are irrelevant to instrumentation. If possible, it is
also recommended, to exclude class loaders such as for example the bootstrap class loader by using
AgentBuilder.type(ElementMatcher, ElementMatcher) instead.
type in interface AgentBuildertypeMatcher - An ElementMatcher that is applied on the type being loaded that
decides if the entailed AgentBuilder.Transformers should
be applied for that type.AgentBuilder.Transformers to be applied when the given typeMatcher
indicates a match.public AgentBuilder.Identified.Narrowable type(ElementMatcher<? super TypeDescription> typeMatcher, ElementMatcher<? super ClassLoader> classLoaderMatcher)
AgentBuilder
Matches a type being loaded in order to apply the supplied AgentBuilder.Transformers before loading this type.
If several matchers positively match a type only the latest registered matcher is considered for transformation.
If this matcher is chained with additional subsequent matchers, this matcher is always executed first whereas the following matchers are
executed in the order of their execution. If any matcher indicates that a type is to be matched, none of the following matchers is still queried.
This behavior can be changed by AgentBuilder.Identified.Extendable.asDecorator() where subsequent type matchers are also applied.
Note: When applying a matcher, regard the performance implications by AgentBuilder.ignore(ElementMatcher). The former
matcher is applied first such that it makes sense to ignore name spaces that are irrelevant to instrumentation. If possible, it
is also recommended, to exclude class loaders such as for example the bootstrap class loader.
type in interface AgentBuildertypeMatcher - An ElementMatcher that is applied on the type being
loaded that decides if the entailed
AgentBuilder.Transformers should be applied for
that type.classLoaderMatcher - An ElementMatcher that is applied to the
ClassLoader that is loading the type being loaded. This matcher
is always applied first where the type matcher is not applied in case that this
matcher does not indicate a match.AgentBuilder.Transformers to be applied when both the given
typeMatcher and classLoaderMatcher indicate a match.public AgentBuilder.Identified.Narrowable type(ElementMatcher<? super TypeDescription> typeMatcher, ElementMatcher<? super ClassLoader> classLoaderMatcher, ElementMatcher<? super JavaModule> moduleMatcher)
AgentBuilder
Matches a type being loaded in order to apply the supplied AgentBuilder.Transformers before loading this type.
If several matchers positively match a type only the latest registered matcher is considered for transformation.
If this matcher is chained with additional subsequent matchers, this matcher is always executed first whereas the following matchers are
executed in the order of their execution. If any matcher indicates that a type is to be matched, none of the following matchers is still queried.
This behavior can be changed by AgentBuilder.Identified.Extendable.asDecorator() where subsequent type matchers are also applied.
Note: When applying a matcher, regard the performance implications by AgentBuilder.ignore(ElementMatcher). The former
matcher is applied first such that it makes sense to ignore name spaces that are irrelevant to instrumentation. If possible, it
is also recommended, to exclude class loaders such as for example the bootstrap class loader.
type in interface AgentBuildertypeMatcher - An ElementMatcher that is applied on the type being
loaded that decides if the entailed
AgentBuilder.Transformers should be applied for
that type.classLoaderMatcher - An ElementMatcher that is applied to the
ClassLoader that is loading the type being loaded. This matcher
is always applied second where the type matcher is not applied in case that this
matcher does not indicate a match.moduleMatcher - An ElementMatcher that is applied to the JavaModule
of the type being loaded. This matcher is always applied first where the class loader and
type matchers are not applied in case that this matcher does not indicate a match. On a JVM
that does not support the Java modules system, this matcher is not applied.AgentBuilder.Transformers to be applied when both the given
typeMatcher and classLoaderMatcher indicate a match.public AgentBuilder.Identified.Narrowable type(AgentBuilder.RawMatcher matcher)
AgentBuilder
Matches a type being loaded in order to apply the supplied AgentBuilder.Transformers before loading this type.
If several matchers positively match a type only the latest registered matcher is considered for transformation.
If this matcher is chained with additional subsequent matchers, this matcher is always executed first whereas the following matchers are executed in the order of their execution. If any matcher indicates that a type is to be matched, none of the following matchers is still queried.
Note: When applying a matcher, regard the performance implications by AgentBuilder.ignore(ElementMatcher). The former
matcher is applied first such that it makes sense to ignore name spaces that are irrelevant to instrumentation. If possible, it
is also recommended, to exclude class loaders such as for example the bootstrap class loader.
type in interface AgentBuildermatcher - A matcher that decides if the entailed AgentBuilder.Transformers should be
applied for a type that is being loaded.AgentBuilder.Transformers to be applied when the given matcher
indicates a match.public AgentBuilder.Ignored ignore(ElementMatcher<? super TypeDescription> ignoredTypes)
AgentBuilder
Excludes any type that is matched by the provided matcher from instrumentation and considers types by all ClassLoaders.
By default, Byte Buddy does not instrument synthetic types or types that are loaded by the bootstrap class loader.
When ignoring a type, any subsequently chained matcher is applied after this matcher in the order of their registration. Also, if any matcher indicates that a type is to be ignored, none of the following chained matchers is executed.
Note: For performance reasons, it is recommended to always include a matcher that excludes as many namespaces as possible. Byte Buddy can determine a type's name without parsing its class file and can therefore discard such types with minimal overhead. When a different property of a type - such as for example its modifiers or its annotations is accessed - Byte Buddy parses the class file lazily in order to allow for such a matching. Therefore, any exclusion of a name should always be done as a first step and even if it does not influence the selection of what types are matched. Without changing this property, the class file of every type is being parsed!
Warning: If a type is loaded during the instrumentation of the same type, this causes the original call site that loads the type
to remain unbound, causing a LinkageError. It is therefore important to not instrument types that may be loaded during the application
of a AgentBuilder.Transformer. For this reason, it is not recommended to instrument classes of the bootstrap class loader that Byte Buddy might
require for instrumenting a class or to instrument any of Byte Buddy's classes. If such instrumentation is desired, it is important to
assert for each class that they are not loaded during instrumentation.
ignore in interface AgentBuilderignoredTypes - A matcher that identifies types that should not be instrumented.public AgentBuilder.Ignored ignore(ElementMatcher<? super TypeDescription> ignoredTypes, ElementMatcher<? super ClassLoader> ignoredClassLoaders)
AgentBuilder
Excludes any type that is matched by the provided matcher and is loaded by a class loader matching the second matcher.
By default, Byte Buddy does not instrument synthetic types, types within a net.bytebuddy.* package or types that
are loaded by the bootstrap class loader.
When ignoring a type, any subsequently chained matcher is applied after this matcher in the order of their registration. Also, if any matcher indicates that a type is to be ignored, none of the following chained matchers is executed.
Note: For performance reasons, it is recommended to always include a matcher that excludes as many namespaces as possible. Byte Buddy can determine a type's name without parsing its class file and can therefore discard such types with minimal overhead. When a different property of a type - such as for example its modifiers or its annotations is accessed - Byte Buddy parses the class file lazily in order to allow for such a matching. Therefore, any exclusion of a name should always be done as a first step and even if it does not influence the selection of what types are matched. Without changing this property, the class file of every type is being parsed!
Warning: If a type is loaded during the instrumentation of the same type, this causes the original call site that loads the type
to remain unbound, causing a LinkageError. It is therefore important to not instrument types that may be loaded during the application
of a AgentBuilder.Transformer. For this reason, it is not recommended to instrument classes of the bootstrap class loader that Byte Buddy might
require for instrumenting a class or to instrument any of Byte Buddy's classes. If such instrumentation is desired, it is important to
assert for each class that they are not loaded during instrumentation.
ignore in interface AgentBuilderignoredTypes - A matcher that identifies types that should not be instrumented.ignoredClassLoaders - A matcher that identifies a class loader that identifies classes that should not be instrumented.public AgentBuilder.Ignored ignore(ElementMatcher<? super TypeDescription> typeMatcher, ElementMatcher<? super ClassLoader> classLoaderMatcher, ElementMatcher<? super JavaModule> moduleMatcher)
AgentBuilder
Excludes any type that is matched by the provided matcher and is loaded by a class loader matching the second matcher.
By default, Byte Buddy does not instrument synthetic types, types within a net.bytebuddy.* package or types that
are loaded by the bootstrap class loader.
When ignoring a type, any subsequently chained matcher is applied after this matcher in the order of their registration. Also, if any matcher indicates that a type is to be ignored, none of the following chained matchers is executed.
Note: For performance reasons, it is recommended to always include a matcher that excludes as many namespaces as possible. Byte Buddy can determine a type's name without parsing its class file and can therefore discard such types with minimal overhead. When a different property of a type - such as for example its modifiers or its annotations is accessed - Byte Buddy parses the class file lazily in order to allow for such a matching. Therefore, any exclusion of a name should always be done as a first step and even if it does not influence the selection of what types are matched. Without changing this property, the class file of every type is being parsed!
Warning: If a type is loaded during the instrumentation of the same type, this causes the original call site that loads the type
to remain unbound, causing a LinkageError. It is therefore important to not instrument types that may be loaded during the application
of a AgentBuilder.Transformer. For this reason, it is not recommended to instrument classes of the bootstrap class loader that Byte Buddy might
require for instrumenting a class or to instrument any of Byte Buddy's classes. If such instrumentation is desired, it is important to
assert for each class that they are not loaded during instrumentation.
ignore in interface AgentBuildertypeMatcher - A matcher that identifies types that should not be instrumented.classLoaderMatcher - A matcher that identifies a class loader that identifies classes that should not be instrumented.moduleMatcher - A matcher that identifies a module that identifies classes that should not be instrumented. On a JVM
that does not support the Java modules system, this matcher is not applied.public AgentBuilder.Ignored ignore(AgentBuilder.RawMatcher rawMatcher)
AgentBuilder
Excludes any type that is matched by the raw matcher provided to this method. By default, Byte Buddy does not
instrument synthetic types, types within a net.bytebuddy.* package or types that are loaded by the bootstrap class loader.
When ignoring a type, any subsequently chained matcher is applied after this matcher in the order of their registration. Also, if any matcher indicates that a type is to be ignored, none of the following chained matchers is executed.
Note: For performance reasons, it is recommended to always include a matcher that excludes as many namespaces as possible. Byte Buddy can determine a type's name without parsing its class file and can therefore discard such types with minimal overhead. When a different property of a type - such as for example its modifiers or its annotations is accessed - Byte Buddy parses the class file lazily in order to allow for such a matching. Therefore, any exclusion of a name should always be done as a first step and even if it does not influence the selection of what types are matched. Without changing this property, the class file of every type is being parsed!
Warning: If a type is loaded during the instrumentation of the same type, this causes the original call site that loads the type
to remain unbound, causing a LinkageError. It is therefore important to not instrument types that may be loaded during the application
of a AgentBuilder.Transformer. For this reason, it is not recommended to instrument classes of the bootstrap class loader that Byte Buddy might
require for instrumenting a class or to instrument any of Byte Buddy's classes. If such instrumentation is desired, it is important to
assert for each class that they are not loaded during instrumentation.
ignore in interface AgentBuilderrawMatcher - A raw matcher that identifies types that should not be instrumented.public ClassFileTransformer makeRaw()
AgentBuilderClassFileTransformer that implements the configuration of this
agent builder. When using a raw class file transformer, the AgentBuilder.InstallationListener callbacks are
not invoked and the set AgentBuilder.RedefinitionStrategy is not applied onto currently loaded classes.makeRaw in interface AgentBuilderpublic ResettableClassFileTransformer installOn(Instrumentation instrumentation)
AgentBuilder
Creates and installs a ClassFileTransformer that implements the configuration of
this agent builder with a given Instrumentation. If retransformation is enabled,
the installation also causes all loaded types to be retransformed.
In order to assure the correct handling of the AgentBuilder.InstallationListener, an uninstallation should be applied
via the ResettableClassFileTransformer's reset methods.
installOn in interface AgentBuilderinstrumentation - The instrumentation on which this agent builder's configuration is to be installed.public ResettableClassFileTransformer installOnByteBuddyAgent()
AgentBuilderClassFileTransformer that implements the configuration of
this agent builder with the Byte Buddy-agent which must be installed prior to calling this method.installOnByteBuddyAgent in interface AgentBuilderAgentBuilder.installOn(Instrumentation)Copyright © 2014–2018. All rights reserved.