xref: /aosp_15_r20/external/apache-commons-lang/src/site/resources/release-notes/RELEASE-NOTES-3.1.txt (revision 455610af95f3bf5f4bc8a9eda520f57e389a4c42)
1Licensed to the Apache Software Foundation (ASF) under one or more
2contributor license agreements.  See the NOTICE file distributed with
3this work for additional information regarding copyright ownership.
4The ASF licenses this file to You under the Apache License, Version 2.0
5(the "License"); you may not use this file except in compliance with
6the License.  You may obtain a copy of the License at
7
8http://www.apache.org/licenses/LICENSE-2.0
9
10Unless required by applicable law or agreed to in writing, software
11distributed under the License is distributed on an "AS IS" BASIS,
12WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13See the License for the specific language governing permissions and
14limitations under the License.
15
16=============================================================================
17
18                        Commons Lang Package
19                            Version 3.1
20                           Release Notes
21
22
23INTRODUCTION:
24
25This document contains the release notes for the 3.1 version of Apache Commons Lang.
26Commons Lang is a set of utility functions and reusable components that should be of use in any
27Java environment.
28
29Lang 3.0 and onwards now targets Java 5.0, making use of features that arrived with Java 5.0 such as generics,
30variable arguments, autoboxing, concurrency and formatted output.
31
32For the advice on upgrading from 2.x to 3.x, see the following page:
33
34    https://commons.apache.org/lang/article3_0.html
35
36CHANGES IN 3.1
37================
38
39    [LANG-760] Add API StringUtils.toString(byte[] input, String charsetName)
40    [LANG-756] Add APIs ClassUtils.isPrimitiveWrapper(Class<?>) and isPrimitiveOrWrapper(Class<?>)
41    [LANG-758] Add an example with whitespace in StringUtils.defaultIfEmpty
42    [LANG-752] Fix createLong() so it behaves like createInteger()
43    [LANG-751] Include the actual type in the Validate.isInstance and isAssignableFrom exception messages
44    [LANG-748] Deprecating chomp(String, String)
45    [LANG-736] CharUtils static final array CHAR_STRING is not needed to compute CHAR_STRING_ARRAY
46    [LANG-695] SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system
47
48BUG FIXES IN 3.1
49==================
50
51    [LANG-749] Incorrect Bundle-SymbolicName in Manifest
52    [LANG-746] NumberUtils does not handle upper-case hex: 0X and -0X
53    [LANG-744] StringUtils throws java.security.AccessControlException on Google App Engine
54    [LANG-741] Ant build has wrong component.name
55    [LANG-698] Document that the Mutable numbers don't work as expected with String.format
56