java.beans.beancontext

Class BeanContextSupport

Table des matières

    • Field Detail

      • children

        protected transient HashMap children
        all accesses to the protected HashMap children field shall be synchronized on that object.

      • bcmListeners

        protected transient ArrayList bcmListeners
        all accesses to the protected ArrayList bcmListeners field shall be synchronized on that object.

      • locale

        protected Locale locale
        The current locale of this BeanContext.

      • okToUseGui

        protected boolean okToUseGui
        A boolean indicating if this instance may now render a GUI.

      • designTime

        protected boolean designTime
        A boolean indicating whether or not this object is currently in design time mode.

    • Constructor Detail

      • BeanContextSupport

        public BeanContextSupport(BeanContext peer,
                  Locale lcle,
                  boolean dTime,
                  boolean visible)
        Construct a BeanContextSupport instance
        Parameters:
        peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer
        lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.
        dTime - The initial state, true if in design mode, false if runtime.
        visible - The initial visibility.
        See Also:
        Locale.getDefault(), Locale.setDefault(java.util.Locale)

      • BeanContextSupport

        public BeanContextSupport(BeanContext 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, or null if this object is its own peer
        lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.
        dtime - The initial state, true if in design mode, false if runtime.
        See Also:
        Locale.getDefault(), Locale.setDefault(java.util.Locale)

      • BeanContextSupport

        public BeanContextSupport(BeanContext peer,
                  Locale lcle)
        Create an instance using the specified locale
        Parameters:
        peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer
        lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.
        See Also:
        Locale.getDefault(), Locale.setDefault(java.util.Locale)

      • BeanContextSupport

        public BeanContextSupport(BeanContext peer)
        Create an instance using with a default locale
        Parameters:
        peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer

      • BeanContextSupport

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

    • Method Detail

      • getBeanContextPeer

        public BeanContext getBeanContextPeer()
        Gets the instance of BeanContext that this object is providing the implementation for.
        Returns:
        the BeanContext instance

      • instantiateChild

        public Object instantiateChild(String beanName)
                        throws IOException,
                               ClassNotFoundException

        The instantiateChild method is a convenience hook in BeanContext to simplify the task of instantiating a Bean, nested, into a BeanContext.

        The semantics of the beanName parameter are defined by java.beans.Beans.instantate.

        Specified by:
        instantiateChild in interface BeanContext
        Parameters:
        beanName - the name of the Bean to instantiate within this BeanContext
        Returns:
        the new object
        Throws:
        IOException - if there is an I/O error when the bean is being deserialized
        ClassNotFoundException - if the class identified by the beanName parameter is not found

      • size

        public int size()
        Gets the number of children currently nested in this BeanContext.
        Specified by:
        size in interface Collection
        Returns:
        number of children

      • isEmpty

        public boolean isEmpty()
        Reports whether or not this BeanContext is empty. A BeanContext is considered empty when it contains zero nested children.
        Specified by:
        isEmpty in interface Collection
        Returns:
        if there are not children

      • contains

        public boolean contains(Object o)
        Determines whether or not the specified object is currently a child of this BeanContext.
        Specified by:
        contains in interface Collection
        Parameters:
        o - the Object in question
        Returns:
        if this object is a child

      • containsKey

        public boolean containsKey(Object o)
        Determines whether or not the specified object is currently a child of this BeanContext.
        Parameters:
        o - the Object in question
        Returns:
        if this object is a child

      • iterator

        public Iterator iterator()
        Gets all JavaBean or BeanContext instances currently nested in this BeanContext.
        Specified by:
        iterator in interface Iterable
        Specified by:
        iterator in interface Collection
        Returns:
        an Iterator of the nested children

      • toArray

        public Object[] toArray()
        Gets all JavaBean or BeanContext instances currently nested in this BeanContext.
        Specified by:
        toArray in interface Collection
        Returns:
        an array containing all of the elements in this collection

      • toArray

        public Object[] toArray(Object[] arry)
        Gets an array containing all children of this BeanContext that match the types contained in arry.
        Specified by:
        toArray in interface Collection
        Parameters:
        arry - The array of object types that are of interest.
        Returns:
        an array of children

      • 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.

        Parameters:
        targetChild - the child to create the Child on behalf of
        peer - the peer if the tragetChild and the peer are related by an implementation of BeanContextProxy

      • add

        public boolean add(Object targetChild)
        Adds/nests a child within this BeanContext.

        Invoked as a side effect of java.beans.Beans.instantiate(). If the child object is not valid for adding then this method throws an IllegalStateException.

        Specified by:
        add in interface Collection
        Parameters:
        targetChild - The child objects to nest within this BeanContext
        Returns:
        true if the child was added successfully.
        See Also:
        validatePendingAdd(java.lang.Object)

      • remove

        public boolean remove(Object targetChild)
        Removes a child from this BeanContext. If the child object is not for adding then this method throws an IllegalStateException.
        Specified by:
        remove in interface Collection
        Parameters:
        targetChild - The child objects to remove
        Returns:
        true if an element was removed as a result of this call
        See Also:
        validatePendingRemove(java.lang.Object)

      • remove

        protected boolean remove(Object targetChild,
             boolean callChildSetBC)
        internal remove used when removal caused by unexpected setBeanContext or by remove() invocation.
        Parameters:
        targetChild - the JavaBean, BeanContext, or Object to be removed
        callChildSetBC - used to indicate that the child should be notified that it is no longer nested in this BeanContext.

      • containsAll

        public boolean containsAll(Collection c)
        Tests to see if all objects in the specified Collection are children of this BeanContext.
        Specified by:
        containsAll in interface Collection
        Parameters:
        c - the specified Collection
        Returns:
        true if all objects in the collection are children of this BeanContext, false if not.
        See Also:
        Collection.contains(Object)

      • addAll

        public boolean addAll(Collection c)
        add Collection to set of Children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field
        Specified by:
        addAll in interface Collection
        Parameters:
        c - collection containing elements to be added to this collection
        Returns:
        true if this collection changed as a result of the call
        Throws:
        UnsupportedOperationException
        See Also:
        Collection.add(Object)

      • clear

        public void clear()
        clear the children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field
        Specified by:
        clear in interface Collection
        Throws:
        UnsupportedOperationException

      • getResourceAsStream

        public InputStream getResourceAsStream(String name,
                              BeanContextChild bcc)
        Description copied from interface: BeanContext
        Analagous to java.lang.ClassLoader.getResourceAsStream(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.
        Specified by:
        getResourceAsStream in interface BeanContext
        Parameters:
        name - the name of the resource requested.
        bcc - the child object making the request.
        Returns:
        the requested resource as an InputStream
        Throws:
        NullPointerException

      • getResource

        public URL getResource(String name,
              BeanContextChild bcc)
        Description copied from interface: BeanContext
        Analagous to java.lang.ClassLoader.getResource(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.
        Specified by:
        getResource in interface BeanContext
        Parameters:
        name - the name of the resource requested.
        bcc - the child object making the request.
        Returns:
        the requested resource as an InputStream

      • isDesignTime

        public boolean isDesignTime()
        Reports whether or not this object is in currently in design time mode.
        Specified by:
        isDesignTime in interface DesignMode
        Returns:
        true if in design time mode, false if not

      • setLocale

        public void setLocale(Locale newLocale)
               throws PropertyVetoException
        Sets the locale of this BeanContext.
        Parameters:
        newLocale - the new locale. This method call will have no effect if newLocale is null.
        Throws:
        PropertyVetoException - if the new value is rejected

      • getLocale

        public Locale getLocale()
        Gets the locale for this BeanContext.
        Returns:
        the current Locale of the BeanContext

      • needsGui

        public boolean needsGui()

        This method is typically called from the environment in order to determine if the implementor "needs" a GUI.

        The algorithm used herein tests the BeanContextPeer, and its current children to determine if they are either Containers, Components, or if they implement Visibility and return needsGui() == true.

        Specified by:
        needsGui in interface Visibility
        Returns:
        true if the implementor needs a GUI

      • dontUseGui

        public void dontUseGui()
        notify this instance that it may no longer render a GUI.
        Specified by:
        dontUseGui in interface Visibility

      • okToUseGui

        public void okToUseGui()
        Notify this instance that it may now render a GUI
        Specified by:
        okToUseGui in interface Visibility

      • avoidingGui

        public boolean avoidingGui()
        Used to determine if the BeanContext child is avoiding using its GUI.
        Specified by:
        avoidingGui in interface Visibility
        Returns:
        is this instance avoiding using its GUI?
        See Also:
        Visibility

      • isSerializing

        public boolean isSerializing()
        Is this BeanContext in the process of being serialized?
        Returns:
        if this BeanContext is currently being serialized

      • bcsChildren

        protected Iterator bcsChildren()
        Returns an iterator of all children of this BeanContext.
        Returns:
        an iterator for all the current BCSChild values

      • bcsPreSerializationHook

        protected void bcsPreSerializationHook(ObjectOutputStream oos)
                                throws IOException
        called by writeObject after defaultWriteObject() but prior to serialization of currently serializable children. This method may be overridden by subclasses to perform custom serialization of their state prior to this superclass serializing the children. This method should not however be used by subclasses to replace their own implementation (if any) of writeObject().
        Throws:
        IOException

      • bcsPreDeserializationHook

        protected void bcsPreDeserializationHook(ObjectInputStream ois)
                                  throws IOException,
                                         ClassNotFoundException
        called by readObject after defaultReadObject() but prior to deserialization of any children. This method may be overridden by subclasses to perform custom deserialization of their state prior to this superclass deserializing the children. This method should not however be used by subclasses to replace their own implementation (if any) of readObject().
        Throws:
        IOException
        ClassNotFoundException

      • childDeserializedHook

        protected void childDeserializedHook(Object child,
                         BeanContextSupport.BCSChild bcsc)
        Called by readObject with the newly deserialized child and BCSChild.
        Parameters:
        child - the newly deserialized child
        bcsc - the newly deserialized BCSChild

      • serialize

        protected final void serialize(ObjectOutputStream oos,
             Collection coll)
                        throws IOException
        Used by writeObject to serialize a Collection.
        Parameters:
        oos - the ObjectOutputStream to use during serialization
        coll - the Collection to serialize
        Throws:
        IOException - if serialization failed

      • writeChildren

        public final void writeChildren(ObjectOutputStream oos)
                         throws IOException
        Used to serialize all children of this BeanContext.
        Parameters:
        oos - the ObjectOutputStream to use during serialization
        Throws:
        IOException - if serialization failed

      • propertyChange

        public void propertyChange(PropertyChangeEvent pce)
        subclasses may envelope to monitor child property changes.
        Specified by:
        propertyChange in interface PropertyChangeListener
        Parameters:
        pce - A PropertyChangeEvent object describing the event source and the property that has changed.

      • validatePendingAdd

        protected boolean validatePendingAdd(Object targetChild)

        Subclasses of this class may override, or envelope, this method to add validation behavior for the BeanContext to examine child objects immediately prior to their being added to the BeanContext.

        Returns:
        true iff the child may be added to this BeanContext, otherwise false.

      • validatePendingRemove

        protected boolean validatePendingRemove(Object targetChild)

        Subclasses of this class may override, or envelope, this method to add validation behavior for the BeanContext to examine child objects immediately prior to their being removed from the BeanContext.

        Returns:
        true iff the child may be removed from this BeanContext, otherwise false.

      • childJustAddedHook

        protected void childJustAddedHook(Object child,
                      BeanContextSupport.BCSChild bcsc)
        subclasses may override this method to simply extend add() semantics after the child has been added and before the event notification has occurred. The method is called with the child synchronized.

      • childJustRemovedHook

        protected void childJustRemovedHook(Object child,
                        BeanContextSupport.BCSChild bcsc)
        subclasses may override this method to simply extend remove() semantics after the child has been removed and before the event notification has occurred. The method is called with the child synchronized.

      • getChildVisibility

        protected static final Visibility getChildVisibility(Object child)
        Gets the Component (if any) associated with the specified child.
        Parameters:
        child - the specified child
        Returns:
        the Component (if any) associated with the specified child.

      • getChildSerializable

        protected static final Serializable getChildSerializable(Object child)
        Gets the Serializable (if any) associated with the specified Child
        Parameters:
        child - the specified child
        Returns:
        the Serializable (if any) associated with the specified Child

      • getChildPropertyChangeListener

        protected static final PropertyChangeListener getChildPropertyChangeListener(Object child)
        Gets the PropertyChangeListener (if any) of the specified child
        Parameters:
        child - the specified child
        Returns:
        the PropertyChangeListener (if any) of the specified child

      • getChildVetoableChangeListener

        protected static final VetoableChangeListener getChildVetoableChangeListener(Object child)
        Gets the VetoableChangeListener (if any) of the specified child
        Parameters:
        child - the specified child
        Returns:
        the VetoableChangeListener (if any) of the specified child

      • getChildBeanContextMembershipListener

        protected static final BeanContextMembershipListener getChildBeanContextMembershipListener(Object child)
        Gets the BeanContextMembershipListener (if any) of the specified child
        Parameters:
        child - the specified child
        Returns:
        the BeanContextMembershipListener (if any) of the specified child

      • getChildBeanContextChild

        protected static final BeanContextChild getChildBeanContextChild(Object child)
        Gets the BeanContextChild (if any) of the specified child
        Parameters:
        child - the specified child
        Returns:
        the BeanContextChild (if any) of the specified child
        Throws:
        IllegalArgumentException - if child implements both BeanContextChild and BeanContextProxy

      • fireChildrenAdded

        protected final void fireChildrenAdded(BeanContextMembershipEvent bcme)
        Fire a BeanContextshipEvent on the BeanContextMembershipListener interface

      • fireChildrenRemoved

        protected final void fireChildrenRemoved(BeanContextMembershipEvent bcme)
        Fire a BeanContextshipEvent on the BeanContextMembershipListener interface

      • initialize

        protected void initialize()
        protected method called from constructor and readObject to initialize transient state of BeanContextSupport instance. This class uses this method to instantiate inner class listeners used to monitor PropertyChange and VetoableChange events on children. subclasses may envelope this method to add their own initialization behavior

      • copyChildren

        protected final Object[] copyChildren()
        Gets a copy of the this BeanContext's children.
        Returns:
        a copy of the current nested children

      • classEquals

        protected static final boolean classEquals(Class first,
                  Class second)
        Tests to see if two class objects, or their names are equal.
        Parameters:
        first - the first object
        second - the second object
        Returns:
        true if equal, false if not

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Version en cache

22/12/2024 09:15:58 Cette version de la page est en cache (à la date du 22/12/2024 09:15:58) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 26/07/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/beans/beancontext/BeanContextSupport.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, BeanContextSupport

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut