| Apache Commons Lang |
| Version 3.4 |
| Release Notes |
| |
| |
| INTRODUCTION: |
| |
| This document contains the release notes for the 3.4 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. Commons Lang 3.4 |
| at least requires Java 6.0. |
| |
| For the advice on upgrading from 2.x to 3.x, see the following page: |
| |
| http://commons.apache.org/lang/article3_0.html |
| |
| |
| COMPATIBILITY |
| ============= |
| |
| Commons Lang 3.4 is fully binary compatible to the last release and can |
| therefore be used as a drop in replacement for 3.3.2. Note that the value of |
| org.apache.commons.lang3.time.DurationFormatUtils.ISO_EXTENDED_FORMAT_PATTERN |
| has changed, which may affect clients using the constant. Furthermore the |
| constant is used internally in |
| o DurationFormatUtils.formatDurationISO(long) |
| o DurationFormatUtils.formatPeriodISO(long, long) |
| |
| For more information see https://issues.apache.org/jira/browse/LANG-1000. |
| |
| NEW FEATURES |
| ============== |
| |
| o LANG-821: Support OS X versions in SystemUtils. Thanks to Timo Kockert. |
| o LANG-1103: Add SystemUtils.IS_JAVA_1_9 |
| o LANG-1093: Add ClassUtils.getAbbreviatedName(). Thanks to Fabian Lange. |
| o LANG-1082: Add option to disable the "objectsTriviallyEqual" test in |
| DiffBuilder. Thanks to Jonathan Baker. |
| o LANG-1015: Add JsonToStringStyle implementation to ToStringStyle. Thanks to |
| Thiago Andrade. |
| o LANG-1080: Add NoClassNameToStringStyle implementation of ToStringStyle. |
| Thanks to Innokenty Shuvalov. |
| o LANG-883: Add StringUtils.containsAny(CharSequence, CharSequence...) method. |
| Thanks to Daniel Stewart. |
| o LANG-1052: Multiline recursive to string style. Thanks to Jan Matèrne. |
| o LANG-536: Add isSorted() to ArrayUtils. Thanks to James Sawle. |
| o LANG-1033: Add StringUtils.countMatches(CharSequence, char) |
| o LANG-1021: Provide methods to retrieve all fields/methods annotated with a |
| specific type. Thanks to Alexander Müller. |
| o LANG-1016: NumberUtils#isParsable method(s). Thanks to |
| Juan Pablo Santos Rodríguez. |
| o LANG-999: Add fuzzy String matching logic to StringUtils. Thanks to |
| Ben Ripkens. |
| o LANG-994: Add zero copy read method to StrBuilder. Thanks to |
| Mikhail Mazursky. |
| o LANG-993: Add zero copy write method to StrBuilder. Thanks to |
| Mikhail Mazursky. |
| o LANG-1044: Add method MethodUtils.invokeExactMethod(Object, String) |
| o LANG-1045: Add method MethodUtils.invokeMethod(Object, String) |
| |
| FIXED BUGS |
| ============ |
| |
| o LANG-794: SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to |
| Timo Kockert. |
| o LANG-1104: Parse test fails for TimeZone America/Sao_Paulo |
| o LANG-948: Exception while using ExtendedMessageFormat and escaping braces. |
| Thanks to Andrey Khobnya. |
| o LANG-1092: Wrong formating of time zones with daylight saving time in |
| FastDatePrinter |
| o LANG-1090: FastDateParser does not set error indication in ParsePosition |
| o LANG-1089: FastDateParser does not handle excess hours as per |
| SimpleDateFormat |
| o LANG-1061: FastDateParser error - timezones not handled correctly. Thanks to |
| dmeneses. |
| o LANG-1087: NumberUtils#createNumber() returns positive BigDecimal when |
| negative Float is expected. Thanks to Renat Zhilkibaev. |
| o LANG-1081: DiffBuilder.append(String, Object left, Object right) does not do |
| a left.equals(right) check. Thanks to Jonathan Baker. |
| o LANG-1055: StrSubstitutor.replaceSystemProperties does not work consistently. |
| Thanks to Jonathan Baker. |
| o LANG-1083: Add (T) casts to get unit tests to pass in old JDK. Thanks to |
| Jonathan Baker. |
| o LANG-1073: Read wrong component type of array in add in ArrayUtils. |
| Thanks to haiyang li. |
| o LANG-1077: StringUtils.ordinalIndexOf("aaaaaa", "aa", 2) != 3 in StringUtils. |
| Thanks to haiyang li. |
| o LANG-1072: Duplicated "0x" check in createBigInteger in NumberUtils. Thanks |
| to haiyang li. |
| o LANG-1064: StringUtils.abbreviate description doesn't agree with the |
| examples. Thanks to B.J. Herbison. |
| o LANG-1041: Fix MethodUtilsTest so it does not depend on JDK method ordering. |
| Thanks to Alexandre Bartel. |
| o LANG-1000: ParseException when trying to parse UTC dates with Z as zone |
| designator using DateFormatUtils.ISO_DATETIME_TIME_ZONE_FORMAT |
| o LANG-1035: Javadoc for EqualsBuilder.reflectionEquals() is unclear |
| o LANG-1001: ISO 8601 misspelled throughout the Javadocs. Thanks to |
| Michael Osipov. |
| o LANG-1088: FastDateParser should be case insensitive |
| o LANG-995: Fix bug with stripping spaces on last line in WordUtils.wrap(). |
| Thanks to Andrey Khobnya. |
| |
| CHANGES |
| ========= |
| |
| o LANG-1102: Make logic for comparing OS versions in SystemUtils smarter |
| o LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange. |
| o LANG-1101: FastDateParser and FastDatePrinter support 'X' format |
| o LANG-1100: Avoid memory allocation when using date formating to StringBuffer. |
| Thanks to mbracher. |
| o LANG-935: Possible performance improvement on string escape functions. |
| Thanks to Fabian Lange, Thomas Neidhart. |
| o LANG-1098: Avoid String allocation in StrBuilder.append(CharSequence). Thanks |
| to Mikhail Mazurskiy, Fabian Lange. |
| o LANG-1098: Update maven-checkstyle-plugin to 2.14. Thanks to Micha? Kordas. |
| o LANG-1097: Update org.easymock:easymock to 3.3.1. Thanks to Micha? Kordas. |
| o LANG-1096: Update maven-pmd-plugin to 3.4. Thanks to Micha? Kordas. |
| o LANG-1095: Update maven-antrun-plugin to 1.8. Thanks to Micha? Kordas. |
| o LANG-877: Performance improvements for StringEscapeUtils. Thanks to |
| Fabian Lange. |
| o LANG-1071: Fix wrong examples in JavaDoc of |
| StringUtils.replaceEachRepeatedly(...), |
| StringUtils.replaceEach(...) Thanks to Arno Noordover. |
| o LANG-827: CompareToBuilder's doc doesn't specify precedence of fields it |
| uses in performing comparisons |
| o LANG-1020: Improve performance of normalize space. Thanks to Libor Ondrusek. |
| o LANG-1027: org.apache.commons.lang3.SystemUtils#isJavaVersionAtLeast should |
| return true by default |
| o LANG-1026: Bring static method references in StringUtils to consistent style. |
| Thanks to Alex Yursha. |
| o LANG-1017: Use non-ASCII digits in Javadoc examples for |
| StringUtils.isNumeric. Thanks to Christoph Schneegans. |
| o LANG-1008: Change min/max methods in NumberUtils/IEEE754rUtils from array |
| input parameters to varargs. Thanks to Thiago Andrade. |
| o LANG-1006: Add wrap (with String or char) to StringUtils. Thanks to |
| Thiago Andrade. |
| o LANG-1005: Extend DurationFormatUtils#formatDurationISO default pattern to |
| match #formatDurationHMS. Thanks to Michael Osipov. |
| o LANG-1007: Fixing NumberUtils JAVADoc comments for max methods. Thanks to |
| Thiago Andrade. |
| o LANG-731: Better Javadoc for BitField class |
| o LANG-1004: DurationFormatUtils#formatDurationHMS implementation does not |
| correspond to Javadoc and vice versa. Thanks to Michael Osipov. |
| o LANG-1003: DurationFormatUtils are not able to handle negative |
| durations/periods |
| o LANG-998: Javadoc is not clear on preferred pattern to instantiate |
| FastDateParser / FastDatePrinter |
| |
| Release Notes for version 3.3.2 |
| |
| NEW FEATURES |
| ============== |
| |
| o LANG-989: Add org.apache.commons.lang3.SystemUtils.IS_JAVA_1_8 |
| |
| FIXED BUGS |
| ============ |
| |
| o LANG-992: NumberUtils#isNumber() returns false for "0.0", "0.4790", et al |
| |
| Release Notes for version 3.3.1 |
| |
| FIXED BUGS |
| ============ |
| |
| o LANG-987: DateUtils.getFragmentInDays(Date, Calendar.MONTH) returns wrong |
| days |
| o LANG-983: DurationFormatUtils does not describe format string fully |
| o LANG-981: DurationFormatUtils#lexx does not detect unmatched quote char |
| o LANG-984: DurationFormatUtils does not handle large durations correctly |
| o LANG-982: DurationFormatUtils.formatDuration(61999, "s.SSSS") - ms field |
| size should be 4 digits |
| o LANG-978: Failing tests with Java 8 b128 |
| |
| Release Notes for version 3.3 |
| |
| NEW FEATURES |
| ============== |
| |
| o LANG-955: Add methods for removing all invalid characters according to |
| XML 1.0 and XML 1.1 in an input string to StringEscapeUtils. |
| Thanks to Adam Hooper. |
| o LANG-970: Add APIs MutableBoolean setTrue() and setFalse() |
| o LANG-962: Add SerializationUtils.roundtrip(T extends Serializable) to |
| serialize then deserialize |
| o LANG-637: There should be a DifferenceBuilder with a |
| ReflectionDifferenceBuilder implementation |
| o LANG-944: Add the Jaro-Winkler string distance algorithm to StringUtils. |
| Thanks to Rekha Joshi. |
| o LANG-417: New class ClassPathUtils with methods for turning FQN into |
| resource path |
| o LANG-834: Validate: add inclusiveBetween and exclusiveBetween overloads |
| for primitive types |
| o LANG-900: New RandomUtils class. Thanks to Duncan Jones. |
| o LANG-966: Add IBM OS/400 detection |
| |
| FIXED BUGS |
| ============ |
| |
| o LANG-621: ReflectionToStringBuilder.toString does not debug 3rd party object |
| fields within 3rd party object. Thanks to Philip Hodges, |
| Thomas Neidhart. |
| o LANG-977: NumericEntityEscaper incorrectly encodes supplementary characters. |
| Thanks to Chris Karcher. |
| o LANG-973: Make some private fields final |
| o LANG-971: NumberUtils#isNumber(String) fails to reject invalid Octal numbers |
| o LANG-972: NumberUtils#isNumber does not allow for hex 0XABCD |
| o LANG-969: StringUtils.toEncodedString(byte[], Charset) needlessly throws |
| UnsupportedEncodingException. Thanks to Matt Bishop. |
| o LANG-946: ConstantInitializerTest fails when building with IBM JDK 7 |
| o LANG-954: uncaught PatternSyntaxException in FastDateFormat on Android. |
| Thanks to Michael Keppler. |
| o LANG-936: StringUtils.getLevenshteinDistance with too big of a threshold |
| returns wrong result. Thanks to Yaniv Kunda, Eli Lindsey. |
| o LANG-943: Test DurationFormatUtilsTest.testEdgeDuration fails in |
| JDK 1.6, 1.7 and 1.8, BRST time zone |
| o LANG-613: ConstructorUtils.getAccessibleConstructor() Does Not Check the |
| Accessibility of Enclosing Classes |
| o LANG-951: Fragments are wrong by 1 day when using fragment YEAR or MONTH. |
| Thanks to Sebastian Götz. |
| o LANG-950: FastDateParser does not handle two digit year parsing like |
| SimpleDateFormat |
| o LANG-949: FastDateParserTest.testParses does not test FastDateParser |
| o LANG-915: Wrong locale handling in LocaleUtils.toLocale(). |
| Thanks to Sergio Fernández. |
| |
| CHANGES |
| ========= |
| |
| o LANG-961: org.apache.commons.lang3.reflect.FieldUtils.removeFinalModifier(Field) |
| does not clean up after itself |
| o LANG-958: FastDateParser javadoc incorrectly states that SimpleDateFormat |
| is used internally |
| o LANG-956: Improve JavaDoc of WordUtils.wrap methods |
| o LANG-939: Move Documentation from user guide to package-info files |
| o LANG-953: Convert package.html files to package-info.java files |
| o LANG-940: Fix deprecation warnings |
| o LANG-819: EnumUtils.generateBitVector needs a "? extends" |
| |
| Release Notes for version 3.2.1 |
| |
| BUG FIXES |
| =========== |
| |
| o LANG-937: Fix missing Hamcrest dependency in Ant Build |
| o LANG-941: Test failure in LocaleUtilsTest when building with JDK 8 |
| o LANG-942: Test failure in FastDateParserTest and FastDateFormat_ParserTest |
| when building with JDK8. Thanks to Bruno P. Kinoshita, |
| Henri Yandell. |
| o LANG-938: Build fails with test failures when building with JDK 8 |
| |
| Release Notes for version 3.2 |
| |
| COMPATIBILITY WITH 3.1 |
| ======================== |
| |
| This release introduces backwards incompatible changes in |
| org.apache.commons.lang3.time.FastDateFormat: |
| o Method 'protected java.util.List parsePattern()' has been removed |
| o Method 'protected java.lang.String parseToken(java.lang.String, int[])' has |
| been removed |
| o Method 'protected org.apache.commons.lang3.time.FastDateFormat$NumberRule |
| selectNumberRule(int, int)' has been removed |
| |
| These changes were the result of [LANG-462]. It is assumed that this change |
| will not break clients as Charles Honton pointed out on 25/Jan/12: |
| " |
| 1. Methods "FastDateFormat$NumberRule selectNumberRule(int, int)" and |
| "List<Rule> parsePattern()" couldn't have been overridden because |
| NumberRule and Rule were private to FastDateFormat. |
| 2. Due to the factory pattern used, it's unlikely other two methods would have |
| been overridden. |
| 3. The four methods are highly implementation specific. I consider it a |
| mistake that the methods were exposed. |
| " |
| For more information see https://issues.apache.org/jira/browse/LANG-462. |
| |
| NEW FEATURES |
| ============== |
| |
| o LANG-934: Add removeFinalModifier to FieldUtils |
| o LANG-863: Method returns number of inheritance hops between parent and |
| subclass. Thanks to Daneel S. Yaitskov. |
| o LANG-774: Added isStarted, isSuspended and isStopped to StopWatch. |
| Thanks to Erhan Bagdemir. |
| o LANG-848: Added StringUtils.isBlank/isEmpty CharSequence... methods. |
| Thanks to Alexander Muthmann. |
| o LANG-926: Added ArrayUtils.reverse(array, from, to) methods. |
| o LANG-795: StringUtils.toString(byte[], String) deprecated in favour of a new |
| StringUtils.toString(byte[], CharSet). Thanks to Aaron Digulla. |
| o LANG-893: StrSubstitutor now supports default values for variables. |
| Thanks to Woonsan Ko. |
| o LANG-913: Adding .gitignore to commons-lang. Thanks to Allon Mureinik. |
| o LANG-837: Add ObjectUtils.toIdentityString methods that support |
| StringBuilder, StrBuilder, and Appendable. |
| o LANG-886: Added CharSetUtils.containsAny(String, String). |
| o LANG-797: Added escape/unescapeJson to StringEscapeUtils. |
| o LANG-875: Added appendIfMissing and prependIfMissing methods to StringUtils. |
| o LANG-870: Add StringUtils.LF and StringUtils.CR values. |
| o LANG-873: Add FieldUtils getAllFields() to return all the fields defined in |
| the given class and super classes. |
| o LANG-835: StrBuilder should support StringBuilder as an input parameter. |
| o LANG-857: StringIndexOutOfBoundsException in CharSequenceTranslator. |
| o LANG-856: Code refactoring in NumberUtils. |
| o LANG-855: NumberUtils#createBigInteger does not allow for hex and octal |
| numbers. |
| o LANG-854: NumberUtils#createNumber - does not allow for hex numbers to be |
| larger than Long. |
| o LANG-853: StringUtils join APIs for primitives. |
| o LANG-841: Add StringUtils API to call String.replaceAll in DOTALL a.k.a. |
| single-line mode. |
| o LANG-825: Create StrBuilder APIs similar to |
| String.format(String, Object...). |
| o LANG-675: Add Triple class (ternary version of Pair). |
| o LANG-462: FastDateFormat supports parse methods. |
| |
| BUG FIXES |
| =========== |
| |
| o LANG-932: Spelling fixes. Thanks to Ville Skyttä. |
| o LANG-929: OctalUnescaper tried to parse all of \279. |
| o LANG-928: OctalUnescaper had bugs when parsing octals starting with a zero. |
| o LANG-905: EqualsBuilder returned true when comparing arrays, even when the |
| elements are different. |
| o LANG-917: Fixed exception when combining custom and choice format in |
| ExtendedMessageFormat. Thanks to Arne Burmeister. |
| o LANG-902: RandomStringUtils.random javadoc was incorrectly promising letters |
| and numbers would, as opposed to may, appear Issue:. Thanks to |
| Andrzej Winnicki. |
| o LANG-921: BooleanUtils.xor(boolean...) produces wrong results. |
| o LANG-896: BooleanUtils.toBoolean(String str) javadoc is not updated. Thanks |
| to Mark Bryan Yu. |
| o LANG-879: LocaleUtils test fails with new Locale "ja_JP_JP_#u-ca-japanese" |
| of JDK7. |
| o LANG-836: StrSubstitutor does not support StringBuilder or CharSequence. |
| Thanks to Arnaud Brunet. |
| o LANG-693: Method createNumber from NumberUtils doesn't work for floating |
| point numbers other than Float Issue: LANG-693. Thanks to |
| Calvin Echols. |
| o LANG-887: FastDateFormat does not use the locale specific cache correctly. |
| o LANG-754: ClassUtils.getShortName(String) will now only do a reverse lookup |
| for array types. |
| o LANG-881: NumberUtils.createNumber() Javadoc says it does not work for octal |
| numbers. |
| o LANG-865: LocaleUtils.toLocale does not parse strings starting with an |
| underscore. |
| o LANG-858: StringEscapeUtils.escapeJava() and escapeEcmaScript() do not |
| output the escaped surrogate pairs that are Java parsable. |
| o LANG-849: FastDateFormat and FastDatePrinter generates Date objects |
| wastefully. |
| o LANG-845: Spelling fixes. |
| o LANG-844: Fix examples contained in javadoc of StringUtils.center methods. |
| o LANG-832: FastDateParser does not handle unterminated quotes correctly. |
| o LANG-831: FastDateParser does not handle white-space properly. |
| o LANG-830: FastDateParser could use \Q \E to quote regexes. |
| o LANG-828: FastDateParser does not handle non-Gregorian calendars properly. |
| o LANG-826: FastDateParser does not handle non-ASCII digits correctly. |
| o LANG-822: NumberUtils#createNumber - bad behaviour for leading "--". |
| o LANG-818: FastDateFormat's "z" pattern does not respect timezone of Calendar |
| instances passed to format(). |
| o LANG-817: Add org.apache.commons.lang3.SystemUtils.IS_OS_WINDOWS_8. |
| o LANG-813: StringUtils.equalsIgnoreCase doesn't check string reference |
| equality. |
| o LANG-810: StringUtils.join() endIndex, bugged for loop. |
| o LANG-807: RandomStringUtils throws confusing IAE when end <= start. |
| o LANG-805: RandomStringUtils.random(count, 0, 0, false, false, universe, |
| random) always throws java.lang.ArrayIndexOutOfBoundsException. |
| o LANG-802: LocaleUtils - unnecessary recursive call in SyncAvoid class. |
| o LANG-800: Javadoc bug in DateUtils#ceiling for Calendar and Object versions. |
| o LANG-788: SerializationUtils throws ClassNotFoundException when cloning |
| primitive classes. |
| o LANG-786: StringUtils equals() relies on undefined behavior. |
| o LANG-783: Documentation bug: StringUtils.split. |
| o LANG-777: jar contains velocity template of release notes. |
| o LANG-776: TypeUtilsTest contains incorrect type assignability assertion. |
| o LANG-775: TypeUtils.getTypeArguments() misses type arguments for |
| partially-assigned classes. |
| o LANG-773: ImmutablePair doc contains nonsense text. |
| o LANG-772: ClassUtils.PACKAGE_SEPARATOR Javadoc contains garbage text. |
| o LANG-765: EventListenerSupport.ProxyInvocationHandler no longer defines |
| serialVersionUID. |
| o LANG-764: StrBuilder is now serializable. |
| o LANG-761: Fix Javadoc Ant warnings. |
| o LANG-747: NumberUtils does not handle Long Hex numbers. |
| o LANG-743: Javadoc bug in static inner class DateIterator. |
| |
| CHANGES |
| ========= |
| |
| o LANG-931: Misleading Javadoc comment in StrBuilderReader class. Thanks |
| to Christoph Schneegans. |
| o LANG-910: StringUtils.normalizeSpace now handles non-breaking spaces |
| (Unicode 00A0). Thanks to Timur Yarosh. |
| o LANG-804: Redundant check for zero in HashCodeBuilder ctor. Thanks to |
| Allon Mureinik. |
| o LANG-884: Simplify FastDateFormat; eliminate boxing. |
| o LANG-882: LookupTranslator now works with implementations of CharSequence |
| other than String. |
| o LANG-846: Provide CharSequenceUtils.regionMatches with a proper green |
| implementation instead of inefficiently converting to Strings. |
| o LANG-839: ArrayUtils removeElements methods use unnecessary HashSet. |
| o LANG-838: ArrayUtils removeElements methods clone temporary index arrays |
| unnecessarily. |
| o LANG-799: DateUtils#parseDate uses default locale; add Locale support. |
| o LANG-798: Use generics in SerializationUtils. |
| |
| CHANGES WITHOUT TICKET |
| ======================== |
| |
| o Fixed URLs in javadoc to point to new oracle.com pages |
| |
| |
| Release Notes for version 3.1 |
| |
| NEW FEATURES |
| ============== |
| |
| o LANG-801: Add Conversion utility to convert between data types on byte level |
| o LANG-760: Add API StringUtils.toString(byte[] intput, String charsetName) |
| o LANG-756: Add APIs ClassUtils.isPrimitiveWrapper(Class<?>) and |
| isPrimitiveOrWrapper(Class<?>) |
| o LANG-695: SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system |
| |
| BUG FIXES |
| =========== |
| |
| o LANG-749: Incorrect Bundle-SymbolicName in Manifest |
| o LANG-746: NumberUtils does not handle upper-case hex: 0X and -0X |
| o LANG-744: StringUtils throws java.security.AccessControlException on Google |
| App Engine |
| o LANG-741: Ant build has wrong component.name |
| o LANG-698: Document that the Mutable numbers don't work as expected with |
| String.format |
| |
| CHANGES |
| ========= |
| |
| o LANG-758: Add an example with whitespace in StringUtils.defaultIfEmpty |
| o LANG-752: Fix createLong() so it behaves like createInteger() |
| o LANG-751: Include the actual type in the Validate.isInstance and |
| isAssignableFrom exception messages |
| o LANG-748: Deprecating chomp(String, String) |
| o LANG-736: CharUtils static final array CHAR_STRING is not needed to compute |
| CHAR_STRING_ARRAY |
| |
| |
| Release Notes for version 3.0 |
| |
| ADDITIONS |
| =========== |
| |
| o LANG-276: MutableBigDecimal and MutableBigInteger. |
| o LANG-285: Wish : method unaccent. |
| o LANG-358: ObjectUtils.coalesce. |
| o LANG-386: LeftOf/RightOfNumber in Range convenience methods necessary. |
| o LANG-435: Add ClassUtils.isAssignable() variants with autoboxing. |
| o LANG-444: StringUtils.emptyToNull. |
| o LANG-482: Enhance StrSubstitutor to support nested ${var-${subvr}} expansion |
| o LANG-482: StrSubstitutor now supports substitution in variable names. |
| o LANG-496: A generic implementation of the Lazy initialization pattern. |
| o LANG-497: Addition of ContextedException and ContextedRuntimeException. |
| o LANG-498: Add StringEscapeUtils.escapeText() methods. |
| o LANG-499: Add support for the handling of ExecutionExceptions. |
| o LANG-501: Add support for background initialization. |
| o LANG-529: Add a concurrent package. |
| o LANG-533: Validate: support for validating blank strings. |
| o LANG-537: Add ArrayUtils.toArray to create generic arrays. |
| o LANG-545: Add ability to create a Future for a constant. |
| o LANG-546: Add methods to Validate to check whether the index is valid for |
| the array/list/string. |
| o LANG-553: Add TypeUtils class to provide utility code for working with generic |
| types. |
| o LANG-559: Added isAssignableFrom and isInstanceOf validation methods. |
| o LANG-559: Added validState validation method. |
| o LANG-560: New TimedSemaphore class. |
| o LANG-582: Provide an implementation of the ThreadFactory interface. |
| o LANG-588: Create a basic Pair<L, R> class. |
| o LANG-594: DateUtils equal & compare functions up to most significant field. |
| o LANG-601: Add Builder Interface / Update Builders to Implement It. |
| o LANG-609: Support lazy initialization using atomic variables |
| o LANG-610: Extend exception handling in ConcurrentUtils to runtime exceptions. |
| o LANG-614: StringUtils.endsWithAny method |
| o LANG-640: Add normalizeSpace to StringUtils |
| o LANG-644: Provide documentation about the new concurrent package |
| o LANG-649: BooleanUtils.toBooleanObject to support single character input |
| o LANG-651: Add AnnotationUtils |
| o LANG-653: Provide a very basic ConcurrentInitializer implementation |
| o LANG-655: Add StringUtils.defaultIfBlank() |
| o LANG-667: Add a Null-safe compare() method to ObjectUtils |
| o LANG-676: Documented potential NPE if auto-boxing occurs for some BooleanUtils |
| methods |
| o LANG-678: Add support for ConcurrentMap.putIfAbsent() |
| o LANG-692: Add hashCodeMulti varargs method |
| o LANG-697: Add FormattableUtils class |
| o LANG-684: Levenshtein Distance Within a Given Threshold |
| |
| REMOVALS |
| ========== |
| |
| o LANG-438: Remove @deprecateds. |
| o LANG-492: Remove code handled now by the JDK. |
| o LANG-493: Remove code that does not hold enough value to remain. |
| o LANG-590: Remove JDK 1.2/1.3 bug handling in |
| StringUtils.indexOf(String, String, int). |
| o LANG-673: WordUtils.abbreviate() removed |
| o LANG-691: Removed DateUtils.UTC_TIME_ZONE |
| |
| IMPROVEMENTS |
| ============== |
| |
| o LANG-290: EnumUtils for JDK 5.0. |
| o LANG-336: Finally start using generics. |
| o LANG-355: StrBuilder should implement CharSequence and Appendable. |
| o LANG-396: Investigate for vararg usages. |
| o LANG-424: Improve Javadoc for StringUtils class. |
| o LANG-458: Refactor Validate.java to eliminate code redundancy. |
| o LANG-479: Document where in SVN trunk is. |
| o LANG-504: bring ArrayUtils.isEmpty to the generics world. |
| o LANG-505: Rewrite StringEscapeUtils. |
| o LANG-507: StringEscapeUtils.unescapeJava should support \u+ notation. |
| o LANG-510: Convert StringUtils API to take CharSequence. |
| o LANG-513: Better EnumUtils. |
| o LANG-528: Mutable classes should implement an appropriately typed Mutable |
| interface. |
| o LANG-539: Compile commons.lang for CDC 1.1/Foundation 1.1. |
| o LANG-540: Make NumericEntityEscaper immutable. |
| o LANG-541: Replace StringBuffer with StringBuilder. |
| o LANG-548: Use Iterable on API instead of Collection. |
| o LANG-551: Replace Range classes with generic version. |
| o LANG-562: Change Maven groupId. |
| o LANG-563: Change Java package name. |
| o LANG-570: Do the test cases really still require main() and suite() methods? |
| o LANG-579: Add new Validate methods. |
| o LANG-599: ClassUtils.getClass(): Allow Dots as Inner Class Separators. |
| o LANG-605: DefaultExceptionContext overwrites values in recursive situations. |
| o LANG-668: Change ObjectUtils min() & max() functions to use varargs rather |
| than just two parameters |
| o LANG-681: Push down WordUtils to "text" sub-package. |
| o LANG-711: Add includeantruntime=false to javac targets to quell warnings in |
| ant 1.8.1 and better (and modest performance gain). |
| o LANG-713: Increase test coverage of FieldUtils read methods and tweak |
| javadoc. |
| o LANG-718: build.xml Java 1.5+ updates. |
| |
| BUG FIXES |
| =========== |
| |
| o LANG-11: Depend on JDK 1.5+. |
| o LANG-302: StrBuilder does not implement clone(). |
| o LANG-339: StringEscapeUtils.escapeHtml() escapes multibyte characters like |
| Chinese, Japanese, etc. |
| o LANG-369: ExceptionUtils not thread-safe. |
| o LANG-418: Javadoc incorrect for StringUtils.endsWithIgnoreCase. |
| o LANG-428: StringUtils.isAlpha, isAlphanumeric and isNumeric now return false |
| for "" |
| o LANG-439: StringEscapeUtils.escapeHTML() does not escape chars (0x00-0x20). |
| o LANG-448: Lower Ascii Characters don't get encoded by Entities.java. |
| o LANG-468: JDK 1.5 build/runtime failure on LANG-393 (EqualsBuilder). |
| o LANG-474: Fixes for thread safety. |
| o LANG-478: StopWatch does not resist to system time changes. |
| o LANG-480: StringEscapeUtils.escapeHtml incorrectly converts unicode |
| characters above U+00FFFF into 2 characters. |
| o LANG-481: Possible race-conditions in hashCode of the range classes. |
| o LANG-564: Improve StrLookup API documentation. |
| o LANG-568: @SuppressWarnings("unchecked") is used too generally. |
| o LANG-571: ArrayUtils.add(T[: array, T element) can create unexpected |
| ClassCastException. |
| o LANG-585: exception.DefaultExceptionContext.getFormattedExceptionMessage |
| catches Throwable. |
| o LANG-596: StrSubstitutor should also handle the default properties of a |
| java.util.Properties class |
| o LANG-600: Javadoc is incorrect for public static int |
| lastIndexOf(String str, String searchStr). |
| o LANG-602: ContextedRuntimeException no longer an 'unchecked' exception. |
| o LANG-606: EqualsBuilder causes StackOverflowException. |
| o LANG-608: Some StringUtils methods should take an int character instead of |
| char to use String API features. |
| o LANG-617: StringEscapeUtils.escapeXML() can't process UTF-16 supplementary |
| characters |
| o LANG-624: SystemUtils.getJavaVersionAsFloat throws |
| StringIndexOutOfBoundsException on Android runtime/Dalvik VM |
| o LANG-629: Charset may not be threadsafe, because the HashSet is not synch. |
| o LANG-638: NumberUtils createNumber throws a StringIndexOutOfBoundsException |
| when argument containing "e" and "E" is passed in |
| o LANG-643: Javadoc StringUtils.left() claims to throw on negative len, but |
| doesn't |
| o LANG-645: FastDateFormat.format() outputs incorrect week of year because |
| locale isn't respected |
| o LANG-646: StringEscapeUtils.unescapeJava doesn't handle octal escapes and |
| Unicode with extra u |
| o LANG-656: Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect |
| o LANG-658: Some Entitys like Ö are not matched properly against its |
| ISO8859-1 representation |
| o LANG-659: EntityArrays typo: {"\u2122", "−"}, // minus sign, U+2212 |
| ISOtech |
| o LANG-66: StringEscaper.escapeXml() escapes characters > 0x7f. |
| o LANG-662: org.apache.commons.lang3.math.Fraction does not reduce |
| (Integer.MIN_VALUE, 2^k) |
| o LANG-663: org.apache.commons.lang3.math.Fraction does not always succeed in |
| multiplyBy and divideBy |
| o LANG-664: NumberUtils.isNumber(String) is not right when the String is |
| "1.1L" |
| o LANG-672: Doc bug in DateUtils#ceiling |
| o LANG-677: DateUtils.isSameLocalTime compares using 12 hour clock and not |
| 24 hour |
| o LANG-685: EqualsBuilder synchronizes on HashCodeBuilder. |
| o LANG-703: StringUtils.join throws NPE when toString returns null for one of |
| objects in collection |
| o LANG-710: StringIndexOutOfBoundsException when calling unescapeHtml4("") |
| o LANG-714: StringUtils doc/comment spelling fixes. |
| o LANG-715: CharSetUtils.squeeze() speedup. |
| o LANG-716: swapCase and *capitalize speedups. |
| |
| |
| Historical list of changes: http://commons.apache.org/lang/changes-report.html |
| |
| For complete information on Commons Lang, including instructions on how to |
| submit bug reports, patches, or suggestions for improvement, see the |
| Apache Commons Lang website: |
| |
| http://commons.apache.org/lang/ |
| |
| Have fun! |
| -Apache Commons Lang team |
| |