You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sc...@apache.org on 2003/11/27 23:55:16 UTC

cvs commit: jakarta-commons/collections/src/java/org/apache/commons/collections BagUtils.java CollectionUtils.java SetUtils.java ListUtils.java BufferUtils.java

scolebourne    2003/11/27 14:55:16

  Modified:    collections/src/java/org/apache/commons/collections/observed
                        ObservableSortedBag.java ObservableBuffer.java
                        ObservableSortedSet.java ObservableList.java
                        ModificationEventType.java ModificationEvent.java
                        ModificationHandler.java ObservableBag.java
                        ObservableCollection.java ModificationListener.java
                        ModificationVetoedException.java ObservableSet.java
                        ModificationHandlerFactory.java
               collections/src/java/org/apache/commons/collections/observed/standard
                        StandardPreModificationEvent.java
                        StandardModificationHandler.java
                        StandardPostModificationEvent.java
                        StandardPreModificationListener.java
                        StandardPostModificationListener.java
                        StandardModificationEvent.java
                        StandardModificationListener.java
               collections/src/java/org/apache/commons/collections
                        BagUtils.java CollectionUtils.java SetUtils.java
                        ListUtils.java BufferUtils.java
  Log:
  Deprecate observable implementation, as it is moved to the sandbox
  
  Revision  Changes    Path
  1.4       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableSortedBag.java
  
  Index: ObservableSortedBag.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableSortedBag.java,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- ObservableSortedBag.java	13 Oct 2003 21:18:56 -0000	1.3
  +++ ObservableSortedBag.java	27 Nov 2003 22:55:15 -0000	1.4
  @@ -71,6 +71,7 @@
    * {@link org.apache.commons.collections.observed.standard.StandardModificationHandler StandardModificationHandler}.
    * See this class for details of configuration available.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.4       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableBuffer.java
  
  Index: ObservableBuffer.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableBuffer.java,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- ObservableBuffer.java	13 Oct 2003 21:18:56 -0000	1.3
  +++ ObservableBuffer.java	27 Nov 2003 22:55:15 -0000	1.4
  @@ -69,6 +69,7 @@
    * {@link org.apache.commons.collections.observed.standard.StandardModificationHandler StandardModificationHandler}.
    * See this class for details of configuration available.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.5       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableSortedSet.java
  
  Index: ObservableSortedSet.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableSortedSet.java,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- ObservableSortedSet.java	13 Oct 2003 21:18:56 -0000	1.4
  +++ ObservableSortedSet.java	27 Nov 2003 22:55:15 -0000	1.5
  @@ -70,6 +70,7 @@
    * {@link org.apache.commons.collections.observed.standard.StandardModificationHandler StandardModificationHandler}.
    * See this class for details of configuration available.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.5       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableList.java
  
  Index: ObservableList.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableList.java,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- ObservableList.java	16 Nov 2003 00:05:47 -0000	1.4
  +++ ObservableList.java	27 Nov 2003 22:55:15 -0000	1.5
  @@ -76,6 +76,7 @@
    * All indices on events returned by <code>subList</code> are relative to the
    * base <code>List</code>.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.4       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationEventType.java
  
  Index: ModificationEventType.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationEventType.java,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- ModificationEventType.java	7 Sep 2003 16:50:59 -0000	1.3
  +++ ModificationEventType.java	27 Nov 2003 22:55:15 -0000	1.4
  @@ -73,6 +73,7 @@
    * They may combined using the bitwise OR, <code>|</code>.
    * They may negated using the bitwise NOT, <code>~</code>.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.4       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationEvent.java
  
  Index: ModificationEvent.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationEvent.java,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- ModificationEvent.java	21 Sep 2003 16:00:28 -0000	1.3
  +++ ModificationEvent.java	27 Nov 2003 22:55:15 -0000	1.4
  @@ -65,6 +65,7 @@
    * <p>
    * This class can be used as is, but generally it is subclassed.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.9       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationHandler.java
  
  Index: ModificationHandler.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationHandler.java,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- ModificationHandler.java	9 Oct 2003 20:50:04 -0000	1.8
  +++ ModificationHandler.java	27 Nov 2003 22:55:15 -0000	1.9
  @@ -75,6 +75,7 @@
    * that if you subclass this class, you must check it when you upgrade to a
    * later collections release.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.4       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableBag.java
  
  Index: ObservableBag.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableBag.java,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- ObservableBag.java	13 Oct 2003 21:18:56 -0000	1.3
  +++ ObservableBag.java	27 Nov 2003 22:55:15 -0000	1.4
  @@ -74,6 +74,7 @@
    * NOTE: The {@link #uniqueSet()} method returns a <code>Set</code> that is
    * NOT observed. This is because the set should be unmodifiable.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.4       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableCollection.java
  
  Index: ObservableCollection.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableCollection.java,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- ObservableCollection.java	16 Nov 2003 00:05:47 -0000	1.3
  +++ ObservableCollection.java	27 Nov 2003 22:55:15 -0000	1.4
  @@ -73,6 +73,7 @@
    * The default handler is {@link StandardModificationHandler}.
    * See this class for details of configuration available.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.2       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationListener.java
  
  Index: ModificationListener.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationListener.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- ModificationListener.java	3 Sep 2003 23:54:26 -0000	1.1
  +++ ModificationListener.java	27 Nov 2003 22:55:15 -0000	1.2
  @@ -65,6 +65,7 @@
    * This interface exists to mark independent subclasses as fulfilling the
    * role of an event listener for collection modification events.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.2       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationVetoedException.java
  
  Index: ModificationVetoedException.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationVetoedException.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- ModificationVetoedException.java	3 Sep 2003 23:54:26 -0000	1.1
  +++ ModificationVetoedException.java	27 Nov 2003 22:55:15 -0000	1.2
  @@ -61,6 +61,7 @@
    * Exception thrown when a modification to a collection is vetoed.
    * It extends IllegalArgumentException for compatibility with the collections API.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.4       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableSet.java
  
  Index: ObservableSet.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ObservableSet.java,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- ObservableSet.java	13 Oct 2003 21:18:56 -0000	1.3
  +++ ObservableSet.java	27 Nov 2003 22:55:15 -0000	1.4
  @@ -69,6 +69,7 @@
    * {@link org.apache.commons.collections.observed.standard.StandardModificationHandler}.
    * See this class for details of configuration available.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.3       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationHandlerFactory.java
  
  Index: ModificationHandlerFactory.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/ModificationHandlerFactory.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ModificationHandlerFactory.java	21 Sep 2003 16:00:28 -0000	1.2
  +++ ModificationHandlerFactory.java	27 Nov 2003 22:55:15 -0000	1.3
  @@ -70,6 +70,7 @@
    * <li>One of the <code>registerFactory</code> methods must be called on ObservableCollection
    * </ol>
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.6       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardPreModificationEvent.java
  
  Index: StandardPreModificationEvent.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardPreModificationEvent.java,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- StandardPreModificationEvent.java	21 Sep 2003 20:00:29 -0000	1.5
  +++ StandardPreModificationEvent.java	27 Nov 2003 22:55:16 -0000	1.6
  @@ -69,6 +69,7 @@
    * In addition, the <code>size</code> method is used on the collection.
    * All objects used are the real objects from the method calls, not clones.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.8       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardModificationHandler.java
  
  Index: StandardModificationHandler.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardModificationHandler.java,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- StandardModificationHandler.java	9 Oct 2003 20:50:04 -0000	1.7
  +++ StandardModificationHandler.java	27 Nov 2003 22:55:16 -0000	1.8
  @@ -76,6 +76,7 @@
    * Each listener can be filtered. There are separate filters for pre and post
    * modification events.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.6       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardPostModificationEvent.java
  
  Index: StandardPostModificationEvent.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardPostModificationEvent.java,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- StandardPostModificationEvent.java	21 Sep 2003 20:00:29 -0000	1.5
  +++ StandardPostModificationEvent.java	27 Nov 2003 22:55:16 -0000	1.6
  @@ -69,6 +69,7 @@
    * In addition, the <code>size</code> method is used on the collection.
    * All objects used are the real objects from the method calls, not clones.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.3       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardPreModificationListener.java
  
  Index: StandardPreModificationListener.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardPreModificationListener.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- StandardPreModificationListener.java	6 Sep 2003 18:59:09 -0000	1.2
  +++ StandardPreModificationListener.java	27 Nov 2003 22:55:16 -0000	1.3
  @@ -63,6 +63,7 @@
    * A listener for the <code>StandardModificationHandler</code> that is called
    * when a collection is about to be modified.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.3       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardPostModificationListener.java
  
  Index: StandardPostModificationListener.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardPostModificationListener.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- StandardPostModificationListener.java	6 Sep 2003 18:59:09 -0000	1.2
  +++ StandardPostModificationListener.java	27 Nov 2003 22:55:16 -0000	1.3
  @@ -63,6 +63,7 @@
    * A listener for the <code>StandardModificationHandler</code> that is called
    * when a collection has been changed.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.8       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardModificationEvent.java
  
  Index: StandardModificationEvent.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardModificationEvent.java,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- StandardModificationEvent.java	21 Sep 2003 20:00:29 -0000	1.7
  +++ StandardModificationEvent.java	27 Nov 2003 22:55:16 -0000	1.8
  @@ -79,6 +79,7 @@
    * In addition, the <code>size</code> method is used on the collection.
    * All objects used are the real objects from the method calls, not clones.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.2       +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardModificationListener.java
  
  Index: StandardModificationListener.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/observed/standard/StandardModificationListener.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- StandardModificationListener.java	3 Sep 2003 23:54:26 -0000	1.1
  +++ StandardModificationListener.java	27 Nov 2003 22:55:16 -0000	1.2
  @@ -61,6 +61,7 @@
    * A listener for the <code>StandardModificationHandler</code> that is called
    * both before the collection is changed and after the change has occurred.
    *
  + * @deprecated TO BE REMOVED BEFORE v3.0
    * @since Commons Collections 3.0
    * @version $Revision$ $Date$
    * 
  
  
  
  1.16      +4 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/BagUtils.java
  
  Index: BagUtils.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/BagUtils.java,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- BagUtils.java	16 Nov 2003 00:05:44 -0000	1.15
  +++ BagUtils.java	27 Nov 2003 22:55:16 -0000	1.16
  @@ -197,6 +197,7 @@
        * If more than one listener or other complex setup is required then the
        * ObservableBag class should be accessed directly.
        *
  +     * @deprecated TO BE REMOVED BEFORE v3.0
        * @param bag  the bag to decorate, must not be null
        * @param listener  bag listener, must not be null
        * @return the observed bag
  @@ -307,6 +308,7 @@
        * If more than one listener or other complex setup is required then the
        * ObservableSortedBag class should be accessed directly.
        *
  +     * @deprecated TO BE REMOVED BEFORE v3.0
        * @param bag  the bag to decorate, must not be null
        * @param listener  bag listener, must not be null
        * @return the observed bag
  
  
  
  1.48      +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/CollectionUtils.java
  
  Index: CollectionUtils.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/CollectionUtils.java,v
  retrieving revision 1.47
  retrieving revision 1.48
  diff -u -r1.47 -r1.48
  --- CollectionUtils.java	18 Nov 2003 22:50:44 -0000	1.47
  +++ CollectionUtils.java	27 Nov 2003 22:55:16 -0000	1.48
  @@ -1112,6 +1112,7 @@
        * If more than one listener or other complex setup is required then the
        * ObservableCollection class should be accessed directly.
        *
  +     * @deprecated TO BE REMOVED BEFORE v3.0
        * @param collection  the collection to decorate, must not be null
        * @param listener  collection listener, must not be null
        * @return the observed collection
  
  
  
  1.20      +4 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/SetUtils.java
  
  Index: SetUtils.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/SetUtils.java,v
  retrieving revision 1.19
  retrieving revision 1.20
  diff -u -r1.19 -r1.20
  --- SetUtils.java	16 Nov 2003 00:05:44 -0000	1.19
  +++ SetUtils.java	27 Nov 2003 22:55:16 -0000	1.20
  @@ -271,6 +271,7 @@
        * If more than one listener or other complex setup is required then the
        * ObservableSet class should be accessed directly.
        *
  +     * @deprecated TO BE REMOVED BEFORE v3.0
        * @param set  the set to decorate, must not be null
        * @param listener  set listener, must not be null
        * @return the observed set
  @@ -391,6 +392,7 @@
        * If more than one listener or other complex setup is required then the
        * ObservableSortedSet class should be accessed directly.
        *
  +     * @deprecated TO BE REMOVED BEFORE v3.0
        * @param set  the set to decorate, must not be null
        * @param listener  set listener, must not be null
        * @return the observed set
  
  
  
  1.23      +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/ListUtils.java
  
  Index: ListUtils.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/ListUtils.java,v
  retrieving revision 1.22
  retrieving revision 1.23
  diff -u -r1.22 -r1.23
  --- ListUtils.java	16 Nov 2003 00:05:44 -0000	1.22
  +++ ListUtils.java	27 Nov 2003 22:55:16 -0000	1.23
  @@ -353,6 +353,7 @@
        * If more than one listener or other complex setup is required then the
        * ObservableList class should be accessed directly.
        *
  +     * @deprecated TO BE REMOVED BEFORE v3.0
        * @param list  the list to decorate, must not be null
        * @param listener  list listener, must not be null
        * @return the observed list
  
  
  
  1.16      +3 -2      jakarta-commons/collections/src/java/org/apache/commons/collections/BufferUtils.java
  
  Index: BufferUtils.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/BufferUtils.java,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- BufferUtils.java	16 Nov 2003 00:05:44 -0000	1.15
  +++ BufferUtils.java	27 Nov 2003 22:55:16 -0000	1.16
  @@ -193,6 +193,7 @@
        * If more than one listener or other complex setup is required then the
        * ObservableBuffer class should be accessed directly.
        *
  +     * @deprecated TO BE REMOVED BEFORE v3.0
        * @param buffer  the buffer to decorate, must not be null
        * @param listener  buffer listener, must not be null
        * @return the observed buffer
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org