Package org.codehaus.groovy.vmplugin
Interface VMPlugin
public interface VMPlugin
Interface to access VM version based actions.
 This interface is for internal use only!
- 
Method SummaryModifier and TypeMethodDescriptionbooleancheckAccessible(Class<?> callerClass, Class<?> declaringClass, int memberModifiers, boolean allowIllegalAccess) check whether the member can be accessed or notbooleancheckCanSetAccessible(AccessibleObject accessibleObject, Class<?> callerClass) Check whether invokingAccessibleObject.setAccessible(boolean)on the accessible object will be completed successfullyvoidvoidconfigureAnnotationNodeFromDefinition(AnnotationNode definition, AnnotationNode root) voidconfigureClassNode(CompileUnit compileUnit, ClassNode classNode) <T> TdoPrivileged(PrivilegedAction<T> action) Deprecated.<T> TdoPrivileged(PrivilegedExceptionAction<T> action) Deprecated.getDefaultImportClasses(String[] packageNames) Returns the default import classes: class name -> the relevant package namesgetInvokeSpecialHandle(Method m, Object receiver) Returns a handle with bound receiver to invokeSpecial the given method.static StringDeprecated.Class[]Class[]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.intGives the version the plugin is made forvoidinvokeHandle(Object handle, Object[] args) Invokes a handle produced by #getInvokeSpecialdHandlevoidtransformMetaMethod(MetaClass metaClass, MetaMethod metaMethod) transform meta method.transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod, Class<?> caller) transform meta methodbooleanSet theaccessibleflag for this reflected object totrueif possible.
- 
Method Details- 
setAdditionalClassInformation
- 
getPluginDefaultGroovyMethodsClass[] getPluginDefaultGroovyMethods()
- 
getPluginStaticGroovyMethodsClass[] getPluginStaticGroovyMethods()
- 
configureAnnotationNodeFromDefinition
- 
configureAnnotation
- 
configureClassNode
- 
invalidateCallSitesvoid invalidateCallSites()
- 
getInvokeSpecialHandleReturns 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
 
- 
invokeHandleInvokes 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
 
- 
getVersionint getVersion()Gives the version the plugin is made for- Returns:
- 7 for jdk7, 8 for jdk8, 9 for jdk9 or higher
 
- 
getJavaVersionDeprecated.Returns java version, e.g. 1.8, 9, 11, 17- Returns:
- java version
- Since:
- 4.0.0
 
- 
checkCanSetAccessibleCheck whether invokingAccessibleObject.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
 
- 
checkAccessibleboolean 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
 
- 
trySetAccessibleSet theaccessibleflag for this reflected object totrueif possible.- Parameters:
- ao- the accessible object
- Returns:
- trueif the- accessibleflag is set to- true;- falseif access cannot be enabled.
- Throws:
- SecurityException- if the request is denied by the security manager
 
- 
transformMetaMethodtransform meta method- Parameters:
- metaClass- metaclass
- metaMethod- the original meta method
- caller- caller class, whose method sets accessible for methods
- Returns:
- the transformed meta method
 
- 
doPrivilegedDeprecated.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
 
- 
transformMetaMethodtransform meta method.- Parameters:
- metaClass- metaclass
- metaMethod- the original meta method
- Returns:
- the transformed meta method
 
- 
getDefaultImportClassesReturns 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
 
- 
getRecordComponentNamesReturns 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
 
 
-