jadex.bridge.service

Interface IServiceContainer

All Superinterfaces:

IRemotable, IServiceProvider

All Known Implementing Classes:

BasicServiceContainer, ComponentServiceContainer

public interface IServiceContainer
extends IServiceProvider

Internal interface for a service container. Allows adding and removing services.

Method Summary

Methods

Modifier and Type	Method and Description
void	addInterceptor(IServiceInvocationInterceptor interceptor, Object service, int pos) Add a service interceptor.
void	addMethodInvocationListener(IServiceIdentifier sid, MethodInfo mi, IMethodInvocationListener listener) Add a method invocation handler.
void	addRequiredServiceInfos(RequiredServiceInfo[] requiredservices) Add required services for a given prefix.
IFuture<Void>	addService(IInternalService service, ProvidedServiceInfo info) Add a service to the container.
IServiceInvocationInterceptor[]	getInterceptors(Object service) Get the interceptors of a service.
<T> T	getLastRequiredService(String name) Get the result of the last search.
<T> Collection<T>	getLastRequiredServices(String name) Get the result of the last search.
IService	getProvidedService(Class<?> clazz) Get provided (declared) service.
IService	getProvidedService(String name) Get provided (declared) service.
Object	getProvidedServiceRawImpl(Class<?> clazz) Get the provided service
IService[]	getProvidedServices(Class<?> clazz) Get provided (declared) service.
<T> IFuture<T>	getRequiredService(String name) Get a required service of a given name.
<T> IFuture<T>	getRequiredService(String name, boolean rebind) Get a required service.
<T> IFuture<T>	getRequiredService(String name, boolean rebind, IRemoteFilter<T> filter) Get a required service.
RequiredServiceInfo	getRequiredServiceInfo(String name) Get the required service info.
RequiredServiceInfo[]	getRequiredServiceInfos() Get the required service infos.
INFMixedPropertyProvider	getRequiredServicePropertyProvider(IServiceIdentifier sid) Get the required service property provider for a service.
<T> ITerminableIntermediateFuture<T>	getRequiredServices(String name) Get a required services of a given name.
<T> ITerminableIntermediateFuture<T>	getRequiredServices(String name, boolean rebind) Get a required services.
<T> ITerminableIntermediateFuture<T>	getRequiredServices(String name, boolean rebind, IRemoteFilter<T> filter) Get a required services.
<T> IFuture<T>	getService(Class<T> type, IComponentIdentifier cid) Get one service of a type from a specific component.
boolean	hasMethodListeners(IServiceIdentifier sid, MethodInfo mi) Test if service and method has listeners.
boolean	hasRequiredServicePropertyProvider(IServiceIdentifier sid) Has the service a property provider.
void	notifyMethodListeners(IServiceIdentifier sid, boolean start, Object proxy, Method method, Object[] args, Object callid, ServiceInvocationContext context) Notify listeners that a service method has been called.
void	removeInterceptor(IServiceInvocationInterceptor interceptor, Object service) Remove a service interceptor.
void	removeMethodInvocationListener(IServiceIdentifier sid, MethodInfo mi, IMethodInvocationListener listener) Remove a method invocation handler.
IFuture<Void>	removeService(IServiceIdentifier sid) Removes a service from the container (shutdowns also the service if the container is running).
<T> IFuture<T>	searchService(Class<T> type) Get one service of a type.
<T> IFuture<T>	searchService(Class<T> type, String scope) Get one service of a type.
<T> IIntermediateFuture<T>	searchServices(Class<T> type) Get all services of a type.
<T> IIntermediateFuture<T>	searchServices(Class<T> type, String scope) Get all services of a type.
<T> IFuture<T>	searchServiceUpwards(Class<T> type) Get one service of a type and only search upwards (parents).
void	setRequiredServiceInfos(RequiredServiceInfo[] requiredservices) Set the required services.
IFuture<Void>	shutdown() Shutdown the service.
IFuture<Void>	start() Start the service.

Methods inherited from interface jadex.bridge.service.IServiceProvider

getChildren, getId, getParent, getServices, getType

Method Detail

start

IFuture<Void> start()

Start the service.

Returns:

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

shutdown

IFuture<Void> shutdown()

Shutdown the service.

Returns:

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

addService

IFuture<Void> addService(IInternalService service,
                       ProvidedServiceInfo info)

Add a service to the container. The service is started, if the container is already running.

Parameters:

service - The service.

info - The provided service info.

Returns:

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

removeService

IFuture<Void> removeService(IServiceIdentifier sid)

Removes a service from the container (shutdowns also the service if the container is running).

Parameters:

service - The service identifier.

Returns:

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

getProvidedService

IService getProvidedService(String name)

Get provided (declared) service.

Parameters:

name - The service name.

Returns:

The service.

getProvidedService

IService getProvidedService(Class<?> clazz)

Get provided (declared) service.

Parameters:

clazz - The interface.

Returns:

The service.

getProvidedServices

