# 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.FileSystemUtils As of 2.6 deprecated without replacement. Use equivalent methods in `FileStore` instead, e.g. `Files.getFileStore(Paths.get("/home")).getUsableSpace()` or iterate over `FileSystems.getDefault().getFileStores()`
org.apache.commons.io.filefilter.WildcardFilter Use WildcardFileFilter. Deprecated as this class performs directory filtering which it shouldn't do, but that can't be removed due to compatibility.

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.IOUtils.closeQuietly(Closeable...) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.IOUtils.closeQuietly(Closeable) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.IOUtils.closeQuietly(InputStream) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.LineIterator.closeQuietly(LineIterator) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.IOUtils.closeQuietly(OutputStream) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.IOUtils.closeQuietly(Reader) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.IOUtils.closeQuietly(Selector) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.IOUtils.closeQuietly(ServerSocket) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.IOUtils.closeQuietly(Socket) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.IOUtils.closeQuietly(Writer) As of 2.6 removed without replacement. Please use the try-with-resources statement or handle suppressed exceptions manually.
org.apache.commons.io.CopyUtils.copy(byte[], Writer) 2.5 use `CopyUtils.copy(byte[], 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(InputStream, Writer) 2.5 use `CopyUtils.copy(InputStream, Writer, 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(Reader, OutputStream) 2.5 use `CopyUtils.copy(Reader, OutputStream, String)` 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.FileSystemUtils.freeSpaceKb() As of 2.6 deprecated without replacement. Please use `FileStore.getUsableSpace()`.
org.apache.commons.io.FileSystemUtils.freeSpaceKb(long) As of 2.6 deprecated without replacement. Please use `FileStore.getUsableSpace()`.
org.apache.commons.io.FileSystemUtils.freeSpaceKb(String) As of 2.6 deprecated without replacement. Please use `FileStore.getUsableSpace()`.
org.apache.commons.io.FileSystemUtils.freeSpaceKb(String, long) As of 2.6 deprecated without replacement. Please use `FileStore.getUsableSpace()`.
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 (and specify the appropriate encoding)
org.apache.commons.io.FileUtils.readLines(File) 2.5 use `FileUtils.readLines(File, Charset)` instead (and specify the appropriate encoding)
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 (and specify the appropriate encoding)
org.apache.commons.io.FileUtils.write(File, CharSequence, boolean) 2.5 use `FileUtils.write(File, CharSequence, Charset, boolean)` instead (and specify the appropriate encoding)
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 (and specify the appropriate encoding)
org.apache.commons.io.FileUtils.writeStringToFile(File, String, boolean) 2.5 use `FileUtils.writeStringToFile(File, String, Charset, boolean)` instead (and specify the appropriate encoding)

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