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
  

Wiki MarkupThe Javadoc of the latest version (2.1) is available.

The Javadoc of the CVS version (development) is available0 version (latest) is \[http://jakarta.apache.org/commons/lang/api/index.html available\]. Wiki MarkupThe Javadoc of the CVS version (development) is \[http://jakarta.apache.org/commons/lang/apidocs/index.html available\].

Development plan for 2.

...

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=20015 20015\] \[lang\] Make Entities public and unit test - *Entities. Needs finishing.*

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

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

5. 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*

6. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=26297 26297\] \[lang\] [BitSetUtils] class, toIndexArray and fromIndexArray

7. 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 - Gary to confirm, looks like primitive overloads are still needed*

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

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

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

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

Seeking opinions

1. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=22692 22692\] [StringUtils].split ignores empty items - *new splitPreserveAllTokens Needs to be reviewed.*

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

3. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=18962 18962\] \[lang\] New Method: getSubstitutedValues( String, Map ) - *org.apache.commons.lang.Interpolation available for opinions*

4. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=30334 30334\] \[lang\] New class proposal: *CharacterEncoding* \\ \\

Pushed back

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

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

6. 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*

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

8. Wiki Markup

   \

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

   22172

   22172

   \

   ] \[lang\] [DateUtils].parseCVS behavior parsing "h:mm z" - *Moved to sandbox*

   \\

...

2. Wiki Markup

   \

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

   27592 27592\

   26297] \[lang\] [

   WordUtils

   BitSetUtils]

   capitalize

   class,

   improvement

   toIndexArray

   -

   and

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

   fromIndexArray

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

4. Wiki Markup

   \

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

   27778 27778\

   30674]

   \[lang\]
   add
   remove
   methods
   to [ArrayUtils] - *DONE*
5. StringTokenizer replacement: (DONE - Tokenizer)

6. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=25227 25227\] \[lang\] [StringEscapeUtils].unescapeHtml() doesn't handle hex entities - *DONE*

7. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=27640 27640\] \[lang\]\[patch\] [ClassUtils].primitivesToWrappers method - *DONE*

8. Wiki Markup
   \[http://issues.apache.org/bugzilla/show_bug.cgi?id=23749 23749\] \[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. StringUtils.ordinalIndexOf() - Appears to be DONE

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

13. 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' - *DONE*

Wiki Markup\[http://issues.apache.org/bugzilla/show_bug.cgi?id=19331 19331\] \[lang\] General case: infinite loop: [ToStringBuilder].reflectionToString - *The bugzilla entry* *_Gary Gregory 2003-06-23 17:27_* *shows this to have been fixed.*

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

15. LocaleUtils - including toLocale(String,String)
16. 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.