Class MutableHandlerRegistry

java.lang.Object

io.grpc.HandlerRegistry

io.grpc.util.MutableHandlerRegistry

@ThreadSafe
public final class MutableHandlerRegistry
extends HandlerRegistry

Default implementation of HandlerRegistry.

Uses ConcurrentHashMap to avoid service registration excessively blocking method lookup.

Field Summary

Fields

Modifier and Type	Field	Description
private final ConcurrentMap<String, ServerServiceDefinition>	services

Constructor Summary

Constructors

Constructor	Description
MutableHandlerRegistry()

Method Summary

Modifier and Type	Method	Description
ServerServiceDefinition	addService(BindableService bindableService)	Registers a service.
ServerServiceDefinition	addService(ServerServiceDefinition service)	Registers a service.
List<ServerServiceDefinition>	getServices()	Note: This does not necessarily return a consistent view of the map.
ServerMethodDefinition<?,?>	lookupMethod(String methodName, String authority)	Note: This does not actually honor the authority provided.
boolean	removeService(ServerServiceDefinition service)	Removes a registered service.

Methods inherited from class HandlerRegistry

lookupMethod

Methods inherited from class Object

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

Field Details

services

private final ConcurrentMap<String, ServerServiceDefinition> services

Constructor Details

MutableHandlerRegistry

public MutableHandlerRegistry()

Method Details

addService

@Nullable
public ServerServiceDefinition addService(ServerServiceDefinition service)

Registers a service.

Returns:

the previously registered service with the same service descriptor name if exists, otherwise null.

addService

@Nullable
public ServerServiceDefinition addService(BindableService bindableService)

Registers a service.

Returns:

the previously registered service with the same service descriptor name if exists, otherwise null.

removeService

public boolean removeService(ServerServiceDefinition service)

Removes a registered service.

Returns:

true if the service was found to be removed.

getServices

@ExperimentalApi("https://github.com/grpc/grpc-java/issues/2222")
public List<ServerServiceDefinition> getServices()

Note: This does not necessarily return a consistent view of the map.

Overrides:

getServices in class HandlerRegistry

lookupMethod

@Nullable
public ServerMethodDefinition<?,?> lookupMethod(String methodName,
 @Nullable
 String authority)

Note: This does not actually honor the authority provided. It will, eventually in the future.

Specified by:

lookupMethod in class HandlerRegistry

Parameters:

methodName - to lookup ServerMethodDefinition for.

authority - the authority for the desired method (to do virtual hosting). If null the first matching method will be returned.

Returns:

the resolved method or null if no method for that name exists.