Package org.codehaus.groovy.runtime

# Class InvokerHelper

java.lang.Object
org.codehaus.groovy.runtime.InvokerHelper

public class InvokerHelper extends Object
A static helper class to make bytecode generation easier and act as a facade over the Invoker

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `static final Object[]`
  `EMPTY_ARGS`
  `protected static final Object[]`
  `EMPTY_ARGUMENTS`
  `protected static final Class[]`
  `EMPTY_TYPES`
  `static final String`
  `MAIN_METHOD_NAME`
  `static final MetaClassRegistry`
  `metaRegistry`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `InvokerHelper()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `static void`
  `append(Appendable out, Object object)`
  Deprecated.
  `static Object[]`
  `asArray(Object arguments)`
  Converts the given object into an array; if it's an array then just cast otherwise wrap it in an array
  `static Iterator<Object>`
  `asIterator(Object o)`
  `static List`
  `asList(Object value)`
  `static void`
  `assertFailed(Object expression, Object message)`
  `static Object[]`
  `asUnwrappedArray(Object arguments)`
  `static Object`
  `bitwiseNegate(Object value)`
  `static AssertionError`
  `createAssertError(Object expression, Object message)`
  `static List`
  `createList(Object[] values)`
  `static Map`
  `createMap(Object[] values)`
  `static List`
  `createRange(Object from, Object to, boolean inclusive)`
  `static List`
  `createRange(Object from, Object to, boolean exclusiveLeft, boolean exclusiveRight)`
  `static Script`
  `createScript(Class scriptClass, Binding context)`
  `static Tuple`
  `createTuple(Object[] array)`
  `static String`
  `escapeBackslashes(String orig)`
  Deprecated.
  `static Matcher`
  `findRegex(Object left, Object right)`
  Find the right hand regex within the left hand string and return a matcher.
  `protected static String`
  `format(Object arguments, boolean verbose)`
  Deprecated.
  `static String`
  `format(Object arguments, boolean verbose, int maxSize)`
  Deprecated.
  `static String`
  `format(Object arguments, boolean verbose, int maxSize, boolean safe)`
  Deprecated.
  `static Object`
  `getAttribute(Object object, String attribute)`
  `static Object`
  `getGroovyObjectProperty(GroovyObject object, String property)`
  `static MetaClass`
  `getMetaClass(Class cls)`
  `static MetaClass`
  `getMetaClass(Object object)`
  `static MetaClassRegistry`
  `getMetaRegistry()`
  `static Closure`
  `getMethodPointer(Object object, String methodName)`
  Returns a method closure for the given object and name.
  `static Object`
  `getProperty(Object object, String property)`
  `static Object`
  `getPropertySafe(Object object, String property)`
  `static int`
  `initialCapacity(int initialEntryCnt)`
  According to the initial entry count, calculate the initial capacity of hash map, which is power of 2 (SEE https://stackoverflow.com/questions/8352378/why-does-hashmap-require-that-the-initial-capacity-be-a-power-of-two)
  `static String`
  `inspect(Object self)`
  Deprecated.
  `static Object`
  `invokeClosure(Object closure, Object arguments)`
  `static Object`
  `invokeConstructorOf(Class type, Object arguments)`
  `static Object`
  `invokeConstructorOf(String klass, Object arguments)`
  `static Object`
  `invokeMethod(Object object, String methodName, Object arguments)`
  Invokes the given method on the object.
  `static Object`
  `invokeMethodSafe(Object object, String methodName, Object arguments)`
  `static Object`
  `invokeNoArgumentsConstructorOf(Class type)`
  `static Object`
  `invokeStaticMethod(Class type, String method, Object arguments)`
  `static Object`
  `invokeStaticMethod(String klass, String methodName, Object arguments)`
  `static Object`
  `invokeStaticNoArgumentsMethod(Class type, String methodName)`
  `static Object`
  `invokeSuperMethod(Object object, String methodName, Object arguments)`
  `static boolean`
  `matchRegex(Object left, Object right)`
  Find the right hand regex within the left hand string and return a matcher.
  `static Script`
  `newScript(Class<? extends Script> scriptClass, Binding context)`
  `static void`
  `removeClass(Class clazz)`
  `static Object`
  `runScript(Class scriptClass, String[] args)`
  `static void`
  `setAttribute(Object object, String attribute, Object newValue)`
  `static void`
  `setGroovyObjectProperty(Object newValue, GroovyObject object, String property)`
  This is so we don't have to reorder the stack when we call this method.
  `static void`
  `setProperties(Object object, Map map)`
  Sets the properties on the given object
  `static void`
  `setProperty(Object object, String property, Object newValue)`
  `static void`
  `setProperty2(Object newValue, Object object, String property)`
  This is so we don't have to reorder the stack when we call this method.
  `static void`
  `setPropertySafe2(Object newValue, Object object, String property)`
  This is so we don't have to reorder the stack when we call this method.
  `static SpreadMap`
  `spreadMap(Object value)`
  `static String`
  `toArrayString(Object[] arguments)`
  Deprecated.
  `static String`
  `toArrayString(Object[] arguments, int maxSize, boolean safe)`
  Deprecated.
  `static String`
  `toListString(Collection arg)`
  Deprecated.
  `static String`
  `toListString(Collection arg, int maxSize)`
  Deprecated.
  `static String`
  `toListString(Collection arg, int maxSize, boolean safe)`
  Deprecated.
  `static String`
  `toMapString(Map arg)`
  Deprecated.
  `static String`
  `toMapString(Map arg, int maxSize)`
  Deprecated.
  `static String`
  `toString(Object arguments)`
  Deprecated.
  `static String`
  `toTypeString(Object[] arguments)`
  Deprecated.
  `static String`
  `toTypeString(Object[] arguments, int maxSize)`
  Deprecated.
  `static Object`
  `unaryMinus(Object value)`
  `static Object`
  `unaryPlus(Object value)`
  `static void`
  `write(Writer out, Object object)`
  Deprecated.

  ### Methods inherited from class java.lang.Object

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

- ## Field Details

  - ### EMPTY_ARGS

    public static final Object[] EMPTY_ARGS

  - ### EMPTY_ARGUMENTS

    protected static final Object[] EMPTY_ARGUMENTS

  - ### EMPTY_TYPES

    protected static final Class[] EMPTY_TYPES

  - ### metaRegistry

    public static final MetaClassRegistry metaRegistry

  - ### MAIN_METHOD_NAME

    public static final String MAIN_METHOD_NAME
    See Also:
      - Constant Field Values

- ## Constructor Details

  - ### InvokerHelper

    public InvokerHelper()

- ## Method Details

  - ### removeClass

    public static void removeClass(Class clazz)

  - ### invokeMethodSafe

    public static Object invokeMethodSafe(Object object, String methodName, Object arguments)

  - ### invokeStaticMethod

    public static Object invokeStaticMethod(String klass, String methodName, Object arguments) throws ClassNotFoundException
    Throws:
      `ClassNotFoundException`

  - ### invokeStaticNoArgumentsMethod

    public static Object invokeStaticNoArgumentsMethod(Class type, String methodName)

  - ### invokeConstructorOf

    public static Object invokeConstructorOf(String klass, Object arguments) throws ClassNotFoundException
    Throws:
      `ClassNotFoundException`

  - ### invokeNoArgumentsConstructorOf

    public static Object invokeNoArgumentsConstructorOf(Class type)

  - ### invokeClosure

    public static Object invokeClosure(Object closure, Object arguments)

  - ### asList

    public static List asList(Object value)

  - ### getAttribute

    public static Object getAttribute(Object object, String attribute)

  - ### setAttribute

    public static void setAttribute(Object object, String attribute, Object newValue)

  - ### getProperty

    public static Object getProperty(Object object, String property)

  - ### getPropertySafe

    public static Object getPropertySafe(Object object, String property)

  - ### setProperty

    public static void setProperty(Object object, String property, Object newValue)

  - ### setProperty2

    public static void setProperty2(Object newValue, Object object, String property)
    This is so we don't have to reorder the stack when we call this method. At some point a better name might be in order.

  - ### setGroovyObjectProperty

    public static void setGroovyObjectProperty(Object newValue, GroovyObject object, String property)
    This is so we don't have to reorder the stack when we call this method. At some point a better name might be in order.

  - ### getGroovyObjectProperty

    public static Object getGroovyObjectProperty(GroovyObject object, String property)

  - ### setPropertySafe2

    public static void setPropertySafe2(Object newValue, Object object, String property)
    This is so we don't have to reorder the stack when we call this method. At some point a better name might be in order.

  - ### getMethodPointer

    public static Closure getMethodPointer(Object object, String methodName)
    Returns a method closure for the given object and name.

  - ### unaryMinus

    public static Object unaryMinus(Object value)

  - ### unaryPlus

    public static Object unaryPlus(Object value)

  - ### findRegex

    public static Matcher findRegex(Object left, Object right)
    Find the right hand regex within the left hand string and return a matcher.
    Parameters:
      `left` - string to compare
      `right` - regular expression to compare the string to

  - ### matchRegex

    public static boolean matchRegex(Object left, Object right)
    Find the right hand regex within the left hand string and return a matcher.
    Parameters:
      `left` - string to compare
      `right` - regular expression to compare the string to

  - ### createTuple

    public static Tuple createTuple(Object[] array)

  - ### spreadMap

    public static SpreadMap spreadMap(Object value)

  - ### createList

    public static List createList(Object[] values)

  - ### initialCapacity

    public static int initialCapacity(int initialEntryCnt)
    According to the initial entry count, calculate the initial capacity of hash map, which is power of 2 (SEE https://stackoverflow.com/questions/8352378/why-does-hashmap-require-that-the-initial-capacity-be-a-power-of-two)
    Parameters:
      `initialEntryCnt` - the initial entry count
    Returns:
      the initial capacity

  - ### createMap

    public static Map createMap(Object[] values)

  - ### assertFailed

    public static void assertFailed(Object expression, Object message)

  - ### createAssertError

    public static AssertionError createAssertError(Object expression, Object message)
    Since:
      4.0.7

  - ### runScript

    public static Object runScript(Class scriptClass, String[] args)

  - ### createScript

    public static Script createScript(Class scriptClass, Binding context)

  - ### newScript

    public static Script newScript(Class<? extends Script> scriptClass, Binding context) throws InstantiationException, IllegalAccessException, InvocationTargetException, NoSuchMethodException
    Throws:
      `InstantiationException`
      `IllegalAccessException`
      `InvocationTargetException`
      `NoSuchMethodException`

  - ### setProperties

    public static void setProperties(Object object, Map map)
    Sets the properties on the given object

  - ### createRange

    public static List createRange(Object from, Object to, boolean exclusiveLeft, boolean exclusiveRight)

  - ### createRange

    public static List createRange(Object from, Object to, boolean inclusive)

  - ### bitwiseNegate

    public static Object bitwiseNegate(Object value)

  - ### getMetaRegistry

    public static MetaClassRegistry getMetaRegistry()

  - ### getMetaClass

    public static MetaClass getMetaClass(Object object)

  - ### getMetaClass

    public static MetaClass getMetaClass(Class cls)

  - ### invokeMethod

    public static Object invokeMethod(Object object, String methodName, Object arguments)
    Invokes the given method on the object.

  - ### invokeSuperMethod

    public static Object invokeSuperMethod(Object object, String methodName, Object arguments)

  - ### invokeStaticMethod

    public static Object invokeStaticMethod(Class type, String method, Object arguments)

  - ### invokeConstructorOf

    public static Object invokeConstructorOf(Class type, Object arguments)

  - ### asArray

    public static Object[] asArray(Object arguments)
    Converts the given object into an array; if it's an array then just cast otherwise wrap it in an array

  - ### asUnwrappedArray

    public static Object[] asUnwrappedArray(Object arguments)

  - ### asIterator

    public static Iterator<Object> asIterator(Object o)

  - ### toString

    @Deprecated public static String toString(Object arguments)
    Deprecated.

  - ### inspect

    @Deprecated public static String inspect(Object self)
    Deprecated.

  - ### write

    @Deprecated public static void write(Writer out, Object object) throws IOException
    Deprecated.
    Throws:
      `IOException`

  - ### append

    @Deprecated public static void append(Appendable out, Object object) throws IOException
    Deprecated.
    Throws:
      `IOException`

  - ### format

    @Deprecated protected static String format(Object arguments, boolean verbose)
    Deprecated.

  - ### format

    @Deprecated public static String format(Object arguments, boolean verbose, int maxSize)
    Deprecated.

  - ### format

    @Deprecated public static String format(Object arguments, boolean verbose, int maxSize, boolean safe)
    Deprecated.

  - ### escapeBackslashes

    @Deprecated public static String escapeBackslashes(String orig)
    Deprecated.

  - ### toTypeString

    @Deprecated public static String toTypeString(Object[] arguments)
    Deprecated.

  - ### toTypeString

    @Deprecated public static String toTypeString(Object[] arguments, int maxSize)
    Deprecated.

  - ### toMapString

    @Deprecated public static String toMapString(Map arg)
    Deprecated.

  - ### toMapString

    @Deprecated public static String toMapString(Map arg, int maxSize)
    Deprecated.

  - ### toListString

    @Deprecated public static String toListString(Collection arg)
    Deprecated.

  - ### toListString

    @Deprecated public static String toListString(Collection arg, int maxSize)
    Deprecated.

  - ### toListString

    @Deprecated public static String toListString(Collection arg, int maxSize, boolean safe)
    Deprecated.

  - ### toArrayString

    @Deprecated public static String toArrayString(Object[] arguments)
    Deprecated.

  - ### toArrayString

    @Deprecated public static String toArrayString(Object[] arguments, int maxSize, boolean safe)
    Deprecated.