forked from apache/commons-lang
-
Notifications
You must be signed in to change notification settings - Fork 0
/
RELEASE-NOTES.txt
1948 lines (1660 loc) · 108 KB
/
RELEASE-NOTES.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Apache Commons Lang
Version 3.14.0
Release Notes
This document contains the release notes for the 3.14.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 (Java 8 or above).
Changes in this version include:
New features:
o Add Functions#function(Function). Thanks to Rob Spoor, Gary Gregory.
o Add FailableFunction#function(FailableFunction). Thanks to Rob Spoor, Gary Gregory.
o Add CalendarUtils.getInstance(). Thanks to Gary Gregory.
o Add syntax for optional tokens to DurationFormatUtils #1062. Thanks to Dan Watson.
o Add ArrayFill. Thanks to Gary Gregory.
o Add FastDateParser.TimeZoneStrategy.TzInfo.toString(). Thanks to Gary Gregory.
o Add LocaleUtils.isLanguageUndetermined(Locale). Thanks to Gary Gregory.
o Add ObjectUtils.toString(Supplier<Object>, Supplier<String>). Thanks to Gary Gregory.
o Add LazyInitializer.isInitialized(). Thanks to Gary Gregory.
o Add ConcurrentInitializer#isInitialized() #1120. Thanks to Benjamin Confino, Gary Gregory.
o Add Streams.failableStream(T...). Thanks to Gary Gregory.
o Add FailableSupplier.nul(). Thanks to Gary Gregory.
o Add Suppliers.nul(). Thanks to Gary Gregory.
o Add ExceptionUtils.throwUnchecked(T) where T extends Throwable, and deprecate Object version. Thanks to Gary Gregory.
o Add ExceptionUtils.rethrowRuntimeException(T), and deprecate rethrow(T). Thanks to Gary Gregory.
o LANG-1716: ConcurrentInitializer implementations can now be instantiated and configured with allocation and release lambdas. Thanks to Benjamin Confino, Gary Gregory.
o LANG-1717: Add support for RISC-V in ArchUtils #1128. Thanks to Levi Zim, Gary Gregory.
Fixed Bugs:
o Rename variable names from 'clss' to 'clazz' #1087. Thanks to remeio.
o [Javadoc] ComparableUtils'c1' to 'comparable1', 'c2' to ' Thanks to remeio.
o [Javadoc] Remove 2.1 specific comment #1091. Thanks to Elliotte Rusty Harold.
o LANG-1704: ImmutablePair and ImmutableTriple implementation don't match final in Javadoc. Thanks to Dan Ziemba, Gilles Sadowski, Alex Herbert, Gary Gregory.
o [Javadoc] Fix Incorrect Description in Processor isAarch64() #1093. Thanks to Sung Ho Yoon.
o [Javadoc] Point to right getShortClassName flavor in Javadoc for relevant notes #1097. Thanks to ljacqu.
o Improve performance of StringUtils.isMixedCase() #1096. Thanks to hduelme.
o LANG-1706: ThreadUtils find methods should not return null items #1098. Thanks to Alberto Fernández.
o LANG-1710: ReflectionToStringBuilder changes in version 3.13.0 has broken the logic for overriding classes. Thanks to Shashank Sharma, Gary Gregory, Oksana.
o Return "null" instead of NPE in ClassLoaderUtils.toString(ClassLoader). Thanks to Gary Gregory.
o Return "null" instead of NPE in ClassLoaderUtils.toString(URLClassLoader). Thanks to Gary Gregory.
o Return ToStringStyle.nullText instead of NPE for ReflectionToStringBuilder.toString(). Thanks to Gary Gregory.
o Fix ThresholdCircuitBreaker#checkState() #1100. Thanks to yichinzhu, Gary Gregory.
o Use ConcurrentInitializer implementations without subclassing. #1123. Thanks to Benjamin Confino, Gary Gregory.
o Update critical value for chi-square test #1125. Thanks to Alex Herbert.
o Fix Javadoc syntax errors #1129. Thanks to Sung Ho Yoon.
Changes:
o Bump commons-parent from 58 to 64. Thanks to Gary Gregory.
o Bump org.easymock:easymock from 5.1.0 to 5.2.0 #1104. Thanks to Gary Gregory.
o Bump commons-text from 1.10.0 to 1.11.0. Thanks to Gary Gregory.
o Bump org.codehaus.mojo:exec-maven-plugin from 3.1.0 to 3.1.1 #1135. Thanks to Gary Gregory.
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.13.0
Release Notes
This document contains the release notes for the 3.13.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 (Java 8 or above).
Changes in this version include:
New features:
o Add GitHub coverage.yml. Thanks to Gary Gregory.
o Add EnumUtils.getEnumSystemProperty(...). Thanks to Gary Gregory.
o Add TriConsumer. Thanks to Gary Gregory.
o Add and use EnumUtils.getFirstEnumIgnoreCase(Class, String, Function, E). Thanks to Gary Gregory.
o Add and use Suppliers. Thanks to Gary Gregory.
o Add and use ArrayUtils.getComponentType(T[]). Thanks to Gary Gregory.
o Add and use ClassUtils.getComponentType(Class>T[]>). Thanks to Gary Gregory.
o Add and use ObjectUtils.getClass(T). Thanks to Gary Gregory.
o Add and use ArrayUtils.newInstance(Class>T>, int). Thanks to Gary Gregory.
o Add and use null-safe Streams.of(T...). Thanks to Gary Gregory.
o Add ClassUtils.comparator(). Thanks to Gary Gregory.
o Add and use ThreadUtils.sleepQuietly(Duration). Thanks to Gary Gregory.
o Add and use ArrayUtils.setAll(T[], IntFunction). Thanks to Gary Gregory.
o Add and use ArrayUtils.setAll(T[], Supplier). Thanks to Gary Gregory.
o Add BooleanConsumer. Thanks to Gary Gregory.
o Add IntToCharFunction. Thanks to Gary Gregory.
o Add IntStreams. Thanks to Gary Gregory.
o Add UncheckedFuture. Thanks to Gary Gregory.
o Add UncheckedException. Thanks to Gary Gregory.
o Add UncheckedExecutionException. Thanks to Gary Gregory.
o Add UncheckedTimeoutException. Thanks to Gary Gregory.
o Add UncheckedInterruptedException. Thanks to Gary Gregory.
o Add TimeZones.GMT. Thanks to Gary Gregory.
o Add ObjectUtils.identityHashCodeHex(Object). Thanks to Gary Gregory.
o Add ObjectUtils.hashCodeHex(Object). Thanks to Gary Gregory.
o Add StringUtils.removeStart(String, char). Thanks to Gary Gregory.
o LANG-1659: Add null-safe ObjectUtils.isArray() #754. Thanks to Arturo Bernal, Gary Gregory.
o Add ComparableUtils.max(A, A) and ComparableUtils.min(A, A). Thanks to Gary Gregory.
o Add UncheckedReflectiveOperationException. Thanks to Gary Gregory.
o Add and use ClassUtils.isPublic(Class). Thanks to Gary Gregory.
o Add UncheckedIllegalAccessException. Thanks to Gary Gregory.
o Add MethodInvokers. Thanks to Gary Gregory.
o Add Streams.nullSafeStream(Collection). Thanks to Gary Gregory.
o Add Streams.toStream(Collection). Thanks to Gary Gregory.
o Add Streams.failableStream(Collection) and deprecate misnamed stream(Collection). Thanks to Gary Gregory.
o Add Streams.failableStream(Stream) and deprecate misnamed stream(Stream). Thanks to Gary Gregory.
o Add EnumUtils.getEnumMap(Class, Function). #730 Thanks to Maxwell Cody, Gary Gregory.
o Add FluentBitSet. Thanks to Gary Gregory.
o Add Streams.instancesOf(Class, Collection). Thanks to Gary Gregory.
o Add ImmutablePair.ofNonNull(L, R). Thanks to Gary Gregory.
o Add ImmutableTriple.ofNonNull(L, M, R). Thanks to Gary Gregory.
o Add MutablePair.ofNonNull(L, R). Thanks to Gary Gregory.
o Add MutableTriple.ofNonNull(L, M, R). Thanks to Gary Gregory.
o Add Pair.ofNonNull(L, R). Thanks to Gary Gregory.
o Add Triple.ofNonNull(L, M, R). Thanks to Gary Gregory.
o Add ArrayUtils.containsAny(Object[], Object...). Thanks to Gary Gregory.
o Add Processor.Type.AARCH_64. Thanks to Gary Gregory.
o Add Processor.isAarch64(). Thanks to Gary Gregory.
o Update ArchUtils.getProcessor(String) for "aarch64". Thanks to Gary Gregory.
o Add JavaVersion.JAVA_18. Thanks to Gary Gregory.
o Add JavaVersion.JAVA_19. Thanks to Emmanuel Bourg.
o Add JavaVersion.JAVA_20. Thanks to Emmanuel Bourg.
o Add JavaVersion.JAVA_21. Thanks to Emmanuel Bourg.
o Add TimeZones.toTimeZone(TimeZone). Thanks to Gary Gregory.
o Add FutureTasks. Thanks to Gary Gregory.
o Add Memoizer(Function) and Memoizer(Function, boolean). Thanks to Gary Gregory.
o Add Consumers. Thanks to Gary Gregory.
o Add github/codeql-action. Thanks to Gary Gregory.
o Add coverage.yml. Thanks to Gary Gregory.
o Add DurationUtils.since(Temporal). Thanks to Gary Gregory.
o Add DurationUtils.of(FailableConsumer|FailableRunnbale). Thanks to Gary Gregory.
o Add ExceptionUtils.forEach(Throwable, Consumer<Throwable>). Thanks to Gary Gregory.
o Add ExceptionUtils.stream(Throwable). Thanks to Gary Gregory.
o Add ExceptionUtils.getRootCauseStackTraceList(Throwable). Thanks to Gary Gregory.
o Add SystemUtils.IS_OS_WINDOWS_11. Thanks to Will Herrmann, Gary Gregory, Roland Kreuzer.
o Add SystemUtils.IS_JAVA_16. Thanks to Gary Gregory.
o Add SystemUtils.IS_JAVA_17. Thanks to Gary Gregory.
o Add SystemUtils.IS_JAVA_18. Thanks to Gary Gregory.
o Add SystemUtils.IS_JAVA_19. Thanks to Gary Gregory.
o Add SystemUtils.IS_JAVA_20. Thanks to Gary Gregory.
o Add SystemUtils.IS_JAVA_21. Thanks to Emmanuel Bourg.
o LANG-1627: Add ArrayUtils.oneHot(). Thanks to Alberto Scotto, Avijit Chakraborty, Steve Bosman, Bruno P. Kinoshita, Gary Gregory.
o LANG-1662: Let ReflectionToStringBuilder only reflect given field names #849. Thanks to Daniel Augusto Veronezi Salvador, Gary Gregory, Bruno P. Kinoshita.
o Add Streams.of(Enumeration<E>). Thanks to Gary Gregory.
o Add Streams.of(Iterable<E>). Thanks to Gary Gregory.
o Add Streams.of(Iterator<E>). Thanks to Gary Gregory.
o LANG-1689: Simple support for Optional in ObjectUtils#isEmpty() #933. Thanks to Joseph Hendrix, Gary Gregory.
o Add Processor.Type.getLabel(). Thanks to Gary Gregory.
o Add Processor.toString(). Thanks to Gary Gregory.
o Add HashCodeBuilder.equals(Object). Thanks to Gary Gregory.
o Add BooleanUtils.values() and forEach(). Thanks to Gary Gregory.
o Add ClassPathUtils.packageToPath(String) and pathToPackage(String) Thanks to Gary Gregory.
o Add CalendarUtils#getDayOfYear() #968 Thanks to Arturo Bernal.
o Add NumberRange, DoubleRange, IntegerRange, LongRange. Thanks to Gary Gregory.
o Add missing exception javadoc/tests for some null arguments #869. Thanks to Diego Marcilio, Bruno P. Kinoshita, Gary Gregory.
o Add ClassLoaderUtils.getSystemURLs() and getThreadURLs(). Thanks to Gary Gregory.
o Add RegExUtils.dotAll() and dotAllMatcher(). Thanks to Gary Gregory.
o Add Pair.accept(FailableBiConsumer). Thanks to Gary Gregory.
o Add Pair.apply(FailableBiFunction). Thanks to Gary Gregory.
o LANG-1677: Add ReflectionDiffBuilder.setExcludeFieldNames(...) and DiffExclude a? #838. Thanks to Dennis Baerten, Gary Gregory.
o LANG-1647: Add and ExceptionUtils.isChecked() and isUnchecked() #1069 Thanks to Arturo Bernal, Dimitrios Efthymiou, Gary Gregory.
o Add and use ExceptionUtils.throwUnchecked(throwable). Thanks to Gary Gregory.
o Add LockingVisitors.create(O, ReadWriteLock). Thanks to Gary Gregory.
Fixed Bugs:
o LANG-1645: NumberUtils.createNumber() to recognize hex integers prefixed with +. Thanks to Alex Herbert.
o LANG-1646: NumberUtils.createNumber() to return requested floating point type for zero. Thanks to Alex Herbert.
o DMI: Random object created and used only once (DMI_RANDOM_USED_ONLY_ONCE); Better multi-threaded behavior. Thanks to SpotBugs, Gary Gregory.
o LANG-1646: Redundant Collection operation. Use Collections.emptyIterator() #738. Thanks to Arturo Bernal.
o Make Streams.stream(Collection) null-safe. Thanks to Gary Gregory.
o LANG-1667: Allow tests to access java.util classes such as ArrayList in Java 16 #788. Thanks to Andrew Thomas.
o LANG-1669: OpenJDK 16 Day Period Parsing #791. Thanks to Andrew Thomas.
o LANG-1663: Update documentation to list correct exception for null array parameters #785. Thanks to Andrew Thomas.
o Fixing reversed Javadoc descriptions in StopWatch #781. Thanks to Thunderforge.
o LANG-1670: Fix typos in JavaDoc #795. Thanks to Igor Shuvalov.
o Simplify assertions with equivalent but more simple. #792. Thanks to Arturo Bernal.
o Avoid multiple equivalent occurrences of the same expression. #797. Thanks to Arturo Bernal.
o Remove redundant initializers #800. Thanks to Arturo Bernal.
o Fix ObjectUtils Javadocs #755. Thanks to Arturo Bernal.
o Add test idea for RangeTest from PR #815 by Rushi98, but with a new comment. Thanks to Rushi98, Gary Gregory.
o LANG-1674: Make Range constructors more generic #810. Thanks to singhbaljit, Gary Gregory.
o Use final and Remove redundant String. #813, #816. Thanks to Arturo Bernal.
o Use Set instead of List for checking the contains() method #734. Thanks to CiprianBodnarescu.
o Javadoc for StringUtils.substringBefore(String str, int separator) doesn't mention that the separator is an int. Thanks to Roland Kreuzer.
o Fix NullPointerException in ThreadUtils.getSystemThreadGroup() when the current thread is stopped. Thanks to Gary Gregory.
o ArrayUtils.toPrimitive(Boolean...) null array elements map to false, like Boolean.parseBoolean(null) and its callers return false. Thanks to Gary Gregory.
o StrBuilder.StrBuilderReader.skip(long): Throw an exception when an implicit narrowing conversion in a compound assignment would result in information loss or a numeric error such as an overflows. Thanks to CodeQL, Gary Gregory.
o Deprecate Validate#notNull(Object) in favor of using Objects#requireNonNull(Object, String). Thanks to Gary Gregory.
o LANG-1462: Use TimeZone from calendar in DateFormatUtils. Thanks to Lijun Liang, Arun Avanathan, Tai Dupree, Maria Buiakova, Gary Gregory.
o Updating javadoc for NullPointerException when Validate.notNull() is called #870. Thanks to Diego Marcilio.
o Fixing and adding DateUtils exception Javadocs #871. Thanks to Diego Marcilio.
o LANG-1679: Improve performance of StringUtils.unwrap(String, String) #844. Thanks to clover.
o LANG-1675: Improve performance of StringUtils.join for primitives #812. Thanks to clover.
o LANG-1675: Fixed NPE getting Stack Trace if Throwable is null #733. Thanks to Arturo Bernal.
o Make Validate.isAssignableFrom() check null inputs. Thanks to Gary Gregory, Arturo Bernal.
o Fix Javadoc for Validate.isAssignableFrom(). Thanks to Arturo Bernal.
o Make final mappingFunction variable #876. Thanks to Arturo Bernal.
o Remove unnecessary variable creations #882. Thanks to Arturo Bernal.
o Minor changes #769. Thanks to Arturo Bernal.
o LANG-1680: FastDateFormat does not support the 'L'-Pattern from SimpleDateFormat. Thanks to Michael Krause, Steve Bosman, Gary Gregory.
o Increase test coverage of ComparableUtils from 71% to 100% #898. Thanks to Steve Bosman, Gary Gregory.
o Increase method test coverage of MultilineRecursiveToStringStyle #899. Thanks to Steve Bosman.
o Fix unstable coverage of CharSequenceUtils tests noticed during merge of PRs 898 and 899 #901. Thanks to Steve Bosman.
o Rewrite Conversion.binaryBeMsb0ToHexDigit to invert logic of binaryToHexDigit. Thanks to Arturo Bernal.
o Allow extension of previously final classes ImmutablePair and ImmutableTriple. Thanks to Gary Gregory.
o Update ClassUtils Javadoc with some missing throws NPE #912. Thanks to shalk, Bruno P. Kinoshita, Gary Gregory.
o Javadoc: StringUtils.repeat("", "x", 3) = "xx"; #918. Thanks to guicaiyue.
o Fix typos #920, #923. Thanks to Marc Wrobel.
o Simplify condition #925. Thanks to Bhimantoro Suryo Admodjo.
o StringUtils.join(Iterable, String) should only return null when the Iterable is null. Thanks to Gary Gregory.
o StringUtils.join(Iterator, String) should only return null when the Iterator is null. Thanks to Gary Gregory.
o Add tests to increase coverage #904. Thanks to Arturo Bernal.
o Extends Object clauses are redundant #937. Thanks to Arturo Bernal.
o Simplify conditional expression. #941. Thanks to Arturo Bernal.
o Fix some Javadoc comments #938. Thanks to Arturo Bernal.
o Deprecate getNanosOfMiili() method with typo and create proper getNanosOfMilli() #940. Thanks to Arturo Bernal, Gary Gregory.
o Deprecate ThreadUtils code that defines custom function interfaces in favor of stock java.util.function.Predicate usage. Thanks to Gary Gregory.
o Fix links in Javadoc and documentation #926. Thanks to Marc Wrobel.
o LANG-1604: Deprecate RandomUtils in favor of Apache Commons RNG UniformRandomProvider #942. Thanks to Gilles Sadowski, Maksym Bohachov, Gary Gregory.
o LANG-1638: Added docs regarding week year support #924. Thanks to Shailendra Soni, Michael Osipov, Arun Avanathan, Andrew Thomas, Bruno P. Kinoshita, Gary Gregory.
o LANG-1691: ClassUtils.getShortCanonicalName doesn't use the canonicalName #949. Thanks to Thiyagarajan, Gary Gregory.
o Validate: Get error messages without using String.format when varargs is empty. Thanks to Piotr Stawirej.
o Simplify expression (length is never < 0) #962. Thanks to Arturo Bernal.
o Fix simple broken javadoc. #981. Thanks to Arturo Bernal.
o Fix typo #1001. Thanks to LeeJuHyun.
o Use Objects.requireNonNull() directly #1022. Thanks to Arturo Bernal.
o LANG-1694: MethodUtils.getMatchingMethod() fails with "Found multiple candidates" #1033. Thanks to SeasonPan.
o LANG-1643: Construct ArrayList with better default size #1041. Thanks to laurentschoelens.
o ThreadUtilsTest#testThreadGroups will test failed when using Junit5 parallel test #1051. Thanks to remeio.
o Swap the order of assertion args (first excepted then actual) #1054. Thanks to remeio.
o Fix the comment of Failable, redundant "-" #1056. Thanks to remeio.
o Fix the comment of ComparableUtils, using "smallest", not "largest" #1058. Thanks to remeio.
o AnnotationUtilsTest and FormattableUtilsTest Only use static imports to import assert methods in tests #1052. Thanks to remeio.
o [LANG-1681] Fix some FieldUtils Javadocs #1047. Thanks to laurentschoelens, Bruno P. Kinoshita, Diego Marcilio.
o Remove unnecessary statement in DurationFormatUtils #965. Thanks to Arturo Bernal.
o LANG-1699: Corrected value of SystemUtils.JAVA_VENDOR #1066. Thanks to Darren Coleman.
o [StepSecurity] ci: Harden GitHub Actions #1067. Thanks to step-security-bot, Gary Gregory.
o Update Javadoc for the insert methods in ArrayUtils #1078. Thanks to Dimitrios Efthymiou.
o Deprecate ExceptionUtils.ExceptionUtils(). Thanks to Gary Gregory.
o LANG-1697: TypeUtils.getRawType() throws a NullPointerException on Wildcard GenericArrayType. Thanks to Jan Arne Sparka, Gary Gregory.
o Throw IllegalArgumentException instead of InternalError in the builder package. Thanks to Gary Gregory.
o Avoid NPE in MutableObject#equals() for null content. Thanks to Gary Gregory.
o SystemUtils fix and updates related to macOS #1085. Thanks to Ali Khaleqi Yekta, Gary Gregory.
Changes:
o Bump actions/cache from 2.1.4 to 3.0.10 #742, #752, #764, #833, #867, #959, #964. Thanks to Dependabot, XenoAmess, Gary Gregory.
o Bump actions/checkout from 2 to 3.1.0 #819, #825, #859, #963. Thanks to Dependabot, Gary Gregory.
o Bump actions/setup-java from v1.4.3 to 3.5.1 #879. Thanks to Gary Gregory.
o Bump spotbugs-maven-plugin from 4.2.0 to 4.7.3.0 #735, #808, #822, #834, #868, #895, #919, #927, #946, #989. Thanks to Dependabot, Gary Gregory.
o Bump spotbugs from 4.2.2 to 4.7.3 #744, #917, #947, #973. Thanks to Dependabot, Gary Gregory.
o Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #943. Thanks to Dependabot, Gary Gregory.
o Bump checkstyle from 8.41 to 9.3 #739, #768, #787, #811, #824, #843. Thanks to Dependabot, Gary Gregory.
o Bump easymock from 4.2 to 5.1.0 #746, #972, #986, #1012. Thanks to Dependabot.
o Bump commons.jacoco.version from 0.8.6 to 0.8.8. Thanks to Gary Gregory.
o Bump commons.japicmp.version from 0.15.2 to 0.16.0. Thanks to Gary Gregory.
o Bump junit-pioneer from 1.3.8 to 1.9.1 #749, #767, #832, #883, #988, #991, #995. Thanks to Dependabot, Gary Gregory.
o Bump junit-bom from 5.7.1 to 5.9.1 #761, #805, #807, #836, #928, #955. Thanks to Dependabot.
o Bump maven-javadoc-plugin from 3.2.0 to 3.4.1. Thanks to Dependabot, Gary Gregory.
o Bump jmh.version from 1.27 to 1.36 #794, #842, #872, #990. Thanks to Dependabot.
o Bump maven-pmd-plugin from 3.14.0 to 3.19.0 #802, #858, #909, #948. Thanks to Dependabot.
o Bump pmd from 6.40.0 to 6.52.0 #837, #861, #873, #905, #915, #932, #944. Thanks to Dependabot.
o Bump biz.aQute.bndlib from 5.3.0 to 6.3.1 #814, #835. Thanks to Dependabot, Gary Gregory.
o Bump maven-bundle-plugin from 5.1.1 to 5.1.2. Thanks to Dependabot.
o Bump animal-sniffer-maven-plugin from 1.19 to 1.21. Thanks to Dependabot.
o Bump exec-maven-plugin from 1.6.0 to 3.1.0 #590, #922. Thanks to Dependabot.
o Bump maven-surefire-plugin from 3.0.0-M5 to 3.0.0-M7 #880, #910. Thanks to Dependabot.
o Bump apache-rat from 0.13 to 0.14. Thanks to Gary Gregory.
o Bump commons-parent from 53 to 58 #954, #1000, #1011, #1061. Thanks to Dependabot, Gary Gregory.
o Bump commons-text from 1.9 to 1.10.0 #957. Thanks to Dependabot.
o Bump commons.pmd-impl.version from 6.49.0 to 6.51.0 #961. Thanks to Dependabot, Gary Gregory.
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.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.