com.github.jlangch.venice

Interface IServiceRegistry

public interface IServiceRegistry

A service registry for service discovery and registration.

Note: Registrations can only be managed through IServiceRegistry. Venice scripts have access to lookup(String) only.

Example:

 Venice venice = new Venice();

 IServiceRegistry registry = venice.getServiceRegistry();
 registry.register("Calculator", new Calculator());

 long r = (Long)venice.eval("(service :Calculator :multiply 10 20)");
 

While `Calculator` is defined as:

 public class Calculator {
   public long multiply(long v1, long v2) {
     return v1 * v2;
   }
 }
 

Method Summary

Modifier and Type	Method and Description
boolean	exists(java.lang.String name) Returns true if the service exists otherwise false
java.lang.Object	lookup(java.lang.String name) Looking up a service
IServiceRegistry	register(java.lang.String name, java.lang.Object service) Register a named service.
IServiceRegistry	registerAll(java.util.Map<java.lang.String,java.lang.Object> services) Register named services.
IServiceRegistry	registerServiceDiscovery(IServiceDiscovery serviceDiscovery) Register a dynamic service lookup.
IServiceRegistry	unregister(java.lang.String name) Unregister a service.
IServiceRegistry	unregisterAll() Unregister all services and the service discovery
IServiceRegistry	unregisterServiceDiscovery() Unregister the dynamic service lookup.

Method Detail

register

IServiceRegistry register(java.lang.String name,
                          java.lang.Object service)

Register a named service.

Services can be replaced by registering them anew with another service object.

Parameters:

name - The service's name. A service name must be a non blank string.

service - The service, any non null Java object

Returns:

this registry to allow builder style configuration

registerAll

IServiceRegistry registerAll(java.util.Map<java.lang.String,java.lang.Object> services)

Register named services.

Parameters:

services - A map of named services. The key holds the service's name (a non blank string). The value holds the service, any non null Java object

Returns:

this registry to allow builder style configuration

registerServiceDiscovery

IServiceRegistry registerServiceDiscovery(IServiceDiscovery serviceDiscovery)

Register a dynamic service lookup.

Note: Services registered through register(String,Object) have precedence over services available provided by the custom service discovery via IServiceDiscovery

Parameters:

serviceDiscovery - The custom service discovery mechanism

Returns:

this registry to allow builder style configuration

unregister

IServiceRegistry unregister(java.lang.String name)

Unregister a service.

Unregistering an unknown service is silently skipped.

Parameters:

name - The service's name

Returns:

this registry to allow builder style configuration

unregisterAll

IServiceRegistry unregisterAll()

Unregister all services and the service discovery

Returns:

this registry to allow builder style configuration

unregisterServiceDiscovery

IServiceRegistry unregisterServiceDiscovery()

Unregister the dynamic service lookup.

Returns:

this registry to allow builder style configuration

lookup

java.lang.Object lookup(java.lang.String name)

Looking up a service

Parameters:

name - The service's name

Returns:

the service or null if not registered

exists

boolean exists(java.lang.String name)

Returns true if the service exists otherwise false

Parameters:

name - The service's name

Returns:

true if the service exists otherwise false