Modifier and Type	Class and Description
private static class	Selector.CastSelector Deprecated as a consequence of `Selector.MethodSelector` being deprecated.
private static class	Selector.InitSelector Deprecated as a consequence of `Selector.MethodSelector` being deprecated.
private static class	Selector.MethodSelector Deprecated as a consequence of `Selector` being deprecated. Method invocation based `Selector`.
private static class	Selector.PropertySelector Deprecated as a consequence of `Selector.MethodSelector` being deprecated.

Modifier and Type	Field and Description
public Object[]	args
public boolean	cache
private static final IndyInterface.CallType[]	CALL_TYPE_VALUES Cache values for read-only access
public MutableCallSite	callSite
public IndyInterface.CallType	callType
public boolean	catchException
public MethodType	currentType
public MethodHandle	handle
public boolean	isVargs
public MetaMethod	method
public String	name
public Object[]	originalArguments
public boolean	safeNavigation
public boolean	safeNavigationOrig
public Class<?>	selectionBase
public Class<?>	sender
public boolean	skipSpreadCollector
public boolean	spread
public MethodType	targetType
public boolean	thisCall
public boolean	useMetaClass

Access	Constructor and Description
public	Selector()

Modifier and Type	Method and Description
public Object	getCorrectedReceiver() Returns `NullObject#getNullObject()` if the receiver (args[0]) is null.
private static MetaClassImpl	getMetaClassImpl(MetaClass mc, boolean includeEMC) Returns the MetaClassImpl if the given MetaClass is one of MetaClassImpl, AdaptingMetaClass or ClosureMetaClass.
public static Selector	getSelector(MutableCallSite callSite, Class<?> sender, String methodName, int callID, boolean safeNavigation, boolean thisCall, boolean spreadCall, Object[] arguments) Deprecated as a consequence of `Selector` being deprecated. Returns the Selector
private static boolean	isStatic(Method m) Returns if a method is static
private static Object[]	removeRealReceiver(Object[] args) Helper method to remove the receiver from the argument array by producing a new array.
pack-priv abstract void	setCallSiteTarget()
private static Object[]	spread(Object[] args, boolean spreadCall) Helper method to transform the given arguments, consisting of the receiver and the actual arguments in an Object[], into a new Object[] consisting of the receiver and the arguments directly.
private static Object	unwrapIfWrapped(Object object) Unwraps the given object from a `Wrapper`.

args	back to summary
public Object[] args

cache	back to summary
public boolean cache

CALL_TYPE_VALUES	back to summary
private static final IndyInterface.CallType[] CALL_TYPE_VALUES Cache values for read-only access

callSite	back to summary
public MutableCallSite callSite

callType	back to summary
public IndyInterface.CallType callType

catchException	back to summary
public boolean catchException

currentType	back to summary
public MethodType currentType

handle	back to summary
public MethodHandle handle

isVargs	back to summary
public boolean isVargs

method	back to summary
public MetaMethod method

name	back to summary
public String name

originalArguments	back to summary
public Object[] originalArguments

selectionBase	back to summary
public Class<?> selectionBase

sender	back to summary
public Class<?> sender

skipSpreadCollector	back to summary
public boolean skipSpreadCollector

spread	back to summary
public boolean spread

targetType	back to summary
public MethodType targetType

thisCall	back to summary
public boolean thisCall

useMetaClass	back to summary
public boolean useMetaClass

Selector	back to summary
public Selector()

Method Detail

getCorrectedReceiver	back to summary
public Object getCorrectedReceiver() Returns `NullObject#getNullObject()` if the receiver (args[0]) is null. If it is not null, the recevier itself is returned.

getMetaClassImpl	back to summary
private static MetaClassImpl getMetaClassImpl(MetaClass mc, boolean includeEMC) Returns the MetaClassImpl if the given MetaClass is one of MetaClassImpl, AdaptingMetaClass or ClosureMetaClass. If none of these cases matches, this method returns null.

getSelector	back to summary
public static Selector getSelector(MutableCallSite callSite, Class<?> sender, String methodName, int callID, boolean safeNavigation, boolean thisCall, boolean spreadCall, Object[] arguments) Deprecated as a consequence of `Selector` being deprecated. See corresponding docs for further information. Returns the Selector

isStatic	back to summary
private static boolean isStatic(Method m) Returns if a method is static

removeRealReceiver	back to summary
private static Object[] removeRealReceiver(Object[] args) Helper method to remove the receiver from the argument array by producing a new array.

