Deprecated API

Contents

• Deprecated Fields
• Deprecated Methods
• Deprecated Enum Constants

Deprecated Fields

Field and 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.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.
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.

Deprecated Methods

Method and Description
org.apache.commons.lang3.time.FastDatePrinter.applyRules(Calendar, StringBuffer) use FastDatePrinter.format(Calendar) or FastDatePrinter.format(Calendar, Appendable)
org.apache.commons.lang3.time.FastDateFormat.applyRules(Calendar, StringBuffer) Use FastDateFormat.format(Calendar, Appendable)
org.apache.commons.lang3.StringUtils.chomp(String, String) This feature will be removed in Lang 4.0, use StringUtils.removeEnd(String, 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.StringEscapeUtils.escapeXml(String) use StringEscapeUtils.escapeXml10(java.lang.String) or StringEscapeUtils.escapeXml11(java.lang.String) instead.
org.apache.commons.lang3.time.FastDateFormat.format(Calendar, StringBuffer) Use {FastDateFormat.format(Calendar, Appendable).
org.apache.commons.lang3.time.DatePrinter.format(Calendar, StringBuffer) Use {DatePrinter.format(Calendar, Appendable).
org.apache.commons.lang3.time.FastDateFormat.format(Date, StringBuffer) Use {FastDateFormat.format(Date, Appendable).
org.apache.commons.lang3.time.DatePrinter.format(Date, StringBuffer) Use {DatePrinter.format(Date, Appendable).
org.apache.commons.lang3.time.FastDateFormat.format(long, StringBuffer) Use {FastDateFormat.format(long, Appendable).
org.apache.commons.lang3.time.DatePrinter.format(long, StringBuffer) Use {DatePrinter.format(long, Appendable).
org.apache.commons.lang3.time.FastDatePrinter.format(Object, StringBuffer, FieldPosition) Use {FastDatePrinter.format(Date), {FastDatePrinter.format(Calendar), {FastDatePrinter.format(long), or {FastDatePrinter.format(Object)
org.apache.commons.lang3.exception.ExceptionUtils.getCause(Throwable) This feature will be removed in Lang 4.0, use Throwable.getCause() instead
org.apache.commons.lang3.exception.ExceptionUtils.getCause(Throwable, String[]) This feature will be removed in Lang 4.0, use Throwable.getCause() instead
org.apache.commons.lang3.exception.ExceptionUtils.getDefaultCauseMethodNames() This feature will be removed in Lang 4.0
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.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.math.NumberUtils.isNumber(String) This feature will be removed in Lang 4.0, use NumberUtils.isCreatable(String) instead
org.apache.commons.lang3.CharUtils.toCharacterObject(char) Java 5 introduced Character.valueOf(char) which caches chars 0 through 127.
org.apache.commons.lang3.StringUtils.toString(byte[], String) use StringUtils.toEncodedString(byte[], Charset) instead of String constants in your code
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 and empty String. To preserve behavior use java.util.Objects.toString(myObject, "")
org.apache.commons.lang3.ObjectUtils.toString(Object, String) this method has been replaced by java.util.Objects.toString(Object, String) in Java 7 and will be removed in future releases.

Deprecated Enum Constants

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