Modifier and Type	Class and Description
public static class	InvokerUtils.Arg
public static interface	InvokerUtils.ParamIdentifier
private static class	InvokerUtils.ParamIdentity

Modifier and Type	Field and Description
private static final Logger	LOG
public static final InvokerUtils.ParamIdentifier	PARAM_IDENTITY

Access	Constructor and Description
public	InvokerUtils()

Method Summary

Modifier and Type	Method and Description
private static void	appendTypeList(StringBuilder str, InvokerUtils.Arg[] args)
public static MethodHandle	Returns: the bound MethodHandle, or null if the provided `methodHandle` was null. bindTo(MethodHandle the method handle to bind to methodHandle, Object... the list of optional objects to bind to. objs) Bind optional arguments to provided method handle
public static MethodHandle	mutatedInvoker(MethodHandles.Lookup the `java.lang.invoke.MethodHandles.Lookup` instance to use. lookup, Class<?> the target class for invocations of the resulting MethodHandle (also known as parameter 0) targetClass, Method the method to invoke method, InvokerUtils.Arg... the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the `MethodHandle#type()` in the order specified in this array. callingArgs) Build a MethodHandle that can call the method with the calling args provided.
public static MethodHandle	Returns: the MethodHandle for this set of CallingArgs mutatedInvoker(MethodHandles.Lookup the `java.lang.invoke.MethodHandles.Lookup` instance to use. lookup, Class<?> the target class for invocations of the resulting MethodHandle (also known as parameter 0) targetClass, Method the method to invoke method, InvokerUtils.ParamIdentifier the mechanism to identify parameters in method paramIdentifier, String[] the array of named variables. This is the array of named arguments that the target method might have. The resulting MethodHandle will include all of these namedVariables as the first non-object arguments in the `MethodType` found on the returned `MethodHandle#type()` namedVariables, InvokerUtils.Arg... the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the `MethodHandle#type()` in the order specified in this array. callingArgs) Create a MethodHandle that performs the following layers `MethodHandles#permuteArguments(MethodHandle, MethodType, int...)` - moving calling Args around to fit actual actual method parameter arguments (in proper order), with remaining (unused) calling args afterwords `MethodHandles#dropArguments(MethodHandle, int, Class[])` - to drop the unused calling args `MethodHandle#invoke(Object...)` - to call the specific method
private static MethodHandle	mutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, boolean throwOnFailure, Method method, InvokerUtils.ParamIdentifier paramIdentifier, String[] namedVariables, InvokerUtils.Arg... rawCallingArgs)
public static MethodHandle	Returns: the MethodHandle for this set of CallingArgs, or null if not possible to create MethodHandle with CallingArgs to provided method optionalMutatedInvoker(MethodHandles.Lookup the `java.lang.invoke.MethodHandles.Lookup` instance to use. lookup, Class<?> the target class for invocations of the resulting MethodHandle (also known as parameter 0) targetClass, Method the method to invoke method, InvokerUtils.ParamIdentifier the mechanism to identify parameters in method paramIdentifier, String[] the array of named variables. This is the array of named arguments that the target method might have. The resulting MethodHandle will include all of these namedVariables as the first non-object arguments in the `MethodType` found on the returned `MethodHandle#type()` namedVariables, InvokerUtils.Arg... the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the `MethodHandle#type()` in the order specified in this array. callingArgs) Create an optional MethodHandle that performs the following layers.
public static MethodHandle	optionalMutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, Method method, InvokerUtils.Arg... callingArgs)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

LOG	back to summary
private static final Logger LOG

PARAM_IDENTITY	back to summary
public static final InvokerUtils.ParamIdentifier PARAM_IDENTITY

Constructor Detail

InvokerUtils	back to summary
public InvokerUtils()

Method Detail

appendTypeList	back to summary
private static void appendTypeList(StringBuilder str, InvokerUtils.Arg[] args)

bindTo back to summary

bindTo	back to summary
public static MethodHandle bindTo(MethodHandle methodHandle, Object... objs) Bind optional arguments to provided method handle Parameters methodHandle:MethodHandle the method handle to bind to objs:Object[] the list of optional objects to bind to. Returns:MethodHandle the bound MethodHandle, or null if the provided `methodHandle` was null.

public static MethodHandle bindTo(MethodHandle methodHandle, Object... objs)

Bind optional arguments to provided method handle

Parameters

methodHandle:MethodHandle: the method handle to bind to
objs:Object[]: the list of optional objects to bind to.

Returns:MethodHandle

the bound MethodHandle, or null if the provided methodHandle was null.

mutatedInvoker back to summary

