From 41bf62151749719452565a18eb4d3f93789cc8b3 Mon Sep 17 00:00:00 2001 From: Henri Yandell Date: Fri, 5 Aug 2011 07:28:15 +0000 Subject: [PATCH] Updating the release notes git-svn-id: https://svn.apache.org/repos/asf/commons/proper/lang/trunk@1154104 13f79535-47bb-0310-9956-ffa450edef68 --- RELEASE-NOTES.txt | 157 +++++++--------------------------------------- 1 file changed, 22 insertions(+), 135 deletions(-) diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 5c5d6663c..ab312c9c3 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,155 +1,42 @@ $Id$ Commons Lang Package - Version 3.0 + Version 3.0.1 Release Notes INTRODUCTION: -This document contains the release notes for the 3.0 version of Apache Commons Lang. +This document contains the release notes for the 3.0.1 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 3.0 now targets Java 5.0, making use of features that arrived with Java 5.0 such as generics, +Lang 3.0 and onwards now targets Java 5.0, making use of features that arrived with Java 5.0 such as generics, variable arguments, autoboxing, concurrency and formatted output. -For the latest advice on upgrading, see the following page: +For the advice on upgrading from 2.x to 3.x, see the following page: http://commons.apache.org/lang/article3_0.html -ADDITIONS IN 3.0 +CHANGES IN 3.0.1 ================ - [LANG-276] MutableBigDecimal and MutableBigInteger. - [LANG-285] Wish : method unaccent. - [LANG-358] ObjectUtils.coalesce. - [LANG-386] LeftOf/RightOfNumber in Range convenience methods necessary. - [LANG-435] Add ClassUtils.isAssignable() variants with autoboxing. - [LANG-444] StringUtils.emptyToNull. - [LANG-482] Enhance StrSubstitutor to support nested ${var-${subvr}} expansion - [LANG-482] StrSubstitutor now supports substitution in variable names. - [LANG-496] A generic implementation of the Lazy initialization pattern. - [LANG-497] Addition of ContextedException and ContextedRuntimeException. - [LANG-498] Add StringEscapeUtils.escapeText() methods. - [LANG-499] Add support for the handling of ExecutionExceptions. - [LANG-501] Add support for background initialization. - [LANG-529] Add a concurrent package. - [LANG-533] Validate: support for validating blank strings. - [LANG-537] Add ArrayUtils.toArray to create generic arrays. - [LANG-545] Add ability to create a Future for a constant. - [LANG-546] Add methods to Validate to check whether the index is valid for the array/list/string. - [LANG-553] Add TypeUtils class to provide utility code for working with generic types. - [LANG-559] Added isAssignableFrom and isInstanceOf validation methods. - [LANG-559] Added validState validation method. - [LANG-560] New TimedSemaphore class. - [LANG-582] Provide an implementation of the ThreadFactory interface. - [LANG-588] Create a basic Pair class. - [LANG-594] DateUtils equal & compare functions up to most significant field. - [LANG-601] Add Builder Interface / Update Builders to Implement It. - [LANG-609] Support lazy initialization using atomic variables - [LANG-610] Extend exception handling in ConcurrentUtils to runtime exceptions. - [LANG-614] StringUtils.endsWithAny method - [LANG-640] Add normalizeSpace to StringUtils - [LANG-644] Provide documentation about the new concurrent package - [LANG-649] BooleanUtils.toBooleanObject to support single character input - [LANG-651] Add AnnotationUtils - [LANG-653] Provide a very basic ConcurrentInitializer implementation - [LANG-655] Add StringUtils.defaultIfBlank() - [LANG-667] Add a Null-safe compare() method to ObjectUtils - [LANG-676] Documented potential NPE if auto-boxing occurs for some BooleanUtils methods - [LANG-678] Add support for ConcurrentMap.putIfAbsent() - [LANG-692] Add hashCodeMulti varargs method - [LANG-697] Add FormattableUtils class - [LANG-684] Levenshtein Distance Within a Given Threshold + [LANG-686] Improve exception message when StringUtils.replaceEachRepeatedly detects recursion + [LANG-717] Specify source encoding for Ant build + [LANG-721] Complement ArrayUtils.addAll() variants with by-index and by-value removal methods + [LANG-726] Add Range<T> Range<T>.intersectionWith(Range<T>) + [LANG-723] Add mode and median Comparable... methods to ObjectUtils + [LANG-722] Add BooleanUtils.and + or varargs methods + [LANG-730] EnumSet -> bit vector + [LANG-735] Deprecate CharUtils.toCharacterObject(char) in favor of java.lang.Character.valueOf(char) + [LANG-737] Missing method getRawMessage for ContextedException and ContextedRuntimeException -REMOVALS IN 3.0 -=============== +BUG FIXES IN 3.0.1 +================== - [LANG-438] Remove @deprecateds. - [LANG-492] Remove code handled now by the JDK. - [LANG-493] Remove code that does not hold enough value to remain. - [LANG-590] Remove JDK 1.2/1.3 bug handling in StringUtils.indexOf(String, String, int). - [LANG-673] WordUtils.abbreviate() removed - [LANG-691] Removed DateUtils.UTC_TIME_ZONE - -IMPROVEMENTS IN 3.0 -=================== - - [LANG-290] EnumUtils for JDK 5.0. - [LANG-336] Finally start using generics. - [LANG-355] StrBuilder should implement CharSequence and Appendable. - [LANG-396] Investigate for vararg usages. - [LANG-424] Improve Javadoc for StringUtils class. - [LANG-458] Refactor Validate.java to eliminate code redundancy. - [LANG-479] Document where in SVN trunk is. - [LANG-504] bring ArrayUtils.isEmpty to the generics world. - [LANG-505] Rewrite StringEscapeUtils. - [LANG-507] StringEscapeUtils.unescapeJava should support \u+ notation. - [LANG-510] Convert StringUtils API to take CharSequence. - [LANG-513] Better EnumUtils. - [LANG-528] Mutable classes should implement an appropriately typed Mutable interface. - [LANG-539] Compile commons.lang for CDC 1.1/Foundation 1.1. - [LANG-540] Make NumericEntityEscaper immutable. - [LANG-541] Replace StringBuffer with StringBuilder. - [LANG-548] Use Iterable on API instead of Collection. - [LANG-551] Replace Range classes with generic version. - [LANG-562] Change Maven groupId. - [LANG-563] Change Java package name. - [LANG-570] Do the test cases really still require main() and suite() methods?. - [LANG-579] Add new Validate methods. - [LANG-599] ClassUtils.getClass(): Allow Dots as Inner Class Separators. - [LANG-605] DefaultExceptionContext overwrites values in recursive situations. - [LANG-668] Change ObjectUtils min() & max() functions to use varargs rather than just two parameters - [LANG-681] Push down WordUtils to "text" sub-package. - [LANG-711] Add includeantruntime=false to javac targets to quell warnings in ant 1.8.1 and better (and modest performance gain). - [LANG-713] Increase test coverage of FieldUtils read methods and tweak javadoc. - [LANG-718] build.xml Java 1.5+ updates. - -BUG FIXES IN 3.0 -================ - - [LANG-11] Depend on JDK 1.5+. - [LANG-302] StrBuilder does not implement clone(). - [LANG-339] StringEscapeUtils.escapeHtml() escapes multibyte characters like Chinese, Japanes, etc. - [LANG-369] ExceptionUtils not thread-safe. - [LANG-418] Javadoc incorrect for StringUtils.endsWithIgnoreCase. - [LANG-428] StringUtils.isAlpha, isAlphanumeric and isNumeric now return false for "" - [LANG-439] StringEscapeUtils.escapeHTML() does not escape chars (0x00-0x20). - [LANG-448] Lower Ascii Characters don't get encoded by Entities.java. - [LANG-468] JDK 1.5 build/runtime failure on LANG-393 (EqualsBuilder). - [LANG-474] Fixes for thread safety. - [LANG-478] StopWatch does not resist to system time changes. - [LANG-480] StringEscapeUtils.escapeHtml incorrectly converts unicode characters above U+00FFFF into 2 characters. - [LANG-481] Possible race-conditions in hashCode of the range classes. - [LANG-564] Improve StrLookup API documentation. - [LANG-568] @SuppressWarnings("unchecked") is used too generally. - [LANG-571] ArrayUtils.add(T[] array, T element) can create unexpected ClassCastException. - [LANG-585] exception.DefaultExceptionContext.getFormattedExceptionMessage catches Throwable. - [LANG-596] StrSubstitutor should also handle the default properties of a java.util.Properties class - [LANG-600] Javadoc is incorrect for public static int lastIndexOf(String str, String searchStr). - [LANG-602] ContextedRuntimeException no longer an 'unchecked' exception. - [LANG-606] EqualsBuilder causes StackOverflowException. - [LANG-608] Some StringUtils methods should take an int character instead of char to use String API features. - [LANG-617] StringEscapeUtils.escapeXML() can't process UTF-16 supplementary characters - [LANG-624] SystemUtils.getJavaVersionAsFloat throws StringIndexOutOfBoundsException on Android runtime/Dalvik VM - [LANG-629] Charset may not be threadsafe, because the HashSet is not synch. - [LANG-638] NumberUtils createNumber throws a StringIndexOutOfBoundsException when argument containing "e" and "E" is passed in - [LANG-643] Javadoc StringUtils.left() claims to throw on negative len, but doesn't - [LANG-645] FastDateFormat.format() outputs incorrect week of year because locale isn't respected - [LANG-646] StringEscapeUtils.unescapeJava doesn't handle octal escapes and Unicode with extra u - [LANG-656] Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect - [LANG-658] Some Entitys like Ö are not matched properly against its ISO8859-1 representation - [LANG-659] EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 ISOtech - [LANG-66] StringEscaper.escapeXml() escapes characters > 0x7f. - [LANG-662] org.apache.commons.lang3.math.Fraction does not reduce (Integer.MIN_VALUE, 2^k) - [LANG-663] org.apache.commons.lang3.math.Fraction does not always succeed in multiplyBy and divideBy - [LANG-664] NumberUtils.isNumber(String) is not right when the String is "1.1L" - [LANG-672] Doc bug in DateUtils#ceiling - [LANG-677] DateUtils.isSameLocalTime compares using 12 hour clock and not 24 hour - [LANG-685] EqualsBuilder synchronizes on HashCodeBuilder. - [LANG-703] StringUtils.join throws NPE when toString returns null for one of objects in collection - [LANG-710] StringIndexOutOfBoundsException when calling unescapeHtml4("") - [LANG-714] StringUtils doc/comment spelling fixes. - [LANG-715] CharSetUtils.squeeze() speedup. - [LANG-716] swapCase and *capitalize speedups. + [LANG-626] SerializationUtils.clone: Fallback to context classloader if class not found in current classloader + [LANG-727] ToStringBuilderTest.testReflectionHierarchyArrayList fails with IBM JDK 6 + [LANG-720] StringEscapeUtils.escapeXml(input) wrong when input contains characters in Supplementary Planes + [LANG-708] StringEscapeUtils.escapeEcmaScript from lang3 cuts off long unicode string + [LANG-734] The CHAR_ARRAY cache in CharUtils duplicates the cache in java.lang.Character + [LANG-738] Use internal Java's Number caches instead creating new objects