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\](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
   [

   StringUtils].ordinalIndexOf() 2. [StringBuffer] replacement 3. Mutable Number classes 4. [StringTokenizer] replacement: *(DONE - Tokenizer)* 5. Fix the Fraction class as per the email thread. 5. 15082 \[lang\] elapsed time formatting utility method - *DurationFormatUtils. Needs finishing.* 5. 18962

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

   New

   Add

   Method: getSubstitutedValues( String, Map ) - *Patch supplied. Need to resurrect Interpolator from Util, merge with this patch and decide if it makes sense.* 5. 19331 \[lang\] General case: infinite loop: [ToStringBuilder].reflectionToString

   support in [ToStringStyle] for [DateFormat]. - *

   Need

   Grows

   to

   quickly

   confirm whether this is a bug* 5. 20015 \[lang\] Make Entities public and unit test - *Entities. Needs finishing.* 5. 21333 Add [TimeoutController] - *Class in [HttpClient]. Needs evaluating.* 5. 21663

   into commons-convert*

2. Wiki Markup
   [27643|http://issues.apache.org/bugzilla/show_bug.cgi?id=27643] \[lang\]

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

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

   Add support in [ToStringStyle] for [DateFormat]. 5. 22172 \[lang\] [DateUtils].parseCVS behavior parsing "h:mm z" 5. 22692 [StringUtils].split ignores empty items 5. 22717

   \[lang\] [

   MutableNumbers] - *Matt Hawthorne and Geronimo have implementations.* 5. 23749 \[lang\] \[PATCH\] [NumberRange] - adds inclusive and exclusive end points 5. 24910 new [StringUtils].split methods that split on the whole separator string 5. 25560 [DateUtils].truncate() is off by one hour when using a date in DST switch 'zone' 5. 26056 \[lang\] Add methods to [ArrayUtils]: add at end and insert-like ops 5. 26297 \[lang\] [BitSetUtils] class, toIndexArray and fromIndexArray 5. 26659

   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. Wiki Markup
   [26659|http://issues.apache.org/bugzilla/show_bug.cgi?id=26659] \[lang\] add method to [DateUtils] to get the distance between 2 dates

   5.

   - *Mainly replicated by [DurationFormatUtils], or non-obvious*

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

   26922 \[lang\] public static boolean [DateUtils].equals(Date dt1, Date dt2) ? 5. 27640 \[lang\]\[patch\] [ClassUtils].primitivesToWrappers method 5. 27643 \[lang\]\[patch\] [ClassUtils].newInstance method 5. 27778

   \[lang\]

   add

   String

   remove

   indentation

   methods

   feature

   to

   request

   [

   - *Needs design as a non-simple problem*

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

   ArrayUtils] 5. 27876 \[lang\] [ReflectionToStringBuilder].toString(null) throws exception by design 5. 27877 \[lang\]\[patch\] Make [ClassUtils] methods null-safe and not throw an IAE. 5. 29149

   \[lang\] [

   StringEscapeUtils

   DateUtils].

   unescapeHtml() doesn't handle an empty entity

   parseCVS behavior parsing "h:mm z" - *

   Empty entity is in fact illegal HTML, so need to decide if we should ignore* 5. 25227

   Moved to sandbox*

7. Wiki Markup
   [26297|http://issues.apache.org/bugzilla/show_bug.cgi?id=26297] \[lang\] [

   StringEscapeUtils

   BitSetUtils]

   .unescapeHtml() doesn't handle hex entities - *DONE* 5. 29163 Make [StopWatch] validate state transitions - *Coding needed* 5. 29294 \[lang\]\[PATCH\] lang.math.Fraction class deficiencies - *Mail list conversation ongoing. \\

Fixed list

(meaning closed in Bugzilla)

1. class, toIndexArray and 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=30674] Support [HttpClient]'s [DateParser] class - *This is basically a Date parseDate(String dateValue, String\[\] dateFormats) method.*

4. LocaleUtils - including toLocale(String,String)
5. 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. Wiki Markup 5. 27592 \[lang\] [WordUtils] capitalize improvement -* DONE* 5. 23557 [WordUtils].capitalizeFully(String str) should take a delimiter -* DONE'''