org.spongepowered.asm.mixin.gen

Class AccessorInfo

java.lang.Object

org.spongepowered.asm.mixin.struct.SpecialMethodInfo

org.spongepowered.asm.mixin.gen.AccessorInfo

All Implemented Interfaces:

IInjectionPointContext

Direct Known Subclasses:

InvokerInfo

public class AccessorInfo
extends SpecialMethodInfo

Information about an accessor

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AccessorInfo.AccessorType Accessor types

Field Summary

Fields

Modifier and Type	Field and Description
protected org.spongepowered.asm.lib.Type[]	argTypes Accessor method argument types (raw, from method)
protected static java.util.regex.Pattern	PATTERN_ACCESSOR Pattern for matching accessor names (for inflector)
protected org.spongepowered.asm.lib.Type	returnType Accessor method return type (raw, from method)
protected MemberInfo	target Computed information about the target field or method, name and descriptor
protected org.spongepowered.asm.lib.tree.FieldNode	targetField For accessors, stores the discovered target field
protected org.spongepowered.asm.lib.tree.MethodNode	targetMethod For invokers, stores the discovered target method
protected AccessorInfo.AccessorType	type Type of accessor to generate, computed based on the signature of the target method.

Fields inherited from class org.spongepowered.asm.mixin.struct.SpecialMethodInfo

annotation, classNode, method, mixin

Constructor Summary

Constructors

Modifier	Constructor and Description
	AccessorInfo(MixinTargetContext mixin, org.spongepowered.asm.lib.tree.MethodNode method)
protected	AccessorInfo(MixinTargetContext mixin, org.spongepowered.asm.lib.tree.MethodNode method, java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass)

Method Summary

Modifier and Type	Method and Description
protected <TNode> TNode	findTarget(java.util.List<TNode> nodes) Generified candidate search, since the search logic is the same for both fields and methods.
org.spongepowered.asm.lib.tree.MethodNode	generate() Second pass, generate the actual accessor method for this accessor.
org.spongepowered.asm.lib.Type[]	getArgTypes() Get the argument types of the annotated method
org.spongepowered.asm.lib.Type	getReturnType() Get the return type of the annotated method
MemberInfo	getTarget() Get the inflected/specified target member for this accessor
org.spongepowered.asm.lib.tree.FieldNode	getTargetField() For field accessors, returns the target field, returns null for invokers
org.spongepowered.asm.lib.Type	getTargetFieldType() For field accessors, returns the field type, returns null for invokers
org.spongepowered.asm.lib.tree.MethodNode	getTargetMethod() For invokers, returns the target method, returns null for field accessors
protected java.lang.String	getTargetName()
protected java.lang.String	inflectTarget() Uses the name of this accessor method and the calculated accessor type to try and inflect the name of the target field or method.
static java.lang.String	inflectTarget(java.lang.String accessorName, AccessorInfo.AccessorType accessorType, java.lang.String accessorDescription, IMixinContext context, boolean verbose) Uses the name of an accessor method and the accessor type to try and inflect the name of the target field or method.
protected MemberInfo	initTarget()
protected org.spongepowered.asm.lib.Type	initTargetFieldType()
protected AccessorInfo.AccessorType	initType()
void	locate() First pass, locate the target field in the class.
static AccessorInfo	of(MixinTargetContext mixin, org.spongepowered.asm.lib.tree.MethodNode method, java.lang.Class<? extends java.lang.annotation.Annotation> type) Return a wrapper AccessorInfo of the correct type based on the method passed in.
java.lang.String	toString()

Methods inherited from class org.spongepowered.asm.mixin.struct.SpecialMethodInfo

getAnnotation, getClassNode, getContext, getMethod

Methods inherited from class java.lang.Object

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

Field Detail

PATTERN_ACCESSOR

protected static final java.util.regex.Pattern PATTERN_ACCESSOR

Pattern for matching accessor names (for inflector)

argTypes

protected final org.spongepowered.asm.lib.Type[] argTypes