mutatedInvoker	back to summary
public static MethodHandle mutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, Method method, InvokerUtils.Arg... callingArgs) Build a MethodHandle that can call the method with the calling args provided. Might need to drop calling args and/or reorder the calling args to fit the actual method being called. Parameters lookup:MethodHandles.Lookup the `java.lang.invoke.MethodHandles.Lookup` instance to use. targetClass:Class<?> the target class for invocations of the resulting MethodHandle (also known as parameter 0) method:Method the method to invoke callingArgs:InvokerUtils.Arg[] the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the `MethodHandle#type()` in the order specified in this array.

public static MethodHandle mutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, Method method, InvokerUtils.Arg... callingArgs)

Build a MethodHandle that can call the method with the calling args provided.

Might need to drop calling args and/or reorder the calling args to fit the actual method being called.

Parameters

lookup:MethodHandles.Lookup: the java.lang.invoke.MethodHandles.Lookup instance to use.
targetClass:Class<?>: the target class for invocations of the resulting MethodHandle (also known as parameter 0)
method:Method: the method to invoke
callingArgs:InvokerUtils.Arg[]: the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the MethodHandle#type() in the order specified in this array.

mutatedInvoker back to summary

mutatedInvoker	back to summary
public static MethodHandle mutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, Method method, InvokerUtils.ParamIdentifier paramIdentifier, String[] namedVariables, InvokerUtils.Arg... callingArgs) Create a MethodHandle that performs the following layers `MethodHandles#permuteArguments(MethodHandle, MethodType, int...)` - moving calling Args around to fit actual actual method parameter arguments (in proper order), with remaining (unused) calling args afterwords `MethodHandles#dropArguments(MethodHandle, int, Class[])` - to drop the unused calling args `MethodHandle#invoke(Object...)` - to call the specific method The returned `MethodHandle`.`MethodHandle#type()` assumes the following: Return type will be what the provided `Method` has. The first parameter is the type of class provided in the `targetClass`. The next parameters are all of the found type's of the named arguments, or type `String` if not found in provided `Method`. The next parameters are all of the provided `callingArg` types Parameters lookup:MethodHandles.Lookup the `java.lang.invoke.MethodHandles.Lookup` instance to use. targetClass:Class<?> the target class for invocations of the resulting MethodHandle (also known as parameter 0) method:Method the method to invoke paramIdentifier:InvokerUtils.ParamIdentifier the mechanism to identify parameters in method namedVariables:String[] the array of named variables. This is the array of named arguments that the target method might have. The resulting MethodHandle will include all of these namedVariables as the first non-object arguments in the `MethodType` found on the returned `MethodHandle#type()` callingArgs:InvokerUtils.Arg[] the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the `MethodHandle#type()` in the order specified in this array. Returns:MethodHandle the MethodHandle for this set of CallingArgs Exceptions RuntimeException: when unable to fit Calling Args to Parameter Types

public static MethodHandle mutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, Method method, InvokerUtils.ParamIdentifier paramIdentifier, String[] namedVariables, InvokerUtils.Arg... callingArgs)

Create a MethodHandle that performs the following layers

MethodHandles#permuteArguments(MethodHandle, MethodType, int...) - moving calling Args around to fit actual actual method parameter arguments (in proper order), with remaining (unused) calling args afterwords
MethodHandles#dropArguments(MethodHandle, int, Class[]) - to drop the unused calling args
MethodHandle#invoke(Object...) - to call the specific method

The returned MethodHandle.MethodHandle#type() assumes the following:

Return type will be what the provided Method has.
The first parameter is the type of class provided in the targetClass.
The next parameters are all of the found type's of the named arguments, or type String if not found in provided Method.
The next parameters are all of the provided callingArg types

Parameters

lookup:MethodHandles.Lookup: the java.lang.invoke.MethodHandles.Lookup instance to use.
targetClass:Class<?>: the target class for invocations of the resulting MethodHandle (also known as parameter 0)
method:Method: the method to invoke
paramIdentifier:InvokerUtils.ParamIdentifier: the mechanism to identify parameters in method
namedVariables:String[]: the array of named variables. This is the array of named arguments that the target method might have. The resulting MethodHandle will include all of these namedVariables as the first non-object arguments in the MethodType found on the returned MethodHandle#type()
callingArgs:InvokerUtils.Arg[]: the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the MethodHandle#type() in the order specified in this array.

Returns:MethodHandle

the MethodHandle for this set of CallingArgs

Exceptions

RuntimeException:: when unable to fit Calling Args to Parameter Types

mutatedInvoker	back to summary
private static MethodHandle mutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, boolean throwOnFailure, Method method, InvokerUtils.ParamIdentifier paramIdentifier, String[] namedVariables, InvokerUtils.Arg... rawCallingArgs)

optionalMutatedInvoker back to summary