setCallSiteTarget	back to summary
pack-priv abstract void setCallSiteTarget()

spread	back to summary
private static Object[] spread(Object[] args, boolean spreadCall) Helper method to transform the given arguments, consisting of the receiver and the actual arguments in an Object[], into a new Object[] consisting of the receiver and the arguments directly. Before the size of args was always 2, the returned Object[] will have a size of 1+n, where n is the number arguments.

unwrapIfWrapped	back to summary
private static Object unwrapIfWrapped(Object object) Unwraps the given object from a `Wrapper`. If not wrapped, the given object is returned.

org.codehaus.groovy.vmplugin.v7 back to summary

private Class Selector.CastSelector

Class Inheritance

extends MethodSelector

java.lang.Object
org.codehaus.groovy.vmplugin.v7.Selector
org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector
org.codehaus.groovy.vmplugin.v7.Selector.CastSelector

Deprecated

as a consequence of Selector.MethodSelector being deprecated. See corresponding docs for further information.

Field Summary

Modifier and Type	Field and Description
private final Class<?>	staticSourceType
private final Class<?>	staticTargetType

Inherited from org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector:: mc

Constructor Summary

Access	Constructor and Description
public	CastSelector(MutableCallSite callSite, Object[] arguments)

Method Summary

Modifier and Type	Method and Description
private void	castAndSetGuards()
private void	castToTypeFallBack()
private void	handleBoolean()
private void	handleCollections()
private void	handleInstanceCase()
private void	handleNullWithoutBoolean()
private void	handleSAM()
private static boolean	isAbstractClassOf(Class<?> toTest, Class<?> givenOnCallSite)
public void	setCallSiteTarget() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setCallSiteTarget. setting a call site target consists of the following steps: # get the meta class # select a method/constructor/property from it, if it is a MetaClassImpl # make a handle out of the selection # if nothing could be selected select a path through the given MetaClass or the GroovyObject # apply transformations for vargs, implicit null argument, coercion, wrapping, null receiver and spreading

Inherited from org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector:: addExceptionHandler chooseMeta correctCoerce correctNullReceiver correctParameterLength correctSpreading correctWrapping doCallSiteTargetSet getMetaClass setGuards setHandleForMetaMethod setInterceptor setMetaClassCallHandleIfNeeded setNullForSafeNavigation setSelectionBase

Field Detail

staticSourceType	back to summary
private final Class<?> staticSourceType

staticTargetType	back to summary
private final Class<?> staticTargetType

Constructor Detail

CastSelector	back to summary
public CastSelector(MutableCallSite callSite, Object[] arguments)

Method Detail

castAndSetGuards	back to summary
private void castAndSetGuards()

castToTypeFallBack	back to summary
private void castToTypeFallBack()

handleBoolean	back to summary
private void handleBoolean()

handleCollections	back to summary
private void handleCollections()

handleInstanceCase	back to summary
private void handleInstanceCase()

handleNullWithoutBoolean	back to summary
private void handleNullWithoutBoolean()

handleSAM	back to summary
private void handleSAM()

isAbstractClassOf	back to summary
private static boolean isAbstractClassOf(Class<?> toTest, Class<?> givenOnCallSite)

setCallSiteTarget	back to summary
public void setCallSiteTarget() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setCallSiteTarget. Doc from org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setCallSiteTarget. setting a call site target consists of the following steps: # get the meta class # select a method/constructor/property from it, if it is a MetaClassImpl # make a handle out of the selection # if nothing could be selected select a path through the given MetaClass or the GroovyObject # apply transformations for vargs, implicit null argument, coercion, wrapping, null receiver and spreading Annotations @Override

setCallSiteTarget

back to summary

public void setCallSiteTarget()

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setCallSiteTarget.

Doc from org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setCallSiteTarget.

setting a call site target consists of the following steps: # get the meta class # select a method/constructor/property from it, if it is a MetaClassImpl # make a handle out of the selection # if nothing could be selected select a path through the given MetaClass or the GroovyObject # apply transformations for vargs, implicit null argument, coercion, wrapping, null receiver and spreading

Annotations

@Override

org.codehaus.groovy.vmplugin.v7 back to summary

private Class Selector.InitSelector

Class Inheritance

extends MethodSelector

java.lang.Object
org.codehaus.groovy.vmplugin.v7.Selector
org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector
org.codehaus.groovy.vmplugin.v7.Selector.InitSelector