Accessor method argument types (raw, from method)

returnType

protected final org.spongepowered.asm.lib.Type returnType

Accessor method return type (raw, from method)

type

protected final AccessorInfo.AccessorType type

Type of accessor to generate, computed based on the signature of the target method.

target

protected final MemberInfo target

Computed information about the target field or method, name and descriptor

targetField

protected org.spongepowered.asm.lib.tree.FieldNode targetField

For accessors, stores the discovered target field

targetMethod

protected org.spongepowered.asm.lib.tree.MethodNode targetMethod

For invokers, stores the discovered target method

Constructor Detail

AccessorInfo

public AccessorInfo(MixinTargetContext mixin,
                    org.spongepowered.asm.lib.tree.MethodNode method)

AccessorInfo

protected AccessorInfo(MixinTargetContext mixin,
                       org.spongepowered.asm.lib.tree.MethodNode method,
                       java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass)

Method Detail

initType

protected AccessorInfo.AccessorType initType()

initTargetFieldType

protected org.spongepowered.asm.lib.Type initTargetFieldType()

initTarget

protected MemberInfo initTarget()

getTargetName

protected java.lang.String getTargetName()

inflectTarget

protected java.lang.String inflectTarget()

Uses the name of this accessor method and the calculated accessor type to try and inflect the name of the target field or method. This allows a method named getFoo to be inflected to a target named foo for example.

inflectTarget

public static java.lang.String inflectTarget(java.lang.String accessorName,
                                             AccessorInfo.AccessorType accessorType,
                                             java.lang.String accessorDescription,
                                             IMixinContext context,
                                             boolean verbose)

Uses the name of an accessor method and the accessor type to try and inflect the name of the target field or method. This allows a method named getFoo to be inflected to a target named foo for example.

Parameters:

accessorName - Name of the accessor method

accessorType - Type of accessor being processed, this is calculated from the method signature (void methods being setters, methods with return types being getters)

accessorDescription - description of the accessor to include in error messages

context - Mixin context

verbose - Emit warnings when accessor prefix doesn't match type

Returns:

inflected target member name or null if name cannot be inflected

getTarget

public final MemberInfo getTarget()

Get the inflected/specified target member for this accessor

getTargetFieldType

public final org.spongepowered.asm.lib.Type getTargetFieldType()

For field accessors, returns the field type, returns null for invokers

getTargetField

public final org.spongepowered.asm.lib.tree.FieldNode getTargetField()

For field accessors, returns the target field, returns null for invokers

getTargetMethod

public final org.spongepowered.asm.lib.tree.MethodNode getTargetMethod()

For invokers, returns the target method, returns null for field accessors

getReturnType

public final org.spongepowered.asm.lib.Type getReturnType()

Get the return type of the annotated method

getArgTypes

public final org.spongepowered.asm.lib.Type[] getArgTypes()

Get the argument types of the annotated method

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

locate

public void locate()

First pass, locate the target field in the class. This is done after all other mixins are applied so that mixin-added fields and methods can be targetted.

generate

public org.spongepowered.asm.lib.tree.MethodNode generate()

Second pass, generate the actual accessor method for this accessor. The method still respects intrinsic/mixinmerged rules so is not guaranteed to be added to the target class

Returns:

generated accessor method

findTarget

protected <TNode> TNode findTarget(java.util.List<TNode> nodes)

Generified candidate search, since the search logic is the same for both fields and methods.

Type Parameters:

TNode - node type

Parameters:

nodes - Node list to search (method/field list)

Returns:

best match

of

public static AccessorInfo of(MixinTargetContext mixin,
                              org.spongepowered.asm.lib.tree.MethodNode method,
                              java.lang.Class<? extends java.lang.annotation.Annotation> type)

Return a wrapper AccessorInfo of the correct type based on the method passed in.

Parameters:

mixin - mixin context which owns this accessor

method - annotated method

type - annotation type to process

Returns:

parsed AccessorInfo