Annotation Type Advice.Thrown
-
@Documented @Retention(RUNTIME) @Target(PARAMETER) public static @interface Advice.Thrown
Indicates that the annotated parameter should be mapped to the
Throwable
thrown by the instrumented method or tonull
if the method returned regularly. Note that the Java runtime does not enforce checked exceptions. In order to capture any error, the parameter type must therefore be of typeThrowable
. By assigning another value ornull
to this parameter, a thrown exception can be suppressed.Note: This annotation must only be used on exit advice methods.
- See Also:
Advice
,Advice.OnMethodExit
-
-
Optional Element Summary
Optional Elements Modifier and Type Optional Element Description boolean
readOnly
Indicates if it is possible to write to this parameter.Assigner.Typing
typing
Determines the typing that is applied when assigning the capturedThrowable
to the annotated parameter.
-
-
-
Element Detail
-
readOnly
boolean readOnly
Indicates if it is possible to write to this parameter. If this property is set to
false
, the annotated type must be equal to the type declaring the instrumented method if the typing is not also set toAssigner.Typing.DYNAMIC
. If this property is set totrue
, the annotated parameter can be any super type of the instrumented method's declaring type.Important: This property must be set to
true
if the advice method is not inlined.- Returns:
true
if this parameter is read-only.
- Default:
- true
-
-
-
typing
Assigner.Typing typing
Determines the typing that is applied when assigning the capturedThrowable
to the annotated parameter.- Returns:
- The typing to apply when assigning the annotated parameter.
- Default:
- net.bytebuddy.implementation.bytecode.assign.Assigner.Typing.DYNAMIC
-
-