xref: /aosp_15_r20/external/apache-commons-lang/src/site/xdoc/upgradeto2_5.xml (revision 455610af95f3bf5f4bc8a9eda520f57e389a4c42)
1*455610afSAndroid Build Coastguard Worker<?xml version="1.0"?>
2*455610afSAndroid Build Coastguard Worker<!--
3*455610afSAndroid Build Coastguard WorkerLicensed to the Apache Software Foundation (ASF) under one or more
4*455610afSAndroid Build Coastguard Workercontributor license agreements.  See the NOTICE file distributed with
5*455610afSAndroid Build Coastguard Workerthis work for additional information regarding copyright ownership.
6*455610afSAndroid Build Coastguard WorkerThe ASF licenses this file to You under the Apache License, Version 2.0
7*455610afSAndroid Build Coastguard Worker(the "License"); you may not use this file except in compliance with
8*455610afSAndroid Build Coastguard Workerthe License.  You may obtain a copy of the License at
9*455610afSAndroid Build Coastguard Worker
10*455610afSAndroid Build Coastguard Worker     http://www.apache.org/licenses/LICENSE-2.0
11*455610afSAndroid Build Coastguard Worker
12*455610afSAndroid Build Coastguard WorkerUnless required by applicable law or agreed to in writing, software
13*455610afSAndroid Build Coastguard Workerdistributed under the License is distributed on an "AS IS" BASIS,
14*455610afSAndroid Build Coastguard WorkerWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15*455610afSAndroid Build Coastguard WorkerSee the License for the specific language governing permissions and
16*455610afSAndroid Build Coastguard Workerlimitations under the License.
17*455610afSAndroid Build Coastguard Worker-->
18*455610afSAndroid Build Coastguard Worker<document>
19*455610afSAndroid Build Coastguard Worker <properties>
20*455610afSAndroid Build Coastguard Worker  <title>2.5 Release Notes</title>
21*455610afSAndroid Build Coastguard Worker  <author email="[email protected]">Commons Documentation Team</author>
22*455610afSAndroid Build Coastguard Worker </properties>
23*455610afSAndroid Build Coastguard Worker<body>
24*455610afSAndroid Build Coastguard Worker
25*455610afSAndroid Build Coastguard Worker<section name="Lang 2.5 Release Notes">
26*455610afSAndroid Build Coastguard Worker<p>
27*455610afSAndroid Build Coastguard WorkerThese are the release notes and advice for upgrading Commons-Lang from
28*455610afSAndroid Build Coastguard Workerversion 2.4 to version 2.5. <br/><br/>See '<a href="article2_5.html">What's new in 2.5?</a>' for more information.
29*455610afSAndroid Build Coastguard Worker<source>
30*455610afSAndroid Build Coastguard WorkerINTRODUCTION:
31*455610afSAndroid Build Coastguard Worker
32*455610afSAndroid Build Coastguard WorkerThis document contains the release notes for the 2.5 version of Apache Commons Lang.
33*455610afSAndroid Build Coastguard WorkerCommons Lang is a set of utility functions and reusable components that should be of use in any Java environment.
34*455610afSAndroid Build Coastguard Worker
35*455610afSAndroid Build Coastguard WorkerLang 2.5 no longer attempts to target the Java 1.2 environment and now targets Java 1.3.
36*455610afSAndroid Build Coastguard Worker
37*455610afSAndroid Build Coastguard WorkerIMPROVEMENTS IN 2.5
38*455610afSAndroid Build Coastguard Worker===================
39*455610afSAndroid Build Coastguard Worker
40*455610afSAndroid Build Coastguard Worker    * [LANG-583] - ArrayUtils - add isNotEmpty() methods
41*455610afSAndroid Build Coastguard Worker    * [LANG-534] - ArrayUtils - add nullToEmpty() methods
42*455610afSAndroid Build Coastguard Worker    * [LANG-454] - CharRange - provide an iterator that lets you walk the chars in the range
43*455610afSAndroid Build Coastguard Worker    * [LANG-514] - CharRange - add more readable static builder methods
44*455610afSAndroid Build Coastguard Worker    * [        ] - ClassUtils - new isAssignable() methods with autoboxing
45*455610afSAndroid Build Coastguard Worker    * [LANG-535] - ClassUtils - add support to getShortClassName and getPackageName for arrays
46*455610afSAndroid Build Coastguard Worker    * [LANG-434] - DateUtils - add ceiling() method
47*455610afSAndroid Build Coastguard Worker    * [LANG-486] - DateUtils - add parseDateStrictly() method
48*455610afSAndroid Build Coastguard Worker    * [LANG-466] - EqualsBuilder - add reset() method
49*455610afSAndroid Build Coastguard Worker    * [LANG-461] - NumberUtils - add toByte() and toShort() methods
50*455610afSAndroid Build Coastguard Worker    * [LANG-522] - Mutable numbers - add string constructors
51*455610afSAndroid Build Coastguard Worker    * [        ] - MutableBoolean - add toBoolean(), isTrue() and isFalse() methods
52*455610afSAndroid Build Coastguard Worker    * [LANG-422] - StrBuilder - add appendSeparator() methods with an alternative default separator if the StrBuilder is currently empty
53*455610afSAndroid Build Coastguard Worker    * [LANG-555] - SystemUtils - add IS_OS_WINDOWS_7 constant
54*455610afSAndroid Build Coastguard Worker    * [LANG-554] - SystemUtils - add IS_JAVA_1_7 constant for JDK 1.7
55*455610afSAndroid Build Coastguard Worker    * [LANG-405] - StringUtils - add abbreviateMiddle() method
56*455610afSAndroid Build Coastguard Worker    * [LANG-569] - StringUtils - add indexOfIgnoreCase() and lastIndexOfIgnoreCase() methods
57*455610afSAndroid Build Coastguard Worker    * [LANG-471] - StringUtils - add isAllUpperCase() and isAllLowerCase() methods
58*455610afSAndroid Build Coastguard Worker    * [LANG-469] - StringUtils - add lastOrdinalIndexOf() method to complement the existing ordinalIndexOf() method
59*455610afSAndroid Build Coastguard Worker    * [LANG-348] - StringUtils - add repeat() method
60*455610afSAndroid Build Coastguard Worker    * [LANG-445] - StringUtils - add startsWithAny() method
61*455610afSAndroid Build Coastguard Worker    * [LANG-430] - StringUtils - add upperCase(String, Locale) and lowerCase(String, Locale) methods
62*455610afSAndroid Build Coastguard Worker    * [LANG-416] - New Reflection package containing ConstructorUtils, FieldUtils, MemberUtils and MethodUtils
63*455610afSAndroid Build Coastguard Worker
64*455610afSAndroid Build Coastguard WorkerBUG FIXES IN 2.5
65*455610afSAndroid Build Coastguard Worker================
66*455610afSAndroid Build Coastguard Worker
67*455610afSAndroid Build Coastguard Worker    * [LANG-494] - CharSet - Synchronizing the COMMON Map so that getInstance doesn't miss a put from a subclass in another thread
68*455610afSAndroid Build Coastguard Worker    * [LANG-500] - ClassUtils - improving performance of getAllInterfaces
69*455610afSAndroid Build Coastguard Worker    * [LANG-587] - ClassUtils - toClass() throws NullPointerException on null array element
70*455610afSAndroid Build Coastguard Worker    * [LANG-530] - DateUtils - Fix parseDate() cannot parse ISO8601 dates produced by FastDateFormat
71*455610afSAndroid Build Coastguard Worker    * [LANG-440] - DateUtils - round() doesn't work correct for Calendar.AM_PM
72*455610afSAndroid Build Coastguard Worker    * [LANG-443] - DateUtils - improve tests
73*455610afSAndroid Build Coastguard Worker    * [LANG-204] - Entities - multithreaded initialization
74*455610afSAndroid Build Coastguard Worker    * [LANG-506] - Entities - missing final modifiers; thread-safety issues
75*455610afSAndroid Build Coastguard Worker    * [LANG-76]  - EnumUtils - getEnum() doesn't work well in 1.5+
76*455610afSAndroid Build Coastguard Worker    * [LANG-584] - ExceptionUtils - use immutable lock target
77*455610afSAndroid Build Coastguard Worker    * [LANG-477] - ExtendedMessageFormat - OutOfMemory with a pattern containing single quotes
78*455610afSAndroid Build Coastguard Worker    * [LANG-538] - FastDateFormat - call getTime() on a calendar to ensure timezone is in the right state
79*455610afSAndroid Build Coastguard Worker    * [LANG-547] - FastDateFormat - Remove unused field
80*455610afSAndroid Build Coastguard Worker    * [LANG-511] - LocaleUtils - initialization of available locales can be deferred
81*455610afSAndroid Build Coastguard Worker    * [LANG-457] - NumberUtils - createNumber() throws a StringIndexOutOfBoundsException for "l"
82*455610afSAndroid Build Coastguard Worker    * [LANG-521] - NumberUtils - isNumber(String) and createNumber(String) both modified to support '2.'
83*455610afSAndroid Build Coastguard Worker    * [LANG-432] - StringUtils - improve handling of case-insensitive Strings
84*455610afSAndroid Build Coastguard Worker    * [LANG-552] - StringUtils - replaceEach() no longer NPEs when null appears in the last String[]
85*455610afSAndroid Build Coastguard Worker    * [LANG-460] - StringUtils - correct Javadocs for startsWith() and startsWithIgnoreCase()
86*455610afSAndroid Build Coastguard Worker    * [LANG-421] - StringEscapeUtils - escapeJava() escapes '/' characters
87*455610afSAndroid Build Coastguard Worker    * [LANG-450] - StringEscapeUtils - change escapeJavaStyleString() to throw UnhandledException instead swallowing IOException
88*455610afSAndroid Build Coastguard Worker    * [LANG-419] - WordUtils - fix StringIndexOutOfBoundsException when lower is greater than the String length
89*455610afSAndroid Build Coastguard Worker    * [LANG-523] - StrBuilder - Performance improvement by doubling the size of the String in ensureCapacity
90*455610afSAndroid Build Coastguard Worker    * [LANG-575] - Compare, Equals and HashCode builders - use ArrayUtils to avoid creating a temporary List
91*455610afSAndroid Build Coastguard Worker    * [LANG-467] - EqualsBuilder - removing the special handling of BigDecimal (LANG-393) to use compareTo
92*455610afSAndroid Build Coastguard Worker    * [LANG-574] - HashCodeBuilder - Performance improvement: check for isArray to short-circuit the 9 instanceof checks
93*455610afSAndroid Build Coastguard Worker    * [LANG-520] - HashCodeBuilder - Changing the hashCode() method to return toHashCode()
94*455610afSAndroid Build Coastguard Worker    * [LANG-459] - HashCodeBuilder - reflectionHashCode() can generate incorrect hashcodes
95*455610afSAndroid Build Coastguard Worker    * [LANG-586] - HashCodeBuilder and ToStringStyle - use of ThreadLocal causes memory leaks in container environments
96*455610afSAndroid Build Coastguard Worker    * [LANG-487] - ToStringBuilder - make default style thread-safe
97*455610afSAndroid Build Coastguard Worker    * [LANG-472] - RandomUtils - nextLong() always produces even numbers
98*455610afSAndroid Build Coastguard Worker    * [LANG-592] - RandomUtils - RandomUtils tests are failing frequently
99*455610afSAndroid Build Coastguard Worker
100*455610afSAndroid Build Coastguard Worker</source>
101*455610afSAndroid Build Coastguard Worker</p>
102*455610afSAndroid Build Coastguard Worker</section>
103*455610afSAndroid Build Coastguard Worker
104*455610afSAndroid Build Coastguard Worker</body>
105*455610afSAndroid Build Coastguard Worker</document>
106