io.silverware.microservices

Class Context

java.lang.Object

io.silverware.microservices.Context

public class Context
extends Object

Microservices context carrying all necessary execution information. The intention is to separate all information shared between providers to be able to create multiple instances of the platform in the same JVM.

Author:

Martin Večeřa

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEPLOYMENT_PACKAGES Name of the system property that lists the packages to be searched for provider deployments.
static String	MICROSERVICE_PROVIDERS_REGISTRY Property key where a registry with Microservice providers is.
static String	MICROSERVICES Property key where a registry with local Microservices is.

Constructor Summary

Constructors

Constructor and Description
Context() Creates the context and binds the registries to global properties.

Method Summary

Modifier and Type	Method and Description
List<ServiceHandle>	assureHandles(MicroserviceMetaData metaData) Makes that there are handles created for all the local services that meet the given the query.
Set<SilverService>	getAllProviders(Class<? extends SilverService> clazz) Gets all providers based on the interface or class specification.
ServiceHandle	getInboundServiceHandle(int handle) Gets the ServiceHandle for the given handle number.
Set<MicroserviceMetaData>	getMicroservices() Gets an unmodifiable copy of the current local Microservices registry.
Map<String,Object>	getProperties() Gets the global properties.
SilverService	getProvider(Class<? extends SilverService> clazz) Gets a provider based on the interface or class specification.
Map<String,MicroserviceProvider>	getProvidersRegistry() Gets the registry of Microservices providers.
Set<Object>	lookupLocalMicroservice(MicroserviceMetaData metaData) Looks up Microservices based on the provided meta-data query.
Set<Object>	lookupMicroservice(MicroserviceMetaData metaData) Looks up Microservices based on the provided meta-data query.
void	registerMicroservice(MicroserviceMetaData metaData) Adds a Microservice to the registry.

Methods inherited from class java.lang.Object

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

Field Detail

MICROSERVICE_PROVIDERS_REGISTRY

public static final String MICROSERVICE_PROVIDERS_REGISTRY

Property key where a registry with Microservice providers is.

See Also:

Constant Field Values

DEPLOYMENT_PACKAGES

public static final String DEPLOYMENT_PACKAGES

Name of the system property that lists the packages to be searched for provider deployments.

See Also:

Constant Field Values

MICROSERVICES

public static final String MICROSERVICES

Property key where a registry with local Microservices is.

See Also:

Constant Field Values

Constructor Detail

Context

public Context()

Creates the context and binds the registries to global properties.

Method Detail

getProperties

public Map<String,Object> getProperties()

Gets the global properties.

Returns:

The global properties.

getProvidersRegistry

public Map<String,MicroserviceProvider> getProvidersRegistry()

Gets the registry of Microservices providers.

Returns:

The registry of Microservices providers.

registerMicroservice

public void registerMicroservice(MicroserviceMetaData metaData)

Adds a Microservice to the registry.

Parameters:

metaData - Description of the service to be registered.

getMicroservices

public Set<MicroserviceMetaData> getMicroservices()

Gets an unmodifiable copy of the current local Microservices registry.

Returns:

An unmodifiable copy of the current local Microservices registry.

lookupMicroservice

public Set<Object> lookupMicroservice(MicroserviceMetaData metaData)

Looks up Microservices based on the provided meta-data query. All providers are asked to look up all possible services including local and remote.

Parameters:

metaData - Meta-data query.

Returns:

A set of Microservices instances that meets the query.

lookupLocalMicroservice

public Set<Object> lookupLocalMicroservice(MicroserviceMetaData metaData)

Looks up Microservices based on the provided meta-data query. Only local Microservices are searched.

Parameters:

metaData - Meta-data query.

Returns:

A set of Microservices instances that meets the query.

getProvider

public SilverService getProvider(Class<? extends SilverService> clazz)

Gets a provider based on the interface or class specification. Usually ancestors of SilverService are used for the query. The first class from the registry that meets the query is returned.

Parameters:

clazz - An interface or class the implementation of which we are looking for.

Returns:

The appropriate Microservice provider if it exists, null otherwise.

getAllProviders

public Set<SilverService> getAllProviders(Class<? extends SilverService> clazz)

Gets all providers based on the interface or class specification. Usually ancestors of SilverService are used for the query.

Parameters:

clazz - An interface or class the implementation of which we are looking for.

Returns:

A set of appropriate Microservice providers if they exists, an empty set otherwise.

assureHandles

public List<ServiceHandle> assureHandles(MicroserviceMetaData metaData)

Makes that there are handles created for all the local services that meet the given the query. Only local Microservices are searched as we cannot created inbound handles for remote Microservices (we do not want to just pass through calls).

Parameters:

metaData - The query for which to look up the service handles.

Returns:

A list of Service Handles that meet the specified query.

getInboundServiceHandle

public ServiceHandle getInboundServiceHandle(int handle)

Gets the ServiceHandle for the given handle number.

Parameters:

handle - The handle number.

Returns:

The ServiceHandle with the given handle number.