| Apache Commons Lang |
| Version 3.12.0 |
| Release Notes |
| |
| INTRODUCTION: |
| |
| This document contains the release notes for the 3.12.0 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.9 and onwards now targets Java 8, making use of features that arrived with Java 8. |
| |
| For the advice on upgrading from 2.x to 3.x, see the following page: |
| |
| https://commons.apache.org/lang/article3_0.html |
| |
| Apache Commons Lang, a package of Java utility classes for the |
| classes that are in java.lang's hierarchy, or are considered to be so |
| standard as to justify existence in java.lang. |
| |
| New features and bug fixes. |
| |
| Changes in this version include: |
| |
| New features: |
| o Add BooleanUtils.booleanValues(). Thanks to Gary Gregory. |
| o Add BooleanUtils.primitiveValues(). Thanks to Gary Gregory. |
| o LANG-1535: Add StringUtils.containsAnyIgnoreCase(CharSequence, CharSequence...). Thanks to Gary Gregory, Isira Seneviratne. |
| o LANG-1359: Add StopWatch.getStopTime(). Thanks to Gary Gregory, Keegan Witt. |
| o More test coverage for CharSequenceUtils. #631. Thanks to Edgar Asatryan. |
| o Add fluent-style ArraySorter. Thanks to Gary Gregory. |
| o Add and use LocaleUtils.toLocale(Locale) to avoid NPEs. Thanks to Gary Gregory. |
| o Add FailableShortSupplier, handy for JDBC APIs. Thanks to Gary Gregory. |
| o Add JavaVersion.JAVA_17. Thanks to Gary Gregory. |
| o LANG-1636: Add missing boolean[] join method #686. Thanks to . |
| o Add StringUtils.substringBefore(String, int). Thanks to Gary Gregory. |
| o Add Range.INTEGER. Thanks to Gary Gregory. |
| o Add DurationUtils. Thanks to Gary Gregory. |
| o Introduce the use of @Nonnull, and @Nullable, and the Objects class as a helper tool. |
| o Add and use true and false String constants #714. Thanks to Arturo Bernal, Gary Gregory. |
| o Add and use ObjectUtils.requireNonEmpty() #716. Thanks to Arturo Bernal, Gary Gregory. |
| |
| Fixed Bugs: |
| o LANG-1592: Correct implementation of RandomUtils.nextLong(long, long) Thanks to Huang Pingcai, Alex Herbert. |
| o LANG-1600: Restore handling of collections for non-JSON ToStringStyle #610. Thanks to Michael F. |
| o ContextedException Javadoc add missing semicolon #581. Thanks to iamchao1129. |
| o LANG-1608: Resolve JUnit pioneer transitive dependencies using JUnit BOM. Thanks to Edgar Asatryan. |
| o NumberUtilsTest - incorrect types in min/max tests #634. Thanks to HubertWo, Gary Gregory. |
| o LANG-1579: Improve StringUtils.stripAccents conversion of remaining accents. Thanks to XenoAmess. |
| o LANG-1606: StringUtils.countMatches - clarify Javadoc. Thanks to Rustem Galiev. |
| o LANG-1591: Remove redundant argument from substring call. Thanks to bhawna94. |
| o LANG-1613: BigDecimal is created when you pass it the min and max values, #642. Thanks to Arturo Bernal, Gary Gregory. |
| o LANG-1541: ArrayUtils.contains() and indexOf() fail to handle Double.NaN #647. Thanks to Arturo Bernal, Gary Gregory. |
| o LANG-1615: ArrayUtils contains() and indexOf() fail to handle Float.NaN # #561. Thanks to Arturo Bernal, Gary Gregory. |
| o Fix potential NPE in TypeUtils.isAssignable(Type, ParameterizedType, Map, Type>). Thanks to Gary Gregory. |
| o LANG-1420: TypeUtils.isAssignable returns wrong result for GenericArrayType and ParameterizedType, #643. Thanks to Gordon Fraser, Rostislav Krasny, Arturo Bernal, Gary Gregory. |
| o LANG-1612: testGetAllFields and testGetFieldsWithAnnotation sometimes fail. Thanks to XinT, Gary Gregory. |
| o Fix Javadoc for SystemUtils.isJavaVersionAtMost() #638. Thanks to John R. D'Orazio. |
| o LANG-1610: Fix StringUtils.unwrap throws StringIndexOutOfBoundsException #636. Thanks to Tony Liang. |
| o Fix formatting of isAnyBlank() and isAnyEmpty(). #513. Thanks to Isira Seneviratne. |
| o LANG-1618: TypeUtils. containsTypeVariables does not support GenericArrayType #661. Thanks to Arturo Bernal. |
| o LANG-1622: Javadoc of some methods incorrectly refers to another method, #667, #668. #670. Thanks to Kanak Sony, anomen-s. |
| o LANG-1620: Refine StringUtils.lastIndexOfIgnoreCase #664. Thanks to Arturo Bernal. |
| o LANG-1619: Refine StringUtils.abbreviate #663. Thanks to Arturo Bernal. |
| o LANG-1584: Refine StringUtils.isNumericSpace #573. Thanks to Arturo Bernal. |
| o LANG-1580: Refine StringUtils.deleteWhitespace #569. Thanks to Arturo Bernal. |
| o LANG-1626: Correction in Javadoc of some methods. #673 Thanks to Kanak Sony. |
| o LANG-1628: Javadoc for RandomStringUtils.random() letters, numbers parameters is wrong. Thanks to Jarkko Rantavuori. |
| o Correct markup in Javadoc for unbalanced braces #679. Thanks to Felix Schumacher. |
| o LANG-1544: MethodUtils.invokeMethod NullPointerException in case of null in args list #680. Thanks to Peter Nagy, Michael Buck, Gary Gregory. |
| o LANG-1637: Fix 2 digit week year formatting #688. Thanks to Uri Gonen, Gary Gregory, Michael Osipov. |
| o Fix broken Javadoc links to commons-text #712. Thanks to Chris Smowton. |
| o Add and use ThreadUtils.sleep(Duration). Thanks to Gary Gregory. |
| o Add and use ThreadUtils.join(Thread, Duration). Thanks to Gary Gregory. |
| o Add ObjectUtils.wait(Duration). Thanks to Gary Gregory. |
| |
| Changes: |
| o LANG-1596: ArrayUtils.toPrimitive(Object) does not support boolean and other types #607. Thanks to Richard Eckart de Castilho. |
| o Enable Dependabot #587. Thanks to Gary Gregory. |
| o Bump junit-jupiter from 5.6.2 to 5.7.0. |
| o Bump spotbugs from 4.1.2 to 4.2.1, #627, #671, #708. Thanks to chtompki, Dependabot. |
| o Bump spotbugs-maven-plugin from 4.0.0 to 4.2.0, #593, #596, #609, #623, #632, #692. Thanks to Dependabot. |
| o Bump biz.aQute.bndlib from 5.1.1 to 5.3.0 #592, #628, #715. Thanks to Dependabot. |
| o Bump junit-pioneer from 0.6.0 to 1.1.0, #589, #597, #600, #624, #625, #662. Thanks to Dependabot. |
| o Bump checkstyle from 8.34 to 8.40, #594, #614, #637, #665, #706. Thanks to Dependabot. |
| o Bump actions/checkout from v2.3.1 to v2.3.4 #601, #639. Thanks to Dependabot. |
| o Bump actions/setup-java from v1.4.0 to v1.4.2 #612. Thanks to Dependabot. |
| o Update commons.jacoco.version 0.8.5 to 0.8.6 (Fixes Java 15 builds). Thanks to Gary Gregory. |
| o Update maven-surefire-plugin 2.22.2 -> 3.0.0-M5. Thanks to Gary Gregory. |
| o Bump maven-pmd-plugin from 3.13.0 to 3.14.0 #660. Thanks to Dependabot. |
| o Bump jmh.version from 1.21 to 1.27 #674. Thanks to Dependabot. |
| o Update commons.japicmp.version 0.14.3 -> 0.15.2. Thanks to Gary Gregory. |
| o Processor.java: check enum equality with == instead of .equals() method #690. Thanks to Ali K. Nouri. |
| o Bump junit-pioneer from 1.1.0 to 1.3.0 #702. Thanks to Dependabot. |
| o Bump maven-checkstyle-plugin from 3.1.1 to 3.1.2 #705. Thanks to Dependabot. |
| o Bump actions/cache from v2 to v2.1.4 #710. Thanks to Dependabot. |
| o Bump junit-bom from 5.7.0 to 5.7.1 #707. Thanks to Dependabot. |
| o Minor Improvements #701. Thanks to Arturo Bernal. |
| o Minor Improvement: Add final variable.try to make the code read-only #700. Thanks to Arturo Bernal. |
| o Minor Improvement: Remove redundant initializer #699. Thanks to Arturo Bernal. |
| o Use own validator ObjectUtils.anyNull to check null String input #718. Thanks to Arturo Bernal. |
| |
| |
| Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html |
| |
| For complete information on Apache Commons Lang, including instructions on how to submit bug reports, |
| patches, or suggestions for improvement, see the Apache Commons Lang website: |
| |
| https://commons.apache.org/proper/commons-lang/ |
| |
| Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi |
| |
| Have fun! |
| -Apache Commons Team |
| |
| ============================================================================= |
| |
| Apache Commons Lang |
| Version 3.11 |
| Release Notes |
| |
| |
| INTRODUCTION: |
| |
| This document contains the release notes for the 3.11 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.9 and onwards now targets Java 8, making use of features that arrived with Java 8. |
| |
| For the advice on upgrading from 2.x to 3.x, see the following page: |
| |
| https://commons.apache.org/lang/article3_0.html |
| |
| Apache Commons Lang, a package of Java utility classes for the |
| classes that are in java.lang's hierarchy, or are considered to be so |
| standard as to justify existence in java.lang. |
| |
| New features and bug fixes. |
| |
| Changes in this version include: |
| |
| New features: |
| o Add ArrayUtils.isSameLength() to compare more array types #430. Thanks to XenoAmess, Gary Gregory. |
| o Added the Locks class as a convenient possibility to deal with locked objects. |
| o LANG-1568: Add to Functions: FailableBooleanSupplier, FailableIntSupplier, FailableLongSupplier, FailableDoubleSupplier, and so on. |
| o LANG-1569: Add ArrayUtils.get(T[], index, T) to provide an out-of-bounds default value. |
| o LANG-1570: Add JavaVersion enum constants for Java 14 and 15. #553. Thanks to Edgar Asatryan. |
| o Add JavaVersion enum constants for Java 16. Thanks to Gary Gregory. |
| o LANG-1556: Use Java 8 lambdas and Map operations. Thanks to XenoAmess. |
| o LANG-1565: Change removeLastFieldSeparator to use endsWith #550. Thanks to XenoAmess. |
| o LANG-1557: Change a Pattern to a static final field, for not letting it compile each time the function invoked. #542. Thanks to XenoAmess, Gary Gregory. |
| o Add ImmutablePair factory methods left() and right(). |
| o Add ObjectUtils.toString(Object, Supplier<String>). |
| o Add org.apache.commons.lang3.StringUtils.substringAfter(String, int). |
| o Add org.apache.commons.lang3.StringUtils.substringAfterLast(String, int). |
| |
| Fixed Bugs: |
| o Fix Javadoc for StringUtils.appendIfMissingIgnoreCase() #507. Thanks to contextshuffling. |
| o LANG-1560: Refine Javadoc #545. Thanks to XenoAmess. |
| o LANG-1554: Fix typos #539. Thanks to XenoAmess. |
| o LANG-1555: Ignored exception `ignored`, should not be called so #540. Thanks to XenoAmess. |
| o LANG-1528: StringUtils.replaceEachRepeatedly gives IllegalStateException #505. Thanks to Edwin Delgado H. |
| o LANG-1543: [JSON string for maps] ToStringBuilder.reflectionToString doesnt render nested maps correctly. Thanks to Swaraj Pal, Wander Costa, Gary Gregory. |
| o Correct Javadocs of methods that use Validate.notNull() and replace some uses of Validate.isTrue() with Validate.notNull(). #525. Thanks to Isira Seneviratne. |
| o LANG-1539: Add allNull() and anyNull() methods to ObjectUtils. #522. Thanks to Isira Seneviratne. |
| |
| Changes: |
| o Refine test output for FastDateParserTest Thanks to Jin Xu. |
| o LANG-1549: CharSequenceUtils.lastIndexOf : remake it Thanks to Jin Xu. |
| o remove encoding and docEncoding and use inherited values from commons-parent Thanks to XenoAmess. |
| o Simplify null checks in Pair.hashCode() using Objects.hashCode(). #517. Thanks to Isira Seneviratne, Bruno P. Kinoshita. |
| o Simplify null checks in Triple.hashCode() using Objects.hashCode(). #516. Thanks to Isira Seneviratne, Bruno P. Kinoshita. |
| o Simplify some if statements in StringUtils. #521. Thanks to Isira Seneviratne, Bruno P. Kinoshita. |
| o LANG-1537: Simplify a null check in the private replaceEach() method of StringUtils. #514. Thanks to Isira Seneviratne, Bruno P. Kinoshita. |
| o LANG-1534: Replace some usages of the ternary operator with calls to Math.max() and Math.min() #512. Thanks to Isira Seneviratne, Bruno P. Kinoshita. |
| o (Javadoc) Fix return tag for throwableOf*() methods #518. Thanks to Arend v. Reinersdorff, Bruno P. Kinoshita. |
| o LANG-1545: CharSequenceUtils.regionMatches is wrong dealing with Georgian. Thanks to XenoAmess, Gary Gregory. |
| o LANG-1550: Optimize ArrayUtils::isArrayIndexValid method. #551. Thanks to Edgar Asatryan. |
| o LANG-1561: Use List.sort instead of Collection.sort #546. Thanks to XenoAmess. |
| o LANG-1563: Use StandardCharsets.UTF_8 #548. Thanks to XenoAmess. |
| o LANG-1564: Use Collections.singletonList insteadof Arrays.asList when there be only one element. #549. Thanks to XenoAmess. |
| o LANG-1553: Change array style from `int a[]` to `int[] a` #537. Thanks to XenoAmess. |
| o LANG-1552: Change from addAll to constructors for some List #536. Thanks to XenoAmess. |
| o LANG-1558: Simplify if as some conditions are covered by others #543. Thanks to XenoAmess. |
| o LANG-1567: Fixed Javadocs for setTestRecursive() #556. Thanks to Miguel Muñoz, Bruno P. Kinoshita, Gary Gregory. |
| o LANG-1542: ToStringBuilder.reflectionToString - Wrong JSON format when object has a List of Enum. Thanks to Tr?n Ng?c Khoa, Gary Gregory. |
| o Make org.apache.commons.lang3.CharSequenceUtils.toCharArray(CharSequence) public. |
| o org.apache.commons:commons-parent 50 -> 51. |
| o org.junit-pioneer:junit-pioneer 0.5.4 -> 0.6.0. |
| o org.junit.jupiter:junit-jupiter 5.6.0 -> 5.6.2. |
| o com.github.spotbugs:spotbugs 4.0.0 -> 4.0.6. |
| o com.puppycrawl.tools:checkstyle 8.29 -> 8.34. |
| o commons.surefire.version 3.0.0-M4 -> 3.0.0-M5.. |
| |
| |
| Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html |
| |
| For complete information on Apache Commons Lang, including instructions on how to submit bug reports, |
| patches, or suggestions for improvement, see the Apache Commons Lang website: |
| |
| https://commons.apache.org/proper/commons-lang/ |
| |
| Download page: https://commons.apache.org/proper/commons-lang/download_csv.cgi |
| |
| Have fun! |
| -Apache Commons Team |
| |
| ============================================================================= |
| |
| Apache Commons Lang |
| Version 3.10 |
| Release Notes |
| |
| |
| INTRODUCTION: |
| |
| This document contains the release notes for the 3.10 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.9 and onwards now targets Java 8, making use of features that arrived with Java 8. |
| |
| For the advice on upgrading from 2.x to 3.x, see the following page: |
| |
| https://commons.apache.org/lang/article3_0.html |
| |
| Apache Commons Lang, a package of Java utility classes for the |
| classes that are in java.lang's hierarchy, or are considered to be so |
| standard as to justify existence in java.lang. |
| |
| New features and bug fixes. Requires Java 8, supports Java 9, 10, 11. |
| |
| Changes in this version include: |
| |
| New features: |
| o LANG-1457: Add ExceptionUtils.throwableOfType(Throwable, Class) and friends. |
| o LANG-1458: Add EMPTY_ARRAY constants to classes in org.apache.commons.lang3.tuple. |
| o LANG-1461: Add null-safe StringUtils APIs to wrap String#getBytes([Charset|String]). |
| o LANG-1467: Add zero arg constructor for org.apache.commons.lang3.NotImplementedException. |
| o LANG-1470: Add ArrayUtils.addFirst() methods. |
| o LANG-1479: Add Range.fit(T) to fit a value into a range. |
| o LANG-1477: Added Functions.as*, and tests thereof, as suggested by Peter Verhas |
| o LANG-1485: Add getters for lhs and rhs objects in DiffResult #451. Thanks to nicolasbd. |
| o LANG-1486: Generify builder classes Diffable, DiffBuilder, and DiffResult #452. Thanks to Gary Gregory. |
| o LANG-1487: Add ClassLoaderUtils with toString() implementations #453. Thanks to Gary Gregory. |
| o LANG-1489: Add null-safe APIs as StringUtils.toRootLowerCase(String) and StringUtils.toRootUpperCase(String) #456. Thanks to Gary Gregory. |
| o LANG-1494: Add org.apache.commons.lang3.time.Calendars. Thanks to Gary Gregory. |
| o LANG-1495: Add EnumUtils getEnum() methods with default values #475. Thanks to Cheong Voon Leong. |
| o LANG-1177: Added indexesOf methods and simplified removeAllOccurences #471. Thanks to Liel Fridman. |
| o LANG-1498: Add support of lambda value evaluation for defaulting methods #416. Thanks to Lysergid, Gary Gregory. |
| o LANG-1503: Add factory methods to Pair classes with Map.Entry input. #454. Thanks to XenoAmess, Gary Gregory. |
| o LANG-1505: Add StopWatch convenience APIs to format times and create a simple instance. Thanks to Gary Gregory. |
| o LANG-1506: Allow a StopWatch to carry an optional message. Thanks to Gary Gregory. |
| o LANG-1507: Add ComparableUtils #398. Thanks to Sam Kruglov, Mark Dacek, Marc Magon, Pascal Schumacher, Rob Tompkins, Bruno P. Kinoshita, Amey Jadiye, Gary Gregory. |
| o LANG-1508: Add org.apache.commons.lang3.SystemUtils.getUserName(). Thanks to Gary Gregory. |
| o LANG-1509: Add ObjectToStringComparator. #483. Thanks to Gary Gregory. |
| o LANG-1510: Add org.apache.commons.lang3.arch.Processor.Arch.getLabel(). Thanks to Gary Gregory. |
| o LANG-1512: Add IS_JAVA_14 and IS_JAVA_15 to org.apache.commons.lang3.SystemUtils. Thanks to Gary Gregory. |
| o LANG-1513: ObjectUtils: Get first non-null supplier value. Thanks to Bernhard Bonigl, Gary Gregory. |
| o Added the Streams class, and Functions.stream() as an accessor thereof. |
| |
| Fixed Bugs: |
| o LANG-1514: Make test more stable by wrapping assertions in hashset. Thanks to contextshuffling. |
| o LANG-1450: Generate Javadoc jar on build. |
| o LANG-1460: Trivial: year of release for 3.9 says 2018, should be 2019 Thanks to Larry West. |
| o LANG-1476: Use synchronize on a set created with Collections.synchronizedSet before iterating Thanks to emopers. |
| o LANG-1475: StringUtils.unwrap incorrect throw StringIndexOutOfBoundsException. Thanks to stzx. |
| o LANG-1406: StringIndexOutOfBoundsException in StringUtils.replaceIgnoreCase #423. Thanks to geratorres. |
| o LANG-1453: StringUtils.removeIgnoreCase("?a", "a") throws IndexOutOfBoundsException #423. Thanks to geratorres. |
| o LANG-1426: Corrected usage examples in Javadocs #458. Thanks to Brower, Mikko Maunu, Suraj Gautam. |
| o LANG-1463: StringUtils abbreviate returns String of length greater than maxWidth #477. Thanks to bbeckercscc, Gary Gregory. |
| o LANG-1500: Test may fail due to a different order of fields returned by reflection api #480. Thanks to contextshuffling. |
| o LANG-1501: Sort fields in ReflectionToStringBuilder for deterministic order #481. Thanks to contextshuffling. |
| o LANG-1433: MethodUtils will throw a NPE if invokeMethod() is called for a var-args method #407. Thanks to Christian Franzen. |
| o LANG-1518: MethodUtils.getAnnotation() with searchSupers = true does not work if super is generic #494. Thanks to Michele Preti, Bruno P. Kinoshita, Gary Gregory. |
| |
| Changes: |
| o LANG-1437: Remove redundant if statements in join methods #411. Thanks to Andrei Troie. |
| o commons.japicmp.version 0.13.1 -> 0.14.1. |
| o junit-jupiter 5.5.0 -> 5.5.1. |
| o junit-jupiter 5.5.1 -> 5.5.2. |
| o Improve Javadoc based on the discussion of the GitHub PR #459. Thanks to Jonathan Leitschuh, Bruno P. Kinoshita, Rob Tompkins, Gary Gregory. |
| o maven-checkstyle-plugin 3.0.0 -> 3.1.0. |
| o LANG-696: Update documentation related to the issue LANG-696 #449. Thanks to Peter Verhas. |
| o AnnotationUtils little cleanup #467. Thanks to Peter Verhas. |
| o Update test dependency: org.easymock:easymock 4.0.2 -> 4.1. Thanks to Gary Gregory. |
| o Update test dependency: org.hamcrest:hamcrest 2.1 -> 2.2. Thanks to Gary Gregory. |
| o Update test dependency: org.junit-pioneer:junit-pioneer 0.3.0 -> 0.4.2. Thanks to Gary Gregory. |
| o Update build dependency: com.puppycrawl.tools:checkstyle 8.18 -> 8.27. Thanks to Gary Gregory. |
| o Update POM parent: org.apache.commons:commons-parent 48 -> 50. Thanks to Gary Gregory. |
| o BooleanUtils Javadoc #469. Thanks to Peter Verhas. |
| o Functions Javadoc #466. Thanks to Peter Verhas. |
| o org.easymock:easymock 4.1 -> 4.2. Thanks to Gary Gregory. |
| o org.junit-pioneer:junit-pioneer 0.4.2 -> 0.5.4. Thanks to Gary Gregory. |
| o org.junit.jupiter:junit-jupiter 5.5.2 -> 5.6.0. Thanks to Gary Gregory. |
| o Use Javadoc {@code} instead of pre tags. #490. Thanks to Peter Verhas. |
| o ExceptionUtilsTest to 100% #486. Thanks to Peter Verhas. |
| o Reuse own code in Functions.java #493. Thanks to Peter Verhas. |
| o LANG-1523: Avoid unnecessary allocation in StringUtils.wrapIfMissing. #496. Thanks to Edgar Asatryan, Bruno P. Kinoshita, Gary Gregory. |
| o LANG-1525: Internally use Validate.notNull(foo, ...) instead of Validate.isTrue(foo != null, ...). Thanks to Edgar Asatryan, Bruno P. Kinoshita, Gary Gregory. |
| o LANG-1526: Add 1 and 0 in toBooleanObject(final String str) #502. Thanks to Dominik Schramm. |
| o LANG-1527: Remove an redundant argument check in NumberUtils #504. Thanks to Pengyu Nie. |
| o LANG-1529: Deprecate org.apache.commons.lang3.ArrayUtils.removeAllOccurences(*) for org.apache.commons.lang3.ArrayUtils.removeAllOccurrences(*). Thanks to Gary Gregory, BillCindy, Bruno P. Kinoshita. |
| |
| |
| Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html |
| |
| For complete information on Apache Commons Lang, including instructions on how to submit bug reports, |
| patches, or suggestions for improvement, see the Apache Commons Lang website: |
| |
| https://commons.apache.org/proper/commons-lang/ |
| |
| Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi |
| |
| ============================================================================= |
| |
| Apache Commons Lang |
| Version 3.9 |
| Release Notes |
| |
| |
| INTRODUCTION: |
| |
| This document contains the release notes for the 3.9 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.9 and onwards now targets Java 8, making use of features that arrived with Java 8. |
| |
| For the advice on upgrading from 2.x to 3.x, see the following page: |
| |
| https://commons.apache.org/lang/article3_0.html |
| |
| Apache Commons Lang, a package of Java utility classes for the |
| classes that are in java.lang's hierarchy, or are considered to be so |
| standard as to justify existence in java.lang. |
| |
| New features and bug fixes. Requires Java 8, supports Java 9, 10, 11 |
| |
| Changes in this version include: |
| |
| New features: |
| o LANG-1442: Javadoc pointing to Commons RNG. |
| o Adding the Functions class. |
| o LANG-1411: Add isEmpty method to ObjectUtils Thanks to Alexander Tsvetkov. |
| o LANG-1422: Add null-safe StringUtils.valueOf(char[]) to delegate to String.valueOf(char[]) |
| o LANG-1427: Add API org.apache.commons.lang3.SystemUtils.isJavaVersionAtMost(JavaVersion) |
| |
| |
| Changes: |
| o LANG-1416: Add more SystemUtils.IS_JAVA_XX variants. |
| o LANG-1416: Update to JUnit 5 |
| o LANG-1417: Add @FunctionalInterface to ThreadPredicate and ThreadGroupPredicate |
| o LANG-1415: Update Java Language requirement to 1.8 |
| o LANG-1436: Consolidate the StringUtils equals and equalsIgnoreCase Javadoc and implementation |
| o (doc) Fix javadoc for 'startIndex' parameter of StringUtils.join() methods. GitHub PR #412. Thanks to Andrei Troie aft90. |
| |
| |
| Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html |
| |
| For complete information on Apache Commons Lang, including instructions on how to submit bug reports, |
| patches, or suggestions for improvement, see the Apache Commons Lang website: |
| |
| https://commons.apache.org/proper/commons-lang/ |
| |
| ============================================================================= |
| |
| Apache Commons Lang |
| Version 3.8.1 |
| Release Notes |
| |
| |
| INTRODUCTION: |
| |
| This document contains the release notes for the 3.8.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 and onwards now targets Java 7.0, making use of features that arrived with Java 7.0. |
| |
| For the advice on upgrading from 2.x to 3.x, see the following page: |
| |
| https://commons.apache.org/lang/article3_0.html |
| |
| Apache Commons Lang, a package of Java utility classes for the |
| classes that are in java.lang's hierarchy, or are considered to be so |
| standard as to justify existence in java.lang. |
| |
| This release is a bugfix for Restoring Bundle-SymbolicName in the MANIFEST.mf file. |
| |
| Changes in this version include: |
| |
| |
| Fixed Bugs: |
| o LANG-1419: Restore BundleSymbolicName for OSGi |
| |
| ============================================================================= |
| |
| Apache Commons Lang |
| Version 3.8 |
| Release Notes |
| |
| |
| INTRODUCTION: |
| |
| This document contains the release notes for the 3.8 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 and onwards now targets Java 7.0, making use of features that arrived with Java 7.0. |
| |
| For the advice on upgrading from 2.x to 3.x, see the following page: |
| |
| https://commons.apache.org/lang/article3_0.html |
| |
| Apache Commons Lang, a package of Java utility classes for the |
| classes that are in java.lang's hierarchy, or are considered to be so |
| standard as to justify existence in java.lang. |
| |
| New features and bug fixes. Requires Java 7, supports Java 8, 9, 10. |
| |
| Changes in this version include: |
| |
| New features: |
| o LANG-1352: EnumUtils.getEnumIgnoreCase and isValidEnumIgnoreCase methods added Thanks to Ruslan Sibgatullin. |
| o LANG-1372: Add ToStringSummary annotation Thanks to SĂ©rgio Ozaki. |
| o LANG-1356: Add bypass option for classes to recursive and reflective EqualsBuilder Thanks to Yathos UG. |
| o LANG-1391: Improve Javadoc for StringUtils.isAnyEmpty(null) Thanks to Sauro Matulli, Oleg Chubaryov. |
| o LANG-1393: Add API SystemUtils.String getEnvironmentVariable(final String name, final String defaultValue) Thanks to Gary Gregory. |
| o LANG-1394: org.apache.commons.lang3.SystemUtils should not write to System.err. Thanks to Sebb, Gary Gregory. |
| o LANG-1238: Add RegexUtils class instead of overloading methods in StringUtils that take a regex to take precompiled Pattern. Thanks to Christopher Cordeiro, Gary Gregory, Bruno P. Kinoshita, Oleg Chubaryov. |
| o LANG-1390: StringUtils.join() with support for List<?> with configurable start/end indices. Thanks to Jochen Schalanda. |
| o LANG-1392: Methods for getting first non empty or non blank value Thanks to Jeff Nelson. |
| o LANG-1408: Rounding utilities for converting to BigDecimal |
| |
| Fixed Bugs: |
| o LANG-1380: FastDateParser too strict on abbreviated short month symbols Thanks to Markus Jelsma. |
| o LANG-1396: JsonToStringStyle does not escape string names |
| o LANG-1395: JsonToStringStyle does not escape double quote in a string value Thanks to Jim Gan. |
| o LANG-1384: New Java version ("11") must be handled Thanks to Ian Young. |
| o LANG-1364: ExceptionUtils#getRootCause(Throwable t) should return t if no lower level cause exists Thanks to Zheng Xie. |
| o LANG-1060: NumberUtils.isNumber assumes number starting with Zero Thanks to Piotr Kosmala. |
| o LANG-1375: defaultString(final String str) in StringUtils to reuse defaultString(final String str, final String defaultStr) Thanks to Jerry Zhao. |
| o LANG-1374: Parsing Json Array failed Thanks to Jaswanth Bala. |
| o LANG-1371: Fix TypeUtils#parameterize to work correctly with narrower-typed array Thanks to Dmitry Ovchinnikov. |
| o LANG-1370: Fix EventCountCircuitBreaker increment batch Thanks to Andre Dieb. |
| o LANG-1385: NumberUtils.createNumber() throws StringIndexOutOfBoundsException instead of NumberFormatException Thanks to Rohan Padhye. |
| o LANG-1397: WordUtils.wrap throws StringIndexOutOfBoundsException when wrapLength is Integer.MAX_VALUE. Thanks to Takanobu Asanuma. |
| o LANG-1401: Typo in JavaDoc for lastIndexOf Thanks to Roman Golyshev, Alex Mamedov. |
| |
| Changes: |
| o LANG-1367: ObjectUtils.identityToString(Object) and friends should allocate builders and buffers with a size Thanks to Gary Gregory. |
| o LANG-1405: Remove checks for java versions below the minimum supported one Thanks to Lars Grefer. |
| o LANG-1402: Null/index safe get methods for ArrayUtils Thanks to Mark Dacek. |
| |
| ============================================================================= |
| |
| Apache Commons Lang |
| Version 3.7 |
| Release Notes |
| |
| |
| INTRODUCTION: |
| |
| This document contains the release notes for the 3.7 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 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 advice on upgrading from 2.x to 3.x, see the following page: |
| |
| https://commons.apache.org/lang/article3_0.html |
| |
| Apache Commons Lang, a package of Java utility classes for the |
| classes that are in java.lang's hierarchy, or are considered to be so |
| standard as to justify existence in java.lang. |
| |
| New features and bug fixes. Requires Java 7, supports Java 8, 9, 10. |
| |
| Changes in this version include: |
| |
| New features: |
| o LANG-1355: TimeZone.getTimeZone() in FastDateParser causes resource contention (PR #296.) Thanks to Chas Honton. |
| o LANG-1360: Add methods to ObjectUtils to get various forms of class names in a null-safe manner Thanks to Gary Gregory. |
| |
| Fixed Bugs: |
| o LANG-1362: Fix tests DateUtilsTest for Java 9 with en_GB locale Thanks to Stephen Colebourne. |
| o LANG-1365: Fix NullPointerException in isJavaVersionAtLeast on Java 10, add SystemUtils.IS_JAVA_10, add JavaVersion.JAVA_10 Thanks to Gary Gregory. |
| o LANG-1348: StackOverflowError on TypeUtils.toString(...) for a generic return type of Enum.valueOf Thanks to mbusso. |
| o LANG-1350: ConstructorUtils.invokeConstructor(Class, Object...) regression Thanks to Brett Kail. |
| o LANG-1349: EqualsBuilder#isRegistered: swappedPair construction bug Thanks to Naman Nigam. |
| o LANG-1357: org.apache.commons.lang3.time.FastDateParser should use toUpperCase(Locale) Thanks to BruceKuiLiu. |
| |
| Changes: |
| o LANG-1358: Improve StringUtils#replace throughput Thanks to Stephane Landelle. |
| o LANG-1346: Remove deprecation from RandomStringUtils |
| o LANG-1361: ExceptionUtils.getThrowableList() is using deprecated ExceptionUtils.getCause() Thanks to Ana. |
| |
| |
| ============================================================================= |
| |
| 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: |
| |
| https://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: |
| |
| https://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 Memoizer. 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 behavior 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 Java 6 to 7. |
| o LANG-1143: StringUtils should use toXxxxCase(int) rather than |
| toXxxxCase(char). Thanks to sebb. |
| o LANG-1297: Add SystemUtils.getHostName() API. |
| o LANG-1301: Moving apache-rat-plugin configuration into pluginManagement. |
| Thanks to Karl Heinz Marbaise. |
| o LANG-1316: Deprecate classes/methods moved to commons-text. |
| |
| ============================================================================= |
| |
| Release Notes for version 3.5 |
| |
| |
| HIGHLIGHTS |
| ========== |
| |
| Some of the highlights in this release include: |
| |
| o Added Java 9 detection to org.apache.commons.lang3.SystemUtils. |
| o Support for shifting and swapping elements in |
| org.apache.commons.lang3.ArrayUtils. |
| o New methods for generating random strings from different character classes |
| including alphabetic, alpha-numeric and ASCII added to |
| org.apache.commons.lang3.RandomStringUtils. |
| o Numerous extensions to org.apache.commons.lang3.StringUtils including |
| null safe compare variants, more remove and replace variants, rotation and |
| truncation. |
| o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with |
| instances of java.lang.Thread and java.lang.ThreadGroup. |
| o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to |
| mark fields which should be ignored by the reflective builders in the |
| org.apache.commons.lang3.builder package. |
| o Support for various modify and retrieve value use cases added to the classes |
| in org.apache.commons.lang3.mutable. |
| |
| COMPATIBILITY |
| ============= |
| |
| Apache Commons Lang 3.5 is binary compatible with the 3.4 release. Users |
| should not experience any problems when upgrading from 3.4 to 3.5. |
| |
| There has been an addition to the org.apache.commons.lang3.time.DatePrinter |
| interface: |
| |
| o Added method 'public boolean parse(java.lang.String, java.text.ParsePosition, |
| java.util.Calendar)' |
| o Added method 'public java.lang.Appendable format(long, java.lang.Appendable)' |
| o Added method 'public java.lang.Appendable format(java.util.Date, |
| java.lang.Appendable)' |
| o Added method 'public java.lang.Appendable format(java.util.Calendar, |
| java.lang.Appendable)' |
| |
| For this reason 3.5 is not strictly source compatible to 3.4. Since the |
| DatePrinter interface is not meant to be implemented by clients, this |
| change it not considered to cause any problems. |
| |
| JAVA 9 SUPPORT |
| ============== |
| |
| Java 9 introduces a new version-string scheme. Details of this new scheme are |
| documented in JEP-223 (https://openjdk.org/jeps/223). In order to support |
| JEP-223 two classes had to be changed: |
| |
| o org.apache.commons.lang3.JavaVersion |
| deprecated enum constant JAVA_1_9 |
| introduced enum constant JAVA_9 |
| |
| o org.apache.commons.lang3.SystemUtils |
| deprecated constant IS_JAVA_1_9 |
| introduced constant IS_JAVA_9 |
| |
| For more information see LANG-1197 |
| (https://issues.apache.org/jira/browse/LANG-1197). All other APIs are expected |
| to work with Java 9. |
| |
| BUILDING ON JAVA 9 |
| ================== |
| |
| Java 8 introduced the Unicode Consortium's Common Locale Data Repository as |
| alternative source for locale data. Java 9 will use the CLDR provider as |
| default provider for locale data (see https://openjdk.org/jeps/252). This |
| causes an number of locale-sensitive test in Commons Lang to fail. In order |
| to build Commons Lang 3.5 on Java 9, the locale provider has to be set to |
| 'JRE': |
| |
| mvn -Djava.locale.providers=JRE clean install |
| |
| We are currently investigating ways to support building on Java 9 without |
| further configuration. For more information see: |
| https://issues.apache.org/jira/browse/LANG-1265 |
| |
| |
| NEW FEATURES |
| ============== |
| |
| o LANG-1275: Added a tryAcquire() method to TimedSemaphore. |
| o LANG-1255: Add DateUtils.toCalendar(Date, TimeZone). Thanks to Kaiyuan Wang. |
| o LANG-1023: Add WordUtils.wrap overload with customizable breakable character. |
| Thanks to Marko Bekhta. |
| o LANG-787: Add method removeIgnoreCase(String, String) to StringUtils. Thanks |
| to Gokul Nanthakumar C. |
| o LANG-1224: Extend RandomStringUtils with methods that generate strings |
| between a min and max length. Thanks to Caleb Cushing. |
| o LANG-1257: Add APIs StringUtils.wrapIfMissing(String, char|String). Thanks to |
| Gary Gregory. |
| o LANG-1253: Add RandomUtils#nextBoolean() method. Thanks to adilek. |
| o LANG-1085: Add a circuit breaker implementation. Thanks to Oliver Heger and |
| Bruno P. Kinoshita. |
| o LANG-1013: Add StringUtils.truncate(). Thanks to Thiago Andrade. |
| o LANG-1195: Enhance MethodUtils to allow invocation of private methods. Thanks |
| to Derek C. Ashmore. |
| o LANG-1189: Add getAndIncrement/getAndDecrement/getAndAdd/incrementAndGet/ |
| decrementAndGet/addAndGet in Mutable* classes. Thanks to |
| Haiyang Li and Matthew Bartenschlag. |
| o LANG-1225: Add RandomStringUtils#randomGraph and #randomPrint which match |
| corresponding regular expression class. Thanks to Caleb Cushing. |
| o LANG-1223: Add StopWatch#getTime(TimeUnit). Thanks to Nick Manley. |
| o LANG-781: Add methods to ObjectUtils class to check for null elements in the |
| array. Thanks to Krzysztof Wolny. |
| o LANG-1228: Prefer Throwable.getCause() in ExceptionUtils.getCause(). |
| Thanks to Brad Hess. |
| o LANG-1233: DiffBuilder add method to allow appending from a DiffResult. |
| Thanks to Nick Manley. |
| o LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property. |
| Thanks to Pascal Schumacher. |
| o LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and |
| MethodUtils. Thanks to Jim Lloyd and Joe Ferner. |
| o LANG-1134: Add methods to check numbers against NaN and infinite to |
| Validate. Thanks to Alan Smithee. |
| o LANG-1220: Add tests for missed branches in DateUtils. |
| Thanks to Casey Scarborough. |
| o LANG-1146: z/OS identification in SystemUtils. |
| Thanks to Gabor Liptak. |
| o LANG-1192: FastDateFormat support of the week-year component (uppercase 'Y'). |
| Thanks to Dominik Stadler. |
| o LANG-1169: Add StringUtils methods to compare a string to multiple strings. |
| Thanks to Rafal Glowinski, Robert Parr and Arman Sharif. |
| o LANG-1185: Add remove by regular expression methods in StringUtils. |
| o LANG-1139: Add replace by regular expression methods in StringUtils. |
| o LANG-1171: Add compare methods in StringUtils. |
| o LANG-1174: Add sugar to RandomUtils. Thanks to Punkratz312. |
| o LANG-1154: FastDateFormat APIs that use a StringBuilder. Thanks to |
| Gary Gregory. |
| o LANG-1149: Ability to throw checked exceptions without declaring them. Thanks |
| to Gregory Zak. |
| o LANG-1153: Implement ParsePosition api for FastDateParser. |
| o LANG-1137: Add check for duplicate event listener in EventListenerSupport. |
| Thanks to Matthew Aguirre. |
| o LANG-1135: Add method containsAllWords to WordUtils. Thanks to |
| Eduardo Martins. |
| o LANG-1132: ReflectionToStringBuilder doesn't throw IllegalArgumentException |
| when the constructor's object param is null. Thanks to Jack Tan. |
| o LANG-701: StringUtils join with var args. Thanks to James Sawle. |
| o LANG-1105: Add ThreadUtils - A utility class which provides helper methods |
| related to java.lang.Thread Issue: LANG-1105. Thanks to |
| Hendrik Saly. |
| o LANG-1031: Add annotations to exclude fields from ReflectionEqualsBuilder, |
| ReflectionToStringBuilder and ReflectionHashCodeBuilder. Thanks |
| to Felipe Adorno. |
| o LANG-1127: Use JUnit rules to set and reset the default Locale and TimeZone. |
| o LANG-1119: Add rotate(string, int) method to StringUtils. Thanks to |
| Loic Guibert. |
| o LANG-1099: Add swap and shift operations for arrays to ArrayUtils. Thanks to |
| Adrian Ber. |
| o LANG-1050: Change nullToEmpty methods to generics. Thanks to James Sawle. |
| o LANG-1074: Add a method to ArrayUtils for removing all occurrences of a given |
| element Issue: LANG-1074. Thanks to Haiyang Li. |
| |
| FIXED BUGS |
| ============ |
| |
| o LANG-1261: ArrayUtils.contains returns false for instances of subtypes. |
| o LANG-1252: Rename NumberUtils.isNumber, isCreatable to better reflect |
| createNumber. Also, accommodated for "+" symbol as prefix in |
| isCreatable and isNumber. Thanks to Rob Tompkins. |
| o LANG-1230: Remove unnecessary synchronization from registry lookup in |
| EqualsBuilder and HashCodeBuilder. Thanks to Philippe Marschall. |
| o LANG-1214: Handle "void" in ClassUtils.getClass(). Thanks to Henry Tung. |
| o LANG-1250: SerializationUtils#deserialize has unnecessary code and a comment |
| for that. Thanks to Glease Wang. |
| o LANG-1190: TypeUtils.isAssignable throws NullPointerException when fromType |
| has type variables and toType generic superclass specifies type |
| variable. Thanks to Pascal Schumacher. |
| o LANG-1226: StringUtils#normalizeSpace does not trim the string anymore. |
| Thanks to Pascal Schumacher. |
| o LANG-1251: SerializationUtils.ClassLoaderAwareObjectInputStream should use |
| static initializer to initialize primitiveTypes map. Thanks to |
| Takuya Ueshin. |
| o LANG-1248: FastDatePrinter Memory allocation regression. Thanks to |
| Benoit Wiart. |
| o LANG-1018: Fix precision loss on NumberUtils.createNumber(String). Thanks to |
| Nick Manley. |
| o LANG-1199: Fix implementation of StringUtils.getJaroWinklerDistance(). Thanks |
| to M. Steiger. |
| o LANG-1244: Fix dead links in StringUtils.getLevenshteinDistance() javadoc. |
| Thanks to jjbankert. |
| o LANG-1242: "\u2284":"?" mapping missing from |
| EntityArrays#HTML40_EXTENDED_ESCAPE. Thanks to Neal Stewart. |
| o LANG-901: StringUtils#startsWithAny/endsWithAny is case sensitive - |
| documented as case insensitive. Thanks to Matthew Bartenschlag. |
| o LANG-1232: DiffBuilder: Add null check on fieldName when appending Object or |
| Object[]. Thanks to Nick Manley. |
| o LANG-1178: ArrayUtils.removeAll(Object array, int... indices) should do the |
| clone, not its callers. Thanks to Henri Yandell. |
| o LANG-1120: StringUtils.stripAccents should remove accents from "?" and "?". |
| Thanks to kaching88. |
| o LANG-1205: NumberUtils.createNumber() behaves inconsistently with |
| NumberUtils.isNumber(). Thanks to pbrose. |
| o LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase |
| method. Thanks to Adam J. |
| o LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier. |
| o LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to |
| Markus Jelsma. |
| o LANG-1219: FastDateFormat doesn't respect summer daylight in some localized |
| strings. Thanks to Jarek. |
| o LANG-1175: Remove Ant-based build. |
| o LANG-1194: Limit max heap memory for consistent Travis CI build. |
| o LANG-1186: Fix NullPointerException in FastDateParser$TimeZoneStrategy. |
| Thanks to NickManley. |
| o LANG-1193: ordinalIndexOf("abc", "ab", 1) gives incorrect answer of -1 |
| (correct answer should be 0); revert fix for LANG-1077. Thanks to |
| Qin Li. |
| o LANG-1002: Several predefined ISO FastDateFormats in DateFormatUtils are |
| incorrect. Thanks to Michael Osipov. |
| o LANG-1152: StringIndexOutOfBoundsException or field over-write for large year |
| fields in FastDateParser. Thanks to Pas Filip. |
| o LANG-1141: StrLookup.systemPropertiesLookup() no longer reacts on changes on |
| system properties. |
| o LANG-1147: EnumUtils *BitVector issue with more than 32 values Enum. Thanks |
| to Loic Guibert. |
| o LANG-1059: Capitalize javadoc is incorrect. Thanks to Colin Casey. |
| o LANG-1122: Inconsistent behavior of swap for malformed inputs. Thanks to |
| Adrian Ber. |
| o LANG-1130: Fix critical issues reported by SonarQube. |
| o LANG-1131: StrBuilder.equals(StrBuilder) doesn't check for null inputs. |
| o LANG-1128: JsonToStringStyle doesn't handle chars and objects correctly. |
| Thanks to Jack Tan. |
| o LANG-1126: DateFormatUtilsTest.testSMTP depends on the default Locale. |
| o LANG-1123: Unit test FastDatePrinterTimeZonesTest needs a timezone set. |
| Thanks to Christian P. Momon. |
| o LANG-916: DateFormatUtils.format does not correctly change Calendar |
| TimeZone in certain situations. Thanks to Christian P. Momon. |
| o LANG-1116: DateUtilsTest.testLang530 fails for some timezones. Thanks to |
| Aaron Sheldon. |
| o LANG-1114: TypeUtils.ParameterizedType#equals doesn't work with wildcard |
| types. Thanks to Andy Coates. |
| o LANG-1118: StringUtils.repeat('z', -1) throws NegativeArraySizeException. |
| Thanks to Loic Guibert. |
| o LANG-1111: Fix FindBugs warnings in DurationFormatUtils. |
| o LANG-1162: StringUtils#equals fails with Index OOBE on non-Strings with |
| identical leading prefix.. |
| o LANG-1163: There are no tests for CharSequenceUtils.regionMatches. |
| o LANG-1200: Fix Javadoc of StringUtils.ordinalIndexOf. Thanks to BarkZhang. |
| o LANG-1191: Incorrect Javadoc |
| StringUtils.containsAny(CharSequence, CharSequence...). Thanks to |
| qed, Brent Worden and Gary Gregory. |
| |
| CHANGES |
| ========= |
| o LANG-1197: Prepare Java 9 detection. |
| o LANG-1262: CompareToBuilder.append(Object, Object, Comparator) method is too |
| big to be inlined. Thanks to Ruslan Cheremin. |
| o LANG-1259: Javadoc for ArrayUtils.isNotEmpty() is slightly misleading. Thanks |
| to Dominik Stadler. |
| o LANG-1247: FastDatePrinter generates extra Date objects. Thanks to |
| Benoit Wiart. |
| o LANG-1229: HashCodeBuilder.append(Object,Object) is too big to be inlined, |
| which prevents whole builder to be scalarized. Thanks to |
| Ruslan Cheremin. |
| o LANG-1243: Simplify ArrayUtils removeElements by using new decrementAndGet() |
| method. |
| o LANG-1240: Optimize BitField constructor implementation. Thanks to zhanhb. |
| o LANG-1206: Improve CharSetUtils.squeeze() performance. Thanks to |
| Mohammed Alfallaj. |
| o LANG-1176: Improve ArrayUtils removeElements time complexity to O(n). Thanks |
| to Jeffery Yuan. |
| o LANG-1234: getLevenshteinDistance with a threshold: optimize implementation |
| if the strings lengths differ more than the threshold. Thanks to |
| Jonatan Jönsson. |
| o LANG-1151: Performance improvements for NumberUtils.isParsable. Thanks to |
| Juan Pablo Santos RodrĂguez. |
| o LANG-1218: EqualsBuilder.append(Object,Object) is too big to be inlined, |
| which prevents whole builder to be scalarized. Thanks to |
| Ruslan Cheremin. |
| o LANG-1210: StringUtils#startsWithAny has error in Javadoc. Thanks to |
| Matthias Niehoff. |
| o LANG-1208: StrSubstitutor can preserve escapes. Thanks to Samuel Karp. |
| o LANG-1182: Clarify Javadoc of StringUtils.containsAny(). Thanks to |
| Larry West and Pascal Schumacher. |
| o LANG-1183: Making replacePattern/removePattern methods null safe in |
| StringUtils. |
| o LANG-1057: Replace StringBuilder with String concatenation for better |
| optimization. Thanks to Otávio Santana. |
| o LANG-1075: Deprecate SystemUtils.FILE_SEPARATOR and |
| SystemUtils.PATH_SEPARATOR. |
| o LANG-979: TypeUtils.parameterizeWithOwner - wrong format descriptor for |
| "invalid number of type parameters". Thanks to Bruno P. Kinoshita. |
| o LANG-1112: MultilineRecursiveToStringStyle largely unusable due to being |
| package-private. |
| o LANG-1058: StringUtils.uncapitalize performance improvement. Thanks to |
| Leo Wang. |
| o LANG-1069: CharSet.getInstance documentation does not clearly explain how |
| to include negation character in set. Thanks to Arno Noordover. |
| o LANG-1107: Fix parsing edge cases in FastDateParser. |
| o LANG-1273: Added new property IS_OS_MAC_OSX_EL_CAPITAN in SystemUtils. Thanks |
| to Jake Wang. |
| |
| ============================================================================= |
| |
| Release Notes for version 3.4 |
| |
| |
| 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 formatting 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 formatting 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 behavior 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[] input, 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 entities 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: https://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: |
| |
| https://commons.apache.org/lang/ |
| |
| Have fun! |
| -Apache Commons Lang team |
| |