jadex.bridge.service

Class CacheServiceContainer

java.lang.Object

jadex.bridge.service.CacheServiceContainer

All Implemented Interfaces:

IServiceContainer, IServiceProvider, IRemotable

public class CacheServiceContainer
extends Object
implements IServiceContainer

Service container that uses caching for fast service access.

Constructor Summary

Constructors

Constructor and Description
CacheServiceContainer(IServiceContainer container) Create a new service container.
CacheServiceContainer(IServiceContainer container, int max, long ttl) Create a new service container.

Method Summary

Methods

Modifier and Type	Method and Description
void	addInterceptor(IServiceInvocationInterceptor interceptor, Object service, int pos) Add a service interceptor.
void	addRequiredServiceInfos(RequiredServiceInfo[] requiredservices) Add required services for a given prefix.
IFuture	addService(IInternalService service, ProvidedServiceInfo info) Add a service to the platform.
IFuture	getChildren() Get the children container.
IComponentIdentifier	getId() Get the globally unique id of the provider.
IServiceInvocationInterceptor[]	getInterceptors(Object service) Get the interceptors of a service.
IFuture	getParent() Get the parent service container.
IService	getProvidedService(String name) Get provided (declared) service.
IService[]	getProvidedServices(Class clazz) Get provided (declared) service.
IFuture	getRequiredService(String name) Get a required service of a given name.
IFuture	getRequiredService(String name, boolean rebind) Get a required service.
RequiredServiceInfo	getRequiredServiceInfo(String name) Get the required service info.
RequiredServiceInfo[]	getRequiredServiceInfos() Get the required service infos.
IIntermediateFuture	getRequiredServices(String name) Get a required services of a given name.
IIntermediateFuture	getRequiredServices(String name, boolean rebind) Get a required services.
IFuture	getService(Class type, IComponentIdentifier cid) Get one service of a type from a specific component.
IIntermediateFuture	getServices(ISearchManager manager, IVisitDecider decider, IResultSelector selector) Get all services of a type.
String	getType() Get the type of the service provider (e.g. enclosing component type).
void	removeInterceptor(IServiceInvocationInterceptor interceptor, Object service) Remove a service interceptor.
IFuture	removeService(IServiceIdentifier sid) Removes a service from the platform (shutdowns also the service).
IFuture	searchService(Class type) Get one service of a type.
IFuture	searchService(Class type, String scope) Get one service of a type.
IIntermediateFuture	searchServices(Class type) Get all services of a type.
IIntermediateFuture	searchServices(Class type, String scope) Get all services of a type.
IFuture	searchServiceUpwards(Class type) Get one service of a type and only search upwards (parents).
void	setRequiredServiceInfos(RequiredServiceInfo[] requiredservices) Set the required services.
IFuture	shutdown() Shutdown the service.
IFuture	start() Start the service.
String	toString() Get the string representation.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CacheServiceContainer

public CacheServiceContainer(IServiceContainer container)

Create a new service container.

CacheServiceContainer

public CacheServiceContainer(IServiceContainer container,
                     int max,
                     long ttl)

Create a new service container.

Method Detail

getServices

public IIntermediateFuture getServices(ISearchManager manager,
                              IVisitDecider decider,
                              IResultSelector selector)

Get all services of a type.

Specified by:

getServices in interface IServiceProvider

Parameters:

type - The class.

Returns:

The corresponding services.

getParent

public IFuture getParent()

Get the parent service container.

Specified by:

getParent in interface IServiceProvider

Returns:

The parent container.

getChildren

public IFuture getChildren()

Get the children container.

Specified by:

getChildren in interface IServiceProvider

Returns:

The children container.

getId

public IComponentIdentifier getId()

Get the globally unique id of the provider.

Specified by:

getId in interface IServiceProvider

Returns:

The id of this provider.

getType

public String getType()

Get the type of the service provider (e.g. enclosing component type).

Specified by:

getType in interface IServiceProvider

Returns:

The type of this provider.

start

public IFuture start()

Start the service.

Specified by:

start in interface IServiceContainer

Returns:

A future that is done when the service has completed starting.

shutdown

public IFuture shutdown()

Shutdown the service.

Specified by:

shutdown in interface IServiceContainer

Returns:

A future that is done when the service has completed its shutdown.

addService

public IFuture addService(IInternalService service,
                 ProvidedServiceInfo info)

Add a service to the platform. If under the same name and type a service was contained, the old one is removed and shutdowned.

Specified by:

addService in interface IServiceContainer

Parameters:

name - The name.

service - The service.

Returns:

A future that is done when the service has completed starting.

removeService

public IFuture removeService(IServiceIdentifier sid)

Removes a service from the platform (shutdowns also the service).

Specified by:

removeService in interface IServiceContainer

Parameters:

name - The name.

service - The service.

Returns:

A future that is done when the service has completed its shutdown.

