public class BeanContextServicesSupport extends BeanContextSupport implements BeanContextServices
This helper class provides a utility implementation of the java.beans.beancontext.BeanContextServices interface.
Since this class directly implements the BeanContextServices interface, the class can, and is intended to be used either by subclassing this implementation, or via delegation of an instance of this class from another through the BeanContextProxy interface.
Modifier and Type | Class and Description |
---|---|
protected class |
BeanContextServicesSupport.BCSSChild |
protected class |
BeanContextServicesSupport.BCSSProxyServiceProvider |
protected static class |
BeanContextServicesSupport.BCSSServiceProvider subclasses may subclass this nested class to add behaviors for each BeanContextServicesProvider. |
BeanContextSupport.BCSChild, BeanContextSupport.BCSIterator
protected transient HashMap services
all accesses to the protected transient HashMap services
field should be synchronized on that object
protected transient int serializable
The number of instances of a serializable BeanContextServceProvider
.
protected transient BeanContextServicesSupport.BCSSProxyServiceProvider proxy
Delegate for the BeanContextServiceProvider
.
protected transient ArrayList bcsListeners
List of BeanContextServicesListener
objects.
public BeanContextServicesSupport(BeanContextServices peer, Locale lcle, boolean dTime, boolean visible)
Construct a BeanContextServicesSupport instance
peer
- The peer BeanContext we are supplying an implementation for, if null the this object is its own peerlcle
- The current Locale for this BeanContext.dTime
- The initial state, true if in design mode, false if runtime.visible
- The initial visibility.public BeanContextServicesSupport(BeanContextServices peer, Locale lcle, boolean dtime)
Create an instance using the specified Locale and design mode.
peer
- The peer BeanContext we are supplying an implementation for, if null the this object is its own peerlcle
- The current Locale for this BeanContext.dtime
- The initial state, true if in design mode, false if runtime.public BeanContextServicesSupport(BeanContextServices peer, Locale lcle)
Create an instance using the specified locale
peer
- The peer BeanContext we are supplying an implementation for, if null the this object is its own peerlcle
- The current Locale for this BeanContext.public BeanContextServicesSupport(BeanContextServices peer)
Create an instance with a peer
peer
- The peer BeanContext we are supplying an implementation for, if null the this object is its own peerpublic BeanContextServicesSupport()
Create an instance that is not a delegate of another object
public void initialize()
called by BeanContextSupport superclass during construction and deserialization to initialize subclass transient state. subclasses may envelope this method, but should not override it or call it directly.
initialize
in class BeanContextSupport
public BeanContextServices getBeanContextServicesPeer()
Gets the BeanContextServices
associated with this BeanContextServicesSupport
.
BeanContext
this object is providing the implementation for.protected BeanContextSupport.BCSChild createBCSChild(Object targetChild, Object peer)
Subclasses can override this method to insert their own subclass of Child without having to override add() or the other Collection methods that add children to the set.
createBCSChild
in class BeanContextSupport
targetChild
- the child to create the Child on behalf ofpeer
- the peer if the targetChild and peer are related by BeanContextProxyprotected BeanContextServicesSupport.BCSSServiceProvider createBCSSServiceProvider(Class sc, BeanContextServiceProvider bcsp)
subclasses can override this method to create new subclasses of BCSSServiceProvider without having to override addService() in order to instantiate.
sc
- the classbcsp
- the service providerpublic void addBeanContextServicesListener(BeanContextServicesListener bcsl)
add a BeanContextServicesListener
addBeanContextServicesListener
in interface BeanContextServices
bcsl
- the BeanContextServicesListener
to addNullPointerException
- if the argument is nullpublic void removeBeanContextServicesListener(BeanContextServicesListener bcsl)
remove a BeanContextServicesListener
removeBeanContextServicesListener
in interface BeanContextServices
bcsl
- the BeanContextServicesListener
to remove from this contextpublic boolean addService(Class serviceClass, BeanContextServiceProvider bcsp)
add a service
addService
in interface BeanContextServices
serviceClass
- the service classbcsp
- the service providerprotected boolean addService(Class serviceClass, BeanContextServiceProvider bcsp, boolean fireEvent)
add a service
serviceClass
- the service classbcsp
- the service providerfireEvent
- whether or not an event should be firedpublic void revokeService(Class serviceClass, BeanContextServiceProvider bcsp, boolean revokeCurrentServicesNow)
remove a service
revokeService
in interface BeanContextServices
serviceClass
- the service classbcsp
- the service providerrevokeCurrentServicesNow
- whether or not to revoke the servicepublic boolean hasService(Class serviceClass)
has a service, which may be delegated
hasService
in interface BeanContextServices
serviceClass
- the service in questionpublic Object getService(BeanContextChild child, Object requestor, Class serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) throws TooManyListenersException
obtain a service which may be delegated
getService
in interface BeanContextServices
child
- the BeanContextChild
associated with this requestrequestor
- the object requesting the serviceserviceClass
- class of the requested serviceserviceSelector
- the service dependent parameterbcsrl
- the BeanContextServiceRevokedListener
to notify if the service should later become revokednull
TooManyListenersException
- if there are too many listenerspublic void releaseService(BeanContextChild child, Object requestor, Object service)
release a service
releaseService
in interface BeanContextServices
child
- the BeanContextChild
requestor
- the requestorservice
- the servicepublic Iterator getCurrentServiceClasses()
Description copied from interface: BeanContextServices
Gets the currently available services for this context.
getCurrentServiceClasses
in interface BeanContextServices
public Iterator getCurrentServiceSelectors(Class serviceClass)
Description copied from interface: BeanContextServices
Gets the list of service dependent service parameters (Service Selectors) for the specified service, by calling getCurrentServiceSelectors() on the underlying BeanContextServiceProvider.
getCurrentServiceSelectors
in interface BeanContextServices
serviceClass
- the specified servicepublic void serviceAvailable(BeanContextServiceAvailableEvent bcssae)
BeanContextServicesListener callback, propagates event to all currently registered listeners and BeanContextServices children, if this BeanContextService does not already implement this service itself. subclasses may override or envelope this method to implement their own propagation semantics.
serviceAvailable
in interface BeanContextServicesListener
serviceAvailable
in class BeanContextChildSupport
bcssae
- The BeanContextServiceAvailableEvent fired as a result of a service becoming availablepublic void serviceRevoked(BeanContextServiceRevokedEvent bcssre)
BeanContextServicesListener callback, propagates event to all currently registered listeners and BeanContextServices children, if this BeanContextService does not already implement this service itself. subclasses may override or envelope this method to implement their own propagation semantics.
serviceRevoked
in interface BeanContextServiceRevokedListener
serviceRevoked
in class BeanContextChildSupport
bcssre
- The BeanContextServiceRevokedEvent
fired as a result of a service being revokedprotected static final BeanContextServicesListener getChildBeanContextServicesListener(Object child)
Gets the BeanContextServicesListener
(if any) of the specified child.
child
- the specified childprotected void childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)
called from superclass child removal operations after a child has been successfully removed. called with child synchronized. This subclass uses this hook to immediately revoke any services being used by this child if it is a BeanContextChild. subclasses may envelope this method in order to implement their own child removal side-effects.
childJustRemovedHook
in class BeanContextSupport
child
- the childbcsc
- the BCSChildprotected void releaseBeanContextResources()
called from setBeanContext to notify a BeanContextChild to release resources obtained from the nesting BeanContext. This method revokes any services obtained from its parent. subclasses may envelope this method to implement their own semantics.
releaseBeanContextResources
in class BeanContextChildSupport
protected void initializeBeanContextResources()
called from setBeanContext to notify a BeanContextChild to allocate resources obtained from the nesting BeanContext. subclasses may envelope this method to implement their own semantics.
initializeBeanContextResources
in class BeanContextChildSupport
protected final void fireServiceAdded(Class serviceClass)
Fires a BeanContextServiceEvent
notifying of a new service.
serviceClass
- the service classprotected final void fireServiceAdded(BeanContextServiceAvailableEvent bcssae)
Fires a BeanContextServiceAvailableEvent
indicating that a new service has become available.
bcssae
- the BeanContextServiceAvailableEvent
protected final void fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)
Fires a BeanContextServiceEvent
notifying of a service being revoked.
bcsre
- the BeanContextServiceRevokedEvent
protected final void fireServiceRevoked(Class serviceClass, boolean revokeNow)
Fires a BeanContextServiceRevokedEvent
indicating that a particular service is no longer available.
serviceClass
- the service classrevokeNow
- whether or not the event should be revoked nowprotected void bcsPreSerializationHook(ObjectOutputStream oos) throws IOException
called from BeanContextSupport writeObject before it serializes the children ... This class will serialize any Serializable BeanContextServiceProviders herein. subclasses may envelope this method to insert their own serialization processing that has to occur prior to serialization of the children
bcsPreSerializationHook
in class BeanContextSupport
oos
- the ObjectOutputStream
to use during serializationIOException
- if serialization failedprotected void bcsPreDeserializationHook(ObjectInputStream ois) throws IOException, ClassNotFoundException
called from BeanContextSupport readObject before it deserializes the children ... This class will deserialize any Serializable BeanContextServiceProviders serialized earlier thus making them available to the children when they deserialized. subclasses may envelope this method to insert their own serialization processing that has to occur prior to serialization of the children
bcsPreDeserializationHook
in class BeanContextSupport
ois
- the ObjectInputStream
to use during deserializationIOException
- if deserialization failedClassNotFoundException
- if needed classes are not found
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.