net.lenni0451.classtransform.utils

Class ASMUtils

java.lang.Object

net.lenni0451.classtransform.utils.ASMUtils

public class ASMUtils
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
ASMUtils()

Method Summary

Modifier and Type	Method and Description
static org.objectweb.asm.tree.ClassNode	cloneClass(org.objectweb.asm.tree.ClassNode classNode) Clone a ClassNode
static org.objectweb.asm.tree.MethodNode	cloneMethod(org.objectweb.asm.tree.MethodNode methodNode) Clone a MethodNode
static java.lang.String	combiToRegex(java.lang.String combi) Convert a field or method name matching name and descriptor to a regex pattern Use * for wildcard e.g.
static boolean	compareType(org.objectweb.asm.Type type, org.objectweb.asm.Type targetType) Compare a single Type with a target Type This supports Object instead of direct types
static boolean	compareTypes(org.objectweb.asm.Type[] types, org.objectweb.asm.Type[] targetTypes) Compare an array of Type with a target array of Type This supports Object instead of direct types
static boolean	compareTypes(org.objectweb.asm.Type[] types, org.objectweb.asm.Type[] targetTypes, boolean prepend, org.objectweb.asm.Type... additionalNeededTypes) Compare an array of Type with a target array of Type This supports Object instead of direct types
static org.objectweb.asm.tree.ClassNode	createEmptyClass(java.lang.String name) Create an empty class with a default constructor
static org.objectweb.asm.tree.ClassNode	fromBytes(byte[] bytecode) Get a ClassNode from the raw bytecode of a class
static org.objectweb.asm.tree.InsnList	getCast(org.objectweb.asm.Type wantedType) Get the code to cast an Object to any Type Converts primitive wrapper to their primitive types (e.g.
static org.objectweb.asm.tree.FieldNode	getField(org.objectweb.asm.tree.ClassNode classNode, java.lang.String name, java.lang.String desc) Get a FieldNode from a ClassNode using the name
static java.util.List<org.objectweb.asm.tree.FieldNode>	getFieldsFromCombi(org.objectweb.asm.tree.ClassNode classNode, java.lang.String combi) Get a List of FieldNodes from a ClassNode using the combined name and descriptor Use * for wildcard e.g.
static org.objectweb.asm.tree.AbstractInsnNode	getFirstConstructorInstruction(java.lang.String superClass, org.objectweb.asm.tree.MethodNode methodNode) Get the first instruction of a constructor
static int	getFreeVarIndex(org.objectweb.asm.tree.MethodNode methodNode) Get the last empty local variable index
static int	getLoadOpcode(org.objectweb.asm.Type type) Get the needed load opcode for a given Type
static org.objectweb.asm.tree.MethodNode	getMethod(org.objectweb.asm.tree.ClassNode classNode, java.lang.String name, java.lang.String desc) Get a MethodNode from a ClassNode using the name and descriptor
static java.util.List<org.objectweb.asm.tree.MethodNode>	getMethodsFromCombi(org.objectweb.asm.tree.ClassNode classNode, java.lang.String combi) Get a List of MethodNodes from a ClassNode using the combined name and descriptor Use * for wildcard e.g.
static java.lang.Number	getNumber(org.objectweb.asm.tree.AbstractInsnNode instruction) Get a Number from an AbstractInsnNode if it represents a Number
static org.objectweb.asm.tree.AbstractInsnNode	getPrimitiveToObject(org.objectweb.asm.Type primitive) Get the code to wrap a primitive to their wrapper type (e.g.
static int	getReturnOpcode(org.objectweb.asm.Type returnType) Get the needed return opcode for a given Type
static int	getStoreOpcode(org.objectweb.asm.Type type) Get the needed store opcode for a given Type
static boolean	isAccessLower(int toCheck, int checkAgainst) Check if the access is lower than another
static int	setAccess(int currentAccess, int newAccess) Set the wanted access to a given access mask
static MemberDeclaration	splitMemberDeclaration(java.lang.String injectDeclaration) Split an injection declaration into owner, name and desc
static byte[]	toBytes(org.objectweb.asm.tree.ClassNode node, IClassProvider classProvider) Get the bytecode from a ClassNode

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ASMUtils

public ASMUtils()

Method Detail

fromBytes

public static org.objectweb.asm.tree.ClassNode fromBytes(byte[] bytecode)

Get a ClassNode from the raw bytecode of a class

Parameters:

bytecode - The bytecode of the class

Returns:

The loaded ClassNode

toBytes

public static byte[] toBytes(org.objectweb.asm.tree.ClassNode node,
                             IClassProvider classProvider)

Get the bytecode from a ClassNode

Parameters:

node - The ClassNode

classProvider - The IClassProvider

Returns:

The bytecode of the class

getMethod

public static org.objectweb.asm.tree.MethodNode getMethod(org.objectweb.asm.tree.ClassNode classNode,
                                                          java.lang.String name,
                                                          java.lang.String desc)

Get a MethodNode from a ClassNode using the name and descriptor

Parameters:

classNode - The owner ClassNode

name - The name of the method

desc - The descriptor of the method

Returns:

The MethodNode

getField

public static org.objectweb.asm.tree.FieldNode getField(org.objectweb.asm.tree.ClassNode classNode,
                                                        java.lang.String name,
                                                        java.lang.String desc)

Get a FieldNode from a ClassNode using the name

Parameters:

classNode - The owner ClassNode

name - The name of the field

desc - The descriptor of the field

Returns:

The FieldNode

getMethodsFromCombi

public static java.util.List<org.objectweb.asm.tree.MethodNode> getMethodsFromCombi(org.objectweb.asm.tree.ClassNode classNode,
                                                                                    java.lang.String combi)

Get a List of MethodNodes from a ClassNode using the combined name and descriptor
Use * for wildcard
e.g. print(Ljava/lang/String;)V

Parameters:

classNode - The owner ClassNode

combi - The combined name and descriptor

Returns:

The List of MethodNodes

getFieldsFromCombi

public static java.util.List<org.objectweb.asm.tree.FieldNode> getFieldsFromCombi(org.objectweb.asm.tree.ClassNode classNode,
                                                                                  java.lang.String combi)

Get a List of FieldNodes from a ClassNode using the combined name and descriptor
Use * for wildcard
e.g. out:Ljava/io/PrintStream;

Parameters:

classNode - The owner ClassNode

combi - The combined name and descriptor

Returns:

The List of FieldNodes

combiToRegex

public static java.lang.String combiToRegex(java.lang.String combi)

Convert a field or method name matching name and descriptor to a regex pattern
Use * for wildcard
e.g. get* -> ^\Qget\E.*$

Parameters:

combi - The name of a field or method

Returns:

The regex pattern

isAccessLower

public static boolean isAccessLower(int toCheck,
                                    int checkAgainst)

Check if the access is lower than another

Parameters:

toCheck - The access to check

checkAgainst - The access to check against

Returns:

True if the access is lower than the other

setAccess

public static int setAccess(int currentAccess,
                            int newAccess)

Set the wanted access to a given access mask

Parameters:

currentAccess - The current access mask

newAccess - The wanted access

Returns:

The new access mask

getReturnOpcode

public static int getReturnOpcode(org.objectweb.asm.Type returnType)

Get the needed return opcode for a given Type

Parameters:

returnType - The return Type of a method

Returns:

The needed return opcode

getLoadOpcode

public static int getLoadOpcode(org.objectweb.asm.Type type)

Get the needed load opcode for a given Type

Parameters:

type - The Type to get the load opcode for

Returns:

The needed load opcode

getStoreOpcode

public static int getStoreOpcode(org.objectweb.asm.Type type)

Get the needed store opcode for a given Type

Parameters:

type - The Type to get the store opcode for

Returns:

The needed store opcode

getFreeVarIndex

public static int getFreeVarIndex(org.objectweb.asm.tree.MethodNode methodNode)

Get the last empty local variable index

Parameters:

methodNode - The method to get the last empty local variable index for

Returns:

The last empty local variable index

getCast

public static org.objectweb.asm.tree.InsnList getCast(org.objectweb.asm.Type wantedType)

Get the code to cast an Object to any Type
Converts primitive wrapper to their primitive types (e.g. Integer to int)

Parameters:

wantedType - The wanted Type

Returns:

The code to cast an Object to any Type

getPrimitiveToObject

public static org.objectweb.asm.tree.AbstractInsnNode getPrimitiveToObject(org.objectweb.asm.Type primitive)

Get the code to wrap a primitive to their wrapper type (e.g. int to Integer)

Parameters:

primitive - The primitive type to wrap

Returns:

The code to wrap a primitive to their wrapper type

splitMemberDeclaration

public static MemberDeclaration splitMemberDeclaration(java.lang.String injectDeclaration)

Split an injection declaration into owner, name and desc

Parameters:

injectDeclaration - The injection declaration

Returns:

The owner, name and desc

getFirstConstructorInstruction

public static org.objectweb.asm.tree.AbstractInsnNode getFirstConstructorInstruction(java.lang.String superClass,
                                                                                     org.objectweb.asm.tree.MethodNode methodNode)

Get the first instruction of a constructor

Parameters:

superClass - The name of the super class

methodNode - The MethodNode of the constructor

Returns:

The first instruction of the constructor

getNumber

public static java.lang.Number getNumber(org.objectweb.asm.tree.AbstractInsnNode instruction)

Get a Number from an AbstractInsnNode if it represents a Number

Parameters:

instruction - The AbstractInsnNode

Returns:

The Number or null if it is not a Number

compareTypes

public static boolean compareTypes(org.objectweb.asm.Type[] types,
                                   org.objectweb.asm.Type[] targetTypes)

Compare an array of Type with a target array of Type
This supports Object instead of direct types

Parameters:

types - The source array of Type

targetTypes - The target array of Type

Returns:

If the arrays match

compareTypes

public static boolean compareTypes(org.objectweb.asm.Type[] types,
                                   org.objectweb.asm.Type[] targetTypes,
                                   boolean prepend,
                                   org.objectweb.asm.Type... additionalNeededTypes)

Compare an array of Type with a target array of Type
This supports Object instead of direct types

Parameters:

types - The source array of Type

targetTypes - The target array of Type

prepend - If the additional Type array should be prepended or appended

additionalNeededTypes - The additional Type to append to the source

Returns:

If the arrays match

compareType

public static boolean compareType(org.objectweb.asm.Type type,
                                  org.objectweb.asm.Type targetType)

Compare a single Type with a target Type
This supports Object instead of direct types

Parameters:

type - The source Type

targetType - The target Type

Returns:

If the types match

cloneClass

public static org.objectweb.asm.tree.ClassNode cloneClass(org.objectweb.asm.tree.ClassNode classNode)

Clone a ClassNode

Parameters:

classNode - The ClassNode to clone

Returns:

The cloned ClassNode

cloneMethod

public static org.objectweb.asm.tree.MethodNode cloneMethod(org.objectweb.asm.tree.MethodNode methodNode)

Clone a MethodNode

Parameters:

methodNode - The MethodNode to clone

Returns:

The cloned MethodNode

createEmptyClass

public static org.objectweb.asm.tree.ClassNode createEmptyClass(java.lang.String name)

Create an empty class with a default constructor

Parameters:

name - The name of the class

Returns:

The ClassNode