diff options
author | Niall Pemberton <niallp@apache.org> | 2010-02-25 01:29:36 +0000 |
---|---|---|
committer | Niall Pemberton <niallp@apache.org> | 2010-02-25 01:29:36 +0000 |
commit | cf7486556173620fccd26758aee9a99313c54843 (patch) | |
tree | 7e36986e26c61eaba65062857e3ec170ede664c0 /RELEASE-NOTES.txt | |
parent | 43fca0d7499c99f9e82e0ee2e52b81acdc954f2c (diff) | |
download | apache-commons-lang-cf7486556173620fccd26758aee9a99313c54843.tar.gz |
Update site for 2.5 release
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/lang/trunk@916082 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'RELEASE-NOTES.txt')
-rw-r--r-- | RELEASE-NOTES.txt | 183 |
1 files changed, 71 insertions, 112 deletions
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 5a5159f1e..603225c35 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,124 +1,83 @@ $Id$ Commons Lang Package - Version 2.4 + Version 2.5 Release Notes INTRODUCTION: -This document contains the release notes for the 2.4 version of Apache Commons Lang. +This document contains the release notes for the 2.5 version of Apache Commons Lang. Commons Lang is a set of utility functions and reusable components that should be of use in any Java environment. -Lang 2.4 no longer attempts to target the Java 1.1 environment and now targets Java 1.2. While previous versions -were built for 1.1, some parts were using methods that were only available in 1.2, and the Enum class had -become dependent on Java 1.3. -INCOMPATIBLE CHANGES WITH VERSION 2.3: +COMPATIBILITY WITH 2.4 +====================== +Lang 2.5 is binary compatible release with Lang 2.4, containing bug fixes and small enhancements. + +Lang 2.5 requires a minimum of JDK 1.3. + + +IMPROVEMENTS IN 2.5 +=================== + + * [LANG-583] - ArrayUtils - add isNotEmpty() methods + * [LANG-534] - ArrayUtils - add nullToEmpty() methods + * [LANG-454] - CharRange - provide an iterator that lets you walk the chars in the range + * [LANG-514] - CharRange - add more readable static builder methods + * [ ] - ClassUtils - new isAssignable() methods with autoboxing + * [LANG-535] - ClassUtils - add support to getShortClassName and getPackageName for arrays + * [LANG-434] - DateUtils - add ceiling() method + * [LANG-486] - DateUtils - add parseDateStrictly() method + * [LANG-466] - EqualsBuilder - add reset() method + * [LANG-461] - NumberUtils - add toByte() and toShort() methods + * [LANG-522] - Mutable numbers - add string constructors + * [ ] - MutableBoolean - add toBoolean(), isTrue() and isFalse() methods + * [LANG-422] - StrBuilder - add appendSeparator() methods with an alternative default separator if the StrBuilder is currently empty + * [LANG-555] - SystemUtils - add IS_OS_WINDOWS_7 constant + * [LANG-554] - SystemUtils - add IS_JAVA_1_7 constant for JDK 1.7 + * [LANG-405] - StringUtils - add abbreviateMiddle() method + * [LANG-569] - StringUtils - add indexOfIgnoreCase() and lastIndexOfIgnoreCase() methods + * [LANG-471] - StringUtils - add isAllUpperCase() and isAllLowerCase() methods + * [LANG-469] - StringUtils - add lastOrdinalIndexOf() method to complement the existing ordinalIndexOf() method + * [LANG-438] - StringUtils - add repeat() method + * [LANG-445] - StringUtils - add startsWithAny() method + * [LANG-430] - StringUtils - add upperCase(String, Locale) and lowerCase(String, Locale) methods + * [LANG-416] - New Reflection package containing ConstructorUtils, FieldUtils, MemberUtils and MethodUtils + +BUG FIXES IN 2.5 +================ + + * [LANG-494] - CharSet - Synchronizing the COMMON Map so that getInstance doesn't miss a put from a subclass in another thread + * [LANG-500] - ClassUtils - improving performance of getAllInterfaces + * [LANG-587] - ClassUtils - toClass() throws NullPointerException on null array element + * [LANG-530] - DateUtils - Fix parseDate() cannot parse ISO8601 dates produced by FastDateFormat + * [LANG-440] - DateUtils - round() doesn't work correct for Calendar.AM_PM + * [LANG-443] - DateUtils - improve tests + * [LANG-204] - Entities - multithreaded initialization + * [LANG-506] - Entities - missing final modifiers; thread-safety issues + * [LANG-76] - EnumUtils - getEnum() doesn't work well in 1.5+ + * [LANG-584] - ExceptionUtils - use immutable lock target + * [LANG-477] - ExtendedMessageFormat - OutOfMemory with a pattern containing single quotes + * [LANG-538] - FastDateFormat - call getTime() on a calendar to ensure timezone is in the right state + * [LANG-547] - FastDateFormat - Remove unused field + * [LANG-511] - LocaleUtils - initialization of available locales can be deferred + * [LANG-457] - NumberUtils - createNumber() thows a StringIndexOutOfBoundsException for "l" + * [LANG-521] - NumberUtils - isNumber(String) and createNumber(String) both modified to support '2.' + * [LANG-432] - StringUtils - improve handling of case-insensitive Strings + * [LANG-552] - StringUtils - replaceEach() no longer NPEs when null appears in the last String[] + * [LANG-460] - StringUtils - correct JavaDocs for startsWith() and startsWithIgnoreCase() + * [LANG-421] - StringEscapeUtils - escapeJava() escapes '/' characters + * [LANG-450] - StringEscapeUtils - change escapeJavaStyleString() to throw UnhandledException instead swallowing IOException + * [LANG-419] - WordUtils - fix StringIndexOutOfBoundsException when lower is greater than the String length + * [LANG-523] - StrBuilder - Performance improvement by doubling the size of the String in ensureCapacity + * [LANG-575] - Compare, Equals and HashCode builders - use ArrayUtils to avoid creating a temporary List + * [LANG-467] - EqualsBuilder - removing the special handling of BigDecimal (LANG-393) to use compareTo + * [LANG-574] - HashCodeBuilder - Performance improvement: check for isArray to short-circuit the 9 instanceof checks + * [LANG-520] - HashCodeBuilder - Changing the hashCode() method to return toHashCode() + * [LANG-459] - HashCodeBuilder - reflectionHashCode() can generate incorrect hashcodes + * [LANG-586] - HashCodeBuilder and ToStringStyle - use of ThreadLocal causes memory leaks in container environments + * [LANG-487] - ToStringBuilder - make default style thread-safe + * [LANG-472] - RandomUtils - nextLong() always produces even numbers + * [LANG-592] - RandomUtils - RandomUtils tests are failing frequently -- None - -INCOMPATIBLE CHANGES WITH VERSION 2.2: - -- Calling stop on a suspended StopWatch will no longer change the underlying time. - It's very unlikely anyone was relying on that bug as a feature. - -ADDITIONAL INCOMPATIBLE CHANGES WITH VERSION 2.0: - -- The Nestable interface defines the method indexOfThrowable(Class). -Previously the implementations checked only for a specific Class. -Now they check for subclasses of that Class as well. -For most situations this will be the expected behaviour (ie. it is a bug fix). -If it causes problems, please use the ExceptionUtils.indexOfThrowable(Class) method instead. -Note that the ExceptionUtils method is available in v1.0 and v2.0 of commons-lang and has not been changed. -(An alternative to this is to change the public static matchSubclasses flag on NestableDelegate. -However, we don't recommend that as a long-term solution.) - -- The StopWatch class has had much extra validation added. -If your code previously relied on unusual aspects, it may no longer work. - -- Starting with version 2.1, Ant version 1.6.x is required to build. Copy -junit.jar to ANT_HOME/lib. You can get JUnit from http://www.junit.org. See the developer's guide -for more details. - -DEPRECATIONS FROM 2.3 to 2.4: - -- ObjectUtils.appendIdentityToString(StringBuffer, Object) - has very odd semantics, use - ObjectUtils.identityToString(StringBuffer, Object) instead. - -- public static java.util.Date add(java.util.Date, int, int) - it is not intended for this - method to be public. Please let us know if you use this. - -DEPRECATIONS FROM 2.2 to 2.3: - -- None - -DEPRECATIONS FROM 2.1 to 2.2: - -- None - -DEPRECATIONS FROM 2.0 to 2.1: - -- The enum package has been renamed to enums for JDK1.5 compliance. -All functionality is identical, just the package has changed. -This package will be removed in v3.0. - -- NumberUtils.stringToInt - renamed to toInt - -- DateUtils - four constants, MILLIS_IN_* have been deprecated as they were defined -as int not long. The replacements are MILLIS_PER_*. - - -BUG FIXES IN 2.4: - - * [LANG-76 ] - EnumUtils.getEnum() doesn't work well in 1.5 - * [LANG-328] - LocaleUtils.toLocale() rejects strings with only language+variant - * [LANG-334] - Enum is not thread-safe - * [LANG-346] - Dates.round() behaves incorrectly for minutes and seconds - * [LANG-349] - Deadlock using ReflectionToStringBuilder - * [LANG-353] - Javadoc Example for EqualsBuilder is questionable - * [LANG-360] - Why does appendIdentityToString return null? - * [LANG-361] - BooleanUtils toBooleanObject javadoc does not match implementation - * [LANG-363] - StringEscapeUtils.escapeJavaScript() method did not escape '/' into '\/', it will make IE render page incorrectly - * [LANG-364] - Documentation bug for ignoreEmptyTokens accessors in StrTokenizer - * [LANG-365] - BooleanUtils.toBoolean() - invalid drop-thru in case statement causes StringIndexOutOfBoundsException - * [LANG-367] - FastDateFormat thread safety - * [LANG-368] - FastDateFormat getDateInstance() and getDateTimeInstance() assume Locale.getDefault() won't change - * [LANG-369] - ExceptionUtils not thread-safe - * [LANG-372] - ToStringBuilder: MULTI_LINE_STYLE does not print anything from appendToString methods. - * [LANG-380] - infinite loop in Fraction.reduce when numerator == 0 - * [LANG-381] - NumberUtils.min(floatArray) returns wrong value if floatArray[0] happens to be Float.NaN - * [LANG-385] - http://commons.apache.org/lang/developerguide.html "Building" section is incorrect and incomplete - * [LANG-393] - EqualsBuilder don't compare BigDecimals correctly - * [LANG-399] - Javadoc bugs - cannot find object - * [LANG-410] - Ambiguous / confusing names in StringUtils replace* methods - * [LANG-412] - StrBuilder appendFixedWidth does not handle nulls - * [LANG-414] - DateUtils.round() often fails - -IMPROVEMENTS IN 2.4: - - * [LANG-180] - adding a StringUtils.replace method that takes an array or List of replacement strings - * [LANG-192] - Split camel case strings - * [LANG-257] - Add new splitByWholeSeparatorPreserveAllTokens() methods to StringUtils - * [LANG-269] - Shouldn't Commons Lang's StringUtils have a "common" string method? - * [LANG-298] - ClassUtils.getShortClassName and ClassUtils.getPackageName and class of array - * [LANG-321] - Add toArray() method to IntRange and LongRange classes - * [LANG-322] - ClassUtils.getShortClassName(String) inefficient - * [LANG-326] - StringUtils: startsWith / endsWith / startsWithIgnoreCase / endsWithIgnoreCase / removeStartIgnoreCase / removeEndIgnoreCase methods - * [LANG-329] - Pointless synchronized in ThreadLocal.initialValue should be removed - * [LANG-333] - ArrayUtils.toClass - * [LANG-337] - Utility class constructor javadocs should acknowledge that they may sometimes be used, e.g. with Velocity. - * [LANG-338] - truncateNicely method which avoids truncating in the middle of a word - * [LANG-345] - Optimize HashCodeBuilder.append(Object) - * [LANG-351] - Extension to ClassUtils: Obtain the primitive class from a wrapper - * [LANG-356] - Add getStartTime to StopWatch - * [LANG-362] - Add ExtendedMessageFormat to org.apache.commons.lang.text - * [LANG-371] - ToStringStyle javadoc should show examples of styles - * [LANG-374] - Add escaping for CSV columns to StringEscapeUtils - * [LANG-375] - add SystemUtils.IS_OS_WINDOWS_VISTA field - * [LANG-379] - Calculating A date fragment in any time-unit - * [LANG-383] - Adding functionality to DateUtils to allow direct setting of various fields. - * [LANG-402] - OSGi-ify Lang - * [LANG-404] - Add Calendar flavour format methods to DateFormatUtils - * [LANG-407] - StringUtils.length(String) returns null-safe length - * [LANG-413] - Memory usage improvement for StringUtils#getLevenshteinDistance() |