- Avoid dependency of
CachedReturnPlugin
on precompiled class files. - Add
NOP
instruction whenAdvice
is used onvoid
methods as those might be empty which results on a frame being written to the same offset, causing an exception. - Allow
Plugin.Enging
to link files instead of copying. - Adjust validator code to avoid compiler bug that was reported by multiple users.
- Allow injection of class path as
File[]
toPlugin
constructors. - Allow for configuring variants when using the Android Gradle plugin.
- Fix Java 8 patterns for multi-release jars to avoid that inner classes are excluded.
- Additional release after time out during previous Gradle plugin release.
- Extend
ClassInjector
API to support lazy resolution of class files. - Extend
DynamicType
API to support lazy resolution of auxiliary types. - Extend
AgentBuilder.Transformer.ForAdvice
to support injection of new classes by their name.
- Additional release after time out during previous Gradle plugin release.
- Add ConstructorResolver to Super annotation for MethodDelegation to allow for dynamic constructor resolution.
- Add Java 8 versions of shaded ASM to allow for faster class file validation and CDS support.
- Publish Byte Buddy and Byte Buddy agent artifacts as multi-release jars to support CDS and faster validation.
- Add non-experimental support for Java 24.
- Treat multi-release class files that are newer than the supported version as regular resources.
- Allow overriding the multi-release class file version from Maven and Gradle plugin.
- Correctly resolve multi-release class files in Android.
- Add support for multi-release JAR files in
ClassFileLocator
s andPlugin.Engine.Default
. - Add Gradle task for transforming multiple jar files with
ByteBuddyJarsTask
. - Avoid validation of
JarFile
when extracting individual entries. - Rework discovery in
ByteBuddyMojo
.
- Revert default
EntryPoint
for Android Gradle plugin to useDECORATE
unless explicitly specified due to many generic type errors in Kotlin classes.
- Introduce
AsmClassWriter
andAsmClassReader
abstractions that allow for plugging different implementations of readers and writers. - Add configuration extension to the Android Gradle plugin and make it behave like regular Gradle plugin with standard configuration.
- Throw
TypeNotPresentException
upon discovering undeclared type variables as it was recently fixed on the JVM.
- Add Maven Mojo for transforming jars and for transforming dependencies folder.
- Better error handling for unresolved type variables.
- Allow loading arguments of the instrumented method in
MemberSubstitution
. - Fix checks for method visibility.
- Avoid verification error if constructor advice meats dropped implicit this frame and throw exception during instrumentation instead.
- Add support to resolve
ByteBuddyAgent
from non-obfuscated name if obfuscation is used. - Make sure
CircularityLock
implementations never load classes during locking. - Offer use of istat if stat command is not available for emulated attachment.
- Avoid locking entire class loader when child-first class loader loads shadowed class and parallel class loading is supported.
- Avoid crashing of Android plugin when there are duplicate files for licenses or license notices.
- Update ASM and introduce support for Java 23.
- Allow attaching from root on J9.
- Adjust type validation to accept additional names that are legal in the class file format.
- Fix dynamic attach on Windows when a service user is active.
- Avoid failure when using Android's strict mode.
- Avoid resolving type variables when generic type processing is disabled.
- Improve error message for Byte Buddy agent external attach.
- Fix build for modular jars when using later version than Java 8.
- Pin proxy class file version to avoid implicit changes when using Graal native image.
- Add support for Java 23.
- Add missing
@MaybeNull
annotation.
- Adjusts Gradle plugin to support Gradle 8.4 without warnings.
- Avoid blurry exception on build plugin for fail fast.
- Add lazy facade to default
TypePool
inAgentBuilder
to avoid parsing of types ignored by name. - Avoid module info classes in Android plugin.
- Update ASM to version 9.6
- Support Android plugin to support APG version 7.4
- Correctly read versions from class file that would use both bytes.
- Fix Byte Buddy Gradle plugin for Gradle 8.3+.
- Correct field and static method access on subtypes in
MemberSubstitution
. - Support APK 7.4+ versions in Byte Buddy Gradle for Android plugin.
- Correctly read minor version from class file.
- Catch type resolution errors when applying
Plugin.Engine
.
- Add
PatchMode.SUBSTITUTE
andResettableClassFileTransformer.Substitutable
for in-order patching. - Allow for explicit specification og differential matcher when patching an
AgentBuilder
. - Add platform loader to locator for build plugins.
- Correctly resolve accessors for fields with capitalized first letter.
- Make jars for Android read-only as newer versions require it.
- Avoid use of location if agent argument separator is contained.
- Allow failure of member substitution if no element is separated.
- Allow retry in case of parallel class injection.
- Include instrumented type and auxiliary types in
TypePool
that is passed toTypeWriter
.
- Make
MethodGraph.Compiler
failsafe when processing incomplete methods. - Update ASM.
- Fix offset mapping for local variable array remapping in
Advice
. - Add possibility to specify an index for
skipOn
andrepeatOn
which resolves the checked value from a returned array.
- Add extended scope for Maven Byte Buddy plugin to include all non-test-dependencies.
- Add
Step.Factory.ForDelegation
inMemberSubstitution
that allows for delegation similar toMethodDelegation
but in-code. - Add handlers for
MethodDelegation
andAdvice
that leverage method handles for field access and self-invocation. - Add
Step.Factory
for type assignment that allows casting the return value from a previous step to another type. - Avoid usage of
URL
class loader as it is deprecated, and use newer method if available.
- Complete
MemberSubstitution
API which now retains the original instruction for invocation. - Allow excluding methods from a
MethodGraph.Compiler
using anElementMatcher
. - Add a filtering
ClassFileLocator
. - Add a matcher for a type's
ClassFileVersion
. - Unify resolution of constant values by introducing a
ConstantValue
API. - Do not exclude
ToThrown
assignment onvoid
methods. - Allow constructors as target in
MemberSubstitution
.
- Allow using
ClassFileLocator
toAgentBuilder
to append boot-injected types. - Add
RenamingPlugin
that allows for migration of names using the build plugin. - Add wrapper method to
ForAdvice
transformation to allow for easier wrapping. - Fix Gradle plugin raw folder and improve detection of unused configurations.
- Add additional default
Step
s toMemberSubstitution
to reduce need for custom bytecode generation.
- Support
MethodHandle
andMethodType
inAdvice.Origin
annotation. - Support
MethodHandles.Lookup
inOrigin
andAdvice.Origin
annotations. - Use modern API for Gradle Android API, if available, to avoid now failing cast.
- Create a Gradle source set for each JVM build automatically to reduce boilerplate.
- Fix Gradle plugin class loading to use correct class loader.
- Use updated release plugin to avoid outdated timestamp in jar.
- Avoid stack overflow error when type variable cannot be resolve during error message generation.
- Allow dumping error message to file when remote attach fails.
- Avoid possible lock through circular class loading of
TypeDescription
subtypes. - Avoid access error when using unsafe API on Java 17 with an active security manager.
- Close URL class loader used in Gradle plugin.
- Allow writing to field from enter
Advice
in constructor, as byte code allows it. - Refactor Android plugin processor to avoid skipping local classes.
- Improve staleness filter for Maven plugin.
- Fix incorrect resolution of custom bound invokedynamic values in
Advice
.
- Use decorating
EntryPoint
in Android Gradle plugin. - Introduce
PatchMode
onAgentBuilder
patching to allow for control over overlap.
- Fix Gradle release script to publish plugin.
- Introduce
ClassVisitorFactory
which allows to translate to and from class wrappers in a different ASM namespace. - Allow builders to change to
ClassVisitors
. - Add support for Android instrumentation from Gradle plugin.
- Add
wrap
method toDynamicType.Builder
that allows for the representation of a dynamic type via aClassVisitor
. - Add
ClassVisitorFactory
that allows to translate between Byte Buddy's, the original, or other shaded representations of ASM. - Fix visibility check for types in the default package.
- Return correct value for types in the default package.
- Avoid duplicate application of Byte Buddy Maven plugin.
- Allow for class path discovery of
Plugin
s when using Maven. - Fix build cache when using Byte Buddy Gradle plugin.
- Allow
Plugin
s to define new types prior to transformation.
- Use correct annotation in Byte Buddy Gradle plugin.
- Correctly resolve generified anonymous/local types that are declared within a method.
- Remove use of thread-local to guarantee Loom compatibility.
- Allow usage of byte-buddy-parent as BOM for imports.
- Add convenience for Maven to disable type validation on entry point.
- Allow Gradle plugin to consume pluginName property and discoverySet to only load plugins in the plugin class loader.
- Correctly resolve temporary folder, if custom folder is set, on Linux during emulated attach.
- Attempt guessing if Graal automatic configuration agent for native image is run.
- Avoid hard-coded dependencies to classes of java.management module.
- Do not include OSGi info in Byte Buddy source module.
- Add support for Java 19.
- Add basic support for Graal native image.
- Add option for strongly referenced cache keys.
- Reduce access requirements for fields from
Advice
.
- Make
Step
type inMemberSubstitution
public as intended. - Add factory that uses
ArrayDeque
instead ofLinkedList
if the used JVM supports it (Java 6+). - Fix resolution of internal names for arrays in
TypeReferenceAdjustment
.
- Adjust warm-up API to return warmed-up byte code.
- Check release property in Byte Buddy Maven plugin.
- Propagate exception from Byte Buddy's class file transformer to improve wrapping behavior.
- Avoid loading of
ElementType
when checking compatibility as the current VM might not provide all constants. - Allow for disabling stack adjustment as it might not always be possible.
- Make stack adjustment more robust when goto targets contain stack values.
- Mark argument for
equals
method as@MaybeNull
. - Mark argument for
ElementMatcher
as@UnknownNull
.
- Add alias annotations to avoid compilation warnings for optional findbugs dependency.
- Adjust
HashCodeEqualsPlugin
to allow for inclusion of custom annotation type on equals method parameter.
- Make paths in Gradle plugin relative and therewith cachable.
- Add explicit check for empty or non-existent source folder to Maven and Gradle plugins.
- Add support for modules when accessing system class loader for
Nexus
orInstaller
. - Add nullability annotations to all type members which are nullable and declare non-nullability the default.
- Move configuration for Java version to extension and avoid implicit configuration during task execution to allow for using a configuration cache.
- Make fail last the alternative to fail fast instead of not failing the build. Enable fail fast by default in the Gradle plugin.
- Use instrumented type in
MemberSubstitution
to include newly added properties in its description.
- Improve error message when class file version is not supported.
- Avoid duplication of fields to store auxiliary objects.
- Fix Gradle plugin to be skipped when input files are empty.
- Resolve dynamic bootstrap constant type correctly.
- Fix binary incompatibility in
BaseNameResolver
for suffixing naming strategy. - Introduce caller sensitive base name resolver for suffixing naming strategies and use it as default if Graal native image property is discovered.
- Introduce detection for Graal native image execution.
- Correctly resolve interface implementations in revers order when compiling method graph.
- Adjust lambda instrumentation strategy to support Java 17.
- Remove automatic frame padding mechanism in favor of explicit NOP instruction after injected blocks.
- Allow
Advice.PostProcessor
to emit frames. - Add possibility for
Advice.AssignReturned
to suppress exceptions. - Add frame when rebasing constructors to avoid breakage if frames are assumed prior to super constructor call.
- Add option for
AsScalar
annotation to assign default value instead of ignoring it. - Add transform-runtime goal to Byte Buddy Mojo to allow for running plugins with runtime class path included.
- Add
Advice.AssignReturned
post processor to allow for assigning values fromAdvice
that uses delegation rather than inlining. - Allow for declaring
Advice.Local
values from both enter and exit advice. - Add option for using runtime class path rather than only compile scope from Byte Buddy Maven plugin.
- Avoid loading of annotation proxies within Byte Buddy's internal API.
- Add plugin to add Java
Repeatable
annotations without requiring a JDK 8+.
- Avoid binary incompatibility due to signature change by reintroducing method overload.
- Use plugin to add annotations for dispatcher methods to avoid breakage when using obfuscators.
- Better error message upon attachment failure due to overridden attach socket.
- Retain label order for instructions in
Advice
to avoid incorrect offsets in stack map frames. - Change
MethodGraph.Compiler
API to accept generic types. - Add plugin to add
Proxied
annotations to all proxied methods of a dispatcher. This avoids problems in obfuscators. - Fix resolution of type initializer in a
Nexus
.
- Avoid naming conflicts when adding super and default method delegation for the same method using
MethodDelegation
. - Fix module visibility for
Invoker
to avoid breakage if Byte Buddy is shaded into another module with different package exports.
- Add net.bytebuddy prefix to Byte Buddy specific privileges.
- Rework
JavaDispatcher
to require specific privilege but use Byte Buddy's protection domain for dispatchers, once acquired.
- Adjust
InvocationHandlerAdapter
to usenull
for methods without parameters as specified by contract. - Offer option to use
null
forMethodDelegation
andAdvice
if method has no parameters. - Add method to seal unsealed class loaders after the fact.
- Use correct type for resolving security manager method in
ByteBuddyAgent
.
- Introduce
warmUp
to further avoid circularities when usingAgentBuilder
. - Fix ignore matcher of
AgentBuilder
to include jdk.internal.reflect package by default.
- Always use reflection and not a
JavaDispatcher
when a method potentially checks the access context via a security manager.
- Do not pollute access context for security manager when defining classes via a method handle lookup.
- Added option for Gradle plugin to register
adjustmentPostProcessor
to manually add task dependencies.
- Include jdk.reflect package in default ignore matcher.
- Retain parameter names for constructor of Java record as it is done by javac.
- Throw
NoSuchTypeException
on non-resolved types rather thenIllegalStateException
. - Weaken visibility checks for fields set by
MethodCall
.
- Fix package exposure for
JavaDispatcher
class when Byte Buddy is used as a module.
- Introduce a more complex error handler for Gradle builds in favor of strict mode.
- Include method for reading all loaded
Class
values of a loaded dynamic type. - Include Byte Buddy version in module-info.
- Fix package list in module-info.
- Add fallback for
JavaDispatcher
that works on Android and other platforms that do not support dynamic class definitions. - Make Gradle task dependency resolution more robust and configurable.
- Update ASM and support Java 18 without experimental configuration.
- Remove
AccessController
API to replace with weaved access control viaAccessControllerPlugin
.
- Add constant for Java 18
- Improve constructor resolution for
Plugin
s. - Add convenience method for translating
TypeDescription.Generic
to a builder. - Add convenience method for resolving an annotation property from a property name.
- Introduce
AccessControllerPlugin
to weave use ofAccessController
only if available. - Fix use of incorrect type when chaining
InvokeDynamic
. - Better emulate visitation order of ASM when creating types.
- Avoid writing duplicate entries for submitted subtypes in sealed types.
- Better encapsulate
JavaDispatcher
utility. - Add frame padding to initialization handler when redefining or rebasing a class.
- Do not assume that
TypeVariable
s areAnnotatedElement
s to support Java 7 and earlier.
- Fixes resolution of array types for Java descriptors of
JavaConstant
. - Properly process Android's version string and avoid relying on the version string where possible.
- Allow for self-calls when creating a
MethodCall
and identifying a method via a matcher.
- Add JNA based
ClassInjector
for use if JNA is already available. - Allow
HashCodeEqualsPlugin
to derive hash code from instrumented type rather then lowest type in hierarchy. - Retain this variable name for index 0 when using advice with remapped locals.
- Rework
AnnotationDescription
forTypePool
to mirror JVM behavior if annotation properties are changed inconsistently. - Add several
StackManipulation
s for common operations. - Remove unwanted dependency to
Instrumentation
API fromJavaModule
type. - Rework use of reflection to use
JavaDispatcher
API which also allows for custom generation of proxies without use of reflection. - Fully rework
JavaConstant
API to integrate with Java'sConstantDesc
API and to allow for production of such descriptions. - Fix different bugs to properly support representation sealed classes.
- Rework resubmission strategy to allow for immediate resubmission or on error.
- Fix type for constructor call when setting field in MethodCall.
- Include thread in default agent logger.
- Add compound property to InvocationHandlerAdapter.
- Flatten conjunction and disjunction matchers.
- Add method to get possibly known class file version of TypeDescription.
- Correctly consider generic array type when computing erasure.
- Refactor
JavaConstant
API and fix handle resolution. - Adjust bootstrap method validation to account for possible dynamic constants.
- Make class loaders parallel capable.
- Correct code for attaching to Windows VMs with 32 bit.
- Allow configuration for Gradle plugin to consider class path as incremental.
- Update ASM and add support for Java 17.
- Make plugin discoverability configurable.
- Add advice suppression handler for rethrowing.
- Reuse simple but commonly used matchers as constants to avoid repeated allocation.
- Allow build plugins to be discovered from a plugin's class path.
- Do not use cached version of classes that are currently transformed.
- Allow using an incremental class path for build plugins in Gradle.
- Fix filter applied to declared, non-virtual methods in
MethodCall
.
- Fix constructor type resolution in
MethodCall
. - Add support for incremental builds to Byte Buddy Maven plugin.
- Correctly handle empty, primitive arrays as annotation properties in
TypePool
. - Improve matching of rebaseale methods by using signature tokens rather then full tokens.
- Use get as prefix for getters of
Boolean
wrapper properties. - Consider types in
net.bytebuddy.renamed
package in Byte Buddy agent. - Set names for all cached variables.
- Do not fail validation for generic properties in Java 1.4 class files since they can be legally contained due to JSR14.
- Fixes descriptor used for method handle constant of field.
- Fixes assignability check for varargs.
- Allow using static interface methods for bootstraping.
- Allow providing null to setsValue for field assignment.
- Cleans up providing of constant arguments as type description, enum or constant.
- Support getPackage in legacy class loaders.
- Allow method call by matcher on private method of instrumented type.
- Adjust Gradle plugin to properly consider registration order with the Java plugin.
- Correct task adjustment when using Byte Buddy in a multimodule project.
- Update to ASM 9 for full support of sealed types.
- Rewrite of Gradle plugin, including support for incremental builds.
- Fix
MethodCall
bug when loading arguments from array. - Mark rebased methods
private final
as required by the JVM when using a native method preifx. - Fix stack excess monitoring when using advice to discover excess stack values correctly to avoid verifier error.
- Fix build config to include Eclipse e2e file.
- Allow for not printing a warning if no file is transformed in build plugin.
- Fix invokability check in
MethodCall
validation. - Avoid premature validation of
InstrumentType
's method modifiers. - Use type cache by default when using loaded type class pool since class lookup showed to be rather expensive.
- Add possibility to filter class loaders before attempting to load a class using the
AgentBuilder
's resubmission feature. - Add
nameOf
matcher for more efficient string matching based on a hash set.
- Experimental support for Java 16.
- Support all constant pool constant types in all APIs.
- Adjust methods for bootstrap arguments to allow types of constantdynamic constants.
- Correctly resolve handle type for method handles on private constructors.
- Fix stack size computation for minimal methods in
Advice
.
- Emit full frame after super or auxiliary constructor call in constructors if no full frame was already issued within this constructor.
- Support methods that start with a stack map frame before any code.
- Pop array after
@AllArguments
parameter. - Fix source inclusion for ASM commons.
- Avoid resolution of detached types when replacing target types in generic arrays on members of instrumented types.
- Fix validation of member substitution.
- Include post processor for
Advice
.
- Update ASM to 8.0.1
- Close Dex files in Android class loader.
- Add abstraction for advice dispatcher to allow for use of invokedynamic.
- Properly handle incompatible type changes in parsed annotations.
- Add support for Java records.
- Add validation for interface method modifiers.
- Correct discovery of MacOs temp directory for Byte Buddy Agent
VirtualMachine
. - Add parallel processor for Byte Buddy build engine.
- Add preprocessor for Byte Buddy build engine.
- Explicitly load Java's
Module
from boot loader to avoid loading pseudo compiler target bundled with NetBeans. - Add convenience method for creating lookup-based class loading strategy with fallback to Unsafe for Java 8 and older.
- Add caching for method, field and parameter description hashCode methods.
- Adjust use of types of the
java.instrument
module to avoid errors if the module is not present on a JVM.
- Correct discovery of old J9 VMs.
- Correct invocation of
AgentBuilder.Listener
during retransformation. - Allow forbidding self-attachment using own artifact.
- Add possibility to patch class file transformers.
- Fix equality check for float and double primitives.
- Add guards for annotation API to handle buggy reflection API with mandated parameters.
- Update ASM.
- Add experimental support for Java 15.
- Allow
AndroidClassLoadingStrategy
to work with newer API level.
- Fixes Gradle plugin release to include correct dependency.
- Fixes source jar release for shaded byte-buddy artifact.
- Throw exception upon illegal creation of entry-only advice with local parameters to avoid verify error.
- Remove escaping for execution path on Windows with spaces for Byte Buddy agent.
- Fix J9 detection for older IBM-released versions of J9 in Byte Buddy agent.
- Allow overriding the name of the native library for Windows attach emulation.
- Use correct type pool in build plugin engine for decorators.
- Fix attach emulation for OpenJ9 on MacOS.
- Upgrade ASM to version 7.2.
- Improve class file version detection for class files.
- Check argument length of Windows attach emulation.
- Extend
VirtualMachine
API emulation. - Reopen socket for POSIX-HotSpot connections after each command being sent to avoid broken pipe errors.
- Only use JNA API that is available in JNA versions 4 and 5 for better compatibility.
- Include correct license information in artifacts.
- Add injection API based on
jdk.internal.misc.Unsafe
to support agents on platforms that do not include jdk.unsupported. - Add
AgentBuilder.InjectionStrategy
to allow usage of internal injection API. - Open package in
AgentBuilder
if from and to edges are added.
- Add API for loading native agents from Byte Buddy agent.
- Extend
VirtualMachine
API to include other methods. - Fix error handling in
VirtualMachine
API. - Fix temporary folder resolution for
VirtualMachine
API. - Add API for
MemberAttributeExtension
. - Rework of
AnnotationDescription
API to emulate JVM error handling for incorrect or inconsistent values. - Add generic type-aware
Assigner
. - Fix method handle-based injector for Java 14.
- Add support for attach emulation on Solaris.
- Fix JNA signatures for attach emulation on POSIX.
- Add standard call conventions for Windows JNA calls.
- Add emulated attach mechanism for HotSpot on Windows and for OpenJ9/J9 on POSIX and Windows (if JNA is present).
- Reimplement POSIX attach mechanism for HotSpot to use JNA (if present).
- Add Java 14 compatibility.
- Refactor emulated attach mechanism and use JNA in order to prepare supporting other mechanisms in the future.
- Reinterrupt threads if interruption exceptions are catched in threads not owned by Byte Buddy.
- Refactor class file dumping.
- Publish Gradle plugin to Gradle plugin repository.
- Added matcher for super class hierarchy that ignores interfaces.
- Extend API for member substitution.
- Minor API extensions.
- Fixed stack map frame generation during constructor advice.
- Improves frame generation for cropping-capable frames.
- Remove field reference in injected class due to possibility of loading Byte Buddy on the boot loader.
- Updated to ASM 7.1.
- Fix unsafe injection on Java 12/13.
- Fixed
ByteArrayClassLoader
when used from boot class loader. - Fixed shading to include ASM class required during renaming.
- Properly interrupt resubmission process in agent builder.
- Fix visibility checks for nest mates.
- Extend
MethodCall
to allow for loading target fromStackManipulation
. - Allow for injection into
MultipleParentClassLoader
. - Performance improvement on array creation.
- Allow for custom strategy for visibility bridge creation.
- Retain native modifier when defining a method without method body.
- Allow appending class loader to multiple parent class loader with hierarchy check.
- Add support for Java 13.
- Extend experimental property to allow for detection of unknown versions.
- Add the JVM extension / platform class loaders to the default excludes for the
AgentBuilder
. - Refactor
MethodCall
to better reuse intermediates. This implies some API changes in the customization API. - Add hook to
AgentBuilder
to customize class file transformer.
- Fixed lookup injection for classes in the default package in Java 9.
- Add API for explicit field access from
FieldAccessor
. - Fix stack size adjustment for custom
MemberSubstitution
s. - Performance improvement for classes with many methods.
- Update to ASM 7.0 final
- Improve field setting capabilities of
FieldAccessor
andMethodCall
.
- Allow for delegation to method result for
MethodDelegation
. - Extend
MemberSubstitution
to allow for delegating to matched member. - Create multi-release jar for module-info carrying artifacts.
- Properly handle directory elements in plugin engine with in-memory or folder target.
- Minor API change of
Plugin.Engine.Source
to allow for closing resources that need to be opened. - Reinstantiate class injection on Java 12 with new Unsafe use.
- Allow for disabling use of Unsafe alltogether.
- Adjust Gradle build plugin to use closure for argument instantiation.
- Prepare method arguments on
MethodCall
.
- Update to ASM 7 for non-experimental Java 11 support.
- Reduce byte code level to Java 5.
- Add module-info.class for byte-buddy and byte-buddy-agent artifacts.
- Extend
ClassInjector
API to allow supplying string to byte array mappings. - Add visitor to allow adjustment of inner class attribute.
- Refactor agent builder API to use decoration by default and rather require explicit termination.
- Add
Plugin.Engine
to allow simple static enhancements and rework build plugins for Maven and Gradle to use it. - Refactor
AsmVisitorWrapper.ForDeclaredMethods
to only instrument methods on.method
but offer.invokable
for anthing.
- Add guard to
EnclosedMethod
property upon redefinition to avoid error with Groovy which often gets the propery wrong. - Add possibility to sort fields in plugin-generated equals method.
- Add class file locator for URL instances.
- Added caching for expensive methods of reflection API.
- Fix treatment of inner class attributes for redefinition and rebasement.
- Extend build plugin API to achieve better Java agent compatibility.
- Add convenience API for creating lambda expressions.
- Fix decoration to include non-virtual methods.
- Add build plugin for caching the return value of a method.
- Fix annotation handling in decorator strategy.
- Several minor bug fixes for
MethodCall
. - Fix shading for signature remapper.
- Add API for defining inner types and nest mate groups.
- Add decoration transformer for more efficient application of ASM visitors.
- Allow chaining of
MethodCall
s. - Prohibit illegal constructor invocation from
MethodCall
s.
- Fix class loader injection using
putBoolean
. - Do not set timeout for Unix attach simulation if value is
0
. - Avoid incorrect lookup of
getDefinedPackage
on Java 8 IBM VMs. - Fix type checks on constantdynamic support.
- Add support for dynamic class file constants for Java 11+.
- Suppress lazy resolution errors within
MemberSubstitution::relaxed
. - Generalize method matcher for
clone
method. - Add
toString
method toClassFileVersion
. - Reenable
ClassFileInjection.Default.INJECTION
in Java 11+ via fallback ontoUnsafe::putBoolean
.
- Add preliminary support for Java 12.
- Query explicitly added class loaders before the instrumented class's class loader in advice transformer for an agent builder.
- Add nullcheck for
Instrumentation::getAllLoadedClasses
. - Allow for access controller-based lookups for
Method
constants. - Use
getMethod
instead ofgetDeclaredMethod
for method lookup if possible.
- Update to ASM 6.2
- Reinstate support for latest Java 11 EA if
net.bytebuddy.experimental
is set. - Fix edge completion for
AgentBuilder
. - Dump input class file if the
net.bytebuddy.dump
is set. - Add convenience chaining methods to
Implementation.Compound
. - Fix nestmate changes in method invocation.
- Fix misrepresentation of default package as
null
. - Add
Advice.Exit
annotation and allow for method repetition based on exit advice value. - Add
Advice.Local
annotation to allow for stack allocation of additional variables. - Improve advice's method size handler.
- Avoid shading unused ASM classes with incomplete links what breaks lint on Android and JPMS module generation.
- Extended support for self-attachment by using current jar file for Java 9+.
- Minor performance improvements.
- Several performance improvements.
- Adjust
toString
implementation for parameterized types to the changed OpenJDK 8+ behavior. - Attempt self-attachment using the current jar file.
- Use cache for loaded
TypeDescription
to avoid overallocation. - Generalize exception handler API for
Advice
.
- Added
ClassWriterStrategy
that allows controlling how the constant pool is copied.
- Introduced concept of sealing the
InjectionClassLoader
to avoid abuse. - Avoid class loader leak by not storing exceptions thrown in class initializers which can keep references to their first loading class in their backtrace.
- Add
ClassFileBufferStrategy
to agent builder. - Retain deprecation modifier on intercepted methods and fields on class files prior to Java 5.
- Release with
equals
andhashCode
methods being generated based on the fixes in the previous version.
- Only open ASM if this is specified via the boolean property
net.bytebuddy.experimental
. - Fix resolution of invoking methods of
Object
on interfaces to not specialize on the interface type. The latter is also failing verification on Android. - Several performance improvements.
- Do no longer use unsafe injection as a default class loading strategy.
- Allow Java 11 classes by opening ASM.
- Remove Lombok and add methods using Byte Buddy plugin.
- Reduce log output for Gradle and Maven plugin.
- Fix class check in
EqualsMethod
.
- Add implementations for
HashCodeMethod
,EqualsMethod
andToStringMethod
including build tool plugins. - Refactor handling of stack map frame translation within
Advice
to allow for handling of methods with inconsistent stack map frames if the method arguments are copied. - Make argument copying the default choice if exit advice is enabled.
- Fix a bug in parameter annotation computation within
Advice
. - Update to ASM 6.1.1.
- Refactored
Advice
argument handling to be controlled by a dedicated structure. - Added basic logic for argument copying in
Advice
. - Fix performance degradation for cached fields.
- Add support for Java 10 and preliminary support for Java 11.
- Fix Maven and Gradle plugins to resolve correct class file version.
- Add method to
ClassReloadingStrategy
to allow specification of explicit redefinition strategy. Change default redefinition strategy. - Improve stack map frame validation in
Advice
. - Fix type resolution for virtual calls in
MemberSubstitution
.
- Fixes self-attachment on Java 9+ on Windows.
- Check for non-accessibility on
MethodCall
. - Change static proxy fields to be
volatile
. - Do not copy security-related meta-data on jar file copying.
- Guard resolution of annotations for methods with synthetic parameters.
- Forbid skipping code in constructors for
Advice
. - Added constructor strategy for defining a default constructor that invokes a non-default constructor.
- Improve performance of accessor methods and cache fields by reducing use of
String::format
.
- Fixes
RAW_TYPES
mode for loaded types where properties were resolved incorrectly. - Adds support for Java 10 version number.
- Added property
net.bytebuddy.raw
to allow for suppress generic type navigation.
- Make self-attachment more robust on Windows.
- Add M2E instructions for Maven plugin.
- Improve hash function for members and avoid collision field names.
- Convenience for custom target binders.
- Update ASM to version 6 final.
- Accept
null
in custom boundAdvice
. - Fix fail fast in build plugins.
- Permit repeated exception in method signature.
- Prevents premature termination of reattempting retransformation.
- Add convenience methods for defining bean properties.
- Minor fixes to support Java 9 and allow building on JDK9.
- Allow configuring
TypePool
to use withinAdvice
.
- Fixes possibility to customize binding in
MethodDelegation
. - Update to ASM 6 beta to support Java 9 fully.
- Added
DiscoveryStrategy
for redefinition to determine types to be redefined. - Changed Maven plugin to only warn of missing output directory which might be missing.
- Added global circularity lock.
- Removed sporadic use of Java util logging API.
- Define names for automatic modules in Java 9.
- Introduce property
net.bytebuddy.nexus.disabled
to allow disablingNexus
mechanism. - Do not use context
ProtectionDomain
when usingNexus
class. - Normalize
Advice
class custom bindings via opening internally usedOffsetMapping
API. RemoveCustomValue
binding which is less powerful. - Do not group
transient
withvolatile
modifier. - Introduce
MemberRemoval
component for removing fields and/or methods. - Introduce first version for
MemberSubstituion
class for replacing field/method access.
- Extended
AgentBuilder
listener API. - Added trivial
RawMatcher
. - Check modules for modifiability.
- Adapt new Java 9 namespaces for modules.
- Start external process for self-attachment if self-attachment is not allowed.
- Explicit consistency check for stack map frame information in
Advice
. - Extended
InstallationListener
API. - Fixed stack size information on variable storage.
- Add
InstallationListener
in favor ofInstallationStrategy
and allow resubmission strategy to hook into it in order to cancel submitted jobs.
- Fix modifier adjustment for visibility bridges (did not work last time)
- Added class injector for Java 9 handle class definition.
- Allow installation of
ClassFileTransformer
in byte array class loader. - Adjust visibility for bridge methods.
- Properly add visibility bridges for default methods.
- Added matcher for unresolvable types.
- Improved
ByteBuddyAgent
API. - Fixed Gradle and Maven plugin path resolution.
- Avoid logging on empty resubmission.
- Retain actual modifiers on frozen instrumented type.
- Refactored
Resubmitter
to a DSL-step within the redefinition configuration. - Added additional element matchers.
- Fixed computation of modifiers for rebased method in native state.
- Improved lazy resolution of super types in matchers.
- Added frozen instrumented type and factory for such types when no class file format changes are desired.
- Improved lazy resolution for generic type signatures.
- Refactored super type visitors to always be lazy until generic properties are required to be resolved.
- Apply proper raw type resolution. Made default method graph compiler reify generic types to compute correct bridges.
- Improved
Resubmitter
configuration. - Added
AgentBuilder.Transformation.ForAdvice
to allow for simple creation ofAdvice
classes from Java agents.
- Removed obsolete
toString
representations. - Start using Lombok for equals/hashCode unless explicit.
- Add security manager check to Byte Buddy agent.
- Added asynchronous super type loading strategies.
- Added resubmitter.
- Added class injection strategy for Android.
- Fixed type initializer instrumentation for redefinitions.
- Added
loaded
property for listener on agent builder.
- Added check to
@Pipe
for method invokability. - Added unsafe
ClassInjector
and class loading strategy. - Improved reflection-based class injector on Java 9.
- Removed unnecessary class file location using modules on Java 9.
- Improved fail-safety for type variable resolution to allow processing incorrectly declared type variables.
- Added
InjectingClassLoader
with class loading strategy that allows for reflection-free loading. - Added proper class loader locking to injection strategy.
- Fixed method lookup to not use declared accessors unless necessary to avoid security manager check.
- Added
@SuperMethod
and@DefaultMethod
annotations forMethodDelegation
. - Refactored
AsmVisitorWrapper
to accept a list of fields and methods that are intercepted. This allows to use the wrapper also for methods that are overridden. - Added a
MethodGraph.Compiler.ForDeclaredMethods
to avoid processing full type hierarchy if only type enhancement should be done without declaring new methods on a type. This should be used in combination withAdvice
instead ofMethodGraph.Empty
as those methods are supplied to the ASM visitor wrappers. - Refactored
MethodDelegation
to precompile records for all candidates to avoid duplicate annotation processing.
- Updates to ASM 5.2
- Updates Android DX-maker.
- Adds API to
MultipleParentClassLoader
to use other loader than bootstrap loader as a parent which is not always legal, e.g. on Android. - Make
ClassInjector
use official class loading lock if one is available. - Make
ClassInjector
usegetDefinedPackage
instead ofgetPackage
if available. - Declare UNIX socket library as provided in Byte Buddy agent to only add the dependency on demand.
- Refactored rebasing of type initializers. Do no longer rebase into static method to pass validation for final static field assignment on Java 9.
- Added fallback to
sun.misc.Unsafe
for class definition if reflective access to the protectedClassLoader
methods is not available which are required for the injection strategy. - Added super-type-loading
DescriptorStrategy
for agent builder. - Added assignment checks for
MethodCall
for invocation target.
- Resolved compound components to linearize nested collections for vastly improved performance with large structures.
- Added
TypeCache
. - Added fallback to assign
null
toSuperCall
andDefaultCall
if assignment is impossible. - Deprecated
Forwarding
in favor ofMethodCall
. - Fixed matcher for interfaces in type builder DSL.
- Fixed resolution of field type in
MethodCall
.
- Added possibility for readding types after a failed retransformation batch.
- Added partitioning batch allocator.
- Allow specifying
TargetType
inAdvice.FieldValue
. - Allow array value explosion in
MethodCall
. - Extended
FieldAccessor
to allow readingFieldDescription
s directly. - Fixed class name resolution in Maven and Gradle plugins.
- Added implementation for attachment on Linux and HotSpot using a non-JDK VM.
- Fixed argument resolution for
ByteBuddyAgent
. - Fixed field resolution for
MethodCall
to allow custom definition of fields. - Fixed visibility checks.
- Do not override default method for proxies for
Pipe
.
- Fixed type discovery for custom advice annotation bindings.
- Added possibility to configure suppression handler in
Advice
classes.
- Refactored
Advice
to use stack manipulations andAssigner
. - Refactored
Advice
to useReturn
instead ofBoxedReturn
and addedAllArguments
instead ofBoxedArguments
in conjunction with allowing to use dynamic typing for assignments via the annotation. - Added fixed value instrumentation for method parameters.
- Added weak class loader referencing for
Nexus
and allow registration of aReferenceQueue
.
- Extended
MethodCall
API. - Added additional element matchers.
- Extended
AsmVisitorWrapper
API.
- Refactored
Advice
to allow usage as a wrapper for anImplementation
. This allows chaining of such advices. - Allow to dynamically locate a
FieldDescription
orParameterDescription
from a customAdvice
annotation which binds the field or parameter value. - Added
invokeSelf
option toMethodCall
instrumentation.
- Refactored
FieldAccessor
to allow more flexible creation of getters and setters of particular parameters. - Create string-based hashes for random fields that depend on a value's hash value.
- Fixed stack size computation when using
@Advice.Origin
.
- Refactor
Instrumentation
s to only delegate to fields instead of requiring their definition. ThedefineField
API should be generally preferred for defining fields as it is much richer and therefore easier to extend. - Made type annotation reader more robust towards older versions of Java 8.
- Refactored lazy type resolution for generic types to no longer eagerly load generic types when navigating through a type hierarchy.
- Unified several implementation APIs and added better abstractions.
- Fixed some missing bits of validation of implementations.
- Do not replicate incompatible bridge methods.
- Use
IMITATE_SUPER_CLASS_OPENING
as a default constructor strategy. - Extract method visibility during method graph compilation.
- Apply a type variable's erasure if a type variable is out of scope instead of throwing an exception. This can happen when subclassing an inner type outside of its outer type or when a compiler such as scalac adds inconsistent generic type information.
- Optimize the application of the ignore matcher within an agent builder to only be applied once.
- Added
ConstructorStrategy
for inheriting constructors but make thempublic
. - Do not instrument anonymously loaded types during redefinition unless the lambda strategy is enabled.
- Reuse
CircularityLock
on allAgentBuilder
s by default to avoid that Byte Buddy agents introduce circularities to different agents. - Also allow using
Advice
asImplementation
. - Added
FixedValue.self()
and addedFieldPersistence
for describingvolatile
fields.
- Also acquire circularity lock during class file retransformation.
- Added slicing
BatchAllocator
.
- Explicitly check for recursive transformation of types used during a transformation causing a
ClassCircularityError
from anAgentBuilder
by adding thread-local locking.
- Additional refactoring of the
AgentBuilder
to fix a regression of 1.4.27. - Unified the error listener and the regular listener that were added in the previous version.
- Refactored
AgentBuilder
retransformation mechanism to allow for custom recovery and batch strategies. - Fixed Gradle plugin build which did not contain files.
- Supply no argument to agent attachment by default instead of empty string argument.
Note: Currently, it seems like the new retransformation mechanism introduces a racing condition in class loading resulting in some classes not being instrumented
- Refactored
skipOn
property ofAdvice
component. - Allow reading a
Method
/Constructor
property fromAdvice
. - Fixed bug that duplicated added parameter annotations on a
DynamicType
builder.
- Added overloaded versions for
byte-buddy-agent
to allow agent attachment with explicit argument. - Made
Advice
more flexible to allow skipping of instrumented method for complex advice method return types.
- Make
AgentBuilder
produceResettableClassFileTransformer
s which can undo their transformation.
- Made
TypeDescription.ForLoadedType
serializable for better alignment with reflection API. - Adapted changes in
Instrumentation
API for Java 9. - Refactored
AnnotationValue
to apply Java 9 specific string rendering on Java 9 VMs. - Adapted new
toString
representation of parameterized types on Java 9 VMs.
- Added Byte Buddy plugin for Gradle.
- Improved Byte Buddy plugin for Maven.
- Fixed modifier resolution for anonymous classes to preserve a shadowed
final
modifier. - Added Byte Buddy plugin for Maven.
- Fixed stack size adjustment for accessing double-sized primitive access array elements.
- Fixed
Advice
adjustment of local variable index for debugging information (improves Java agent compatibility). - Renamed
TypeLocator
toPoolStrategy
to avoid confusion with the names. - Removed
DescriptionStrategy
s that rely on fallback-description as those do not properly fallback for meta data. - Added
FallbackStrategy
as a replacement which allows to reattempt a transformation without using loaded type information.
- Added
@StubValue
and@Unused
annotations toAdvice
component. - Added possibility to retain line number information for entry
Advice
- Removed class loader dependency when querying loaded annotation values.
- Made annotation values more type-safe.
- Added automatic support for Java 9 class file location for boot modules.
- Improved
FieldProxy.Binder
to allow for a single accessor interface. - Fixed counting problem in
Advice
component.
- Fixed annotation resolution for Java 9 to exclude the
jdk.internal
namespace by default. - Do not copy annotations for default constructor strategies but allow configuring annotation strategy.
- Added file-system class file locators for modules in Java 9.
- Added convenience methods to default location strategies.
- Exclude
sun.reflect
namespace by default fromAgentBuilder
to avoid error messages. - Fixed resolution of type variables for transformed methods and fields.
- Fixed stack-aware method visitor when encountering exchanging duplication instructions.
- Added
POOL_LAST_DEFERRED
andPOOL_LAST_FALLBACK
description strategy. - Fixed resolution of bridge methods for diamond inheritance.
- Refactored modifier API to only expose named modifier checks for an element that apply to it.
- Fixed resolution for type variables for transformed methods.
- Fixed frame generation for
void
methods without regular return inAdvice
. - Fixed
TypeValidation
for Java 8 interfaces not allowing private methods. - Simplified and documented
AccessController
usage.
- Fixed bug with handling of legacy byte code instructions in
Advice
component. - Cleaned up and refactored usage of
AccessController
. Added privileged handling toAgentBuilder
. - Added proper buffering to non-buffered interaction with file streams.
- Make
ByteBuddy
creation more robust by adding a default fallback for unknown VMs. - Improved support for Java 9.
- Lazily compute
Implementation.Target
andImplementation.Context
in case of a type inlining to provide correct feature set. Added validation if this constraint is broken. - Make
TypePool
using an eagerTypeDescription
more robust towards errors.
- Monitor advice code for inconsistent stack heights at return statements to clean the stack during instrumentation to not trigger verifier errors if such atypical but legal code is encountered.
- Do not generate handlers for return values if an instrumented method or an advice method only throws exceptions but never returns regularly.
- Added tracer for the state of the operand stack for the
Advice
component to clear the stack upon a return. Without this, if code would return without leaving the stack empty, a verifier error would be thrown. This typically is only a problem when processing code that was produced by other code generation libraries.
- Fixed resolution of modifiers and local type properties from a default type pool.
- Improved key for caching
TypeLocator
to share a key for the system and bootstrap class loader.
- Added additional implementations of a
DescriptionStrategy
forPOOL_LAST
andPOOL_FIRST
resolution.
- Allow to skip execution of instrumented method from
Advice
via entry advice indicated by return value. - Added API to transform predefined type variables on a dynamic type.
- Refactored
Transformer
API to be shared for methods, fields and type variables. - Allow to spread
Advice
methods over multiple classes. - Added convenience methods to
AsmVisitorWrapper
s for declared fields and methods. - Performance improvements in
Advice
class for byte code parsing.
- Added default
TypePool
that allows for lazy resolution of referenced types. This can both be a performance improvement and allows working with optional types as long as they are not directly required within a transformation. This type pool is now used by default. - Make interfaces public by default when creating them via
ByteBuddy::makeInterface
. - Added
TypeResolutionStrategy
to allow for active resolution via theNexus
also from outside theAgentBuilder
. - Make best effort from a
ClassLoadingStrategy
to not resolve types during loading. - Added convenience method for loading a dynamic type with an implicit
ClassLoadingStrategy
.
- Added a
ClassFileLocator
for a class loader that only references it weakly. - Allow to supply
TypePool
andClassFileLocator
separately within anAgentBuilder
. - Made
MethodPool
sensitive to bridge methods which should only be added to classes of a version older than Java 4. - Fixed creation of Java 9 aware
ClassFileTransformer
to only apply on Java 9 VMs. - Added matcher for the type of a class loader.
- Fixed name resolution of anonymously-loaded types.
- Added
InstallationStrategy
toAgentBuilder
that allows customization of error handling. - Added chunked redefinition and retransformation strategies.
- Added
net.bytebuddy
qualifier when logging. - Added
net.bytebuddy.dump
system property for specifying a location for writing all created class files.
- Fixed bug in
MultipleParentClassLoader
where class loaders were no longer filtered properly. - Added support for major.minor version 53 (Java 9).
- Made
DescriptionStrategy
customizable.
- Changed storage order of return values in
Advice
methods to avoid polluting the local variable array when dealing with nested exception handlers. - Added caching
ElementMatcher
as a wrapping matcher. - Exclude Byte Buddy types by default from an
AgentBuilder
. - Added
DescriptionStrategy
that allows not using reflection in case that a class references non-available classes.
- Fixed validation by
MethodCall
instrumentation for number of arguments provided to a method. - Added further support for module system.
- Allow automatic adding of read-edges to specified classes/modules when instrumenting module classes.
- Implicitly skip methods without byte code from advice component.
- Added initial support for Jigsaw modules.
- Adjusted agent builder API to expose modules of instrumented classes.
- Added additional matchers.
- Simplified
BinaryLocator
and changed its name toTypeLocator
.
- Fixed
MultipleParentClassLoader
to support usage as being a parent itself. - Fixed default ignore matcher for
AgentBuilder
to ignore synthetic types.
- Added convenience method to
MethodCall
to add all arguments of the instrumented method. - Added
optional
attribute toAdvice.This
.
- The Owner type of a parameterized type created by a
TypePool
is no longer parameterized for a static inner type. - The receiver type of a executingTransformer is no longer considered parameterized for a static inner type.
- Removed overvalidation of default values for non-static fields.
- Better support for Java 1 to Java 4 by automatically resolving type references from a type pool to
forName
lookups. - Better support for dealing with package-private types by doing the same for invisible types.
- Simplified
MethodHandle
andMethodType
handling asJavaInstance
.
- Extended the
AgentBuilder
to allow for transformations that apply fall-through semantics, i.e. work as a decorator. - Added map-based
BinaryLocator
.
- Only add frames in
Advice
components if class file version is above 1.5. - Allow to specify exception type for exit advice to be named. This implies a default change where exit advice is no longer invoked by default when an exception is thrown from the instrumented method.
- Added possibility to assign a value to a
@BoxedReturn
value to change the returned value.
- Extended the
Advice
component storing serializable values that cannot be represented in the constant pool as encodings in the constant pool. - Added support for non-inlined
Advice
method. - Mask modifiers of ASM to not longer leak internal flags beyond the second byte.
- Added support for suppressing an exception of the instrumented method from within exit advice.
- Fixed error during computation of frames for the
Advice
computation. - Avoid reusing labels during the computations of exception tables of the
Advice
component.
- Byte Buddy
Advice
now appends handlers to an existing exception handler instead of prepending them. Before, existing exception handlers were shadowed when applying suppression or exit advice on an exception. - Added additional annotations for
Advice
such as@Advice.BoxedReturn
and@Advice.BoxedArguments
for more generic advice. Added possibility to write to fields from advice. - Added mechanism for adding custom annotations to
Advice
that map compile-time constants. - Implemented a canonical binder for adding custom compile-time constants to a
MethodDelegation
mapping.
- Fixed another bug during frame translation of the
Advice
component when suppression were not catched for an exit advice. - Improved unit tests to automatically build Byte Buddy with Java 7 and Java 8 byte code targets in integration.
- Optimized method size for
Advice
when exception is not catched. - Improved convenience method
disableClassFormatChanges
forAgentBuilder
.
- Fixed frame computation for the
Advice
. - Optimized frame computation to emit frames of the minimal, possible size when using
Advice
. - Only add exit
Advice
once to reduce amount of added bytes to avoid size explosion when a method supplied several exits. - Optimized
Advice
injection to only add advice infrastructure if entry/exit advice is supplied. - Optimized exception handling infrastructure for exit
Advice
to only be applied when exceptions are catched. - Added mapping for the IINC instruction which was missing from before.
- Added possibility to propagate AMS reader and writer flags for
AsmVisitorWrapper
. - Made
Advice
method parser respect ASM reader flags for expanding frames.
- Fixed bug when returning from an
Advice
exit method without return value and accessing@Advice.Thrown
. - Added additional annotations for advice
@Advice.Ignored
and@Advice.Origin
. - Implemented frame translator for
Advice
method to reuse existing frame information instead of recomputing it.
- Implemented universal
FieldLocator
. - Extended
AgentBuilder
API to allow for more flexible matching and ignoring types.
- Added
Advice.FieldValue
annotation for reading fields from advice.
- Added support for new Java 9 version scheme.
- Added hierarchical notation to default
TypePool
.
- Added possibility to suppress
Throwable
from advice methods when using theAdvice
instrumentation.
- Added possibility to use contravariant parameters within the
Advice
adapter for ASM.
- Added
Advice
adapter for ASM. - Fixed
AsmVisitorWrapper
registration to be stacked instead of replacing a previous value. - Added validation for setting field default values what can only be done for
static
fields. Clarified javadoc. - Fixed attach functionality to work properly on IBM's J9.
- Fixed return type resolution for overloaded bridge method.
- Fixed redefinition strategy for
AgentBuilder
where transformations were applied twice. - Added
ClassLoader
as a third argument for theAgentBuilder.Transformer
.
- Added validation for receiver types.
- Set receiver types to be implicit when extracting constructors of a super type.
- Added support for receiver type retention during type redefinition and rebasement.
- Added support for receiver type definitions.
- Fixed interface assertion of the custom binder types to accept default methods.
- Improved documentation.
- Refactored
AgentBuilder
API to be more streamlined with the general API and improved documentation. - Added possibility to instrument classes that implement lambda expressions.
- Added possibility to explicitly ignore types from an
AgentBuilder
. By default, synthetic types are ignored. - Proper treatment of deprecation which is now written into the class file as part of the resolved modifier and filtered on reading.
- Added support for Java 9 APIs for process id retrieval.
- Added support for Java 9 owner type annotations.
- Fixed bug in type builder validation that prohibited annotations on owner types for non-generic types.
- Added additional element matchers for matching an index parameter type.
- Fixed resolution of type paths for inner classes.
- Added preliminary support for receiver types.
- Fixed resolution of type variables from a static context.
- Refactored type variable bindings for generic super types: Always retain variables that are defined by methods.
- Retain type annotations that are defined on a
TargetType
.
- Added support for type annotations.
- Refactored public API to support type annotations and parameter meta information.
- Several renamings in preparation of the 1.0.0 release.
- Refactored type representation to represent raw types as
TypeDescription
s. This allows for resolution of variables on these types as erasures rather than their unresolved form. Refactored naming of generic types to the common naming scheme with nested classes. - Replaced generalized token representation to define tokens, type tokens and signature tokens.
- General API improvements and minor bug fixes.
- Implemented all type lists of class file-rooted files to fallback to type erasures in case that the length of generic types and raw types does not match. This makes Byte Buddy more robust when dealing with illegally defined class files.
- Fixed rule on a default method's invokeability.
- Extended
MethodCall
implementation to include shortcuts for executingRunnable
andCallable
instances. - Added
failSafe
matcher that returnsfalse
for types that throw exceptions during navigation.
- Fixed type resolution for anonymously loaded classes by the
ClassReloadingStrategy
. - Added additional
InitiailizationStrategy
s for self-injection where the new default strategy loads types that are independent of the instrumented type before completing the instrumentation. This way, the resolution does not fail for types that are accessed via reflection before initializing the types if a executingTransformer is rebased.
- Fixed resolution of
@Origin
for constructors and added possibility to use theExecutable
type. - Fixed name resolution of types loaded by anonymous class loading.
- Allowed alternative lookup for redefinitions to support types loaded by anonymous class loading.
- Fixed generic type resolution optimization for proxies for
@Super
.
- Added
TypePool
that returns precomputedTypeDescription
s for given types. - Fixed agent and nexus attachment and the corresponding value access.
- Added visibility substitution for
@Super
when the instrumented type is instrumented to see changed state on a redefinition. - Added patch for modifier information of inner classes on a redefinition.
- Added fallback for
Nexus
injection to attempt lookup of already loaded class if resource cannot be located.
- Added
TypePool
that falls back to class loading if a class cannot be located. - Added binary locator for agent builder that uses the above class pool and only parses the class file of the instrumented type.
- Added methods for reading inner classes of a
TypeDescription
. - Fixed random naming based on random numbers to avoid signed numbers.
- Moved
Nexus
andInstaller
types to a package-level to avoid illegal outer and inner class references which could be resolved eagerly. - Added validation for illegal constant pool entries.
- Added a
Premature
initialization strategy for optimistically loading auxiliary types. - Added a
ClassVisitorWrapper
for translating Java class files prior to Java 5 to use explicit class loading rather than class pool constants.
- Fixed injection order for types to avoid premature loading by dependent auxiliary types.
- Added additional
ClassFileLocator
s and refactored class file lookup to always use these locators.
- Refactored injection strategy to always inject and load the instrumented type first to avoid premature loading by reference from auxiliary types.
- Refactored
AgentBuilder.Default
to delay auxiliary type injection until load time to avoid premature loading by reference from auxiliary types. - Added API to add additional code to type initializers while building a type.
- Refactored agent
Nexus
to allow for multiple registrations of self initializers if multiple agents are registered via Byte Buddy. - Fixed resolution of interface methods that were represented in the type hierarchy multiple times.
- Implemented custom ASM class writer to allow for frame computation via Byte Buddy's type pool when this is required by a user.
- Fallback to no allowing for instrumenting type initializers for rebased or redefined interfaces before Java 8.
- Refactored
AgentBuilder.Default
to delegate exceptions during redefinitions to listener instead of throwing them. - Fixed bug where instrumented type would count to auxiliary types and trigger injection strategy.
- Fixed bug where interface types would resolve to a non-generic type signature.
- Added strategy to use redefinition or retransformation of the
Instrumentation
API when building agents. - Added lazy facade to be used by agent builder to improve performance for name-based matchers.
- Fixed parser to suppress exceptions from generic signatures which are not supposed to be included in the class file if no array type is generic.
- Fixed class validator which did not allow
<clinit>
blocks in interface types. - Added restriction to retransformation to not attempt a retransformation at all if no class should be retransformed.
- Added a factory for creating an
Implementation.Context
that is configurable. This way, it is possible to avoid a rebase of a type initializer which is not always possible. - Added a possibility to specify for an
AgentBuilder
how it should redefine or rebase a class that is intercepted.
- Fixed naming strategy for fields that cache values which chose duplicate names.
- Fixed resolution of raw types within the type hierarchy which were represented as non-generic
TypeDescription
instances where type variables of members were not resolved. - Added possibility to specify hints for
ClassReader
andClassWriter
instances. - Fixed resolution for modifiers of members that are defined by Byte Buddy. Previously, Byte Buddy would sometimes attempt to define private synthetic methods on generated interfaces.
- Fixed assignability resolution for arrays.
- Fixed class file parser which would not recognize outer classes for version 1.3 byte code.
- Read
Nexus
instances of the Byte Buddy agents from the enclosing class loader rather than from the system class loader. This allows for their usage from OSGi environments and for user with other custom class loaders. - Changed modifiers for accessor methods and rebased methods to be public when rebasing or accessing methods of a Java 8 interface. For interfaces, all modifiers must be public, even for such synthetic members.
- Support absolute path names for accessing class file resources of the
ByteArrayClassLoader
. - Added random suffix to the names of rebased methods to avoid naming conflicts.
- Refactored runtime attachment of Java agents to support Java 9 and additional legacy VM (version 8-).
- Refactored
MethodGraph
to only represent virtual methods. - Changed notion of visibility to not longer consider the declaring type as part of the visibility.
- Increased flexibility of defining proxy types for
@Super
and@Default
annotations. - Added directional
AmbigouityResolver
. - Fixed detection of methods that can be rebased to not include methods that did not previously exist.
- Added support for generic types.
- Replaced
MethodLookupEngine
withMethodGraph.Compiler
to provide a richer data structure. - Added support for bridge methods (type and visibility bridges).
- Refactored the predefined
ElementMatcher
s to allow for matching generic types. - Replaced the
ModifierResolver
with a more generalMethodTransformer
.
- Added support for discovery and handling of Java 9 VMs.
- Fixed class loading for Android 5 (Lollipop) API.
- Fixed resolution of ignored methods. Previously, additional ignored methods were not appended but added as an additional criteria for ignoring a method.
- Fixed resolution of field accessors to not attempt reading of non-static fields from static methods.
- Fixed renaming strategy for type redefinitions to work around a constraint of ASM where stack map frames required to be expanded even though this was not strictly necessary.
- Added API for altering a method's modifiers when intercepting it.
- Added API for allowing to filter default values when writing annotations.
- Added additional
ClassFileLocator
s for locating jar files in folders and jar files. - Added explicit check for invalid access of instance fields from static methods in field accessing interceptors.
- Added the
@StubValue
and@FieldValue
annotations.
- Corrected the resolution of a type's visibility to another type to determine if a method can be legally overridden.
- Previous version 0.6.9 contained another bug when attempting to fix this problem.
Corrected incorrect deployment of version 0.6.7 which does not use a dependency reduced POM for the byte-buddy module.
- Upgraded ASM dependency to 5.0.4.
- Fixed OSGi headers in all relevant artifacts.
Warning: The byte-buddy artifact of version 0.6.7 is accidentally deployed with a defect POM file which does not exclude the shaded resources.
- Fixed error in resolution of the
TargetType
pseudo-variable when used as component type of an array.
- Extended public API with convenience methods.
- Extended public API to accept more general argument types when appropriate.
- Extended
@Origin
annotation to allow for accepting modifiers.
- Made the
TypeDescription.ForLoadedType
class loader agnostic. Before, a class that was loaded by multiple class loaders would have been considered inequal what is not true for the byte code level.
- Added additional class validation such that it becomes impossible to define members on classes that do not fit the class's structure, i.e. default methods on Java interfaces in version seven.
- Added default
Assigner
singleton.
- Added
AnnotationDescription.Builder
to allow easy definition of annotation values without loading any values. - Added possibility to define enumerations at runtime.
- Added possibility to dynamically read enumerations for the
MethodCall
andInvokeDynamic
implementations. - Further API clean-up.
- Renamed the
Instrumentation
interface toImplementation
to avoid naming conflicts with Java types. - Renamed the
Field
annotation toFieldProxy
to avoid naming conflicts with Java types. - Refactored package structure to make the implementation more readable.
- Added possibility to define annotation default values.
- Avoid creation of an auxiliary placeholder type for method rebasements if it is not required.
- Avoid rebasing of methods if they are not instrumented.
- Reimplemented
TypeWriter
,MethodRegistry
and other supporting infrastructure to make the code simpler. - Refactored testing that is related to the previous infrastructure.
- Added possibility to write parameter meta information to created classes if it is fully available for a method.
- Retrofitted method parameters to be represented by
ParameterDescription
s and added possibility to extract names and modifiers for these parameters, either by using the Java 8 API (if available) or by reading this information from the underlying class file. - Fixed a
NullPointerException
being thrown due to accidental return of anull
value from a method.
- Fixed missing retention of method annotations of instrumented types.
- Allowed dynamic lookup of methods for the
MethodCall
instrumentation.
- Changed the
SuperMethodCall
instrumentation to fall back to a default method call if required. A different behavior was found to surprise users and would introduce subtle bugs in user code as the super method instrumentation would always work with subclassing due to Java super method call semantics. - Added a
MethodCall
instrumentation that allows hard-coding a method call. - Added an
InvokeDynamic
instrumentation that allows runtime dispatching by bootstrap methods. - Fixed the default
TypePool
to retain generic signatures in order to avoid that agents delete such signatures. - Fixed a bug in all of the the default
ConstructorStrategy
that effectively prevented intercepting of constructors.
- Fixed a bug where interface generation would result in a
NullPointerException
. - Added additional
ElementMatcher
s that allow to identify class loaders.
Added the andThen
method to the SuperMethodCall
instrumentation in order to allow for a more convenient
executingTransformer interception where a hard-coded super method call is required by the Java verifier.
- Added the
DeclaringTypeResolver
as a component in the default chain which selects the most specific method out of two. This is mainly meant to avoid the accidental matching of the methods that are declared by theObject
type. - Added
TypeInitializer
s in order to allowInstrumentation
s to define type initializer blocks. - Replaced the
MethodMatcher
API with theElementMatcher
API which allows for a more sophisticated matching DSL. - Added a
ClassLoadingStrategy
for Android in its own module. - Introduced an
AgentBuilder
API and implementation.
- Refactored the implementation of the
VoidAwareAssigner
which would otherwise cause unexpected behavior in its default state. - Added a missing boxing instruction to the
InvocationHandlerAdapter
.
- Extended
Instrumentation.Context
to support field accessors. - Added the
TypePool
abstraction and added a default implementation. - Refactored annotations to have an intermediate form as
AnnotationDescription
which does not need to represent loaded values. - Refactored several built-in
Instrumentation
, among others, all implementations now supportTypeDescription
in addition to loadedClass
as their arguments - Added several annotations that apply to the
MethodDelegation
.
- Added support for optionally specifying a
ProtectionDomain
for the built-inClassLoadingStrategy
implementations. - Fixed a bug in the resolution of resources of the
ByteArrayClassLoader
and its child-first implementation.
- Added basic support for Java 7 types
MethodHandle
andMethodType
which are available from Java 7 for injection. - Added support for type redefinition and type rebasing.
- Added support for accessing a JVM's HotSwap features and a Java agent.
- Added latent a child-first
ClassLoadingStrategy
and manifest versions of theWRAPPER
andCHILD_FIRST
default class loading strategies.
- Added proper support for defining class initializers. Added support for field caching from method instrumentations,
mainly for allowing the reuse of
Method
instances for the@Origin
annotation and theInvocationHandlerAdapter
.
- Changed the semantics of the
@SuperCall
to be only bindable, if a super method can be invoked. Before, an exception was thrown if only a non-existent or abstract super method was found. - Added features for the interaction with Java 8 default methods. Refactored method lookup to extract invokable default methods.
- Refactored the invocation of super methods to be created by an
Instrumentation.Target
. For a future release, this hopefully allows for class redefinitions using today's API for creating subclasses. - Upgraded to ASM 5.0.3.
- First general release.