Deprecated List
Date: 2017-02-08

# 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.DatePrinter.format(Calendar, StringBuffer) Use {`DatePrinter.format(Calendar, Appendable)`.
  org.apache.commons.lang3.time.FastDateFormat.format(Calendar, StringBuffer) Use {`FastDateFormat.format(Calendar, Appendable)`.
  org.apache.commons.lang3.time.DatePrinter.format(Date, StringBuffer) Use {`DatePrinter.format(Date, Appendable)`.
  org.apache.commons.lang3.time.FastDateFormat.format(Date, StringBuffer) Use {`FastDateFormat.format(Date, Appendable)`.
  org.apache.commons.lang3.time.DatePrinter.format(long, StringBuffer) Use {`DatePrinter.format(long, Appendable)`.
  org.apache.commons.lang3.time.FastDateFormat.format(long, StringBuffer) Use {`FastDateFormat.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`