Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

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

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

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

    \\

...

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

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

    \

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

    27778 27778\

    30674] 

    \[lang\]

     

    add

     

    remove

     

    methods

     

    to [ArrayUtils] - *DONE*
  4. StringTokenizer replacement: (DONE - Tokenizer)
  5. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=25227 25227\] 	\[lang\] [StringEscapeUtils].unescapeHtml() doesn't handle hex entities - *DONE*
  6. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=27640 27640\] 	\[lang\]\[patch\] [ClassUtils].primitivesToWrappers method - *DONE*
  7. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=23749 23749\] 	\[lang\] \[PATCH\] [NumberRange] - adds inclusive and exclusive end points - *WONTFIX*
  8. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=27876 27876\] 	\[lang\] [ReflectionToStringBuilder].toString(null) throws exception by design - *DONE*
  9. 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*
  10. StringUtils.ordinalIndexOf() - Appears to be DONE
  11. Wiki Markup
    \[http://issues.apache.org/bugzilla/show_bug.cgi?id=29673 29673\] 	\[lang\] [ExceptionUtils]: new getCause() methodname (for tomcat-exception) - *DONE*
  12. 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*
  13. 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.