Page History

Commons Lang

Wiki Markup\[http://jakarta.apache.org/commons/lang Lang\] aims to provide:

• Comprehensive String handling utilities
• Enumerated types (pre JDK 1.5)
• Nested exceptions (pre JDK 1.4)
• Builders to create hashCode, equals, toString and compareTo methods
• Utilities for Object, Date and Numbers
  

...

The Javadoc of the latest version is \[http://jakarta.apache.org/commons/lang/api/index.html available\].

Development plan for 2.1

1. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=29294 29294\] \[lang\]\[PATCH\] Fix the Fraction class - *Patch being reviewed.*

2. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=19331 19331\] \[lang\] General case: infinite loop: [ToStringBuilder].reflectionToString - *Need to confirm whether this is a bug*

3. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=20015 20015\] \[lang\] Make Entities public and unit test - *Entities. Needs finishing.*

4. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=21333 21333\] Add [TimeoutController] - *Class in [HttpClient]. Needs evaluating.*

5. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=21333 21333\] Support [HttpClient]'s [DateParser] class.

6. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=22692 22692\] [StringUtils].split ignores empty items

7. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=24910 24910\] new [StringUtils].split methods that split on the whole separator string - *method signature issue*

8. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=26297 26297\] \[lang\] [BitSetUtils] class, toIndexArray and fromIndexArray - *DONE - Gary to confirm, looks like primitive overloads are still needed*

9. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=22172 22172\] \[lang\] [DateUtils].parseCVS behavior parsing "h:mm z"

10. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=25560 25560\] [DateUtils].truncate() is off by one hour when using a date in DST switch 'zone'

11. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=26922 26922\] \[lang\] public static boolean [DateUtils].equals(Date dt1, Date dt2)

12. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=15082 15082\] \[lang\] elapsed time formatting utility method - *DurationFormatUtils. Needs finishing.*

13. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=29794 29794\] Add convenience format(long) methods to [FastDateFormat] - *Needs improvement*

14. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=29163 29163\] Make [StopWatch] validate state transitions - *Coding needed* \\

...

version (2.1) is available.

The Javadoc of the CVS version (development) is available.

Development plan for 2.2

1. Bug fixes
2. StrTokenizer
3. StrBuilder
4. VariableFormatter/interpolator - 18962
   
   

Other ideas

1. Wiki Markup

   \

   [21663|http://issues.apache.org/bugzilla/show_bug.cgi?id=

   21663

   21663

   \

   ] \[lang\] Add support in [ToStringStyle] for [DateFormat]. - *Grows quickly into commons-convert*

2. Wiki Markup

   \

   [27643|http://issues.apache.org/bugzilla/show_bug.cgi?id=27643

   27643\

   ] \[lang\]\[patch\] [ClassUtils].newInstance method - *Seems unnecessary*

3. Wiki Markup

   \

   [29149|http://issues.apache.org/bugzilla/show_bug.cgi?id=29149

   29149\

   ] \[lang\] [StringEscapeUtils].unescapeHtml() doesn't handle an empty entity - *Empty entity is in fact illegal HTML, so need to decide if we should ignore. Current behaviour seems acceptable as we're not in the work with bad HTML market.*

   StringBuffer replacement - Probably 2.2/3.0. A lot of work in this I'd imagine.

4. Wiki Markup

   \

   [26659|http://issues.apache.org/bugzilla/show_bug.cgi?id=

   26659

   26659

   \

   ] \[lang\] add method to [DateUtils] to get the distance between 2 dates - *Mainly replicated by [DurationFormatUtils], or non-obvious*

5. Wiki Markup

   \

   [29692|http://issues.apache.org/bugzilla/show_bug.cgi?id=

   29692

   29692

   \

   ] \[lang\] String indentation feature request - *Needs design as a non-simple problem*

   \\

...

2. Wiki Markup

   \

   [22172|http://issues.apache.org/bugzilla/show_bug.cgi?id=

   27592 27592\

   22172] \[lang\] [

   WordUtils

   DateUtils].parseCVS

   capitalize

   behavior

   improvement - *DONE*

3. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=23557 23557\] [WordUtils].capitalizeFully(String str) should take a delimiter - *DONE*

4. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=27778 27778\] \[lang\] add remove methods to [ArrayUtils] - *DONE*

5. StringTokenizer replacement: (DONE - Tokenizer)

   parsing "h:mm z" - *Moved to sandbox*

6. Wiki Markup

   \

   [26297|http://issues.apache.org/bugzilla/show_bug.cgi?id=

   25227 25227\

   26297] \[lang\] [

   StringEscapeUtils

   BitSetUtils]

   .unescapeHtml() doesn't handle hex entities - *DONE* Wiki Markup\[http://issues.apache.org/bugzilla/show_bug.cgi?id=27640 27640\] \[lang\]\[patch\] [ClassUtils].primitivesToWrappers method - *DONE*

   class, toIndexArray and fromIndexArray

7. 21333 Add TimeoutController - Class in HttpClient. Leaving til 3.0 as not much movement on it

8. Wiki Markup

   \

   [30674|http://issues.apache.org/bugzilla/show_bug.cgi?id=

   23749 23749\

   30674]

   \[lang\]
   \[PATCH\] [NumberRange]
   -
   adds inclusive and exclusive end points - *WONTFIX*

9. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=27876 27876\] \[lang\] [ReflectionToStringBuilder].toString(null) throws exception by design - *DONE*

10. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=27877 27877\] \[lang\]\[patch\] Make [ClassUtils] methods null-safe and not throw an IAE. - *DONE*

11. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=26056 26056\] \[lang\] Add methods to [ArrayUtils]: add at end and insert-like ops - *DONE*

12. StringUtils.ordinalIndexOf() - Appears to be DONE

13. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=29673 29673\] \[lang\] [ExceptionUtils]: new getCause() methodname (for tomcat-exception) - *DONE* \\

Seeking opinions

...

\[http://issues.apache.org/bugzilla/show_bug.cgi?id=22717 22717\] 	\[lang\] [MutableNumbers] - *see lang.mutable.*

...

1. Support [HttpClient]'s [DateParser] class - *This is basically a Date parseDate(String dateValue, String\[\] dateFormats) method.*

2. LocaleUtils - including toLocale(String,String)
3. CloneUtils - multiple ways to clone an object
   

Articles

This article http://www.devx.com/Java/Article/29392/0/page/6 discusses some of the interesting classes in Commons Lang with real world examples.