Package io.grpc

Class ServerRegistry

java.lang.Object

io.grpc.ServerRegistry

@Internal
@ThreadSafe
public final class ServerRegistry
extends Object

Registry of ServerProviders. The default instance loads providers at runtime through the Java service provider mechanism.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ServerRegistry.ProviderNotFoundException	Thrown when no suitable ServerProvider objects can be found.
private static final class	ServerRegistry.ServerPriorityAccessor

Field Summary

Fields

Modifier and Type	Field	Description
private final LinkedHashSet<ServerProvider>	allProviders
private List<ServerProvider>	effectiveProviders	Immutable, sorted version of allProviders.
private static ServerRegistry	instance
private static final Logger	logger

Constructor Summary

Constructors

Constructor	Description
ServerRegistry()

Method Summary

Modifier and Type	Method	Description
private void	addProvider(ServerProvider provider)
void	deregister(ServerProvider provider)	Deregisters a provider.
static ServerRegistry	getDefaultRegistry()	Returns the default registry that loads providers via the Java service loader mechanism.
(package private) static List<Class<?>>	getHardCodedClasses()
(package private) ServerBuilder<?>	newServerBuilderForPort(int port, ServerCredentials creds)
(package private) ServerProvider	provider()
(package private) List<ServerProvider>	providers()	Returns effective providers, in priority order.
private void	refreshProviders()
void	register(ServerProvider provider)	Register a provider.

Methods inherited from class java.lang.Object

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

Field Details

logger

private static final Logger logger

instance

private static ServerRegistry instance

allProviders

private final LinkedHashSet<ServerProvider> allProviders

effectiveProviders

private List<ServerProvider> effectiveProviders

Immutable, sorted version of allProviders. Is replaced instead of mutating.

Constructor Details

ServerRegistry

public ServerRegistry()

Method Details

register

public void register(ServerProvider provider)

Register a provider.

If the provider's isAvailable() returns false, this method will throw IllegalArgumentException.

Providers will be used in priority order. In case of ties, providers are used in registration order.

addProvider

private void addProvider(ServerProvider provider)

deregister

public void deregister(ServerProvider provider)

Deregisters a provider. No-op if the provider is not in the registry.

Parameters:

provider - the provider that was added to the register via register(io.grpc.ServerProvider).

refreshProviders

private void refreshProviders()

getDefaultRegistry

public static ServerRegistry getDefaultRegistry()

Returns the default registry that loads providers via the Java service loader mechanism.

providers

List<ServerProvider> providers()

Returns effective providers, in priority order.

provider

ServerProvider provider()

getHardCodedClasses

static List<Class<?>> getHardCodedClasses()

newServerBuilderForPort

ServerBuilder<?> newServerBuilderForPort(int port,
 ServerCredentials creds)