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