jadex.bridge.service.component

Interface IProvidedServicesFeature

All Known Implementing Classes:

ProvidedServicesComponentFeature

public interface IProvidedServicesFeature

Component feature for provided services.

Method Summary

Modifier and Type	Method and Description
void	addInterceptor(IServiceInvocationInterceptor interceptor, java.lang.Object service, int pos) Add a service interceptor.
void	addMethodInvocationListener(IServiceIdentifier sid, MethodInfo mi, IMethodInvocationListener listener) Add a method invocation handler.
IFuture<java.lang.Void>	addService(java.lang.String name, java.lang.Class<?> type, java.lang.Object service) Add a service to the container.
IFuture<java.lang.Void>	addService(java.lang.String name, java.lang.Class<?> type, java.lang.Object service, PublishInfo pi, java.lang.String scope) Add a service to the platform.
IFuture<java.lang.Void>	addService(java.lang.String name, java.lang.Class<?> type, java.lang.Object service, java.lang.String proxytype) Add a service to the platform.
IServiceInvocationInterceptor[]	getInterceptors(java.lang.Object service) Get the interceptors of a service.
<T> T	getProvidedService(java.lang.Class<T> clazz) Get provided (declared) service.
<T> T	getProvidedService(IServiceIdentifier sid) Get the provided service implementation object by id.
IService	getProvidedService(java.lang.String name) Get provided (declared) service.
<T> T	getProvidedServiceRawImpl(java.lang.Class<T> clazz) Get the provided service implementation object by class.
java.lang.Object	getProvidedServiceRawImpl(IServiceIdentifier sid) Get the provided service implementation object by name.
java.lang.Object	getProvidedServiceRawImpl(java.lang.String name) Get the provided service implementation object by name.
<T> T[]	getProvidedServices(java.lang.Class<T> clazz) Get provided (declared) service.
boolean	hasMethodListeners(IServiceIdentifier sid, MethodInfo mi) Test if service and method has listeners.
void	notifyMethodListeners(IServiceIdentifier sid, boolean start, java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.Object callid, ServiceInvocationContext context) Notify listeners that a service method has been called.
void	removeInterceptor(IServiceInvocationInterceptor interceptor, java.lang.Object service) Remove a service interceptor.
void	removeMethodInvocationListener(IServiceIdentifier sid, MethodInfo mi, IMethodInvocationListener listener) Remove a method invocation handler.
IFuture<java.lang.Void>	removeService(IServiceIdentifier sid) Removes a service from the container (shutdowns also the service if the container is running).

Method Detail

addService

IFuture<java.lang.Void> addService(java.lang.String name,
                                   java.lang.Class<?> type,
                                   java.lang.Object service)

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.

addService

IFuture<java.lang.Void> addService(java.lang.String name,
                                   java.lang.Class<?> type,
                                   java.lang.Object service,
                                   java.lang.String proxytype)

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

Parameters:

type - The public service interface.

service - The service.

type - The proxy type (@see{BasicServiceInvocationHandler}).

addService

IFuture<java.lang.Void> addService(java.lang.String name,
                                   java.lang.Class<?> type,
                                   java.lang.Object service,
                                   PublishInfo pi,
                                   java.lang.String scope)

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

Parameters:

type - The public service interface.

service - The service.

scope - The service scope.

removeService

IFuture<java.lang.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(java.lang.String name)

Get provided (declared) service.

Parameters:

name - The service name.

Returns:

The service.

getProvidedService

<T> T getProvidedService(java.lang.Class<T> clazz)

Get provided (declared) service.

Parameters:

clazz - The interface.

Returns:

The service.

getProvidedService

<T> T getProvidedService(IServiceIdentifier sid)

Get the provided service implementation object by id.

Parameters:

name - The service identifier.

Returns:

The service.

getProvidedServices

<T> T[] getProvidedServices(java.lang.Class<T> clazz)

Get provided (declared) service.

Parameters:

clazz - The interface (null for all services).

Returns:

The service.

getProvidedServiceRawImpl

<T> T getProvidedServiceRawImpl(java.lang.Class<T> clazz)

Get the provided service implementation object by class.

Parameters:

clazz - The service clazz.

Returns:

The service.

getProvidedServiceRawImpl

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

Get the provided service implementation object by name.

Parameters:

name - The service name.

Returns:

The service.

getProvidedServiceRawImpl

java.lang.Object getProvidedServiceRawImpl(IServiceIdentifier sid)

Get the provided service implementation object by name.

Parameters:

name - The service identifier.

Returns:

The service.

addMethodInvocationListener

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

Add a method invocation handler.

Parameters:

sid - The service identifier.

mi - The method info.

listener - The method listener.

removeMethodInvocationListener

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

Remove a method invocation handler.

Parameters:

sid - The service identifier.

mi - The method info.

listener - The method listener.

hasMethodListeners

boolean hasMethodListeners(IServiceIdentifier sid,
                           MethodInfo mi)

Test if service and method has listeners.

Parameters:

sid - The service identifier.

mi - The method info.

notifyMethodListeners

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

Notify listeners that a service method has been called.

addInterceptor

void addInterceptor(IServiceInvocationInterceptor interceptor,
                    java.lang.Object service,
                    int pos)

Add a service interceptor.

Parameters:

interceptor - The interceptor.

service - The service.

pos - The position (0=first, -1=last-1, i.e. one before method invocation).

removeInterceptor

void removeInterceptor(IServiceInvocationInterceptor interceptor,
                       java.lang.Object service)

Remove a service interceptor.

Parameters:

interceptor - The interceptor.

service - The service.

getInterceptors

IServiceInvocationInterceptor[] getInterceptors(java.lang.Object service)

Get the interceptors of a service.

Parameters:

service - The service.

Returns:

The interceptors.