toString

public String toString()

Get the string representation.

Overrides:

toString in class Object

Returns:

The string representation.

getService

public IFuture getService(Class type,
                 IComponentIdentifier cid)

Get one service of a type from a specific component.

Specified by:

getService in interface IServiceContainer

Parameters:

type - The class.

cid - The component identifier of the target component.

Returns:

The corresponding service.

getProvidedService

public IService getProvidedService(String name)

Get provided (declared) service.

Specified by:

getProvidedService in interface IServiceContainer

Parameters:

name - The service name.

Returns:

The service.

getProvidedServices

public IService[] getProvidedServices(Class clazz)

Description copied from interface: IServiceContainer

Get provided (declared) service.

Specified by:

getProvidedServices in interface IServiceContainer

Parameters:

clazz - The interface.

Returns:

The service.

getRequiredServiceInfos

public RequiredServiceInfo[] getRequiredServiceInfos()

Description copied from interface: IServiceContainer

Get the required service infos.

Specified by:

getRequiredServiceInfos in interface IServiceContainer

getRequiredServiceInfo

public RequiredServiceInfo getRequiredServiceInfo(String name)

Description copied from interface: IServiceContainer

Get the required service info.

Specified by:

getRequiredServiceInfo in interface IServiceContainer

Parameters:

name - The name.

Returns:

The required service info.

setRequiredServiceInfos

public void setRequiredServiceInfos(RequiredServiceInfo[] requiredservices)

Description copied from interface: IServiceContainer

Set the required services.

Specified by:

setRequiredServiceInfos in interface IServiceContainer

addRequiredServiceInfos

public void addRequiredServiceInfos(RequiredServiceInfo[] requiredservices)

Description copied from interface: IServiceContainer

Add required services for a given prefix.

Specified by:

addRequiredServiceInfos in interface IServiceContainer

getRequiredService

public IFuture getRequiredService(String name)

Description copied from interface: IServiceContainer

Get a required service of a given name.

Specified by:

getRequiredService in interface IServiceContainer

Parameters:

name - The service name.

Returns:

The service.

getRequiredServices

public IIntermediateFuture getRequiredServices(String name)

Description copied from interface: IServiceContainer

Get a required services of a given name.

Specified by:

getRequiredServices in interface IServiceContainer

Parameters:

name - The services name.

Returns:

Each service as an intermediate result and a collection of services as final result.

getRequiredService

public IFuture getRequiredService(String name,
                         boolean rebind)

Description copied from interface: IServiceContainer

Get a required service.

Specified by:

getRequiredService in interface IServiceContainer

Returns:

The service.

getRequiredServices

public IIntermediateFuture getRequiredServices(String name,
                                      boolean rebind)

Description copied from interface: IServiceContainer

Get a required services.

Specified by:

getRequiredServices in interface IServiceContainer

Returns:

Each service as an intermediate result and a collection of services as final result.

addInterceptor

public void addInterceptor(IServiceInvocationInterceptor interceptor,
                  Object service,
                  int pos)

Description copied from interface: IServiceContainer

Add a service interceptor.

Specified by:

addInterceptor in interface IServiceContainer

Parameters:

interceptor - The interceptor.

service - The service.

pos - The position (0=first).

removeInterceptor

public void removeInterceptor(IServiceInvocationInterceptor interceptor,
                     Object service)

Description copied from interface: IServiceContainer

Remove a service interceptor.

Specified by:

removeInterceptor in interface IServiceContainer

Parameters:

interceptor - The interceptor.

service - The service.

getInterceptors

public IServiceInvocationInterceptor[] getInterceptors(Object service)

Description copied from interface: IServiceContainer

Get the interceptors of a service.

Specified by:

getInterceptors in interface IServiceContainer

Parameters:

service - The service.

Returns:

The interceptors.

searchService

public IFuture searchService(Class type)

Get one service of a type.

Specified by:

searchService in interface IServiceContainer

Parameters:

type - The class.

Returns:

The corresponding service.

searchService

public IFuture searchService(Class type,
                    String scope)

Get one service of a type.

Specified by:

searchService in interface IServiceContainer

Parameters:

type - The class.

Returns:

The corresponding service.

searchServiceUpwards

public IFuture searchServiceUpwards(Class type)

Get one service of a type and only search upwards (parents).

Specified by:

searchServiceUpwards in interface IServiceContainer

Parameters:

type - The class.

Returns:

The corresponding service.

searchServices

public IIntermediateFuture searchServices(Class type)

Get all services of a type.

Specified by:

searchServices in interface IServiceContainer

Parameters:

type - The class.

Returns:

The corresponding services.

searchServices

public IIntermediateFuture searchServices(Class type,
                                 String scope)

Get all services of a type.

Specified by:

searchServices in interface IServiceContainer

Parameters:

type - The class.

Returns:

The corresponding services.