OpenJDK 27 · jdk.dynalink.linker.support.Guards · APIdia, the JavaDoc alternative

Modifier and Type	Field and Description
private static final MethodHandle	IS_ARRAY
private static final MethodHandle	IS_IDENTICAL
private static final MethodHandle	IS_INSTANCE
private static final MethodHandle	IS_NOT_NULL
private static final MethodHandle	IS_NULL
private static final MethodHandle	IS_OF_CLASS
private static final Logger	LOG

Access	Constructor and Description
private	Guards()

Method Summary

Modifier and Type	Method and Description
public static MethodHandle	Returns: the adapted method handle asType(final MethodHandle the test method handle test, final MethodType the type to adapt the method handle to type) Takes a method handle intended to be used as a guard, and adapts it to the requested type, but returning a boolean.
public static MethodHandle	Returns: the adapted method handle asType(final LinkerServices the linker services to use for type conversions linkerServices, final MethodHandle the test method handle test, final MethodType the type to adapt the method handle to type) Takes a method handle intended to be used as a guard, and adapts it to the requested type, but returning a boolean.
private static MethodHandle	asType(final MethodHandle test, final int pos, final MethodType type)
private static MethodHandle	constantBoolean(final Boolean value, final MethodType type)
private static MethodHandle	constantFalse(final MethodType type)
private static MethodHandle	constantTrue(final MethodType type)
private static MethodHandle	getClassBoundArgumentTest(final MethodHandle test, final Class<?> clazz, final int pos, final MethodType type)
public static MethodHandle	Returns: the desired guard method. getClassGuard(final Class<?> the class to test for. clazz) Creates a guard method that tests its only argument for being of an exact particular class.
public static MethodHandle	Returns: the desired guard method. getIdentityGuard(final Object the object used as referential identity test obj) Creates a guard method that tests its only argument for being referentially identical to another object
public static MethodHandle	Returns: the desired guard method. getInstanceOfGuard(final Class<?> the class to test for. clazz) Creates a guard method that tests its only argument for being an instance of a particular class.
private static MethodType	getTestType(final MethodHandle test, final MethodType type)
public static MethodHandle	Returns: a method handle that returns true if the argument in the specified position is a Java array; the rest of the arguments are ignored. isArray(final int the position in the argument lit pos, final MethodType the method type of the handle type) Creates a method handle that returns true if the argument in the specified position is a Java array.
private static boolean	isArray(final Object o)
private static boolean	isIdentical(final Object o1, final Object o2)
public static MethodHandle	Returns: a method handle testing whether its first argument is of the specified class or subclass. isInstance(final Class<?> the class of the first argument to test for clazz, final MethodType the method type type) Creates a method handle with arguments of a specified type, but with boolean return value.
public static MethodHandle	Returns: a method handle testing whether its first argument is of the specified class or subclass. isInstance(final Class<?> the class of the first argument to test for clazz, final int the position on the argument list to test pos, final MethodType the method type type) Creates a method handle with arguments of a specified type, but with boolean return value.
public static MethodHandle	Returns: a guard that tests whether the first argument is not null. isNotNull() Returns a guard that tests whether the first argument is not null.
private static boolean	isNotNull(final Object obj)
public static MethodHandle	Returns: a guard that tests whether the first argument is null. isNull() Returns a guard that tests whether the first argument is null.
private static boolean	isNull(final Object obj)
public static MethodHandle	Returns: a method handle testing whether its first argument is of the specified class. isOfClass(final Class<?> the class of the first argument to test for clazz, final MethodType the method type type) Creates a guard method handle with arguments of a specified type, but with boolean return value.
private static boolean	isOfClass(final Class<?> c, final Object o)

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

IS_ARRAY	back to summary
private static final MethodHandle IS_ARRAY

IS_IDENTICAL	back to summary
private static final MethodHandle IS_IDENTICAL

IS_INSTANCE	back to summary
private static final MethodHandle IS_INSTANCE

IS_NOT_NULL	back to summary
private static final MethodHandle IS_NOT_NULL

IS_NULL	back to summary
private static final MethodHandle IS_NULL

IS_OF_CLASS	back to summary
private static final MethodHandle IS_OF_CLASS

LOG	back to summary
private static final Logger LOG

Guards	back to summary
private Guards()

Method Detail

asType back to summary

asType	back to summary
public static MethodHandle asType(final MethodHandle test, final MethodType type) Takes a method handle intended to be used as a guard, and adapts it to the requested type, but returning a boolean. Applies `MethodHandle#asType(MethodType)` to convert types and uses `MethodHandles#dropArguments(MethodHandle, int, Class...)` to match the requested type arity. Parameters test:MethodHandle the test method handle type:MethodType the type to adapt the method handle to Returns:MethodHandle the adapted method handle

