commons-lang3-3.1.jar

Apache Commons Lang Version 3.6 Release Notes INTRODUCTION: This document contains the release notes for the 3.6 version of Apache Commons Lang as well as a history all changes in the Commons Lang 3.x release line. Commons Lang is a set of utility functions and reusable components that should be of use in any Java environment. Commons Lang 3.6 at least requires Java 7.0. Note that this has changed from Commons Lang 3.5, which only required Java 1.6. For the advice on upgrading from 2.x to 3.x, see the following page: http://commons.apache.org/lang/article3_0.html HIGHLIGHTS ========== Some of the highlights in this release include: o The class org.apache.commons.lang3.concurrent.Memoizer is an implementation of the Memoizer pattern as shown in Goetz, Brian et al. (2006) - Java Concurrency in Practice, p. 108. o The class org.apache.commons.lang3.ArchUtils has been added. ArchUtils is a utility class for the "os.arch" system property. DEPRECATIONS ============ The Apache Commons Community has recently set up the Commons Text component as a home for algorithms working on strings. For this reason most of the string focused functionality in Commons Lang has been deprecated and moved to Commons Text. This includes: o All classes in the org.apache.commons.lang3.text and the org.apache.commons.lang3.text.translate packages o org.apache.commons.lang3.StringEscapeUtils o org.apache.commons.lang3.RandomStringUtils o The methods org.apache.commons.lang3.StringUtils.getJaroWinklerDistance and org.apache.commons.lang3.StringUtils.getLevenshteinDistance For more information see the Commons Text website: http://commons.apache.org/text The class org.apache.commons.lang3.CharEncoding has been deprecated in favor of java.nio.charset.StandardCharsets. The following methods have been deprecated in org.apache.commons.lang3.ArrayUtils in favor of the corresponding insert methods. Note that the handling for null inputs differs between add and insert. o add(boolean[], int, boolean) -> insert(int, boolean[], boolean...) o add(byte[], int, boolean) -> insert(int, byte[], byte...) o add(char[], int, boolean) -> insert(int, char[], char...) o add(double[], int, boolean) -> insert(int, double[], double...) o add(float[], int, boolean) -> insert(int, float[], float...) o add(int[], int, boolean) -> insert(int, int[], int...) o add(long[], int, boolean) -> insert(int, long[], long...) o add(short[], int, boolean) -> insert(int, short[], short...) o add(T[], int, boolean) -> insert(int, T[], T...) COMPATIBILITY WITH JAVA 9 ================== The MANIFEST.MF now contains an additional entry: Automatic-Module-Name: org.apache.commons.lang3 This should make it possible to use Commons Lang 3.6 as a module in the Java 9 module system. For more information see the corresponding issue and the referenced mailing list discussions: https://issues.apache.org/jira/browse/LANG-1338 The build problems present in the 3.5 release have been resolved. Building Commons Lang 3.6 should work out of the box with the latest Java 9 EA build. Please report any Java 9 related issues at: https://issues.apache.org/jira/browse/LANG NEW FEATURES ============ o LANG-1336: Add NUL Byte To CharUtils. Thanks to Beluga Behr. o LANG-1304: Add method in StringUtils to determine if string contains both mixed cased characters. Thanks to Andy Klimczak. o LANG-1325: Increase test coverage of ToStringBuilder class to 100%. Thanks to Arshad Basha. o LANG-1307: Add a method in StringUtils to extract only digits out of input string. Thanks to Arshad Basha. o LANG-1256: Add JMH maven dependencies. Thanks to C0rWin. o LANG-1167: Add null filter to ReflectionToStringBuilder. Thanks to Mark Dacek. o LANG-1299: Add method for converting string to an array of code points. o LANG-660: Add methods to insert arrays into arrays at an index. o LANG-1034: Add support for recursive comparison to EqualsBuilder#reflectionEquals. Thanks to Yathos UG. o LANG-1067: Add a reflection-based variant of DiffBuilder. o LANG-740: Implementation of a Memomizer. Thanks to James Sawle. o LANG-1258: Add ArrayUtils#toStringArray method. Thanks to IG, Grzegorz Rożniecki. o LANG-1160: StringUtils#abbreviate should support 'custom ellipses' parameter. o LANG-1293: Add StringUtils#isAllEmpty and #isAllBlank methods. Thanks to Pierre Templier, Martin Tarjanyi. o LANG-1313: Add ArchUtils - An utility class for the "os.arch" system property. Thanks to Tomschi. o LANG-1272: Add shuffle methods to ArrayUtils. o LANG-1317: Add MethodUtils#findAnnotation and extend MethodUtils#getMethodsWithAnnotation for non-public, super-class and interface methods. Thanks to Yasser Zamani. o LANG-1331: Add ImmutablePair.nullPair(). o LANG-1332: Add ImmutableTriple.nullTriple(). FIXED BUGS ========== o LANG-1337: Fix test failures in IBM JDK 8 for ToStringBuilderTest. o LANG-1319: MultilineRecursiveToStringStyle StackOverflowError when object is an array. o LANG-1320: LocaleUtils#toLocale does not support language followed by UN M.49 numeric-3 area code followed by variant. o LANG-1300: Clarify or improve behaviour of int-based indexOf methods in StringUtils. Thanks to Mark Dacek. o LANG-1286: RandomStringUtils random method can overflow and return characters outside of specified range. o LANG-1292: WordUtils.wrap throws StringIndexOutOfBoundsException. o LANG-1287: RandomStringUtils#random can enter infinite loop if end parameter is to small. Thanks to Ivan Morozov. o LANG-1285: NullPointerException in FastDateParser$TimeZoneStrategy. Thanks to Francesco Chicchiriccò. o LANG-1281: Javadoc of StringUtils.ordinalIndexOf is contradictory. Thanks to Andreas Lundblad. o LANG-1188: StringUtils#join(T...): warning: [unchecked] Possible heap pollution from parameterized vararg type T. o LANG-1144: Multiple calls of org.apache.commons.lang3.concurrent.LazyInitializer.initialize() are possible. Thanks to Waldemar Maier, Gary Gregory. o LANG-1276: StrBuilder#replaceAll ArrayIndexOutOfBoundsException. Thanks to Andy Klimczak. o LANG-1278: BooleanUtils javadoc issues. Thanks to Duke Yin. o LANG-1070: ArrayUtils#add confusing example in javadoc. Thanks to Paul Pogonyshev. o LANG-1271: StringUtils#isAnyEmpty and #isAnyBlank should return false for an empty array. Thanks to Pierre Templier. o LANG-1155: Add StringUtils#unwrap. Thanks to Saif Asif, Thiago Andrade. o LANG-1311: TypeUtils.toString() doesn't handle primitive and Object arrays correctly. Thanks to Aaron Digulla. o LANG-1312: LocaleUtils#toLocale does not support language followed by UN M.49 numeric-3 area code. o LANG-1265: Build failures when building with Java 9 EA. o LANG-1314: javadoc creation broken with Java 8. Thanks to Allon Murienik. o LANG-1310: MethodUtils.invokeMethod throws ArrayStoreException if using varargs arguments and smaller types than the method defines. Thanks to Don Jeba. CHANGES ======= o LANG-1338: Add Automatic-Module-Name MANIFEST entry for Java 9 compatibility. o LANG-1334: Deprecate CharEncoding in favour of java.nio.charset.StandardCharsets. o LANG-1110: Implement HashSetvBitSetTest using JMH. Thanks to Bruno P. Kinoshita. o LANG-1290: Increase test coverage of org.apache.commons.lang3.ArrayUtils. Thanks to Andrii Abramov. o LANG-1274: StrSubstitutor should state its thread safety. o LANG-1277: StringUtils#getLevenshteinDistance reduce memory consumption. Thanks to yufcuy. o LANG-1279: Update Java requirement from