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
, it is illegal to write to the annotated parameter. If this property is set totrue
, the annotated parameter can either be set tonull
to suppress an exception that was thrown by the adviced method or it can be set to any other exception that will be thrown after the advice method returned.If an exception is suppressed, the default value for the return type is returned from the method, i.e.
0
for any numeric type andnull
for a reference type. The default value can be replaced via theAdvice.Return
annotation.- 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
-
-