public static MethodHandle asType(final MethodHandle test, final MethodType type)

Takes a method handle intended to be used as a guard, and adapts it to the requested type, but returning a boolean. Applies MethodHandle#asType(MethodType) to convert types and uses MethodHandles#dropArguments(MethodHandle, int, Class...) to match the requested type arity.

Parameters

test:MethodHandle: the test method handle
type:MethodType: the type to adapt the method handle to

Returns:MethodHandle

the adapted method handle

asType back to summary

asType	back to summary
public static MethodHandle asType(final LinkerServices linkerServices, final MethodHandle test, final MethodType type) Takes a method handle intended to be used as a guard, and adapts it to the requested type, but returning a boolean. Applies `LinkerServices#asType(MethodHandle, MethodType)` to convert types and uses `MethodHandles#dropArguments(MethodHandle, int, Class...)` to match the requested type arity. Parameters linkerServices:LinkerServices the linker services to use for type conversions test:MethodHandle the test method handle type:MethodType the type to adapt the method handle to Returns:MethodHandle the adapted method handle

public static MethodHandle asType(final LinkerServices linkerServices, final MethodHandle test, final MethodType type)

Takes a method handle intended to be used as a guard, and adapts it to the requested type, but returning a boolean. Applies LinkerServices#asType(MethodHandle, MethodType) to convert types and uses MethodHandles#dropArguments(MethodHandle, int, Class...) to match the requested type arity.

Parameters

linkerServices:LinkerServices: the linker services to use for type conversions
test:MethodHandle: the test method handle
type:MethodType: the type to adapt the method handle to

Returns:MethodHandle

the adapted method handle

asType	back to summary
private static MethodHandle asType(final MethodHandle test, final int pos, final MethodType type)

constantBoolean	back to summary
private static MethodHandle constantBoolean(final Boolean value, final MethodType type)

constantFalse	back to summary
private static MethodHandle constantFalse(final MethodType type)

constantTrue	back to summary
private static MethodHandle constantTrue(final MethodType type)

getClassBoundArgumentTest	back to summary
private static MethodHandle getClassBoundArgumentTest(final MethodHandle test, final Class<?> clazz, final int pos, final MethodType type)

getClassGuard	back to summary
public static MethodHandle getClassGuard(final Class<?> clazz) Creates a guard method that tests its only argument for being of an exact particular class. Parameters clazz:Class<?> the class to test for. Returns:MethodHandle the desired guard method.

getClassGuard

back to summary

public static MethodHandle getClassGuard(final Class<?> clazz)

Creates a guard method that tests its only argument for being of an exact particular class.

Parameters

clazz:Class<?>: the class to test for.

Returns:MethodHandle

the desired guard method.

getIdentityGuard	back to summary
public static MethodHandle getIdentityGuard(final Object obj) Creates a guard method that tests its only argument for being referentially identical to another object Parameters obj:Object the object used as referential identity test Returns:MethodHandle the desired guard method.

getIdentityGuard

back to summary

public static MethodHandle getIdentityGuard(final Object obj)

Creates a guard method that tests its only argument for being referentially identical to another object

Parameters

obj:Object: the object used as referential identity test

Returns:MethodHandle

the desired guard method.

getInstanceOfGuard	back to summary
public static MethodHandle getInstanceOfGuard(final Class<?> clazz) Creates a guard method that tests its only argument for being an instance of a particular class. Parameters clazz:Class<?> the class to test for. Returns:MethodHandle the desired guard method.

getInstanceOfGuard

back to summary

public static MethodHandle getInstanceOfGuard(final Class<?> clazz)

Creates a guard method that tests its only argument for being an instance of a particular class.

Parameters

clazz:Class<?>: the class to test for.

Returns:MethodHandle

the desired guard method.

getTestType	back to summary
private static MethodType getTestType(final MethodHandle test, final MethodType type)

isArray	back to summary
public static MethodHandle isArray(final int pos, final MethodType type) Creates a method handle that returns true if the argument in the specified position is a Java array. Parameters pos:int the position in the argument lit type:MethodType the method type of the handle Returns:MethodHandle a method handle that returns true if the argument in the specified position is a Java array; the rest of the arguments are ignored. Annotations @SuppressWarnings:boxing

isArray

back to summary

public static MethodHandle isArray(final int pos, final MethodType type)

Creates a method handle that returns true if the argument in the specified position is a Java array.

