# Deprecated API

## Contents

- Deprecated Classes
- Deprecated Exceptions
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

- Deprecated Classes
  Class and Description
  org.apache.commons.io.CopyUtils Use IOUtils. Will be removed in 2.0. Methods renamed to IOUtils.write() or IOUtils.copy(). Null handling behaviour changed in IOUtils (null data does not throw NullPointerException).
  org.apache.commons.io.FileCleaner Use `FileCleaningTracker`
  org.apache.commons.io.filefilter.WildcardFilter Use WilcardFileFilter. Deprecated as this class performs directory filtering which it shouldn't do, but that can't be removed due to compatability.

- Deprecated Exceptions
  Exceptions and Description
  org.apache.commons.io.IOExceptionWithCause (since 2.5) use `IOException` instead

- Deprecated Fields
  Field and Description
  org.apache.commons.io.Charsets.ISO_8859_1 Use Java 7's `StandardCharsets`
  org.apache.commons.io.Charsets.US_ASCII Use Java 7's `StandardCharsets`
  org.apache.commons.io.Charsets.UTF_16 Use Java 7's `StandardCharsets`
  org.apache.commons.io.Charsets.UTF_16BE Use Java 7's `StandardCharsets`
  org.apache.commons.io.Charsets.UTF_16LE Use Java 7's `StandardCharsets`
  org.apache.commons.io.Charsets.UTF_8 Use Java 7's `StandardCharsets`

