| $Id$ |
| |
| Commons IO Package |
| Version 1.1 |
| Release Notes |
| |
| |
| INTRODUCTION: |
| |
| Commons IO is a package of Java utility classes for java.io's hierarchy. |
| Classes in this package are considered to be so standard and of such high |
| reuse as to justify existence in java.io. |
| |
| Commons IO contains utility classes, stream implementations, file filters, |
| and endian transformation classes. |
| |
| |
| Incompatible changes from 1.0 |
| ----------------------------- |
| Binary compatible - ??? |
| |
| Source compatible - ??? |
| |
| Semantic compatible - ??? |
| |
| |
| Deprecations from 1.0 |
| --------------------- |
| CopyUtils has been deprecated. |
| Its methods have been moved to IOUtils. |
| The new IOUtils methods handle nulls better, and have clearer names. |
| |
| IOUtils.toByteArray(String) - Use {@link String#getBytes()} |
| IOUtils.toString(byte[]) - Use {@link String#String(byte[])} |
| IOUtils.toString(byte[],String) - Use {@link String#String(byte[],String)} |
| |
| |
| Bug fixes from 1.0 |
| ------------------ |
| - FileUtils - touch() |
| Now creates the file if it did not previously exist |
| |
| - FileUtils - toFile(URL) |
| Now handles escape syntax such as %20 |
| |
| |
| Enhancements from 1.0 |
| --------------------- |
| - FileUtils - toFiles(URL[]) |
| Converts an array of URLs to an array of Files |
| |
| - FileUtils - copyDirectory() |
| New methods to copy a directory |
| |
| - FileUtils - readFileToByteArray(File) |
| Reads an entire file into a byte array |
| |
| - FileUtils - writeByteArrayToFile(File,byte[]) |
| Writes a byte array to a file |
| |
| - FileUtils - readLines(File,encoding) |
| Reads a file line by line into a List of Strings |
| |
| - FilenameUtils - new class |
| A static utility class for working with filenames |
| Seeks to ease the pain of developing on Windows and deploying on Unix |
| |
| - FileSystemUtils - new class |
| A static utility class for working with file systems |
| Provides one method at present, to get the free space on the filing system |
| |
| |
| Feedback |
| -------- |
| Open source works best when you give feedback. |
| |
| Please direct all bug reports to Bugzilla. |
| http://issues.apache.org/bugzilla/buglist.cgi?product=Commons&component=IO |
| |
| Or subscribe to the commons-user mailing list (prefix emails by [io]) |
| http://jakarta.apache.org/site/mail.html |
| |
| The Commons-IO Team |