Deprecated

as a consequence of Selector.MethodSelector being deprecated. See corresponding docs for further information.

Field Summary

Modifier and Type	Field and Description
private boolean	beanConstructor

Inherited from org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector:: mc

Constructor Summary

Access	Constructor and Description
public	InitSelector(MutableCallSite callSite, Class<?> sender, String methodName, IndyInterface.CallType callType, boolean safeNavigation, boolean thisCall, boolean spreadCall, Object[] arguments)

Method Summary

Modifier and Type	Method and Description
public void	chooseMeta(MetaClassImpl mci) Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.chooseMeta. This method chooses a constructor from the meta class.
public void	correctCoerce() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.correctCoerce. In case of a bean constructor we don't do any coercion, otherwise we do the same as for `MethodSelector#correctCoerce()`
public void	correctParameterLength() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.correctParameterLength. In case of a bean constructor we don't do any varags or implicit null argument transformations.
public MetaClass	getMetaClass() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.getMetaClass. For a constructor call we always use the static meta class from the registry
public void	setHandleForMetaMethod() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setHandleForMetaMethod. Adds `MetaConstructor` handling.
public boolean	setInterceptor() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setInterceptor. Constructor calls are not intercepted, thus always returns false.
public void	setMetaClassCallHandleIfNeeded(boolean standardMetaClass) Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setMetaClassCallHandleIfNeeded. Set MOP based constructor invocation path.

Inherited from org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector:: addExceptionHandler correctNullReceiver correctSpreading correctWrapping doCallSiteTargetSet setCallSiteTarget setGuards setNullForSafeNavigation setSelectionBase

Field Detail

beanConstructor	back to summary
private boolean beanConstructor

Constructor Detail

InitSelector	back to summary
public InitSelector(MutableCallSite callSite, Class<?> sender, String methodName, IndyInterface.CallType callType, boolean safeNavigation, boolean thisCall, boolean spreadCall, Object[] arguments)

Method Detail

chooseMeta

back to summary

public void chooseMeta(MetaClassImpl mci)

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.chooseMeta.

This method chooses a constructor from the meta class.

Annotations

@Override

correctCoerce back to summary

public void correctCoerce()

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.correctCoerce.

In case of a bean constructor we don't do any coercion, otherwise we do the same as for MethodSelector#correctCoerce()

Annotations

@Override

correctParameterLength back to summary

public void correctParameterLength()

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.correctParameterLength.

In case of a bean constructor we don't do any varags or implicit null argument transformations. Otherwise we do the same as for MethodSelector#correctParameterLength()

Annotations

@Override

getMetaClass

back to summary

public MetaClass getMetaClass()

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.getMetaClass.

For a constructor call we always use the static meta class from the registry

Annotations

@Override

setHandleForMetaMethod back to summary

public void setHandleForMetaMethod()

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setHandleForMetaMethod.

Adds MetaConstructor handling.

Annotations

@Override

setInterceptor

back to summary

public boolean setInterceptor()

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setInterceptor.

Constructor calls are not intercepted, thus always returns false.

Annotations

@Override

setMetaClassCallHandleIfNeeded

back to summary

public void setMetaClassCallHandleIfNeeded(boolean standardMetaClass)

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setMetaClassCallHandleIfNeeded.

Set MOP based constructor invocation path.

Annotations

@Override

org.codehaus.groovy.vmplugin.v7 back to summary

private Class Selector.MethodSelector

Class Inheritance

extends Selector

java.lang.Object
org.codehaus.groovy.vmplugin.v7.Selector
org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector

Known Direct Subclasses

org.codehaus.groovy.vmplugin.v7.Selector.CastSelector, org.codehaus.groovy.vmplugin.v7.Selector.PropertySelector, org.codehaus.groovy.vmplugin.v7.Selector.InitSelector

Deprecated

as a consequence of Selector being deprecated. See corresponding docs for further information.

Method invocation based Selector. This Selector is called for method invocations and is base for cosntructor calls as well as getProperty calls.

Field Summary

Modifier and Type	Field and Description
private boolean	isCategoryMethod
protected MetaClass	mc
private static final Object[]	SINGLE_NULL_ARRAY

Constructor Summary

Access	Constructor and Description
public	MethodSelector(MutableCallSite callSite, Class<?> sender, String methodName, IndyInterface.CallType callType, Boolean safeNavigation, Boolean thisCall, Boolean spreadCall, Object[] arguments)

