Annotation Type Origin


  • @Documented
    @Retention(RUNTIME)
    @Target(PARAMETER)
    public @interface Origin

    The origin annotation provides some meta information about the source method that is bound to this method where the binding is dependant of the parameter's type:

    1. If the annotated parameter is of type Method, Constructor or java.lang.reflect.Executable, the parameter is assigned a reference to the method or constructor it instruments. If the reference is not assignable to the sort of the intercepted source, the target is not considered for binding.
    2. If the annotated parameter is of type Class, the parameter is assigned a reference of the type of the instrumented type.
    3. If the annotated parameter is of type String, the parameter is assigned a string with the value that would be returned by the Method.toString() method.
    4. If the annotated parameter is a int type, it is assigned the intercepted method's modifiers.
    5. If the annotated type is java.lang.invoke.MethodHandle, a handle of the intercepted method is injected. A java.lang.invoke.MethodHandle is stored in a class's constant pool and does therefore not face the same runtime performance limitations as a (non-cached) Method reference. Method handles are only supported for byte code versions starting from Java 7.
    6. If the annotated type is java.lang.invoke.MethodType, a description of the intercepted method's type is injected. Method type descriptions are only supported for byte code versions starting from Java 7.

    Any other parameter type will cause an IllegalStateException.

    Important: A method handle or method type reference can only be used if the referenced method's types are all visible to the instrumented type or an IllegalAccessError will be thrown at runtime.

    See Also:
    MethodDelegation, TargetMethodAnnotationDrivenBinder
    • Optional Element Summary

      Optional Elements 
      Modifier and Type Optional Element Description
      boolean cache
      Determines if the value that is assigned by this annotation is cached.
      boolean privileged
      Determines if the method should be resolved by using an AccessController using the privileges of the generated class.
    • Element Detail

      • cache

        boolean cache
        Determines if the value that is assigned by this annotation is cached. For values that can be stored in the constant pool, this value is ignored as such values are cached implicitly. As a result, this value currently only affects caching of Method instances.
        Returns:
        true if the value for this parameter should be cached in a static field inside the instrumented class.
        Default:
        true
      • privileged

        boolean privileged
        Determines if the method should be resolved by using an AccessController using the privileges of the generated class. Doing so requires the generation of an auxiliary class that implements PrivilegedExceptionAction.
        Returns:
        true if the class should be looked up using an AccessController.
        Default:
        false