Package org.spongepowered.asm.mixin.injection.selectors

Class ElementNode<TNode>

java.lang.Object
org.spongepowered.asm.mixin.injection.selectors.ElementNode<TNode>
Type Parameters:
TNode - node type
public abstract class ElementNode<TNode> extends Object
Wrapper for all node types supported by target selectors (FieldNode, MethodNode, FieldInsnNode, MethodInsnNode and InvokeDynamicInsnNode) which allows access to common properties of things which are basically "arbitrary node with owner, name and descriptor"

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static enum 
    ElementNode.NodeType
    Element node type, returned by getType so consumers don't need to do instanceof checks, and allows switching on element type in a more expressive way

  • Constructor Summary

    Constructors
    Constructor
    Description
    ElementNode()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static Iterable<ElementNode<org.objectweb.asm.tree.AbstractInsnNode>>
    dynamicInsnList(org.objectweb.asm.tree.InsnList insns)
    Get a wrapped version of the supplied insn list which returns element nodes for every INVOKEDYNAMIC instruction only
    static List<ElementNode<org.objectweb.asm.tree.FieldNode>>
    fieldList(org.objectweb.asm.tree.ClassNode owner)
    Get a list of wrapped ElementNodes for the fields of the supplied owner class
    abstract TNode
    get()
    Returns the node with horrible duck typing
    String
    getDelegateDesc()
    For INVOKEDYNAMIC elements, returns original descriptor of the delegate.
    abstract String
    getDesc()
    Get the element descriptor.
    org.objectweb.asm.tree.FieldNode
    getField()
    Get the FieldNode if this member is a field, otherwise returns null
    String
    getImplDesc()
    For INVOKEDYNAMIC elements, returns specialised descriptor of the delegate (lambda descriptor without prepended captures), can be the same as the delegate descriptor or more specialised.
    org.objectweb.asm.tree.AbstractInsnNode
    getInsn()
    Get the instruction if this member is an insn, otherwise returns null
    org.objectweb.asm.tree.MethodNode
    getMethod()
    Get the MethodNode if this member is a method, otherwise returns null
    abstract String
    getName()
    Get the element name
    abstract String
    getOwner()
    Get the element owner's name, if this element has an owner, otherwise returns null
    abstract String
    getSignature()
    Get the element signature, can be null
    String
    getSyntheticName()
    Get the synthetic element name.
    abstract ElementNode.NodeType
    getType()
    Get the type of this ElementNode, the return value can be used to determine which accessor (getMethod(), getField()
    static Iterable<ElementNode<org.objectweb.asm.tree.AbstractInsnNode>>
    insnList(org.objectweb.asm.tree.InsnList insns)
    Get a wrapped version of the supplied insn list which returns element nodes for each (supported) instruction (FieldInsnNode, MethodInsnNode and InvokeDynamicInsnNode).
    boolean
    isField()
    Get whether this element is a field type and the descriptor is a bare type descriptor without arguments.
    static <TNode> List<ElementNode<TNode>>
    listOf(org.objectweb.asm.tree.ClassNode owner, List<TNode> list)
    Convert the supplied list of nodes to a list of wrapped ElementNodes
    static List<ElementNode<org.objectweb.asm.tree.MethodNode>>
    methodList(org.objectweb.asm.tree.ClassNode owner)
    Get a list of wrapped ElementNodes for the methods of the supplied owner class
    static ElementNode<org.objectweb.asm.tree.FieldNode>
    of(org.objectweb.asm.tree.ClassNode owner, org.objectweb.asm.tree.FieldNode field)
    Create an ElementNode wrapper for the supplied field node
    static ElementNode<org.objectweb.asm.tree.MethodNode>
    of(org.objectweb.asm.tree.ClassNode owner, org.objectweb.asm.tree.MethodNode method)
    Create an ElementNode wrapper for the supplied method node
    static <TNode> ElementNode<TNode>
    of(org.objectweb.asm.tree.ClassNode owner, TNode node)
    Create an ElementNode wrapper for the supplied node object
    static <TNode extends org.objectweb.asm.tree.AbstractInsnNode>
    ElementNode<TNode>
    of(TNode node)
    Create an ElementNode wrapper for the supplied node object
    String
    toString()
     

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • ElementNode

      public ElementNode()

  • Method Details

    • isField

      public boolean isField()
      Get whether this element is a field type and the descriptor is a bare type descriptor without arguments. Otherwise assumes the descriptor is a method descriptor.

    • getType

      public abstract ElementNode.NodeType getType()
      Get the type of this ElementNode, the return value can be used to determine which accessor (getMethod(), getField()

    • getMethod

      public org.objectweb.asm.tree.MethodNode getMethod()
      Get the MethodNode if this member is a method, otherwise returns null

    • getField

      public org.objectweb.asm.tree.FieldNode getField()
      Get the FieldNode if this member is a field, otherwise returns null

    • getInsn

      public org.objectweb.asm.tree.AbstractInsnNode getInsn()
      Get the instruction if this member is an insn, otherwise returns null

    • getOwner

      public abstract String getOwner()
      Get the element owner's name, if this element has an owner, otherwise returns null

    • getName

      public abstract String getName()
      Get the element name

    • getSyntheticName

      public String getSyntheticName()
      Get the synthetic element name. For INVOKEDYNAMIC elements this is the real name of the lambda method implementing the delegate.

    • getDesc

      public abstract String getDesc()
      Get the element descriptor. For INVOKEDYNAMIC this is the full descriptor of the lambda (including prepended captures).

    • getDelegateDesc

      public String getDelegateDesc()
      For INVOKEDYNAMIC elements, returns original descriptor of the delegate.

    • getImplDesc

      public String getImplDesc()
      For INVOKEDYNAMIC elements, returns specialised descriptor of the delegate (lambda descriptor without prepended captures), can be the same as the delegate descriptor or more specialised.

    • getSignature

      public abstract String getSignature()
      Get the element signature, can be null

    • get

      public abstract TNode get()
      Returns the node with horrible duck typing

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • of

      public static ElementNode<org.objectweb.asm.tree.MethodNode> of(org.objectweb.asm.tree.ClassNode owner, org.objectweb.asm.tree.MethodNode method)
      Create an ElementNode wrapper for the supplied method node
      Parameters:
      owner - class which owns the method or null
      method - Method node to wrap
      Returns:
      ElementNode

    • of

      public static ElementNode<org.objectweb.asm.tree.FieldNode> of(org.objectweb.asm.tree.ClassNode owner, org.objectweb.asm.tree.FieldNode field)
      Create an ElementNode wrapper for the supplied field node
      Parameters:
      owner - class which owns the field or null
      field - Field node to wrap
      Returns:
      ElementNode

    • of

      public static <TNode> ElementNode<TNode> of(org.objectweb.asm.tree.ClassNode owner, TNode node)
      Create an ElementNode wrapper for the supplied node object
      Type Parameters:
      TNode - Node type
      Parameters:
      owner - class which owns the node or null
      node - Node to wrap
      Returns:
      ElementNode
      Throws:
      IllegalArgumentException - if the supplied argument is not a MethodNode or FieldNode

    • of

      public static <TNode extends org.objectweb.asm.tree.AbstractInsnNode> ElementNode<TNode> of(TNode node)
      Create an ElementNode wrapper for the supplied node object
      Type Parameters:
      TNode - Node type
      Parameters:
      node - Node to wrap
      Returns:
      ElementNode
      Throws:
      IllegalArgumentException - if the supplied argument is not a MethodNode or FieldNode

    • listOf

      public static <TNode> List<ElementNode<TNode>> listOf(org.objectweb.asm.tree.ClassNode owner, List<TNode> list)
      Convert the supplied list of nodes to a list of wrapped ElementNodes
      Type Parameters:
      TNode - Node type
      Parameters:
      owner - Owner of the supplied nodes, can be null
      list - List of nodes
      Returns:
      List of wrapped nodes

    • fieldList

      public static List<ElementNode<org.objectweb.asm.tree.FieldNode>> fieldList(org.objectweb.asm.tree.ClassNode owner)
      Get a list of wrapped ElementNodes for the fields of the supplied owner class
      Parameters:
      owner - Class to get fields, must not be null
      Returns:
      List of wrapped nodes

    • methodList

      public static List<ElementNode<org.objectweb.asm.tree.MethodNode>> methodList(org.objectweb.asm.tree.ClassNode owner)
      Get a list of wrapped ElementNodes for the methods of the supplied owner class
      Parameters:
      owner - Class to get methods, must not be null
      Returns:
      List of wrapped nodes

    • insnList

      public static Iterable<ElementNode<org.objectweb.asm.tree.AbstractInsnNode>> insnList(org.objectweb.asm.tree.InsnList insns)
      Get a wrapped version of the supplied insn list which returns element nodes for each (supported) instruction (FieldInsnNode, MethodInsnNode and InvokeDynamicInsnNode).
      Parameters:
      insns - Insn list to wrap
      Returns:
      Wrapper for insn list

    • dynamicInsnList

      public static Iterable<ElementNode<org.objectweb.asm.tree.AbstractInsnNode>> dynamicInsnList(org.objectweb.asm.tree.InsnList insns)
      Get a wrapped version of the supplied insn list which returns element nodes for every INVOKEDYNAMIC instruction only
      Parameters:
      insns - Insn list to wrap
      Returns:
      Wrapper for insn list