Method Summary

Modifier and Type	Method and Description
public void	addExceptionHandler() Adds the standard exception handler.
public void	chooseMeta(MetaClassImpl mci) Uses the meta class to get a meta method for a method call.
private MethodHandle	correctClassForNameAndUnReflectOtherwise(Method m)
public void	correctCoerce() There are some conversions we have to do explicitly.
public void	correctNullReceiver() Gives a replacement receiver for null.
public void	correctParameterLength() Handles cases in which we have to correct the length of arguments using the parameters.
public void	correctSpreading()
public void	correctWrapping() Corrects method argument wrapping.
public void	doCallSiteTargetSet() do the actual call site target set, if the call is supposed to be cached
public MetaClass	getMetaClass() Gives the meta class to an Object.
private MethodType	removeWrapper(MethodType targetType) Helper method to manipulate the given type to replace Wrapper with Object.
public void	setCallSiteTarget() Implements abstract org.codehaus.groovy.vmplugin.v7.Selector.setCallSiteTarget. setting a call site target consists of the following steps: # get the meta class # select a method/constructor/property from it, if it is a MetaClassImpl # make a handle out of the selection # if nothing could be selected select a path through the given MetaClass or the GroovyObject # apply transformations for vargs, implicit null argument, coercion, wrapping, null receiver and spreading
public void	setGuards(Object receiver) Sets all argument and receiver guards.
public void	setHandleForMetaMethod() Creates a MethodHandle using a before selected MetaMethod.
public boolean	setInterceptor() Sets a handle to call `GroovyInterceptable#invokeMethod(String, Object)`
public void	setMetaClassCallHandleIfNeeded(boolean standardMetaClass) Creates a MethodHandle, which will use the meta class path.
public boolean	setNullForSafeNavigation() Sets the null constant for safe navigation.
public void	setSelectionBase() Sets the selection base.

Inherited from org.codehaus.groovy.vmplugin.v7.Selector:: getCorrectedReceiver getSelector

Field Detail

isCategoryMethod	back to summary
private boolean isCategoryMethod

mc	back to summary
protected MetaClass mc

SINGLE_NULL_ARRAY	back to summary
private static final Object[] SINGLE_NULL_ARRAY

Constructor Detail

MethodSelector	back to summary
public MethodSelector(MutableCallSite callSite, Class<?> sender, String methodName, IndyInterface.CallType callType, Boolean safeNavigation, Boolean thisCall, Boolean spreadCall, Object[] arguments)

Method Detail

addExceptionHandler	back to summary
public void addExceptionHandler() Adds the standard exception handler.

chooseMeta	back to summary
public void chooseMeta(MetaClassImpl mci) Uses the meta class to get a meta method for a method call. There will be no meta method selected, if the meta class is no MetaClassImpl or the meta class is an AdaptingMetaClass.

correctClassForNameAndUnReflectOtherwise	back to summary
private MethodHandle correctClassForNameAndUnReflectOtherwise(Method m) throws IllegalAccessException

correctCoerce	back to summary
public void correctCoerce() There are some conversions we have to do explicitly. These are GString to String, Number to Byte and Number to BigInteger conversions.

correctNullReceiver	back to summary
public void correctNullReceiver() Gives a replacement receiver for null. In case of the receiver being null we want to do the method invocation on NullObject instead.

correctParameterLength	back to summary
public void correctParameterLength() Handles cases in which we have to correct the length of arguments using the parameters. This might be needed for vargs and for one parameter calls without arguments (null is used then).

correctSpreading	back to summary
public void correctSpreading()

correctWrapping	back to summary
public void correctWrapping() Corrects method argument wrapping. In cases in which we want to force a certain method selection we use Wrapper classes to transport the static type information. This method will be used to undo the wrapping.

doCallSiteTargetSet	back to summary
public void doCallSiteTargetSet() do the actual call site target set, if the call is supposed to be cached

getMetaClass	back to summary
public MetaClass getMetaClass() Gives the meta class to an Object.

removeWrapper	back to summary
private MethodType removeWrapper(MethodType targetType) Helper method to manipulate the given type to replace Wrapper with Object.

setCallSiteTarget

back to summary

public void setCallSiteTarget()

Implements abstract org.codehaus.groovy.vmplugin.v7.Selector.setCallSiteTarget.

Annotations

