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 Summary
Modifier and Type Method Description boolean
checkAccessible(Class<?> callerClass, Class<?> declaringClass, int memberModifiers, boolean allowIllegalAccess)
check whether the member can be accessed or notboolean
checkCanSetAccessible(AccessibleObject accessibleObject, Class<?> callerClass)
Check whether invokingAccessibleObject.setAccessible(boolean)
on the accessible object will be completed successfullyvoid
configureAnnotation(AnnotationNode an)
void
configureAnnotationNodeFromDefinition(AnnotationNode definition, AnnotationNode root)
void
configureClassNode(CompileUnit compileUnit, ClassNode classNode)
default Map<String,Set<String>>
getDefaultImportClasses(String[] packageNames)
Returns the default import classes: class name -> the relevant package namesObject
getInvokeSpecialHandle(Method m, Object receiver)
Returns a handle with bound receiver to invokeSpecial the given method.Class[]
getPluginDefaultGroovyMethods()
Class[]
getPluginStaticGroovyMethods()
int
getVersion()
Gives the version the plugin is made forvoid
invalidateCallSites()
Object
invokeHandle(Object handle, Object[] args)
Invokes a handle produced by #getInvokeSpecialdHandlevoid
setAdditionalClassInformation(ClassNode c)
MetaMethod
transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod)
transform meta method.MetaMethod
transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod, Class<?> caller)
transform meta methodboolean
trySetAccessible(AccessibleObject ao)
Set theaccessible
flag for this reflected object totrue
if possible.
-
Method Details
-
setAdditionalClassInformation
-
getPluginDefaultGroovyMethods
Class[] getPluginDefaultGroovyMethods() -
getPluginStaticGroovyMethods
Class[] getPluginStaticGroovyMethods() -
configureAnnotationNodeFromDefinition
-
configureAnnotation
-
configureClassNode
-
invalidateCallSites
void invalidateCallSites() -
getInvokeSpecialHandle
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
Invokes a handle produced by #getInvokeSpecialdHandle- Parameters:
handle
- the handleargs
- 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
-
checkCanSetAccessible
Check whether invokingAccessibleObject.setAccessible(boolean)
on the accessible object will be completed successfully- Parameters:
accessibleObject
- the accessible object to checkcallerClass
- the callerClass to invokesetAccessible
- 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 invokesetAccessible
declaringClass
- the type of member ownermemberModifiers
- modifiers of memberallowIllegalAccess
- whether to allow illegal access- Returns:
- the result of checking
-
trySetAccessible
Set theaccessible
flag for this reflected object totrue
if possible.- Parameters:
ao
- the accessible object- Returns:
true
if theaccessible
flag is set totrue
;false
if access cannot be enabled.- Throws:
SecurityException
- if the request is denied by the security manager
-
transformMetaMethod
transform meta method- Parameters:
metaClass
- meta classmetaMethod
- the original meta methodcaller
- caller class, whose method sets accessible for methods- Returns:
- the transformed meta method
-
transformMetaMethod
transform meta method.- Parameters:
metaClass
- meta classmetaMethod
- the original meta method- Returns:
- the transformed meta method
-
getDefaultImportClasses
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
-