IService[] getProvidedServices(Class<?> clazz)

Get provided (declared) service.

Parameters:

clazz - The interface.

Returns:

The service.

getProvidedServiceRawImpl

Object getProvidedServiceRawImpl(Class<?> clazz)

Get the provided service

getRequiredServiceInfos

RequiredServiceInfo[] getRequiredServiceInfos()

Get the required service infos.

getRequiredServiceInfo

RequiredServiceInfo getRequiredServiceInfo(String name)

Get the required service info.

Parameters:

name - The name.

Returns:

The required service info.

setRequiredServiceInfos

void setRequiredServiceInfos(RequiredServiceInfo[] requiredservices)

Set the required services.

Parameters:

required - services The required services to set.

addRequiredServiceInfos

void addRequiredServiceInfos(RequiredServiceInfo[] requiredservices)

Add required services for a given prefix.

Parameters:

prefix - The name prefix to use.

required - services The required services to set.

getRequiredServicePropertyProvider

INFMixedPropertyProvider getRequiredServicePropertyProvider(IServiceIdentifier sid)

Get the required service property provider for a service.

hasRequiredServicePropertyProvider

boolean hasRequiredServicePropertyProvider(IServiceIdentifier sid)

Has the service a property provider.

getRequiredService

<T> IFuture<T> getRequiredService(String name)

Get a required service of a given name.

Parameters:

name - The service name.

Returns:

The service.

getRequiredServices

<T> ITerminableIntermediateFuture<T> getRequiredServices(String name)

Get a required services of a given name.

Parameters:

name - The services name.

Returns:

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

getRequiredService

<T> IFuture<T> getRequiredService(String name,
                                boolean rebind)

Get a required service.

Returns:

The service.

getRequiredServices

<T> ITerminableIntermediateFuture<T> getRequiredServices(String name,
                                                       boolean rebind)

Get a required services.

Returns:

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

getRequiredService

<T> IFuture<T> getRequiredService(String name,
                                boolean rebind,
                                IRemoteFilter<T> filter)

Get a required service.

Returns:

The service.

getRequiredServices

<T> ITerminableIntermediateFuture<T> getRequiredServices(String name,
                                                       boolean rebind,
                                                       IRemoteFilter<T> filter)

Get a required services.

Returns:

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

getLastRequiredService

<T> T getLastRequiredService(String name)

Get the result of the last search.

Parameters:

name - The required service name.

Returns:

The last result.

getLastRequiredServices

<T> Collection<T> getLastRequiredServices(String name)

Get the result of the last search.

Parameters:

name - The required services name.

Returns:

The last result.

addInterceptor

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

Add a service interceptor.

Parameters:

interceptor - The interceptor.

service - The service.

pos - The position (0=first).

removeInterceptor

void removeInterceptor(IServiceInvocationInterceptor interceptor,
                     Object service)

Remove a service interceptor.

Parameters:

interceptor - The interceptor.

service - The service.

getInterceptors

IServiceInvocationInterceptor[] getInterceptors(Object service)

Get the interceptors of a service.

Parameters:

service - The service.

Returns:

The interceptors.

addMethodInvocationListener

void addMethodInvocationListener(IServiceIdentifier sid,
                               MethodInfo mi,
                               IMethodInvocationListener listener)

Add a method invocation handler.

removeMethodInvocationListener

void removeMethodInvocationListener(IServiceIdentifier sid,
                                  MethodInfo mi,
                                  IMethodInvocationListener listener)

Remove a method invocation handler.

notifyMethodListeners

void notifyMethodListeners(IServiceIdentifier sid,
                         boolean start,
                         Object proxy,
                         Method method,
                         Object[] args,
                         Object callid,
                         ServiceInvocationContext context)

Notify listeners that a service method has been called.

hasMethodListeners

boolean hasMethodListeners(IServiceIdentifier sid,
                         MethodInfo mi)

Test if service and method has listeners.

getService

<T> IFuture<T> getService(Class<T> type,
                        IComponentIdentifier cid)

Get one service of a type from a specific component.

Parameters:

type - The class.

cid - The component identifier of the target component.

Returns:

The corresponding service.

searchService

<T> IFuture<T> searchService(Class<T> type)

Get one service of a type.

Parameters:

type - The class.

Returns:

The corresponding service.

searchService

<T> IFuture<T> searchService(Class<T> type,
                           String scope)

Get one service of a type.

Parameters:

type - The class.

Returns:

The corresponding service.

searchServiceUpwards

<T> IFuture<T> searchServiceUpwards(Class<T> type)

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

Parameters:

type - The class.

Returns:

The corresponding service.

searchServices

<T> IIntermediateFuture<T> searchServices(Class<T> type)

Get all services of a type.

Parameters:

type - The class.

Returns:

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

searchServices

<T> IIntermediateFuture<T> searchServices(Class<T> type,
                                        String scope)

Get all services of a type.

Parameters:

type - The class.

Returns:

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