net.bytebuddy.dynamic.scaffold

Interface BridgeMethodResolver

All Known Implementing Classes:

BridgeMethodResolver.NoOp, BridgeMethodResolver.Simple

public interface BridgeMethodResolver

Implementations of this interface serve as resolvers for bridge methods. For the Java compiler, a method signature does not include any information on a method's return type. However, within Java byte code, a distinction is made such that the Java compiler needs to include bridge methods where the method with the more specific return type is called from the method with the less specific return type when a method is overridden to return a more specific value. This resolution is important when auxiliary types are called since an accessor required for Foo#qux on some type Bar with an overriden method qux that was defined with a more specific return type would call the bridge method internally and not the intended method. This can be problematic if the following chain is the result of an instrumentation:

1. A super method accessor is registered for Foo#qux for some auxiliary type Baz.
2. The accessor is a bridging method which calls Bar#qux with the more specific return type.
3. The method Bar#qux is intercepted by an instrumentation.
4. Within the instrumented implementation, the auxiliary type Baz is used to invoke Foo#qux.
5. The super method invocation hits the bridge which delegates to the intercepted implementation what results in endless recursion.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	BridgeMethodResolver.Factory A factory for creating a BridgeMethodResolver for a given list of relevant methods that can be called in a given context.
static class	BridgeMethodResolver.NoOp A no-op implementation of a BridgeMethodResolver which is simply returning the method it is given to resolve.
static class	BridgeMethodResolver.Simple A simple bridge method resolver which applies its resolution by analyzing non-generic types.

Method Summary

Modifier and Type	Method and Description
MethodDescription	resolve(MethodDescription methodDescription) Resolves a method which is potentially a bridge method.

Method Detail

resolve

MethodDescription resolve(MethodDescription methodDescription)

Resolves a method which is potentially a bridge method.

Parameters:

methodDescription - The method to resolve in cases it is a bridge method.

Returns:

The intended invocation target of the given method.