Return-Path: Mailing-List: contact commons-dev-help@jakarta.apache.org; run by ezmlm Delivered-To: mailing list commons-dev@jakarta.apache.org Received: (qmail 49001 invoked by uid 500); 3 Sep 2003 23:53:27 -0000 Received: (qmail 48995 invoked from network); 3 Sep 2003 23:53:27 -0000 Received: from unknown (HELO minotaur.apache.org) (209.237.227.194) by daedalus.apache.org with SMTP; 3 Sep 2003 23:53:27 -0000 Received: (qmail 73497 invoked by uid 1529); 3 Sep 2003 23:53:27 -0000 Date: 3 Sep 2003 23:53:27 -0000 Message-ID: <20030903235327.73496.qmail@minotaur.apache.org> From: scolebourne@apache.org To: jakarta-commons-cvs@apache.org Subject: cvs commit: jakarta-commons/collections/src/java/org/apache/commons/collections/decorators package.html X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N scolebourne 2003/09/03 16:53:27 Modified: collections/src/java/org/apache/commons/collections/decorators package.html Log: Improve documentation Revision Changes Path 1.2 +4 -3 jakarta-commons/collections/src/java/org/apache/commons/collections/decorators/package.html Index: package.html =================================================================== RCS file: /home/cvs/jakarta-commons/collections/src/java/org/apache/commons/collections/decorators/package.html,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- package.html 10 May 2003 12:51:06 -0000 1.1 +++ package.html 3 Sep 2003 23:53:27 -0000 1.2 @@ -9,16 +9,17 @@
  • Unmodifiable - ensures the collection cannot be altered
  • Predicated - ensures that only elements that are valid according to a predicate can be added
  • Typed - ensures that only elements that are of a specific type can be added -
  • Lazy - creates objects in the collection on demand -
  • FixedSize - ensures that the size of the collection cannot change
  • Blocking - blocks until data available when calling get() on an empty collection +
  • FixedSize - ensures that the size of the collection cannot change +
  • Lazy - creates objects in the collection on demand +
  • Ordered - ensures that insertion order is remembered in a Map/Set

    Each collection can be constructed using a static decorate() method on the class. They can also be constructed from the XxxUtils class where Xxx is the collection type. 

      -List stringOnlyList = TypedList(new ArrayList(), String.class);
  +List stringOnlyList = TypedList.decorate(new ArrayList(), String.class);
   List otherStringOnlyList = ListUtils.typedList(new ArrayList(), String.class);