diff --git a/xdocs/article2_4.xml b/xdocs/article2_4.xml index bdf36b583..201e4d294 100644 --- a/xdocs/article2_4.xml +++ b/xdocs/article2_4.xml @@ -17,14 +17,14 @@ limitations under the License. --> - What's new in 2.4? + What's new in Commons Lang 2.4? Commons Documentation Team -
+

Commons Lang 2.4 is out, and the obvious question is: "So what? What's changed?".

-

Thus this article aims to briefly cover the changes and save you from having to dig into each JIRA +

This article aims to briefly cover the changes and save you from having to dig through each JIRA issue to see what went on in the year of development between Lang 2.3 and 2.4.

First, let us start with a couple of deprecations. As you can see in the release notes, we chose @@ -132,55 +132,42 @@ cases as a true drop-in replacement.

There were 58 new methods added to existing Commons Lang classes. Going through each one, one at a time would be dull, and fortunately there are some nice groupings that we can discuss instead:

-

CharSet getInstance(String[]) adds an additional builder method by which you can build a CharSet from multiple sets of characters at the same time. If you weren't aware of the CharSet class, it holds a set of characters created by a simple pattern language allowing constructs such as "a-z" and "^a" (everything but 'a'). It's most used by the CharSetUtils class, and came out of CharSetUtils.translate, a simple variant of the UNIX tr command. -

-

ClassUtils Canonical name methods are akin to the non 'Canonical' methods, except they work with the more human readable int[] type names rather than the JVM versions of [I. This makes them useful for parsing input from developer's configuration files. -

-

ClassUtils toClass(String[]) is very easy to explain - it calls toClass on each Object in the array and returns an array of Class objects. -

-

ClassUtils wrapper->primitive conversions are the reflection of the pre-existing primitiveToWrapper methods. Again easy to explain, they turn an array of Integer into an array of int[]. -

-

ObjectUtils identityToString(StringBuffer, Object) is the StringBuffer variant of the pre-existing identityToString method. In case you've not met that before, it produces the toString that would have been produced by an Object if it hadn't been overridden. -

-

StringEscapeUtils CSV methods are a new addition to our range of simple parser/printers. These, quite as expected, parse and unparse CSV text as per RFC-4180. -

+

CharSet getInstance(String[]) adds an additional builder method by which you can build a CharSet from multiple sets of characters at the same time. If you weren't aware of the CharSet class, it holds a set of characters created by a simple pattern language allowing constructs such as "a-z" and "^a" (everything but 'a'). It's most used by the CharSetUtils class, and came out of CharSetUtils.translate, a simple variant of the UNIX tr command.

+

ClassUtils canonical name methods are akin to the non 'Canonical' methods, except they work with the more human readable int[] type names rather than the JVM versions of [I. This makes them useful for parsing input from developer's configuration files.

+

ClassUtils toClass(String[]) is very easy to explain - it calls toClass on each Object in the array and returns an array of Class objects.

+

ClassUtils wrapper->primitive conversions are the reflection of the pre-existing primitiveToWrapper methods. Again easy to explain, they turn an array of Integer into an array of int[].

+

ObjectUtils identityToString(StringBuffer, Object) is the StringBuffer variant of the pre-existing identityToString method. In case you've not met that before, it produces the toString that would have been produced by an Object if it hadn't been overridden.

+

StringEscapeUtils CSV methods are a new addition to our range of simple parser/printers. These, quite as expected, parse and unparse CSV text as per RFC-4180.

StringUtils has a host of new methods, as always, and we'll leave these for later.

-

WordUtils abbreviate finds the first space after the lower limit and abbreviates the text. -

-

math.IntRange/LongRange.toArray turn the range into an array of primitive int/longs contained in the range. -, -

-

text.StrMatch.isMatch(char[], int) is a helper method for checking whether there was a match with the StrMatcher objects. -

-

time.DateFormatUtils format(Calendar, ...) provide Calendar variants for the pre-existing format methods. If these are new to you, they are helper methods to formatting a date. -

-

time.DateUtils getFragment* methods are used to splice the time element out of Date. If you have 2008/12/13 14:57, then these could, for example, pull out the 13. -

-

time.DateUtils setXxx methods round off our walk through the methods - the setXxx variant of the existing addXxx helper methods. -

+

WordUtils abbreviate finds the first space after the lower limit and abbreviates the text.

+

math.IntRange/LongRange.toArray turn the range into an array of primitive int/longs contained in the range.

+

text.StrMatch.isMatch(char[], int) is a helper method for checking whether there was a match with the StrMatcher objects.

+

time.DateFormatUtils format(Calendar, ...) provide Calendar variants for the pre-existing format methods. If these are new to you, they are helper methods to formatting a date.

+

time.DateUtils getFragment* methods are used to splice the time element out of Date. If you have 2008/12/13 14:57, then these could, for example, pull out the 13.

+

time.DateUtils setXxx methods round off our walk through the methods - the setXxx variant of the existing addXxx helper methods.

The StringUtils class is a little large, isn't it? Sorry, but it's gotten bigger.

Hopefully they are in many cases self-describing. Rather than spend a lot of time describing them, we'll let you read the Javadoc of the ones that interest you.

diff --git a/xdocs/index.xml b/xdocs/index.xml index d9fbf6513..455ecf5f6 100644 --- a/xdocs/index.xml +++ b/xdocs/index.xml @@ -62,8 +62,9 @@ The subversion repository can be

The latest version 2.4, is JDK 1.2 compatible - Download now! -(upgrade notes) -

+(upgrade notes).

+ +

Read What's new in 2.4? for more information.

For information on previous releases, see the Release History and to download previous releases, see the Apache Archive. diff --git a/xdocs/upgradeto2_4.xml b/xdocs/upgradeto2_4.xml index 2591dc8a6..bacd3e2e6 100644 --- a/xdocs/upgradeto2_4.xml +++ b/xdocs/upgradeto2_4.xml @@ -25,7 +25,7 @@ limitations under the License.

These are the release notes and advice for upgrading Commons-Lang from -version 2.3 to version 2.4. +version 2.3 to version 2.4.

See what's new in 2.4? for more information. INTRODUCTION: