java.beans.beancontext

Class BeanContextServicesSupport

Contents

    • Field Detail

      • services

        protected transient HashMap services
        all accesses to the protected transient HashMap services field should be synchronized on that object

      • serializable

        protected transient int serializable
        The number of instances of a serializable BeanContextServceProvider.

      • bcsListeners

        protected transient ArrayList bcsListeners
        List of BeanContextServicesListener objects.

    • Constructor Detail

      • BeanContextServicesSupport

        public BeanContextServicesSupport(BeanContextServices peer,
                          Locale lcle,
                          boolean dTime,
                          boolean visible)

        Construct a BeanContextServicesSupport instance

        Parameters:
        peer - The peer BeanContext we are supplying an implementation for, if null the this object is its own peer
        lcle - The current Locale for this BeanContext.
        dTime - The initial state, true if in design mode, false if runtime.
        visible - The initial visibility.

      • BeanContextServicesSupport

        public BeanContextServicesSupport(BeanContextServices peer,
                          Locale lcle,
                          boolean dtime)
        Create an instance using the specified Locale and design mode.
        Parameters:
        peer - The peer BeanContext we are supplying an implementation for, if null the this object is its own peer
        lcle - The current Locale for this BeanContext.
        dtime - The initial state, true if in design mode, false if runtime.

      • BeanContextServicesSupport

        public BeanContextServicesSupport(BeanContextServices peer,
                          Locale lcle)
        Create an instance using the specified locale
        Parameters:
        peer - The peer BeanContext we are supplying an implementation for, if null the this object is its own peer
        lcle - The current Locale for this BeanContext.

      • BeanContextServicesSupport

        public BeanContextServicesSupport(BeanContextServices peer)
        Create an instance with a peer
        Parameters:
        peer - The peer BeanContext we are supplying an implementation for, if null the this object is its own peer

      • BeanContextServicesSupport

        public BeanContextServicesSupport()
        Create an instance that is not a delegate of another object

    • Method Detail

      • initialize

        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.
        Overrides:
        initialize in class BeanContextSupport

      • getBeanContextServicesPeer

        public BeanContextServices getBeanContextServicesPeer()
        Gets the BeanContextServices associated with this BeanContextServicesSupport.
        Returns:
        the instance of BeanContext this object is providing the implementation for.

      • createBCSChild

        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.

        Overrides:
        createBCSChild in class BeanContextSupport
        Parameters:
        targetChild - the child to create the Child on behalf of
        peer - the peer if the targetChild and peer are related by BeanContextProxy

      • revokeService

        public void revokeService(Class serviceClass,
                 BeanContextServiceProvider bcsp,
                 boolean revokeCurrentServicesNow)
        remove a service
        Specified by:
        revokeService in interface BeanContextServices
        Parameters:
        serviceClass - the service to revoke from this BeanContextServices
        bcsp - 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.

      • hasService

        public boolean hasService(Class serviceClass)
        has a service, which may be delegated
        Specified by:
        hasService in interface BeanContextServices
        Parameters:
        serviceClass - the service in question
        Returns:
        true if the service is available

      • getCurrentServiceSelectors

        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.
        Specified by:
        getCurrentServiceSelectors in interface BeanContextServices
        Parameters:
        serviceClass - the specified service
        Returns:
        an iterator for all the currently available service selectors (if any) available for the specified service.

      • serviceAvailable

        public 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.
        Specified by:
        serviceAvailable in interface BeanContextServicesListener
        Overrides:
        serviceAvailable in class BeanContextChildSupport
        Parameters:
        bcssae - The BeanContextServiceAvailableEvent fired as a result of a service becoming available

      • serviceRevoked

        public 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.
        Specified by:
        serviceRevoked in interface BeanContextServiceRevokedListener
        Overrides:
        serviceRevoked in class BeanContextChildSupport
        Parameters:
        bcssre - The BeanContextServiceRevokedEvent fired as a result of a service being revoked

      • getChildBeanContextServicesListener

        protected static final BeanContextServicesListener getChildBeanContextServicesListener(Object child)
        Gets the BeanContextServicesListener (if any) of the specified child.
        Parameters:
        child - the specified child
        Returns:
        the BeanContextServicesListener (if any) of the specified child

      • childJustRemovedHook

        protected 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.
        Overrides:
        childJustRemovedHook in class BeanContextSupport

      • releaseBeanContextResources

        protected 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.
        Overrides:
        releaseBeanContextResources in class BeanContextChildSupport

      • initializeBeanContextResources

        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.
        Overrides:
        initializeBeanContextResources in class BeanContextChildSupport

      • fireServiceAdded

        protected final void fireServiceAdded(Class serviceClass)
        Fires a BeanContextServiceEvent notifying of a new service.

      • fireServiceAdded

        protected final void fireServiceAdded(BeanContextServiceAvailableEvent bcssae)
        Fires a BeanContextServiceAvailableEvent indicating that a new service has become available.
        Parameters:
        bcssae - the BeanContextServiceAvailableEvent

      • fireServiceRevoked

        protected final void fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)
        Fires a BeanContextServiceEvent notifying of a service being revoked.
        Parameters:
        bcsre - the BeanContextServiceRevokedEvent

      • fireServiceRevoked

        protected final void fireServiceRevoked(Class serviceClass,
                      boolean revokeNow)
        Fires a BeanContextServiceRevokedEvent indicating that a particular service is no longer available.

      • bcsPreSerializationHook

        protected 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
        Overrides:
        bcsPreSerializationHook in class BeanContextSupport
        Throws:
        IOException

Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/beans/beancontext/beancontextservicessupport.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut