Deprecated API

Contents

• Interfaces
• Classes
• Fields
• Methods
• Constructors
• Enum Constants

Interfaces

Interface	Description
org.apache.commons.lang3.Functions.FailableBiConsumer	Use FailableBiConsumer.
org.apache.commons.lang3.Functions.FailableBiFunction	Use FailableBiFunction.
org.apache.commons.lang3.Functions.FailableBiPredicate	Use FailableBiPredicate.
org.apache.commons.lang3.Functions.FailableCallable	Use FailableCallable.
org.apache.commons.lang3.Functions.FailableConsumer	Use FailableConsumer.
org.apache.commons.lang3.Functions.FailableFunction	Use FailableFunction.
org.apache.commons.lang3.Functions.FailablePredicate	Use FailablePredicate.
org.apache.commons.lang3.Functions.FailableRunnable	Use FailableRunnable.
org.apache.commons.lang3.Functions.FailableSupplier	Use FailableSupplier.
org.apache.commons.lang3.text.FormatFactory	As of 3.6, use Apache Commons Text FormatFactory instead
org.apache.commons.lang3.ThreadUtils.ThreadGroupPredicate	Use a Predicate.
org.apache.commons.lang3.ThreadUtils.ThreadPredicate	Use a Predicate.

Classes

Class	Description
org.apache.commons.lang3.CharEncoding	Java 7 introduced StandardCharsets, which defines these constants as Charset objects. Use Charset.name() to get the string values provided in this class. This class will be removed in a future release.
org.apache.commons.lang3.Functions	Use Failable.
org.apache.commons.lang3.Streams	Use Streams.
org.apache.commons.lang3.Streams.ArrayCollector	Use Streams.ArrayCollector.
org.apache.commons.lang3.Streams.FailableStream	Use Streams.FailableStream.
org.apache.commons.lang3.StringEscapeUtils	As of 3.6, use Apache Commons Text StringEscapeUtils instead
org.apache.commons.lang3.text.CompositeFormat	As of 3.6, use Apache Commons Text CompositeFormat instead
org.apache.commons.lang3.text.ExtendedMessageFormat	As of 3.6, use Apache Commons Text ExtendedMessageFormat instead
org.apache.commons.lang3.text.FormattableUtils	As of 3.6, use Apache Commons Text FormattableUtils instead
org.apache.commons.lang3.text.StrBuilder	As of 3.6, use Apache Commons Text TextStringBuilder instead
org.apache.commons.lang3.text.StrLookup	As of 3.6, use Apache Commons Text StringLookupFactory instead
org.apache.commons.lang3.text.StrMatcher	As of 3.6, use Apache Commons Text StringMatcherFactory instead
org.apache.commons.lang3.text.StrSubstitutor	As of 3.6, use Apache Commons Text StringSubstitutor instead
org.apache.commons.lang3.text.StrTokenizer	As of 3.6, use Apache Commons Text StringTokenizer instead
org.apache.commons.lang3.text.translate.AggregateTranslator	As of 3.6, use Apache Commons Text AggregateTranslator instead
org.apache.commons.lang3.text.translate.CharSequenceTranslator	As of 3.6, use Apache Commons Text CharSequenceTranslator instead
org.apache.commons.lang3.text.translate.CodePointTranslator	As of 3.6, use Apache Commons Text CharSequenceTranslator instead
org.apache.commons.lang3.text.translate.EntityArrays	As of 3.6, use Apache Commons Text EntityArrays instead
org.apache.commons.lang3.text.translate.JavaUnicodeEscaper	As of 3.6, use Apache Commons Text UnicodeEscaper instead
org.apache.commons.lang3.text.translate.LookupTranslator	As of 3.6, use Apache Commons Text LookupTranslator instead
org.apache.commons.lang3.text.translate.NumericEntityEscaper	As of 3.6, use Apache Commons Text NumericEntityEscaper instead
org.apache.commons.lang3.text.translate.NumericEntityUnescaper	As of 3.6, use Apache Commons Text NumericEntityUnescaper instead
org.apache.commons.lang3.text.translate.OctalUnescaper	As of 3.6, use Apache Commons Text OctalUnescaper instead
org.apache.commons.lang3.text.translate.UnicodeEscaper	As of 3.6, use Apache Commons Text UnicodeEscaper instead
org.apache.commons.lang3.text.translate.UnicodeUnescaper	As of 3.6, use Apache Commons Text UnicodeUnescaper instead
org.apache.commons.lang3.text.translate.UnicodeUnpairedSurrogateRemover	As of 3.6, use Apache Commons Text UnicodeUnpairedSurrogateRemover instead
org.apache.commons.lang3.text.WordUtils	As of 3.6, use Apache Commons Text WordUtils instead
org.apache.commons.lang3.ThreadUtils.NamePredicate	Use a Predicate.
org.apache.commons.lang3.ThreadUtils.ThreadIdPredicate	Use a Predicate.

Fields

Field	Description
org.apache.commons.lang3.StringEscapeUtils.ESCAPE_XML	use StringEscapeUtils.ESCAPE_XML10 or StringEscapeUtils.ESCAPE_XML11 instead.
org.apache.commons.lang3.SystemUtils.FILE_SEPARATOR	Use File.separator, since it is guaranteed to be a string containing a single character and it does not require a privilege check.
org.apache.commons.lang3.SystemUtils.IS_JAVA_1_9	As of release 3.5, replaced by SystemUtils.IS_JAVA_9
org.apache.commons.lang3.SystemUtils.JAVA_HOME_KEY	Use SystemProperties.JAVA_HOME.
org.apache.commons.lang3.SystemUtils.JAVA_IO_TMPDIR_KEY	Use SystemProperties.JAVA_IO_TMPDIR.
org.apache.commons.lang3.SystemUtils.LINE_SEPARATOR	Use System.lineSeparator() instead, since it does not require a privilege check.
org.apache.commons.lang3.SystemUtils.PATH_SEPARATOR	Use File.pathSeparator, since it is guaranteed to be a string containing a single character and it does not require a privilege check.
org.apache.commons.lang3.SystemUtils.USER_DIR_KEY	Use SystemProperties.USER_DIR.
org.apache.commons.lang3.SystemUtils.USER_NAME_KEY	Use SystemProperties.USER_NAME.
org.apache.commons.lang3.ThreadUtils.ALWAYS_TRUE_PREDICATE	Use a Predicate.
org.apache.commons.lang3.time.DateFormatUtils.ISO_DATE_FORMAT	- as of 4.0, ISO_DATE_FORMAT will be replaced by ISO_8601_EXTENDED_DATE_FORMAT.
org.apache.commons.lang3.time.DateFormatUtils.ISO_DATE_TIME_ZONE_FORMAT	- as of 4.0, ISO_DATE_TIME_ZONE_FORMAT will be removed.
org.apache.commons.lang3.time.DateFormatUtils.ISO_DATETIME_FORMAT	- as of 4.0, ISO_DATETIME_FORMAT will be replaced by ISO_8601_EXTENDED_DATETIME_FORMAT.
org.apache.commons.lang3.time.DateFormatUtils.ISO_DATETIME_TIME_ZONE_FORMAT	- as of 4.0, ISO_DATETIME_TIME_ZONE_FORMAT will be replaced by ISO_8601_EXTENDED_DATETIME_TIME_ZONE_FORMAT.
org.apache.commons.lang3.time.DateFormatUtils.ISO_TIME_FORMAT	- as of 4.0, ISO_TIME_FORMAT will be removed.
org.apache.commons.lang3.time.DateFormatUtils.ISO_TIME_NO_T_FORMAT	- as of 4.0, ISO_TIME_NO_T_FORMAT will be replaced by ISO_8601_EXTENDED_TIME_FORMAT.
org.apache.commons.lang3.time.DateFormatUtils.ISO_TIME_NO_T_TIME_ZONE_FORMAT	- as of 4.0, ISO_TIME_NO_T_TIME_ZONE_FORMAT will be replaced by ISO_8601_EXTENDED_TIME_TIME_ZONE_FORMAT.
org.apache.commons.lang3.time.DateFormatUtils.ISO_TIME_TIME_ZONE_FORMAT	- as of 4.0, ISO_TIME_TIME_ZONE_FORMAT will be removed.

Methods

Method	Description
org.apache.commons.lang3.ArrayUtils.add(boolean[], int, boolean)	this method has been superseded by ArrayUtils.insert(int, boolean[], boolean...) and may be removed in a future release. Please note the handling of null input arrays differs in the new method: inserting X into a null array results in null not X.
org.apache.commons.lang3.ArrayUtils.isEquals(Object, Object)	this method has been replaced by java.util.Objects.deepEquals(Object, Object) and will be removed from future releases.
org.apache.commons.lang3.ArrayUtils.removeAllOccurences(boolean[], boolean)	Use ArrayUtils.removeAllOccurrences(boolean[], boolean)
org.apache.commons.lang3.builder.Diff.getType()	Unused, will be removed in 4.0.0.
org.apache.commons.lang3.builder.ReflectionDiffBuilder.setExcludeFieldNames(String...)	Use ReflectionDiffBuilder.Builder.setExcludeFieldNames(String[]).
org.apache.commons.lang3.CharEncoding.isSupported(String)	Please use Charset.isSupported(String) instead, although be aware that null values are not accepted by that method and an IllegalCharsetNameException may be thrown.
org.apache.commons.lang3.CharUtils.toCharacterObject(char)	Use Character.valueOf(char).
org.apache.commons.lang3.exception.ExceptionUtils.getCause(Throwable)	This feature will be removed in Lang 4, use Throwable.getCause() instead
org.apache.commons.lang3.exception.ExceptionUtils.getDefaultCauseMethodNames()	This feature will be removed in Lang 4
org.apache.commons.lang3.exception.ExceptionUtils.throwUnchecked(T)	Use ExceptionUtils.throwUnchecked(Throwable).
org.apache.commons.lang3.math.NumberUtils.isNumber(String)	This feature will be removed in Lang 4, use NumberUtils.isCreatable(String) instead
org.apache.commons.lang3.ObjectUtils.equals(Object, Object)	this method has been replaced by java.util.Objects.equals(Object, Object) in Java 7 and will be removed from future releases.
org.apache.commons.lang3.ObjectUtils.hashCode(Object)	this method has been replaced by java.util.Objects.hashCode(Object) in Java 7 and will be removed in future releases
org.apache.commons.lang3.ObjectUtils.hashCodeMulti(Object...)	this method has been replaced by java.util.Objects.hash(Object...) in Java 7 and will be removed in future releases.
org.apache.commons.lang3.ObjectUtils.identityToString(StrBuilder, Object)	as of 3.6, because StrBuilder was moved to commons-text, use one of the other identityToString methods instead
org.apache.commons.lang3.ObjectUtils.toString(Object)	this method has been replaced by java.util.Objects.toString(Object) in Java 7 and will be removed in future releases. Note however that said method will return "null" for null references, while this method returns an empty String. To preserve behavior use java.util.Objects.toString(myObject, "")
org.apache.commons.lang3.Range.between(T, T)	Use Range.of(Comparable, Comparable).
org.apache.commons.lang3.reflect.FieldUtils.removeFinalModifier(Field, boolean)	As of Java 12, we can no longer drop the final modifier, thus rendering this method obsolete. The JDK discussion about this change can be found here: https://mail.openjdk.java.net/pipermail/core-libs-dev/2018-November/056486.html
org.apache.commons.lang3.stream.Streams.stream(Collection<E>)	Use Streams.failableStream(Collection).
org.apache.commons.lang3.StringEscapeUtils.escapeXml(String)	use StringEscapeUtils.escapeXml10(java.lang.String) or StringEscapeUtils.escapeXml11(java.lang.String) instead.
org.apache.commons.lang3.StringUtils.chomp(String, String)	This feature will be removed in Lang 4, use StringUtils.removeEnd(String, String) instead
org.apache.commons.lang3.StringUtils.defaultString(String, String)	Use Objects.toString(Object, String)
org.apache.commons.lang3.StringUtils.getFuzzyDistance(CharSequence, CharSequence, Locale)	As of 3.6, use Apache Commons Text FuzzyScore instead
org.apache.commons.lang3.StringUtils.getJaroWinklerDistance(CharSequence, CharSequence)	As of 3.6, use Apache Commons Text JaroWinklerDistance instead
org.apache.commons.lang3.StringUtils.getLevenshteinDistance(CharSequence, CharSequence)	As of 3.6, use Apache Commons Text LevenshteinDistance instead
org.apache.commons.lang3.StringUtils.removeAll(String, String)	Moved to RegExUtils.
org.apache.commons.lang3.StringUtils.removeFirst(String, String)	Moved to RegExUtils.
org.apache.commons.lang3.StringUtils.removePattern(String, String)	Moved to RegExUtils.
org.apache.commons.lang3.StringUtils.replaceAll(String, String, String)	Moved to RegExUtils.
org.apache.commons.lang3.StringUtils.replaceFirst(String, String, String)	Moved to RegExUtils.
org.apache.commons.lang3.StringUtils.replacePattern(String, String, String)	Moved to RegExUtils.
org.apache.commons.lang3.StringUtils.toString(byte[], String)	use StringUtils.toEncodedString(byte[], Charset) instead of String constants in your code
org.apache.commons.lang3.SystemUtils.getUserName()	Use SystemProperties.getUserName().
org.apache.commons.lang3.ThreadUtils.findThreadGroups(ThreadGroup, boolean, ThreadUtils.ThreadGroupPredicate)	Use ThreadUtils.findThreadGroups(ThreadGroup, boolean, Predicate).
org.apache.commons.lang3.ThreadUtils.findThreads(ThreadGroup, boolean, ThreadUtils.ThreadPredicate)	Use ThreadUtils.findThreads(ThreadGroup, boolean, Predicate).
org.apache.commons.lang3.time.DatePrinter.format(Calendar, StringBuffer)	Use {DatePrinter.format(Calendar, Appendable).
org.apache.commons.lang3.time.DurationUtils.getNanosOfMiili(Duration)	Use DurationUtils.getNanosOfMilli(Duration).
org.apache.commons.lang3.time.FastDateFormat.applyRules(Calendar, StringBuffer)	Use FastDateFormat.format(Calendar, Appendable)
org.apache.commons.lang3.time.FastDateFormat.format(Calendar, StringBuffer)	Use {FastDateFormat.format(Calendar, Appendable).
org.apache.commons.lang3.time.FastDatePrinter.applyRules(Calendar, StringBuffer)	use FastDatePrinter.format(Calendar) or FastDatePrinter.format(Calendar, Appendable)
org.apache.commons.lang3.time.FastDatePrinter.format(Object, StringBuffer, FieldPosition)	Use {FastDatePrinter.format(Date), {FastDatePrinter.format(Calendar), {FastDatePrinter.format(long).
org.apache.commons.lang3.time.StopWatch.getSplitTime()	Use StopWatch.getSplitDuration().
org.apache.commons.lang3.time.StopWatch.getStartTime()	Use StopWatch.getStartInstant().
org.apache.commons.lang3.time.StopWatch.getStopTime()	Use StopWatch.getStopInstant().
org.apache.commons.lang3.time.StopWatch.getTime()	Use StopWatch.getDuration().
org.apache.commons.lang3.Validate.notNull(T)	Use Objects.requireNonNull(Object).

Constructors

Constructor	Description
org.apache.commons.lang3.AnnotationUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.ArchUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.ArraySorter()	Will be removed in 4.0.0.
org.apache.commons.lang3.ArrayUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.BooleanUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.builder.DiffBuilder(T, T, ToStringStyle)	Use DiffBuilder.Builder.
org.apache.commons.lang3.builder.ReflectionDiffBuilder(T, T, ToStringStyle)	Use ReflectionDiffBuilder.Builder.
org.apache.commons.lang3.CharEncoding()	Will be removed in 4.0.0.
org.apache.commons.lang3.CharSequenceUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.CharSetUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.CharUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.ClassLoaderUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.ClassPathUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.ClassUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.compare.ObjectToStringComparator()	Will be private in 4.0.0.
org.apache.commons.lang3.concurrent.locks.LockingVisitors()	TODO Make private in 4.0.
org.apache.commons.lang3.Conversion()	Will be removed in 4.0.0.
org.apache.commons.lang3.EnumUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.event.EventUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.exception.ExceptionUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.function.Suppliers()	TODO Make private in 4.0.
org.apache.commons.lang3.LocaleUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.math.IEEE754rUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.math.NumberUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.ObjectUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.RandomStringUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.RandomUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.reflect.ConstructorUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.reflect.FieldUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.reflect.InheritanceUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.reflect.MethodUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.reflect.TypeUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.RegExUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.RuntimeEnvironment()	Will be removed in 4.0.0.
org.apache.commons.lang3.SerializationUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.stream.IntStreams()	TODO Make private in 4.0.
org.apache.commons.lang3.stream.Streams()	Will be private in 4.0.0.
org.apache.commons.lang3.StringEscapeUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.StringUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.SystemProperties()	TODO Make private in 4.0.
org.apache.commons.lang3.text.translate.EntityArrays()	Will be removed in 4.0.0.
org.apache.commons.lang3.ThreadUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.time.DateFormatUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.time.DateUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.time.DurationFormatUtils()	TODO Make private in 4.0.
org.apache.commons.lang3.time.DurationUtils()	TODO Make private in 4.0.

Enum Constants

Enum Constant	Description
org.apache.commons.lang3.JavaVersion.JAVA_1_9	As of release 3.5, replaced by JavaVersion.JAVA_9