jadex.commons.beans.beancontext

Class BeanContextServicesSupport

java.lang.Object

jadex.commons.beans.beancontext.BeanContextChildSupport

jadex.commons.beans.beancontext.BeanContextSupport

jadex.commons.beans.beancontext.BeanContextServicesSupport

All Implemented Interfaces:

BeanContext, BeanContextChild, BeanContextServiceRevokedListener, BeanContextServices, BeanContextServicesListener, DesignMode, PropertyChangeListener, VetoableChangeListener, Visibility, Serializable, Iterable, Collection, EventListener

public class BeanContextServicesSupport
extends BeanContextSupport
implements BeanContextServices, Serializable

This support class implements BeanContextServices interface. This class can be used directly, or be a super class of your class, or be a delegate of your implementation that needs to support BeanContextServices interface.

See Also:

Serialized Form

Field Summary

Fields inherited from class jadex.commons.beans.beancontext.BeanContextChildSupport

beanContextChildPeer

Fields inherited from interface jadex.commons.beans.beancontext.BeanContext

globalHierarchyLock

Fields inherited from interface jadex.commons.beans.DesignMode

PROPERTYNAME

Constructor Summary

Constructors

Constructor and Description
BeanContextServicesSupport() Constructs a standard BeanContextServicesSupport.
BeanContextServicesSupport(BeanContextServices peer) Constructs a BeanContextServicesSupport which is a delegate of the given peer.
BeanContextServicesSupport(BeanContextServices peer, Locale locale) Constructs a BeanContextServicesSupport which is a delegate of the given peer.
BeanContextServicesSupport(BeanContextServices peer, Locale locale, boolean designTime) Constructs a BeanContextServicesSupport which is a delegate of the given peer.
BeanContextServicesSupport(BeanContextServices peer, Locale locale, boolean designTime, boolean okToUseGui) Constructs a BeanContextServicesSupport which is a delegate of the given peer.

Method Summary

Methods

Modifier and Type	Method and Description
void	addBeanContextServicesListener(BeanContextServicesListener listener)
boolean	addService(Class serviceClass, BeanContextServiceProvider provider) Add a service to this context.
BeanContextServices	getBeanContextServicesPeer() Returns the peer of this context casted as BeanContextServices.
Iterator	getCurrentServiceClasses() Returns an iterator of all registered service classes, with removed() disabled.
Iterator	getCurrentServiceSelectors(Class serviceClass) Returns the service selectors of the specified service.
Object	getService(BeanContextChild child, Object requestor, Class serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) Get a service instance on behalf of the specified child of this context, by calling the registered service provider, or by delegating to the parent context.
boolean	hasService(Class serviceClass) Checks whether a service is registed in this context or the parent context.
void	initialize() Initializes all transient fields of this instance, called by constructors and readObject().
void	releaseService(BeanContextChild child, Object requestor, Object service) Release a service which has been requested previously.
void	removeBeanContextServicesListener(BeanContextServicesListener listener)
void	revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow) Revokes a service in this bean context.
void	serviceAvailable(BeanContextServiceAvailableEvent event) Notify all listeners and children that implements BeanContextServices of the event.
void	serviceRevoked(BeanContextServiceRevokedEvent event) Notify all listeners and children that implements BeanContextServices of the event.

Methods inherited from class jadex.commons.beans.beancontext.BeanContextSupport

add, addAll, addBeanContextMembershipListener, avoidingGui, clear, contains, containsAll, containsKey, dontUseGui, getBeanContextPeer, getLocale, getResource, getResourceAsStream, instantiateChild, isDesignTime, isEmpty, isSerializing, iterator, needsGui, okToUseGui, propertyChange, readChildren, remove, removeAll, removeBeanContextMembershipListener, retainAll, setDesignTime, setLocale, size, toArray, toArray, vetoableChange, writeChildren

Methods inherited from class jadex.commons.beans.beancontext.BeanContextChildSupport

addPropertyChangeListener, addVetoableChangeListener, firePropertyChange, fireVetoableChange, getBeanContext, getBeanContextChildPeer, isDelegated, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext, validatePendingSetBeanContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface jadex.commons.beans.beancontext.BeanContext

addBeanContextMembershipListener, getResource, getResourceAsStream, instantiateChild, removeBeanContextMembershipListener

Methods inherited from interface jadex.commons.beans.beancontext.BeanContextChild

addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext

Methods inherited from interface java.util.Collection

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Methods inherited from interface jadex.commons.beans.DesignMode

isDesignTime, setDesignTime

Methods inherited from interface jadex.commons.beans.Visibility

avoidingGui, dontUseGui, needsGui, okToUseGui

Constructor Detail

BeanContextServicesSupport

public BeanContextServicesSupport()

Constructs a standard BeanContextServicesSupport.

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer)

Constructs a BeanContextServicesSupport which is a delegate of the given peer.

Parameters:

peer - the peer of this context

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                          Locale locale)

Constructs a BeanContextServicesSupport which is a delegate of the given peer.

Parameters:

peer - the peer of this context

locale - the locale of this context

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                          Locale locale,
                          boolean designTime)

Constructs a BeanContextServicesSupport which is a delegate of the given peer.

Parameters:

peer - the peer of this context

locale - the locale of this context

designTime - whether in design mode or not

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                          Locale locale,
                          boolean designTime,
                          boolean okToUseGui)

Constructs a BeanContextServicesSupport which is a delegate of the given peer.

Parameters:

peer - the peer of this context

locale - the locale of this context

designTime - whether in design mode or not

okToUseGui - whether GUI is usable or not

Method Detail

addBeanContextServicesListener

public void addBeanContextServicesListener(BeanContextServicesListener listener)

Specified by:

addBeanContextServicesListener in interface BeanContextServices

addService

public boolean addService(Class serviceClass,
                 BeanContextServiceProvider provider)

Add a service to this context.

Delegate to addService(serviceClass, provider, true).

Specified by:

addService in interface BeanContextServices

See Also:

BeanContextServices.addService(java.lang.Class, jadex.commons.beans.beancontext.BeanContextServiceProvider)

getBeanContextServicesPeer

public BeanContextServices getBeanContextServicesPeer()

Returns the peer of this context casted as BeanContextServices.

Returns:

the peer of this context casted as BeanContextServices

getCurrentServiceClasses

public Iterator getCurrentServiceClasses()

Returns an iterator of all registered service classes, with removed() disabled.

Specified by:

getCurrentServiceClasses in interface BeanContextServices

Returns:

an iterator of all registered service classes

See Also:

BeanContextServices.getCurrentServiceClasses()

getCurrentServiceSelectors

public Iterator getCurrentServiceSelectors(Class serviceClass)

Returns the service selectors of the specified service. The iterator's remove() operation is disabled.

Specified by:

getCurrentServiceSelectors in interface BeanContextServices

See Also:

BeanContextServices.getCurrentServiceSelectors(java.lang.Class)

getService

public Object getService(BeanContextChild child,
                Object requestor,
                Class serviceClass,
                Object serviceSelector,
                BeanContextServiceRevokedListener bcsrl)
                  throws TooManyListenersException

Get a service instance on behalf of the specified child of this context, by calling the registered service provider, or by delegating to the parent context.

Specified by:

getService in interface BeanContextServices

Parameters:

child - the child that request service

requestor - the requestor object

serviceClass - the service class

serviceSelector - the service selectors

bcsrl - the BeanContextServiceRevokedListener

Returns:

a service instance on behalf of the specified child of this context

Throws:

IllegalArgumentException - if child is not a child of this context

TooManyListenersException

See Also:

BeanContextServices.getService(jadex.commons.beans.beancontext.BeanContextChild, java.lang.Object, java.lang.Class, java.lang.Object, jadex.commons.beans.beancontext.BeanContextServiceRevokedListener)

hasService

public boolean hasService(Class serviceClass)

Checks whether a service is registed in this context or the parent context.

Specified by:

hasService in interface BeanContextServices

Parameters:

serviceClass - the service class

Returns:

true if the service is registered

See Also:

BeanContextServices.hasService(java.lang.Class)

initialize

public void initialize()

Description copied from class: BeanContextSupport

Initializes all transient fields of this instance, called by constructors and readObject().

releaseService

public void releaseService(BeanContextChild child,
                  Object requestor,
                  Object service)

Release a service which has been requested previously.

Specified by:

releaseService in interface BeanContextServices

Parameters:

child - the child that request the service

requestor - the requestor object

service - the service instance

Throws:

IllegalArgumentException - if child is not a child of this context

removeBeanContextServicesListener

public void removeBeanContextServicesListener(BeanContextServicesListener listener)

Specified by:

removeBeanContextServicesListener in interface BeanContextServices

revokeService

public void revokeService(Class serviceClass,
                 BeanContextServiceProvider serviceProvider,
                 boolean revokeCurrentServicesNow)

Revokes a service in this bean context.

The given service provider is unregistered and a BeanContextServiceRevokedEvent is fired. All registered service listeners and current service users get notified.

Specified by:

revokeService in interface BeanContextServices

Parameters:

serviceClass - the service class

serviceProvider - the service provider

revokeCurrentServicesNow - true if service should be terminated immediantly

See Also:

BeanContextServices.revokeService(java.lang.Class, jadex.commons.beans.beancontext.BeanContextServiceProvider, boolean)

serviceAvailable

public void serviceAvailable(BeanContextServiceAvailableEvent event)

Notify all listeners and children that implements BeanContextServices of the event.

Specified by:

serviceAvailable in interface BeanContextServicesListener

Overrides:

serviceAvailable in class BeanContextChildSupport

See Also:

BeanContextServicesListener.serviceAvailable(jadex.commons.beans.beancontext.BeanContextServiceAvailableEvent)

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent event)

Notify all listeners and children that implements BeanContextServices of the event.

Specified by:

serviceRevoked in interface BeanContextServiceRevokedListener

Overrides:

serviceRevoked in class BeanContextChildSupport

See Also:

BeanContextServiceRevokedListener.serviceRevoked(jadex.commons.beans.beancontext.BeanContextServiceRevokedEvent)