net.lenni0451.classtransform.annotations.injection

Annotation Type CWrapCatch

@Retention(value=CLASS)
 @Target(value={METHOD,CONSTRUCTOR})
public @interface CWrapCatch

Wrap an entire method or a single method call in a try-catch block.
The transformer method must have the caught exception as the only parameter.

When wrapping an entire method:

• The transformer method must have the same return type as the wrapped method.

When wrapping a method call instruction:

• The transformer method must have the same return type as the wrapped method.

The transformer method has to be static if the target method is static.

Wrapping an entire method:

 @CWrapCatch()
 public String catchException(Exception e) {
      //Rethrow the exception or return a default value
 }
 

Wrapping a method call instruction:

 @CWrapCatch(target = "...")
 public String catchException(Exception e) {
      //Rethrow the exception or return a default value
 }
 

If your target has to be chosen more precisely you can use a slice() to narrow down the search.

See Also:

CSlice, GitHub Wiki

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String[]	value The method name and descriptor to inject into. This supports multiple targets and wildcards. e.g.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
int	ordinal The ordinal of target method call instruction. Ignored if the entire method should be wrapped.
CSlice	slice The slice to narrow down the search for the target. Ignored if the entire method should be wrapped.
java.lang.String	target The method owner, name and descriptor of the target method call instruction to wrap. If this is not specified the entire method will be wrapped. e.g.

Element Detail

value

public abstract java.lang.String[] value

The method name and descriptor to inject into.
This supports multiple targets and wildcards.
e.g. print(Ljava/lang/String;)V or print*

Returns:

The method name and descriptor

target

public abstract java.lang.String target

The method owner, name and descriptor of the target method call instruction to wrap.
If this is not specified the entire method will be wrapped.
e.g. Ljava/io/InputStream;close()V

Returns:

The method owner, name and descriptor

Default:

""

ordinal

public abstract int ordinal

The ordinal of target method call instruction.
Ignored if the entire method should be wrapped.

Returns:

The ordinal

Default:

-1

slice

public abstract CSlice slice

The slice to narrow down the search for the target.
Ignored if the entire method should be wrapped.

Returns:

The slice

Default:

@net.lenni0451.classtransform.annotations.CSlice