- Deprecated Methods
  Method and Description
  org.apache.commons.io.filefilter.FileFilterUtils.andFileFilter(IOFileFilter, IOFileFilter) use `FileFilterUtils.and(IOFileFilter...)`
  org.apache.commons.io.CopyUtils.copy(byte[], Writer) 2.5 use `CopyUtils.copy(byte[], Writer, String)` instead
  org.apache.commons.io.CopyUtils.copy(InputStream, Writer) 2.5 use `CopyUtils.copy(InputStream, Writer, String)` instead
  org.apache.commons.io.IOUtils.copy(InputStream, Writer) 2.5 use `IOUtils.copy(InputStream, Writer, Charset)` instead
  org.apache.commons.io.CopyUtils.copy(Reader, OutputStream) 2.5 use `CopyUtils.copy(Reader, OutputStream, String)` instead
  org.apache.commons.io.IOUtils.copy(Reader, OutputStream) 2.5 use `IOUtils.copy(Reader, OutputStream, Charset)` instead
  org.apache.commons.io.CopyUtils.copy(String, OutputStream) 2.5 use `CopyUtils.copy(String, OutputStream, String)` instead
  org.apache.commons.io.FileCleaner.exitWhenFinished() Use `FileCleaningTracker.exitWhenFinished()`.
  org.apache.commons.io.FileSystemUtils.freeSpace(String) Use freeSpaceKb(String) Deprecated from 1.3, may be removed in 2.0
  org.apache.commons.io.FileCleaner.getTrackCount() Use `FileCleaningTracker.getTrackCount()`.
  org.apache.commons.io.filefilter.FileFilterUtils.orFileFilter(IOFileFilter, IOFileFilter) use `FileFilterUtils.or(IOFileFilter...)`
  org.apache.commons.io.FileUtils.readFileToString(File) 2.5 use `FileUtils.readFileToString(File, Charset)` instead
  org.apache.commons.io.FileUtils.readLines(File) 2.5 use `FileUtils.readLines(File, Charset)` instead
  org.apache.commons.io.IOUtils.readLines(InputStream) 2.5 use `IOUtils.readLines(InputStream, Charset)` instead
  org.apache.commons.io.IOUtils.toByteArray(Reader) 2.5 use `IOUtils.toByteArray(Reader, Charset)` instead
  org.apache.commons.io.IOUtils.toByteArray(String) 2.5 Use `String.getBytes()` instead
  org.apache.commons.io.IOUtils.toCharArray(InputStream) 2.5 use `IOUtils.toCharArray(InputStream, Charset)` instead
  org.apache.commons.io.IOUtils.toInputStream(CharSequence) 2.5 use `IOUtils.toInputStream(CharSequence, Charset)` instead
  org.apache.commons.io.IOUtils.toInputStream(String) 2.5 use `IOUtils.toInputStream(String, Charset)` instead
  org.apache.commons.io.output.ByteArrayOutputStream.toString() 2.5 use `ByteArrayOutputStream.toString(String)` instead
  org.apache.commons.io.IOUtils.toString(byte[]) 2.5 Use `String.String(byte[])` instead
  org.apache.commons.io.IOUtils.toString(InputStream) 2.5 use `IOUtils.toString(InputStream, Charset)` instead
  org.apache.commons.io.IOUtils.toString(URI) 2.5 use `IOUtils.toString(URI, Charset)` instead
  org.apache.commons.io.IOUtils.toString(URL) 2.5 use `IOUtils.toString(URL, Charset)` instead
  org.apache.commons.io.FileCleaner.track(File, Object) Use `FileCleaningTracker.track(File, Object)`.
  org.apache.commons.io.FileCleaner.track(File, Object, FileDeleteStrategy) Use `FileCleaningTracker.track(File, Object, FileDeleteStrategy)`.
  org.apache.commons.io.FileCleaner.track(String, Object) Use `FileCleaningTracker.track(String, Object)`.
  org.apache.commons.io.FileCleaner.track(String, Object, FileDeleteStrategy) Use `FileCleaningTracker.track(String, Object, FileDeleteStrategy)`.
  org.apache.commons.io.IOUtils.write(byte[], Writer) 2.5 use `IOUtils.write(byte[], Writer, Charset)` instead
  org.apache.commons.io.IOUtils.write(char[], OutputStream) 2.5 use `IOUtils.write(char[], OutputStream, Charset)` instead
  org.apache.commons.io.IOUtils.write(CharSequence, OutputStream) 2.5 use `IOUtils.write(CharSequence, OutputStream, Charset)` instead
  org.apache.commons.io.FileUtils.write(File, CharSequence) 2.5 use `FileUtils.write(File, CharSequence, Charset)` instead
  org.apache.commons.io.FileUtils.write(File, CharSequence, boolean) 2.5 use `FileUtils.write(File, CharSequence, Charset, boolean)` instead
  org.apache.commons.io.IOUtils.write(StringBuffer, OutputStream) replaced by write(CharSequence, OutputStream)
  org.apache.commons.io.IOUtils.write(StringBuffer, OutputStream, String) replaced by write(CharSequence, OutputStream, String)
  org.apache.commons.io.IOUtils.write(StringBuffer, Writer) replaced by write(CharSequence, Writer)
  org.apache.commons.io.IOUtils.write(String, OutputStream) 2.5 use `IOUtils.write(String, OutputStream, Charset)` instead
  org.apache.commons.io.IOUtils.writeLines(Collection, String, OutputStream) 2.5 use `IOUtils.writeLines(Collection, String, OutputStream, Charset)` instead
  org.apache.commons.io.FileUtils.writeStringToFile(File, String) 2.5 use `FileUtils.writeStringToFile(File, String, Charset)` instead
  org.apache.commons.io.FileUtils.writeStringToFile(File, String, boolean) 2.5 use `FileUtils.writeStringToFile(File, String, Charset, boolean)` instead

- Deprecated Constructors
  Constructor and Description
  org.apache.commons.io.output.LockableFileWriter(File, boolean, String) 2.5 use `LockableFileWriter.LockableFileWriter(File, Charset, boolean, String)` instead
  org.apache.commons.io.input.ReaderInputStream(Reader) 2.5 use `ReaderInputStream.ReaderInputStream(Reader, Charset)` instead
  org.apache.commons.io.input.ReversedLinesFileReader(File) 2.5 use `ReversedLinesFileReader.ReversedLinesFileReader(File, Charset)` instead
  org.apache.commons.io.output.WriterOutputStream(Writer) 2.5 use `WriterOutputStream.WriterOutputStream(Writer, Charset)` instead

Copyright © 2002–2016 The Apache Software Foundation. All rights reserved.