org.dynalang.dynalink.support

Class CallSiteDescriptorFactory

java.lang.Object

org.dynalang.dynalink.support.CallSiteDescriptorFactory

public class CallSiteDescriptorFactory
extends Object

Usable as a default factory for call site descriptor implementations. It is weakly canonicalizing, meaning it will return the same immutable call site descriptor for identical inputs, i.e. repeated requests for a descriptor signifying public lookup for "dyn:getProp:color" of type "Object(Object)" will return the same object as long as a previously created, at least softly reachable one exists. It also uses several different implementations of the CallSiteDescriptor internally, and chooses the most space-efficient one based on the input.

Author:

Attila Szegedi

Method Summary

Methods

Modifier and Type	Method and Description
static CallSiteDescriptor	create(MethodHandles.Lookup lookup, String name, MethodType methodType) Creates a new call site descriptor instance.
static String[]	tokenizeName(String name) Tokenizes the composite name along colons, as well as demangles and interns the tokens.
static List<String>	tokenizeOperators(CallSiteDescriptor desc) Tokenizes a composite operation name along pipe characters.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static CallSiteDescriptor create(MethodHandles.Lookup lookup,
                        String name,
                        MethodType methodType)

Creates a new call site descriptor instance. The actual underlying class of the instance is dependent on the passed arguments to be space efficient; i.e. if you only use the public lookup, you'll get back an implementation that doesn't waste space on storing the lookup object.

Parameters:

lookup - the lookup that determines access rights at the call site. If your language runtime doesn't have equivalents of Java access concepts, just use MethodHandles.publicLookup(). Must not be null.

name - the name of the method at the call site. Must not be null.

methodType - the type of the method at the call site. Must not be null.

Returns:

a call site descriptor representing the input. Note that although the method name is "create", it will in fact return a weakly-referenced canonical instance.

tokenizeName

public static String[] tokenizeName(String name)

Tokenizes the composite name along colons, as well as demangles and interns the tokens. The first two tokens are not demangled as they are supposed to be the naming scheme and the name of the operation which can be expected to consist of just alphabetical characters.

Parameters:

name - the composite name consisting of colon-separated, possibly mangled tokens.

Returns:

an array of tokens

tokenizeOperators

public static List<String> tokenizeOperators(CallSiteDescriptor desc)

Tokenizes a composite operation name along pipe characters. I.e. if you have a "dyn:getElem|getProp|getMethod" operation, returns a list of ["getElem", "getProp", "getMethod"]. The tokens are not interned.

Parameters:

desc - the call site descriptor with the operation

Returns:

a list of tokens