optionalMutatedInvoker	back to summary
public static MethodHandle optionalMutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, Method method, InvokerUtils.ParamIdentifier paramIdentifier, String[] namedVariables, InvokerUtils.Arg... callingArgs) Create an optional MethodHandle that performs the following layers. `MethodHandles#permuteArguments(MethodHandle, MethodType, int...)` - moving calling Args around to fit actual actual method parameter arguments (in proper order), with remaining (unused) calling args afterwords `MethodHandles#dropArguments(MethodHandle, int, Class[])` - to drop the unused calling args `MethodHandle#invoke(Object...)` - to call the specific method Parameters lookup:MethodHandles.Lookup the `java.lang.invoke.MethodHandles.Lookup` instance to use. targetClass:Class<?> the target class for invocations of the resulting MethodHandle (also known as parameter 0) method:Method the method to invoke paramIdentifier:InvokerUtils.ParamIdentifier the mechanism to identify parameters in method namedVariables:String[] the array of named variables. This is the array of named arguments that the target method might have. The resulting MethodHandle will include all of these namedVariables as the first non-object arguments in the `MethodType` found on the returned `MethodHandle#type()` callingArgs:InvokerUtils.Arg[] the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the `MethodHandle#type()` in the order specified in this array. Returns:MethodHandle the MethodHandle for this set of CallingArgs, or null if not possible to create MethodHandle with CallingArgs to provided method

public static MethodHandle optionalMutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, Method method, InvokerUtils.ParamIdentifier paramIdentifier, String[] namedVariables, InvokerUtils.Arg... callingArgs)

Create an optional MethodHandle that performs the following layers.

MethodHandles#permuteArguments(MethodHandle, MethodType, int...) - moving calling Args around to fit actual actual method parameter arguments (in proper order), with remaining (unused) calling args afterwords
MethodHandles#dropArguments(MethodHandle, int, Class[]) - to drop the unused calling args
MethodHandle#invoke(Object...) - to call the specific method

Parameters

lookup:MethodHandles.Lookup: the java.lang.invoke.MethodHandles.Lookup instance to use.
targetClass:Class<?>: the target class for invocations of the resulting MethodHandle (also known as parameter 0)
method:Method: the method to invoke
paramIdentifier:InvokerUtils.ParamIdentifier: the mechanism to identify parameters in method
namedVariables:String[]: the array of named variables. This is the array of named arguments that the target method might have. The resulting MethodHandle will include all of these namedVariables as the first non-object arguments in the MethodType found on the returned MethodHandle#type()
callingArgs:InvokerUtils.Arg[]: the calling arguments. This is the array of arguments that will always be passed into the returned MethodHandle. They will be present in the MethodHandle#type() in the order specified in this array.

Returns:MethodHandle

the MethodHandle for this set of CallingArgs, or null if not possible to create MethodHandle with CallingArgs to provided method

optionalMutatedInvoker	back to summary
public static MethodHandle optionalMutatedInvoker(MethodHandles.Lookup lookup, Class<?> targetClass, Method method, InvokerUtils.Arg... callingArgs)

org.eclipse.jetty.websocket.core.util back to summary

public Class InvokerUtils.Arg

Class Inheritance

extends Object

java.lang.Object
org.eclipse.jetty.websocket.core.util.InvokerUtils.Arg

Field Summary

Modifier and Type	Field and Description
private Class<?>	convertedType
private boolean	convertible
private String	name
private boolean	required
private final Class<?>	type

Constructor Summary

Access	Constructor and Description
public	Arg(Class<?> type)
public	Arg(Class<?> type, String name)

Method Summary

Modifier and Type	Method and Description
public InvokerUtils.Arg	convertible()
public Class<?>	getConvertedType()
public String	getName()
public Class<?>	getType()
public boolean	isRequired()
public boolean	matches(InvokerUtils.Arg other)
public InvokerUtils.Arg	required()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

convertedType	back to summary
private Class<?> convertedType

convertible	back to summary
private boolean convertible

name	back to summary
private String name

required	back to summary
private boolean required

type	back to summary
private final Class<?> type

Constructor Detail

Arg	back to summary
public Arg(Class<?> type)

Arg	back to summary
public Arg(Class<?> type, String name)

Method Detail

convertible	back to summary
public InvokerUtils.Arg convertible()

getConvertedType	back to summary
public Class<?> getConvertedType()

getName	back to summary
public String getName()

getType	back to summary
public Class<?> getType()

isRequired	back to summary
public boolean isRequired()

matches	back to summary
public boolean matches(InvokerUtils.Arg other)

required	back to summary
public InvokerUtils.Arg required()

public Class InvokerUtils

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class InvokerUtils.Arg

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Interface InvokerUtils.ParamIdentifier

Method Summary

Method Detail

private Class InvokerUtils.ParamIdentity

Constructor Summary

Method Summary

Constructor Detail

Method Detail