net.bytebuddy.implementation.bind.annotation

Annotation Type DefaultCallHandle

@Documented
 @Retention(value=RUNTIME)
 @Target(value=PARAMETER)
public @interface DefaultCallHandle

A parameter with this annotation is assigned a method handle for invoking a default method that fits the intercepted method. If no suitable default method for the intercepted method can be identified, the target method with the annotated parameter is considered to be unbindable, unless a null value is requested by setting a property.

See Also:

MethodDelegation, TargetMethodAnnotationDrivenBinder

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	nullIfImpossible Assigns null to the parameter if it is impossible to invoke the super method or a possible dominant default method, if permitted.
Class<?>	targetType If this parameter is not explicitly set, a parameter with the DefaultCallHandle is only bound to a source method if this source method directly represents an unambiguous, invokable default method.

Element Detail

targetType

public abstract Class<?> targetType

If this parameter is not explicitly set, a parameter with the DefaultCallHandle is only bound to a source method if this source method directly represents an unambiguous, invokable default method. On the other hand, if a method is not defined unambiguously by an interface, not setting this parameter will exclude the target method with the annotated parameter from a binding to the source method.

If this parameter is however set to an explicit interface type, a default method is always invoked on this given type as long as this type defines a method with a compatible signature. If this is not the case, the target method with the annotated parameter is no longer considered as a possible binding candidate of a source method.

Returns:

The target interface that a default method invocation is to be defined upon. If no such explicit target is set, this parameter should not be defined as the predefined void type encodes an implicit resolution.

Default:

void.class

nullIfImpossible

public abstract boolean nullIfImpossible

Assigns null to the parameter if it is impossible to invoke the super method or a possible dominant default method, if permitted.

Returns:

true if a null constant should be assigned to this parameter in case that a legal binding is impossible.

Default:

false