net.lenni0451.classtransform.transformer

Interface IAnnotationCoprocessor

All Known Implementing Classes:

CLocalVariableCoprocessor, CSharedCoprocessor

public interface IAnnotationCoprocessor

Coprocessor for annotation handlers. The instance of this class will only be used once.
Used to add support for special annotations like CLocalVariable.
Annotation handlers which do not inject calls to the target method will not need this (e.g. CASM, COverride).
If you are adding your own annotation handler you need to add support for this manually (unless you don't inject calls to the target method).

Method Summary

Modifier and Type	Method and Description
void	postprocess(TransformerManager transformerManager, org.objectweb.asm.tree.ClassNode transformedClass, org.objectweb.asm.tree.MethodNode transformedMethod, java.util.List<org.objectweb.asm.tree.MethodInsnNode> transformerMethodCalls, org.objectweb.asm.tree.ClassNode transformer, org.objectweb.asm.tree.MethodNode transformerMethod) Postprocess the transformer and target method after the annotation handler injected calls to the target method. The transformerMethodCalls list only contains direct calls to the transformer method. Example usage: Add the parameter array back and modify the calls to the transformer method to use the parameter array.
org.objectweb.asm.tree.MethodNode	preprocess(TransformerManager transformerManager, org.objectweb.asm.tree.ClassNode transformedClass, org.objectweb.asm.tree.MethodNode transformedMethod, org.objectweb.asm.tree.ClassNode transformer, org.objectweb.asm.tree.MethodNode transformerMethod) Preprocess the target method before the annotation handler injects calls to the target method. This happens before the transformer method is verified by the annotation handler. Example usage: Merge all parameters into one array and add it to the end of the method.
org.objectweb.asm.tree.MethodNode	transform(TransformerManager transformerManager, org.objectweb.asm.tree.ClassNode transformedClass, org.objectweb.asm.tree.MethodNode transformedMethod, org.objectweb.asm.tree.ClassNode transformer, org.objectweb.asm.tree.MethodNode transformerMethod) Process the target method before the annotation handler injects calls to the target method. This happens before the transformer method is verified by the annotation handler but after preprocess(TransformerManager, ClassNode, MethodNode, ClassNode, MethodNode). The calls to this method are in reverse order of the preprocess(TransformerManager, ClassNode, MethodNode, ClassNode, MethodNode) calls. Example usage: Remove the previously added parameter array so the transformer method can be verified by the annotation handler.

Method Detail

preprocess

org.objectweb.asm.tree.MethodNode preprocess(TransformerManager transformerManager,
                                             org.objectweb.asm.tree.ClassNode transformedClass,
                                             org.objectweb.asm.tree.MethodNode transformedMethod,
                                             org.objectweb.asm.tree.ClassNode transformer,
                                             org.objectweb.asm.tree.MethodNode transformerMethod)

Preprocess the target method before the annotation handler injects calls to the target method.
This happens before the transformer method is verified by the annotation handler.

Example usage: Merge all parameters into one array and add it to the end of the method.

Parameters:

transformerManager - The transformer manager

transformedClass - The target class node

transformedMethod - The target method node

transformer - The transformer class node

transformerMethod - The transformer method node

Returns:

The preprocessed transformerMethod node

transform

org.objectweb.asm.tree.MethodNode transform(TransformerManager transformerManager,
                                            org.objectweb.asm.tree.ClassNode transformedClass,
                                            org.objectweb.asm.tree.MethodNode transformedMethod,
                                            org.objectweb.asm.tree.ClassNode transformer,
                                            org.objectweb.asm.tree.MethodNode transformerMethod)

Process the target method before the annotation handler injects calls to the target method.
This happens before the transformer method is verified by the annotation handler but after preprocess(TransformerManager, ClassNode, MethodNode, ClassNode, MethodNode).
The calls to this method are in reverse order of the preprocess(TransformerManager, ClassNode, MethodNode, ClassNode, MethodNode) calls.

Example usage: Remove the previously added parameter array so the transformer method can be verified by the annotation handler.

Parameters:

transformerManager - The transformer manager

transformedClass - The target class node

transformedMethod - The target method node

transformer - The transformer class node

transformerMethod - The transformer method node

Returns:

The preprocessed transformerMethod node

postprocess

void postprocess(TransformerManager transformerManager,
                 org.objectweb.asm.tree.ClassNode transformedClass,
                 org.objectweb.asm.tree.MethodNode transformedMethod,
                 java.util.List<org.objectweb.asm.tree.MethodInsnNode> transformerMethodCalls,
                 org.objectweb.asm.tree.ClassNode transformer,
                 org.objectweb.asm.tree.MethodNode transformerMethod)

Postprocess the transformer and target method after the annotation handler injected calls to the target method.
The transformerMethodCalls list only contains direct calls to the transformer method.

Example usage: Add the parameter array back and modify the calls to the transformer method to use the parameter array.

Parameters:

transformerManager - The transformer manager

transformedClass - The target class node

transformedMethod - The target method node

transformerMethodCalls - The list of calls to the transformer method

transformer - The transformer class node

transformerMethod - The transformer method node