Package org.codehaus.groovy.vmplugin

# Interface VMPlugin

All Known Implementing Classes:
  `Java10`, `Java16`, `Java8`, `Java9`

public interface VMPlugin
Interface to access VM version based actions. This interface is for internal use only!

- ## Method Summary

  Modifier and Type
  Method
  Description
  `boolean`
  `checkAccessible(Class<?> callerClass, Class<?> declaringClass, int memberModifiers, boolean allowIllegalAccess)`
  check whether the member can be accessed or not
  `boolean`
  `checkCanSetAccessible(AccessibleObject accessibleObject, Class<?> callerClass)`
  Check whether invoking `AccessibleObject.setAccessible(boolean)` on the accessible object will be completed successfully
  `void`
  `configureAnnotation(AnnotationNode an)`
  `void`
  `configureAnnotationNodeFromDefinition(AnnotationNode definition, AnnotationNode root)`
  `void`
  `configureClassNode(CompileUnit compileUnit, ClassNode classNode)`
  `<T> T`
  `doPrivileged(PrivilegedAction<T> action)`
  Deprecated.
  `<T> T`
  `doPrivileged(PrivilegedExceptionAction<T> action)`
  Deprecated.
  `default Map<String,Set<String>>`
  `getDefaultImportClasses(String[] packageNames)`
  Returns the default import classes: class name -> the relevant package names
  `Object`
  `getInvokeSpecialHandle(Method m, Object receiver)`
  Returns a handle with bound receiver to invokeSpecial the given method.
  `static String`
  `getJavaVersion()`
  Returns java version, e.g.
  `Class[]`
  `getPluginDefaultGroovyMethods()`
  `Class[]`
  `getPluginStaticGroovyMethods()`
  `default List<String>`
  `getRecordComponentNames(Class<?> maybeRecord)`
  Returns the list of record component names or the empty list if the class is not a record or running on a pre16 JDK.
  `int`
  `getVersion()`
  Gives the version the plugin is made for
  `void`
  `invalidateCallSites()`
  `Object`
  `invokeHandle(Object handle, Object[] args)`
  Invokes a handle produced by #getInvokeSpecialdHandle
  `void`
  `setAdditionalClassInformation(ClassNode c)`
  `MetaMethod`
  `transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod)`
  transform meta method.
  `MetaMethod`
  `transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod, Class<?> caller)`
  transform meta method
  `boolean`
  `trySetAccessible(AccessibleObject ao)`
  Set the `accessible` flag for this reflected object to `true` if possible.

- ## Method Details

  - ### setAdditionalClassInformation

    void setAdditionalClassInformation(ClassNode c)

  - ### getPluginDefaultGroovyMethods

    Class[] getPluginDefaultGroovyMethods()

  - ### getPluginStaticGroovyMethods

    Class[] getPluginStaticGroovyMethods()

  - ### configureAnnotationNodeFromDefinition

    void configureAnnotationNodeFromDefinition(AnnotationNode definition, AnnotationNode root)

  - ### configureAnnotation

    void configureAnnotation(AnnotationNode an)

  - ### configureClassNode

    void configureClassNode(CompileUnit compileUnit, ClassNode classNode)

  - ### invalidateCallSites

    void invalidateCallSites()

  - ### getInvokeSpecialHandle

    Object getInvokeSpecialHandle(Method m, Object receiver)
    Returns a handle with bound receiver to invokeSpecial the given method. This method will require at least Java 7, but since the source has to compile on older Java versions as well it is not marked to return a MethodHandle and uses Object instead
    Returns:
      null in case of jdk<7, otherwise a handle that takes the method call arguments for the invokespecial call

  - ### invokeHandle

    Object invokeHandle(Object handle, Object[] args) throws Throwable
    Invokes a handle produced by #getInvokeSpecialdHandle
    Parameters:
      `handle` - the handle
      `args` - arguments for the method call, can be empty but not null
    Returns:
      the result of the method call
    Throws:
      `Throwable`

  - ### getVersion

    int getVersion()
    Gives the version the plugin is made for
    Returns:
      7 for jdk7, 8 for jdk8, 9 for jdk9 or higher

  - ### getJavaVersion

    static String getJavaVersion()
    Returns java version, e.g. 1.8, 9, 11, 17
    Returns:
      java version
    Since:
      4.0.0

  - ### checkCanSetAccessible

    boolean checkCanSetAccessible(AccessibleObject accessibleObject, Class<?> callerClass)
    Check whether invoking `AccessibleObject.setAccessible(boolean)` on the accessible object will be completed successfully
    Parameters:
      `accessibleObject` - the accessible object to check
      `callerClass` - the callerClass to invoke `setAccessible`
    Returns:
      the check result

  - ### checkAccessible

    boolean checkAccessible(Class<?> callerClass, Class<?> declaringClass, int memberModifiers, boolean allowIllegalAccess)
    check whether the member can be accessed or not
    Parameters:
      `callerClass` - callerClass the callerClass to invoke `setAccessible`
      `declaringClass` - the type of member owner
      `memberModifiers` - modifiers of member
      `allowIllegalAccess` - whether to allow illegal access
    Returns:
      the result of checking

  - ### trySetAccessible

    boolean trySetAccessible(AccessibleObject ao)
    Set the `accessible` flag for this reflected object to `true` if possible.
    Parameters:
      `ao` - the accessible object
    Returns:
      `true` if the `accessible` flag is set to `true`; `false` if access cannot be enabled.
    Throws:
      `SecurityException` - if the request is denied by the security manager

  - ### transformMetaMethod

    MetaMethod transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod, Class<?> caller)
    transform meta method
    Parameters:
      `metaClass` - metaclass
      `metaMethod` - the original meta method
      `caller` - caller class, whose method sets accessible for methods
    Returns:
      the transformed meta method

  - ### doPrivileged

    @Deprecated <T> T doPrivileged(PrivilegedAction<T> action)
    Deprecated.
    Performs the specified PrivilegedAction with privileges enabled on platforms which support that capability, otherwise the action is performed ignoring privileges.
    Type Parameters:
      `T` - the type of the value returned by the PrivilegedAction's run method
    Parameters:
      `action` - the action to be performed
    Returns:
      the value returned by the action's run method

  - ### doPrivileged

    @Deprecated <T> T doPrivileged(PrivilegedExceptionAction<T> action) throws PrivilegedActionException
    Deprecated.
    Performs the specified PrivilegedExceptionAction with privileges enabled on platforms which support that capability, otherwise the action is performed ignoring privileges.
    Type Parameters:
      `T` - the type of the value returned by the PrivilegedAction's run method
    Parameters:
      `action` - the action to be performed
    Returns:
      the value returned by the action's run method
    Throws:
      `PrivilegedActionException`

  - ### transformMetaMethod

    MetaMethod transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod)
    transform meta method.
    Parameters:
      `metaClass` - metaclass
      `metaMethod` - the original meta method
    Returns:
      the transformed meta method

  - ### getDefaultImportClasses

    default Map<String,Set<String>> getDefaultImportClasses(String[] packageNames)
    Returns the default import classes: class name -> the relevant package names
    Parameters:
      `packageNames` - the default import package names, e.g. java.lang.
    Returns:
      the default import classes
    Since:
      3.0.2

  - ### getRecordComponentNames

    @Incubating default List<String> getRecordComponentNames(Class<?> maybeRecord)
    Returns the list of record component names or the empty list if the class is not a record or running on a pre16 JDK.
    Parameters:
      `maybeRecord` - the class in question
    Returns:
      the default list of names
    Since:
      4.0.15