[Java] Interface VMPlugin
public interface VMPlugin
Interface to access VM version based actions. This interface is for internal use only!
Methods Summary
Type Params | Return Type | Name and description |
---|---|---|
public boolean |
checkAccessible(Class<?> callerClass, Class<?> declaringClass, int memberModifiers, boolean allowIllegalAccess) check whether the member can be accessed or not | |
public boolean |
checkCanSetAccessible(AccessibleObject accessibleObject, Class<?> callerClass) Check whether invoking AccessibleObject.setAccessible on the accessible object will be completed successfully | |
public void |
configureAnnotation(AnnotationNode an) | |
public void |
configureAnnotationNodeFromDefinition(AnnotationNode definition, AnnotationNode root) | |
public void |
configureClassNode(CompileUnit compileUnit, ClassNode classNode) | |
public Map<String, Set<String>> |
getDefaultImportClasses(String[] packageNames) Returns the default import classes: class name -> the relevant package names | |
public Object |
getInvokeSpecialHandle(Method m, Object receiver) Returns a handle with bound receiver to invokeSpecial the given method. | |
public Class[] |
getPluginDefaultGroovyMethods() | |
public Class[] |
getPluginStaticGroovyMethods() | |
public int |
getVersion() Gives the version the plugin is made for | |
public void |
invalidateCallSites() | |
public Object |
invokeHandle(Object handle, Object[] args) Invokes a handle produced by #getInvokeSpecialdHandle | |
public void |
setAdditionalClassInformation(ClassNode c) | |
public MetaMethod |
transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod, Class<?> caller) transform meta method | |
public MetaMethod |
transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod) transform meta method. | |
public boolean |
trySetAccessible(AccessibleObject ao) Set the accessible flag for this reflected object to true if possible. |
Method Detail
public 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 owner -
memberModifiers
- modifiers of member -
allowIllegalAccess
- whether to allow illegal access
- Returns:
- the result of checking
public boolean checkCanSetAccessible(AccessibleObject accessibleObject, Class<?> callerClass)
Check whether invoking AccessibleObject.setAccessible on the accessible object will be completed successfully
- Parameters:
-
accessibleObject
- the accessible object to check -
callerClass
- the callerClass to invokesetAccessible
- Returns:
- the check result
public void configureAnnotation(AnnotationNode an)
public void configureAnnotationNodeFromDefinition(AnnotationNode definition, AnnotationNode root)
public void configureClassNode(CompileUnit compileUnit, ClassNode classNode)
public 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
public 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
public Class[] getPluginDefaultGroovyMethods()
public Class[] getPluginStaticGroovyMethods()
public int getVersion()
Gives the version the plugin is made for
- Returns:
- 7 for jdk7, 8 for jdk8, 9 for jdk9 or higher
public void invalidateCallSites()
public Object invokeHandle(Object handle, Object[] args)
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
public void setAdditionalClassInformation(ClassNode c)
public MetaMethod transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod, Class<?> caller)
transform meta method
- Parameters:
-
metaClass
- meta class -
metaMethod
- the original meta method -
caller
- caller class, whose method sets accessible for methods
- Returns:
- the transformed meta method
public MetaMethod transformMetaMethod(MetaClass metaClass, MetaMethod metaMethod)
transform meta method.
- Parameters:
-
metaClass
- meta class -
metaMethod
- the original meta method
- Returns:
- the transformed meta method
public boolean trySetAccessible(AccessibleObject ao)
Set the accessible
flag for this reflected object to true
if possible.
- throws:
- SecurityException if the request is denied by the security manager
- Parameters:
-
ao
- the accessible object
- Returns:
-
true
if theaccessible
flag is set totrue
;false
if access cannot be enabled.
© 2003-2020 The Apache Software Foundation
Licensed under the Apache license.
https://docs.groovy-lang.org/3.0.7/html/gapi/org/codehaus/groovy/vmplugin/VMPlugin.html