Annotation Type DefaultCallHandle


  • @Documented
    @Retention(RUNTIME)
    @Target(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 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.
      java.lang.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

        java.lang.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

        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