Parameters

pos:int: the position in the argument lit
type:MethodType: the method type of the handle

Returns:MethodHandle

a method handle that returns true if the argument in the specified position is a Java array; the rest of the arguments are ignored.

Annotations

@SuppressWarnings:boxing

isArray	back to summary
private static boolean isArray(final Object o) Annotations @SuppressWarnings:unused

isIdentical	back to summary
private static boolean isIdentical(final Object o1, final Object o2) Annotations @SuppressWarnings:unused

isInstance	back to summary
public static MethodHandle isInstance(final Class<?> clazz, final MethodType type) Creates a method handle with arguments of a specified type, but with boolean return value. When invoked, it returns true if the first argument is instance of the specified class or its subclass). The rest of the arguments will be ignored. Parameters clazz:Class<?> the class of the first argument to test for type:MethodType the method type Returns:MethodHandle a method handle testing whether its first argument is of the specified class or subclass.

isInstance

back to summary

public static MethodHandle isInstance(final Class<?> clazz, final MethodType type)

Creates a method handle with arguments of a specified type, but with boolean return value. When invoked, it returns true if the first argument is instance of the specified class or its subclass). The rest of the arguments will be ignored.

Parameters

clazz:Class<?>: the class of the first argument to test for
type:MethodType: the method type

Returns:MethodHandle

a method handle testing whether its first argument is of the specified class or subclass.

isInstance	back to summary
public static MethodHandle isInstance(final Class<?> clazz, final int pos, final MethodType type) Creates a method handle with arguments of a specified type, but with boolean return value. When invoked, it returns true if the n'th argument is instance of the specified class or its subclass). The rest of the arguments will be ignored. Parameters clazz:Class<?> the class of the first argument to test for pos:int the position on the argument list to test type:MethodType the method type Returns:MethodHandle a method handle testing whether its first argument is of the specified class or subclass. Annotations @SuppressWarnings:boxing

isInstance

back to summary

public static MethodHandle isInstance(final Class<?> clazz, final int pos, final MethodType type)

Creates a method handle with arguments of a specified type, but with boolean return value. When invoked, it returns true if the n'th argument is instance of the specified class or its subclass). The rest of the arguments will be ignored.

Parameters

clazz:Class<?>: the class of the first argument to test for
pos:int: the position on the argument list to test
type:MethodType: the method type

Returns:MethodHandle

a method handle testing whether its first argument is of the specified class or subclass.

Annotations

@SuppressWarnings:boxing

isNotNull	back to summary
public static MethodHandle isNotNull() Returns a guard that tests whether the first argument is not null. Returns:MethodHandle a guard that tests whether the first argument is not null.

isNotNull

back to summary

public static MethodHandle isNotNull()

Returns a guard that tests whether the first argument is not null.

Returns:MethodHandle: a guard that tests whether the first argument is not null.

isNotNull	back to summary
private static boolean isNotNull(final Object obj) Annotations @SuppressWarnings:unused

isNull	back to summary
public static MethodHandle isNull() Returns a guard that tests whether the first argument is null. Returns:MethodHandle a guard that tests whether the first argument is null.

isNull

back to summary

public static MethodHandle isNull()

Returns a guard that tests whether the first argument is null.

Returns:MethodHandle: a guard that tests whether the first argument is null.

isNull	back to summary
private static boolean isNull(final Object obj) Annotations @SuppressWarnings:unused

isOfClass	back to summary
public static MethodHandle isOfClass(final Class<?> clazz, final MethodType type) Creates a guard method handle with arguments of a specified type, but with boolean return value. When invoked, it returns true if the first argument is of the specified class (exactly of it, not a subclass). The rest of the arguments will be ignored. Parameters clazz:Class<?> the class of the first argument to test for type:MethodType the method type Returns:MethodHandle a method handle testing whether its first argument is of the specified class. Annotations @SuppressWarnings:boxing

isOfClass

back to summary

public static MethodHandle isOfClass(final Class<?> clazz, final MethodType type)

Creates a guard method handle with arguments of a specified type, but with boolean return value. When invoked, it returns true if the first argument is of the specified class (exactly of it, not a subclass). The rest of the arguments will be ignored.

Parameters

clazz:Class<?>: the class of the first argument to test for
type:MethodType: the method type

Returns:MethodHandle

a method handle testing whether its first argument is of the specified class.

Annotations

@SuppressWarnings:boxing

isOfClass	back to summary
private static boolean isOfClass(final Class<?> c, final Object o) Annotations @SuppressWarnings:unused

public final Class Guards

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail