commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r931453 - /commons/proper/lang/trunk/src/site/xdoc/article2_5.xml
Date Wed, 07 Apr 2010 07:20:25 GMT
Author: bayard
Date: Wed Apr  7 07:20:25 2010
New Revision: 931453

Article written about the 2.5 release

    commons/proper/lang/trunk/src/site/xdoc/article2_5.xml   (with props)

Added: commons/proper/lang/trunk/src/site/xdoc/article2_5.xml
--- commons/proper/lang/trunk/src/site/xdoc/article2_5.xml (added)
+++ commons/proper/lang/trunk/src/site/xdoc/article2_5.xml Wed Apr  7 07:20:25 2010
@@ -0,0 +1,135 @@
+<?xml version="1.0"?>
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+See the License for the specific language governing permissions and
+limitations under the License.
+ <properties>
+  <title>What's new in Commons Lang 2.5?</title>
+  <author email="">Commons Documentation Team</author>
+ </properties>
+<section name="What's new in Commons Lang 2.5?">
+<p>Commons Lang 2.5 is out, and the obvious question is: <i>"So what? What's
+<p>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 two years of development between Lang 2.4 and 2.5.</p>
+<p>Two years?!? Yes, it's true. The reason is that 2.5 represents the backwards compatible
changes in the 
+nearly complete Java-5 focused Lang 3.0. </p>
+<section name="Deprecations">
+<p>There were no new deprecations in 2.5. </p>
+<section name="The build">
+<p>2.5 was built using Sun's 1.6.0_17 JVM, but targets Java 1.3. </p>
+<section name="New classes">
+<p>A new org.apache.commons.lang.reflect package was added, accumulating common high-level
uses of the java.lang.reflect APIs. The 
+classes, hopefully self-evident in nature, were pulled together from the existing BeanUtils
and the unreleased Reflect components. 
+The classes are: </p>
+<li>ConstructorUtils - primarily creating new instances of classes</li>
+<li>FieldUtils - primarily reading and writing to Object/Class fields</li>
+<li>MethodUtils - primarily methods to make invoking methods simpler</li>
+<p>You can read more about the classes in their 
+<a href="LANG_2_5/src/main/java/org/apache/commons/lang/reflect//">javadoc</a>.
+<section name="New fields">
+<p>With both Java 7 and Windows 7 becoming a reality, 
+<a href="">SystemUtils</a>
was updated to 
+provide boolean fields for both versions. </p>
+<section name="New methods">
+<p>There were 66 new methods added to existing Commons Lang classes. </p>
+<p>The <a href="">ArrayUtils</a>
+received two new types of methods. Firstly, a boolean isNotEmpty(array) set of methods, identifying
whether the particular 
+array is null or an empty sized array. This makes it the inverse of the existing isEmpty(array)
methods. Secondly, an array 
+nullToEmpty(array) set of methods that converts null or empty arrays to a singleton empty
array already available from the 
+ArrayUtils class. Non null/empty arrays are left untouched. </p>
+<p>The constructor for the 
+<a href="">CharRange</a>
class is somewhat 
+confusing. It takes a boolean parameter that when set to true means the CharRange is negated.
To make code easier to read, the 
+following static helper methods were added: </p>
+<li>public org.apache.commons.lang.CharRange is(char)</li>
+<li>public org.apache.commons.lang.CharRange isIn(char, char)</li>
+<li>public org.apache.commons.lang.CharRange isNot(char)</li>
+<li>public org.apache.commons.lang.CharRange isNotIn(char, char)</li>
+<p>An iterator() method was also added to provide another way of walking the range.
+<p>The <a href="">EqualsBuilder</a>

+obtained a new reset() method to allow for reuse, while the 
+<a href="">HashCodeBuilder</a>

+received a hashCode() method that returns the built hash code instead of the natural hash
code of the builder object itself. It 
+doesn't really matter what the builder chooses to use as a hash code and this stops accidental
use of the hashCode() instead of 
+toHashCode() method from causing lots of pain. </p>
+<p>Helper isFalse(), isTrue() and toBoolean() methods were added to 
+<a href="">MutableBoolean</a>,

+while the other mutable classes received String argument constructors. </p>
+<p>Lastly, the <a href="">DateUtils</a>

+class received a new ceiling set of methods to truncate upwards, and a parseDateStrictly
method to parse a Date with the 
+supplied DateFormat classes leniency set to false. </p>
+<section name="StringUtils methods">
+<p>As with 2.4, the 
+<a href="">StringUtils</a>
class has 
+grown and we cover its new methods in its own section. </p>
+<li>abbreviateMiddle(String, String, int);String - This method turns aRatherLongNameSuchAsAFileName
into 'aRatherLo...AFileName'. 
+This is often desirable when you want to restrict the length of a name, but you can afford
to have quite long names. </li>
+<li>indexOfIgnoreCase(String, String);int - An indexOf method that ignores the case
of what it's matching. Matching lastIndexOfIgnoreCase and 'start at index' variants were also
added. </li>
+<li>lastOrdinalIndexOf(String, String, int);int - A matching variant for the already
exisitng ordinalIndexOf method - they 
+support finding the Nth indexOf instead of the first time the search term is found. </li>
+<li>isAllLowerCase(String);boolean - Is the String all lower case. </li>
+<li>isAllUpperCase(String);boolean - Is the String all upper case. </li>
+<li>lowerCase(String, Locale);String - Null protected toLowerCase methods for the platform
independent inclined. </li>
+<li>upperCase(String, Locale);String - Null protected toUpperCase methods for the platform
independent inclined. </li>
+<li>repeat(String, String, int);String - Repeat option that includes an optional separator.
+<li>startsWithAny(String, String[]);boolean - Does the specified String start with
any of the supplied values. </li>
+<section name="What's fixed in Lang 2.5?">
+<p>Per the <a href="upgradeto2_5.html">release notes</a> there are 32 bugs
fixed in Lang 2.5. Some highlights are: </p>
+<li><a href="">LANG-477</a>
- fixing an OutOfMemoryError in ExtendedMessageFormat. </li>
+<li><a href="">LANG-76</a>
- EnumUtils.getEnum() doesn't work well in 1.5. </li>
+<li><a href="">LANG-204</a>
+<a href="">LANG-506</a> - Multithread
improvements to the package private Entities 
+class, used behind the scenes by StringEscapeUtils. </li>
+<li><a href="">LANG-511</a>
- Improve performance by deferring LocalUtils initialization. </li>
+<li><a href="">LANG-523</a>
- Two orders of magnitude performance improvement in StrBuilder. </li>
+<li><a href="">LANG-467</a>
- Reverted the change to EqualsBuilder in Lang 2.4 to 
+specially handle BigDecimal. While useful, it put things out of sync with HashCodeBuilder.
+<li><a href="">LANG-586</a>
- Use of a ThreadLocal in HashCodeBuilder and 
+ToStringStyle meant that containers could end up with memory leaks. This was rewritten to
avoid this. </li>
+<li><a href="">LANG-472</a>
- RandomUtils.nextLong() was returning only even numbers. Fans of Java-based roulette wheels
can breathe a sigh of relief. </li>
+<section name="So long, farewell...">
+<p>Hopefully that was all of interest. Don't forget to download <a href="">Lang
2.5</a>, or, for the Maven repository users, upgrade your &lt;version&gt; tag
to 2.5. Please feel free to raise any questions you might have on the <a href="mail-lists.html">mailing
lists</a>, and report bugs or enhancements in the <a href="issue-tracking.html">issue

Propchange: commons/proper/lang/trunk/src/site/xdoc/article2_5.xml
    svn:eol-style = native

View raw message