java.beans.beancontext

Class BeanContextServicesSupport

public class BeanContextServicesSupport extends BeanContextSupport implements BeanContextServices

This is a helper class for implementing a bean context which supplies services. It is intended to be used either by subclassing or by calling methods of this implementation from another.

Since: 1.2

Nested Class Summary
protected class	BeanContextServicesSupport.BCSSChild
protected class	BeanContextServicesSupport.BCSSProxyServiceProvider
protected static class	BeanContextServicesSupport.BCSSServiceProvider

Field Summary
protected ArrayList	bcsListeners A collection of listeners who receive availability and revocation notifications.
protected BeanContextServicesSupport.BCSSProxyServiceProvider	proxy
protected int	serializable The number of serializable service providers.
protected HashMap	services A map of registered services, linking the service class to its associated {@link BCSSServiceProvider}.

Constructor Summary
	BeanContextServicesSupport() Construct a {@link BeanContextServicesSupport} instance.
	BeanContextServicesSupport(BeanContextServices peer) Construct a {@link BeanContextServicesSupport} instance.
	BeanContextServicesSupport(BeanContextServices peer, Locale locale) Construct a {@link BeanContextServicesSupport} instance.
	BeanContextServicesSupport(BeanContextServices peer, Locale locale, boolean dtime) Construct a {@link BeanContextServicesSupport} instance.
	BeanContextServicesSupport(BeanContextServices peer, Locale locale, boolean dtime, boolean visible) Construct a {@link BeanContextServicesSupport} instance.

Method Summary
void	addBeanContextServicesListener(BeanContextServicesListener listener) Adds a new listener for service availability and revocation events.
boolean	addService(Class serviceClass, BeanContextServiceProvider bcsp) Registers a new service from the specified service provider.
protected boolean	addService(Class serviceClass, BeanContextServiceProvider bcsp, boolean fireEvent) Registers a new service from the specified service provider.
protected void	bcsPreDeserializationHook(ObjectInputStream ois) Deserializes any service providers which are serializable.
protected void	bcsPreSerializationHook(ObjectOutputStream oos) Serializes any service providers which are serializable.
protected void	childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc) Revokes any services used by a child that has just been removed.
protected BeanContextSupport.BCSChild	createBCSChild(Object targetChild, Object peer) Overrides the {@link BeanContextSupport#createBCSChild} method so as to use a {@link BCSSChild} instead.
protected BeanContextServicesSupport.BCSSServiceProvider	createBCSSServiceProvider(Class sc, BeanContextServiceProvider bcsp) Provides a hook so that subclasses can replace the {@link BCSSServiceProvider} class, used to store registered service providers, with a subclass without replacing the {@link #addService(Class, BeanContextServiceProvider)} method.
protected void	fireServiceAdded(BeanContextServiceAvailableEvent bcssae) Sends a `BeanContextServiceAvailableEvent` to all registered listeners.
protected void	fireServiceAdded(Class serviceClass) Sends a `BeanContextServiceAvailableEvent` to all registered listeners.
protected void	fireServiceRevoked(BeanContextServiceRevokedEvent event) Sends a `BeanContextServiceRevokedEvent` to all registered listeners.
protected void	fireServiceRevoked(Class serviceClass, boolean revokeNow) Sends a `BeanContextServiceRevokedEvent` to all registered listeners.
BeanContextServices	getBeanContextServicesPeer() Returns the services peer given at construction time, or `null` if no peer was given.
protected static BeanContextServicesListener	getChildBeanContextServicesListener(Object child) Returns `child` as an instance of {@link BeanContextServicesListener}, or `null` if `child` does not implement that interface.
Iterator	getCurrentServiceClasses() Returns an iterator over the currently available services.
Iterator	getCurrentServiceSelectors(Class serviceClass) Returns an iterator over the service selectors of the service provider for the given service.
Object	getService(BeanContextChild child, Object requestor, Class serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) Retrieves the specified service.
boolean	hasService(Class serviceClass) Returns true if the specified service is available.
void	initialize()
protected void	initializeBeanContextResources() Subclasses may override this method to allocate resources from the nesting bean context.
protected void	releaseBeanContextResources() Relinquishes any resources obtained from the parent context.
void	releaseService(BeanContextChild child, Object requestor, Object service) Releases the reference to a service held by a {@link BeanContextChild} (or an arbitrary object associated with it).
void	removeBeanContextServicesListener(BeanContextServicesListener listener)
void	revokeService(Class serviceClass, BeanContextServiceProvider bcsp, boolean revokeCurrentServicesNow) Revokes the given service.
void	serviceAvailable(BeanContextServiceAvailableEvent bcssae)
void	serviceRevoked(BeanContextServiceRevokedEvent bcssre)

Field Detail

bcsListeners

protected transient ArrayList bcsListeners

A collection of listeners who receive availability and revocation notifications.

proxy

protected transient BeanContextServicesSupport.BCSSProxyServiceProvider proxy

serializable

protected transient int serializable

The number of serializable service providers.

services

protected transient HashMap services

A map of registered services, linking the service class to its associated {@link BCSSServiceProvider}.