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 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 5. \[

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

   29294 29294\

   21663] \[lang

   \]\[PATCH

   \]

   Fix

   Add

   the Fraction class - *Patch being reviewed.* 5. 15082 \[lang\] elapsed time formatting utility method - *DurationFormatUtils. Needs finishing.* 5. 18962 \[lang\] New 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 - *Need to 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. 22172 \[lang\] [DateUtils].parseCVS behavior parsing "h:mm z" 5. 22692 [StringUtils].split ignores empty items 5. 22717 \[lang\] [MutableNumbers] - *see lang.mutable. Needs String/Boolean/Character* 5. 23749

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

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

   \[

   PATCH

   patch\] [

   NumberRange

   ClassUtils]

   - adds inclusive and exclusive end points

   .newInstance method - *

   Stephen/Tim

   Seems unnecessary*

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

   discussion* 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. 26659 \[lang\] add method to [DateUtils] to get the distance between 2 dates 5. 26922 \[lang\] public static boolean [DateUtils].equals(Date dt1, Date dt2) ? 5. 27876 \[lang\] [ReflectionToStringBuilder].toString(null) throws exception by design - *Gary to supply fix* 5. 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

   * 5

   .

   29163

   Current

   Make [StopWatch] validate state transitions - *Coding needed* 5. 26297 \[lang\] [BitSetUtils] class, toIndexArray and fromIndexArray - *DONE - Gary to confirm, looks like primitive overloads are still needed* 5. 27877 \[lang\]\[patch\] Make [ClassUtils] methods null-safe and not throw an IAE. - *DONE? - Gary to confirm* 5. 26056 \[lang\] Add methods to [ArrayUtils]: add at end and insert-like ops - *DONE - Gary to confirm* \\

New

1. behaviour seems acceptable as we're not in the work with bad HTML market.*

2. 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 - *Mainly replicated by [DurationFormatUtils], or non-obvious

   Wiki Markup29673 \[lang\] [ExceptionUtils]: new getCause() methodname (for tomcat-exception) - *Confusing

   *

3. Wiki Markup
   [29692|http://issues.apache.org/bugzilla/show_bug.cgi?id=29692] \[lang\] String indentation feature request - *Needs design as a non-simple problem*

4. 29794 Add convenience format(long) methods to FastDateFormat
   

Pushed back

2. Wiki Markup

   21663

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

   Add
   support in

   [

   ToStringStyle] for [DateFormat]. - *Grows quickly into commons-convert* 5. 27643 \[lang\]\[patch\] [ClassUtils].newInstance method - *Seems unnecessary* \\

Fixed list

(meaning closed in Bugzilla)

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

2. Wiki Markup

   27592

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

   WordUtils

   BitSetUtils]

   capitalize

   class,

   improvement

   toIndexArray

   -

   and

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

   27778 	\[lang\] add remove methods to [ArrayUtils] - *DONE*

5. StringTokenizer replacement: (DONE - Tokenizer)

6. Wiki Markup
   25227 \[lang\] [StringEscapeUtils].unescapeHtml() doesn't handle hex entities - *DONE*

Wiki Markup27640 \[lang\]\[patch\] [ClassUtils].primitivesToWrappers method - *DONE*

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

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