@Override

setGuards	back to summary
public void setGuards(Object receiver) Sets all argument and receiver guards.

setHandleForMetaMethod	back to summary
public void setHandleForMetaMethod() Creates a MethodHandle using a before selected MetaMethod. If the MetaMethod has reflective information available, then we will use that information to create the target MethodHandle. If that is not the case we will produce a handle, which will use the MetaMethod itself for invocation.

setInterceptor	back to summary
public boolean setInterceptor() Sets a handle to call `GroovyInterceptable#invokeMethod(String, Object)`

setMetaClassCallHandleIfNeeded	back to summary
public void setMetaClassCallHandleIfNeeded(boolean standardMetaClass) Creates a MethodHandle, which will use the meta class path. This method is called only if no handle has been created before. This is usually the case if the method selection failed.

setNullForSafeNavigation	back to summary
public boolean setNullForSafeNavigation() Sets the null constant for safe navigation. In case of foo?.bar() and foo being null, we don't call the method, instead we simply return null. This produces a handle, which will return the constant.

setSelectionBase	back to summary
public void setSelectionBase() Sets the selection base.

org.codehaus.groovy.vmplugin.v7 back to summary

private Class Selector.PropertySelector

Class Inheritance

extends MethodSelector

java.lang.Object
org.codehaus.groovy.vmplugin.v7.Selector
org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector
org.codehaus.groovy.vmplugin.v7.Selector.PropertySelector

Deprecated

as a consequence of Selector.MethodSelector being deprecated. See corresponding docs for further information.

Field Summary

Modifier and Type	Field and Description
private boolean	insertName

Inherited from org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector:: mc

Constructor Summary

Access	Constructor and Description
public	PropertySelector(MutableCallSite callSite, Class<?> sender, String methodName, IndyInterface.CallType callType, boolean safeNavigation, boolean thisCall, boolean spreadCall, Object[] arguments)

Method Summary

Modifier and Type	Method and Description
public void	chooseMeta(MetaClassImpl mci) Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.chooseMeta. this method chooses a property from the meta class.
private boolean	isMarkedInternal(Method reflectionMethod)
public void	setHandleForMetaMethod() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setHandleForMetaMethod. Additionally to the normal `MethodSelector#setHandleForMetaMethod()` task we have to also take care of generic getter methods, that depend one the name.
public boolean	setInterceptor() Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setInterceptor. We never got the interceptor path with a property get
public void	setMetaClassCallHandleIfNeeded(boolean standardMetaClass) Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setMetaClassCallHandleIfNeeded. The MOP requires all get property operations to go through `GroovyObject#getProperty(String)`.

Inherited from org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector:: addExceptionHandler correctCoerce correctNullReceiver correctParameterLength correctSpreading correctWrapping doCallSiteTargetSet getMetaClass setCallSiteTarget setGuards setNullForSafeNavigation setSelectionBase

Field Detail

insertName	back to summary
private boolean insertName

Constructor Detail

PropertySelector	back to summary
public PropertySelector(MutableCallSite callSite, Class<?> sender, String methodName, IndyInterface.CallType callType, boolean safeNavigation, boolean thisCall, boolean spreadCall, Object[] arguments)

Method Detail

chooseMeta

back to summary

public void chooseMeta(MetaClassImpl mci)

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.chooseMeta.

this method chooses a property from the meta class.

Annotations

@Override

isMarkedInternal	back to summary
private boolean isMarkedInternal(Method reflectionMethod)

setHandleForMetaMethod back to summary

public void setHandleForMetaMethod()

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setHandleForMetaMethod.

Additionally to the normal MethodSelector#setHandleForMetaMethod() task we have to also take care of generic getter methods, that depend one the name.

Annotations

@Override

setInterceptor

back to summary

public boolean setInterceptor()

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setInterceptor.

We never got the interceptor path with a property get

Annotations

@Override

setMetaClassCallHandleIfNeeded back to summary

public void setMetaClassCallHandleIfNeeded(boolean standardMetaClass)

Overrides org.codehaus.groovy.vmplugin.v7.Selector.MethodSelector.setMetaClassCallHandleIfNeeded.

The MOP requires all get property operations to go through GroovyObject#getProperty(String). We do this in case no property was found before.

Annotations

@Override

public abstract Class Selector

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Selector.CastSelector

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Selector.InitSelector

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Selector.MethodSelector

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Selector.PropertySelector

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail