java.beans.beancontext.BeanContextServices |
Known Indirect Subclasses |
The BeanContextServices interface provides a mechanism for a BeanContext to expose generic "services" to the BeanContextChild objects within.
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
java.beans.DesignMode
|
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
java.beans.beancontext.BeanContext
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Adds a
BeanContextServicesListener to this BeanContext | |||||||||||
Adds a service to this BeanContext.
| |||||||||||
Gets the currently available services for this context.
| |||||||||||
Gets the list of service dependent service parameters
(Service Selectors) for the specified service, by
calling getCurrentServiceSelectors() on the
underlying BeanContextServiceProvider.
| |||||||||||
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. | |||||||||||
Reports whether or not a given service is
currently available from this context.
| |||||||||||
Releases a
BeanContextChild 's
(or any arbitrary object associated with a BeanContextChild)
reference to the specified service by calling releaseService()
on the underlying BeanContextServiceProvider . | |||||||||||
Removes a
BeanContextServicesListener
from this BeanContext | |||||||||||
BeanContextServiceProviders wishing to remove
a currently registered service from this context
may do so via invocation of this method.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
java.beans.DesignMode
| |||||||||||
From interface
java.beans.Visibility
| |||||||||||
From interface
java.beans.beancontext.BeanContext
| |||||||||||
From interface
java.beans.beancontext.BeanContextChild
| |||||||||||
From interface
java.beans.beancontext.BeanContextServiceRevokedListener
| |||||||||||
From interface
java.beans.beancontext.BeanContextServicesListener
| |||||||||||
From interface
java.lang.Iterable
| |||||||||||
From interface
java.util.Collection
|
Adds a BeanContextServicesListener
to this BeanContext
bcsl | the BeanContextServicesListener to add
|
---|
Adds a service to this BeanContext.
BeanContextServiceProvider
s 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
.
serviceClass | the service to add |
---|---|
serviceProvider | the BeanContextServiceProvider
associated with the service
|
Gets the currently available services for this context.
Iterator
consisting of the
currently available services
Gets the list of service dependent service parameters (Service Selectors) for the specified service, by calling getCurrentServiceSelectors() on the underlying BeanContextServiceProvider.
serviceClass | the specified service |
---|
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
.
child | the BeanContextChild
associated with this request |
---|---|
requestor | the object requesting the service |
serviceClass | class of the requested service |
serviceSelector | the service dependent parameter |
bcsrl | the
BeanContextServiceRevokedListener to notify
if the service should later become revoked |
null
TooManyListenersException | |
TooManyListenersException |
Reports whether or not a given service is currently available from this context.
serviceClass | the service in question |
---|
Releases a BeanContextChild
's
(or any arbitrary object associated with a BeanContextChild)
reference to the specified service by calling releaseService()
on the underlying BeanContextServiceProvider
.
child | the BeanContextChild |
---|---|
requestor | the requestor |
service | the service |
Removes a BeanContextServicesListener
from this BeanContext
bcsl | the BeanContextServicesListener
to remove from this context
|
---|
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
.
serviceClass | the service to revoke from this BeanContextServices |
---|---|
serviceProvider | the BeanContextServiceProvider associated with this particular service that is being revoked |
revokeCurrentServicesNow | a value of true
indicates an exceptional circumstance where the
BeanContextServiceProvider or
BeanContextServices wishes to immediately
terminate service to all currently outstanding references
to the specified service.
|