| java.beans.beancontext.BeanContextServices
All known Subclasses: java.beans.beancontext.BeanContextServicesSupport,
| BeanContextServices | | public interface BeanContextServices extends BeanContext,BeanContextServicesListener(Code) | |
The BeanContextServices interface provides a mechanism for a BeanContext
to expose generic "services" to the BeanContextChild objects within.
|
| Method Summary | |
| void | addBeanContextServicesListener(BeanContextServicesListener bcsl)
| | boolean | addService(Class serviceClass, BeanContextServiceProvider serviceProvider)
Adds a service to this BeanContext.
BeanContextServiceProviders call this method
to register a particular service with this context. | | Iterator | getCurrentServiceClasses()
Gets the currently available services for this context. | | Iterator | getCurrentServiceSelectors(Class serviceClass)
Gets the list of service dependent service parameters
(Service Selectors) for the specified service, by
calling getCurrentServiceSelectors() on the
underlying BeanContextServiceProvider. | | Object | getService(BeanContextChild child, Object requestor, Class serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl)
A BeanContextChild, or any arbitrary object
associated with a BeanContextChild, may obtain
a reference to a currently registered service from its
nesting BeanContextServices
via invocation of this method. | | boolean | hasService(Class serviceClass)
Reports whether or not a given service is
currently available from this context. | | void | releaseService(BeanContextChild child, Object requestor, Object service)
Releases a BeanContextChild's
(or any arbitrary object associated with a BeanContextChild)
reference to the specified service by calling releaseService()
on the underlying BeanContextServiceProvider. | | void | removeBeanContextServicesListener(BeanContextServicesListener bcsl)
| | void | revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow)
BeanContextServiceProviders wishing to remove
a currently registered service from this context
may do so via invocation of this method. |
| addBeanContextServicesListener | | void addBeanContextServicesListener(BeanContextServicesListener bcsl)(Code) | | Adds a BeanContextServicesListener to this BeanContext
Parameters:
bcsl - the BeanContextServicesListener to add |
| addService | | boolean addService(Class serviceClass, BeanContextServiceProvider serviceProvider)(Code) | | Adds a service to this BeanContext.
BeanContextServiceProviders call this method
to register a particular service with this context.
If the service has not previously been added, the
BeanContextServices associates
the service with the BeanContextServiceProvider and
fires a BeanContextServiceAvailableEvent to all
currently registered BeanContextServicesListeners.
The method then returns true, indicating that
the addition of the service was successful.
If the given service has already been added, this method
simply returns false.
Parameters:
serviceClass - the service to add
Parameters:
serviceProvider - the BeanContextServiceProvider associated with the service |
| getCurrentServiceClasses | | Iterator getCurrentServiceClasses()(Code) | | Gets the currently available services for this context.
an Iterator consisting of the currently available services |
| getCurrentServiceSelectors | | Iterator getCurrentServiceSelectors(Class serviceClass)(Code) | | Gets the list of service dependent service parameters
(Service Selectors) for the specified service, by
calling getCurrentServiceSelectors() on the
underlying BeanContextServiceProvider.
Parameters:
serviceClass - the specified service the currently available service selectors for the named serviceClass |
| getService | | Object getService(BeanContextChild child, Object requestor, Class serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) throws TooManyListenersException(Code) | | A BeanContextChild, or any arbitrary object
associated with a BeanContextChild, may obtain
a reference to a currently registered service from its
nesting BeanContextServices
via invocation of this method. When invoked, this method
gets the service by calling the getService() method on the
underlying BeanContextServiceProvider.
Parameters:
child - the BeanContextChild associated with this request
Parameters:
requestor - the object requesting the service
Parameters:
serviceClass - class of the requested service
Parameters:
serviceSelector - the service dependent parameter
Parameters:
bcsrl - the BeanContextServiceRevokedListener to notifyif the service should later become revoked
throws:
TooManyListenersException - a reference to this context's named Service as requested or null |
| hasService | | boolean hasService(Class serviceClass)(Code) | | Reports whether or not a given service is
currently available from this context.
Parameters:
serviceClass - the service in question true if the service is available |
| releaseService | | void releaseService(BeanContextChild child, Object requestor, Object service)(Code) | | Releases a BeanContextChild's
(or any arbitrary object associated with a BeanContextChild)
reference to the specified service by calling releaseService()
on the underlying BeanContextServiceProvider.
Parameters:
child - the BeanContextChild
Parameters:
requestor - the requestor
Parameters:
service - the service |
| removeBeanContextServicesListener | | void removeBeanContextServicesListener(BeanContextServicesListener bcsl)(Code) | | Removes a BeanContextServicesListener
from this BeanContext
Parameters:
bcsl - the BeanContextServicesListener to remove from this context |
| revokeService | | void revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow)(Code) | | BeanContextServiceProviders wishing to remove
a currently registered service from this context
may do so via invocation of this method. Upon revocation of
the service, the BeanContextServices fires a
BeanContextServiceRevokedEvent to its
list of currently registered
BeanContextServiceRevokedListeners and
BeanContextServicesListeners.
Parameters:
serviceClass - the service to revoke from this BeanContextServices
Parameters:
serviceProvider - the BeanContextServiceProvider associated withthis particular service that is being revoked
Parameters:
revokeCurrentServicesNow - a value of true indicates an exceptional circumstance where the BeanContextServiceProvider orBeanContextServices wishes to immediately terminate service to all currently outstanding references to the specified service. |
|
|