jdk.internal.jvmci.service

Class Services

java.lang.Object

jdk.internal.jvmci.service.Services

public final class Services
extends Object

An mechanism for accessing service providers via JVMCI. These providers are loaded via a JVMCI class loader that is hidden from application code. Hence the SecurityManager checks in load(Class) and loadSingle(Class, boolean).

Field Summary

Fields

Modifier and Type	Field and Description
private static ClassValue<List<?>>	cache
private static String	SUPPRESS_PROPERTY_NAME
private static boolean	SuppressNoClassDefFoundError Determines whether to suppress the NoClassDefFoundError raised if a service provider class specified in a <jre>/jvmci/services/* file is missing.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	Services()

Method Summary

Modifier and Type	Method and Description
private static <S> S[]	getServiceImpls(Class<?> service)
static <S> Iterable<S>	load(Class<S> service) Gets an Iterable of the JVMCI providers available for a given service.
static <S> S	loadSingle(Class<S> service, boolean required) Gets the JVMCI provider for a given service for which at most one provider must be available.

Methods inherited from class java.lang.Object

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

Field Detail

SUPPRESS_PROPERTY_NAME

private static final String SUPPRESS_PROPERTY_NAME

See Also:

Constant Field Values

SuppressNoClassDefFoundError

private static final boolean SuppressNoClassDefFoundError

Determines whether to suppress the NoClassDefFoundError raised if a service provider class specified in a <jre>/jvmci/services/* file is missing.

cache

private static final ClassValue<List<?>> cache

Constructor Detail

Services

private Services()

Method Detail

load

public static <S> Iterable<S> load(Class<S> service)

Gets an Iterable of the JVMCI providers available for a given service.

Throws:

SecurityException - if a security manager is present and it denies RuntimePermission("jvmciServices")

loadSingle

public static <S> S loadSingle(Class<S> service,
                               boolean required)

Gets the JVMCI provider for a given service for which at most one provider must be available.

Parameters:

service - the service whose provider is being requested

required - specifies if an InternalError should be thrown if no provider of service is available

Throws:

SecurityException - if a security manager is present and it denies RuntimePermission("jvmciServices")

getServiceImpls

private static <S> S[] getServiceImpls(Class<?> service)