Common-io工具类

Apache Commons IO Version 2.13.0 Release Notes INTRODUCTION: Commons IO is a package of Java utility classes like java.io. Classes in this package are considered to be so standard and of such high reuse as to justify existence in java.io. The Apache Commons IO library contains utility classes, stream implementations, file filters, file comparators, endian transformation classes, and much more. Java 8 required. Changes in this version include: New features: o Add CharSequenceInputStream.Builder. Thanks to Gary Gregory. o Add ChunkedOutputStream.Builder. Thanks to Gary Gregory. o Add AbstractStreamBuilder.setOpenOptions(OpenOption...). Thanks to Gary Gregory. o Add some missing conversions to AbstractOrigin subclasses. Thanks to Gary Gregory. o Add AbstractOrigin.getByteArray(long, int). Thanks to Gary Gregory. o Add and use RandomAccessFiles. Thanks to Gary Gregory. o Add AbstractOrigin.size(). Thanks to Gary Gregory. o Add PathUtils.EMPTY_FILE_ATTRIBUTE_ARRAY. Thanks to Gary Gregory. o Add CharSequenceInputStream.Builder.setCharsetEncoder(CharsetEncoder). Thanks to Gary Gregory. o Add CharsetEncoders.toCharsetEncoder(CharsetEncoder, Supplier<CharsetEncoder>). Thanks to Gary Gregory. Fixed Bugs: o IO-791: Regression in FileUtils.touch() - no longer creates parent directories. Thanks to Chad Wilson, Gary Gregory. o ByteArrayOrigin should be able convert a byte[] to a ByteArrayInputStream. Thanks to Gary Gregory. o AbstractOriginSupplier.checkOrigin() now throws IllegalStateException instead of NullPointerException. Thanks to Gary Gregory. o IO-796: FileAlreadyExistsException in PathUtils.createParentDirectories(Path, LinkOption, FileAttribute...). Thanks to Giacomo Boccardo, Gary Gregory. o Only read the relevant portion of a file in AbstractOrigin.FileOrigin.getByteArray(long, int) Thanks to Gary Gregory. o Only read the relevant portion of a file in AbstractOrigin.PathOrigin.getByteArray(long, int) Thanks to Gary Gregory. o IO-798: DeferredFileOutputStream throws exception when system temp dir is a symlink. Thanks to Shai Shapira, Gary Gregory. o ReaderInputStream.Builder.setCharsetEncoder(null) should reset to a default object, not throw an NPE. Thanks to Gary Gregory. o ReaderInputStream.Builder.setCharset(null) should reset to a default object, not throw an NPE. Thanks to Gary Gregory. Changes: o Bump commons-parent from 57 to 58. Thanks to Gary Gregory, Dependabot. Compatibility with 2.6: Binary compatible: Yes. Source compatible: Yes. Semantic compatible: Yes. Commons IO 2.9.0 requires Java 8. Commons IO 2.8.0 requires Java 8. Commons IO 2.7 requires Java 8. Commons IO 2.6 requires Java 7. Commons IO 2.5 requires Java 6. Commons IO 2.4 requires Java 6. Commons IO 2.3 requires Java 6. Commons IO 2.2 requires Java 5. Commons IO 1.4 requires Java 1.3. Historical list of changes: https://commons.apache.org/proper/commons-io/changes-report.html For complete information on Apache Commons IO, including instructions on how to submit bug reports, patches, or suggestions for improvement, see the Apache Commons IO website: https://commons.apache.org/proper/commons-io/ Download page: https://commons.apache.org/proper/commons-io/download_io.cgi Have fun! -Apache Commons Team Apache Commons IO Version 2.12.0 Release Notes ============================================================================== INTRODUCTION: Commons IO is a package of Java utility classes like java.io. Classes in this package are considered to be so standard and of such high reuse as to justify existence in java.io. The Apache Commons IO library contains utility classes, stream implementations, file filters, file comparators, endian transformation classes, and much more. Java 8 required. Changes in this version include: New features: o IO-746: Drop unnecessary casts and conversions #267. Thanks to Davide Angelocola. o Add GitHub coverage.yml. Thanks to Gary Gregory. o Add BrokenReader.INSTANCE. Thanks to Gary Gregory. o Add UncheckedBufferedReader. Thanks to Gary Gregory. o Add UncheckedFilterReader. Thanks to Gary Gregory. o Add UncheckedFilterWriter. Thanks to Gary Gregory. o Add StringInputStream. Thanks to Gary Gregory. o Add UncheckedFilterInputStream. Thanks to Gary Gregory. o Add UncheckedFilterOutputStream. Thanks to Gary Gregory. o Add BrokenInputStream.INSTANCE. Thanks to Gary Gregory. o Add ClosedInputStream.INSTANCE and deprecate CLOSED_INPUT_STREAM. Thanks to Gary Gregory. o Add ClosedReader.INSTANCE and deprecate CLOSED_READER. Thanks to Gary Gregory. o Add BrokenWriter.INSTANCE. Thanks to Gary Gregory. o Add ClosedOutputStream.INSTANCE and deprecate CLOSED_OUTPUT_STREAM. Thanks to Gary Gregory. o Add ClosedWriter.INSTANCE and deprecate CLOSED_WRITER. Thanks to Gary Gregory. o Add NullOutputStream.INSTANCE and deprecate NULL_OUTPUT_STREAM. Thanks to Gary Gregory. o Add NullPrintStream.INSTANCE and deprecate NULL_PRINT_STREAM. Thanks to Gary Gregory. o Add NullWriter.INSTANCE and deprecate NULL_WRITER. Thanks to Gary Gregory. o Add NullInputStream.INSTANCE. Thanks to Gary Gregory. o Add NullReader.INSTANCE. Thanks to Gary Gregory. o Add PathUtils.readString(Path, Charset). Thanks to Gary Gregory. o Add FileUtils.newOutputStream(File, boolean). Thanks to Gary Gregory. o Add PathUtils.newOutputStream(Path, boolean). Thanks to Gary Gregory. o Add UncheckedAppendable. Thanks to Gary Gregory. o Add and reuse UncheckedIOExceptions. Thanks to Gary Gregory. o Add PathUtils.getTempDirectory(). Thanks to Gary Gregory. o Add FileSystem.getNameSeparator(). Thanks to Gary Gregory. o Add FileSystem.normalizeSeparators(). Thanks to Gary Gregory. o Add PathUtils.isNewer(Path, FileTime, LinkOption...). Thanks to Gary Gregory. o Add PathUtils.isNewer(Path, Instant, LinkOption...). Thanks to Gary Gregory. o Add AgeFileFilter.AgeFileFilter(Instant). Add AgeFileFilter.AgeFileFilter(Instant, boolean). Thanks to Gary Gregory. o Add FileUtils.lastModifiedFileTime(File). Thanks to Gary Gregory. o Add FileTimes. Thanks to Gary Gregory. o Add PathUtils.waitFor(Path, Duration, LinkOption...). Thanks to Gary Gregory. o Add org.apache.commons.io.input.Tailer.getDelayDuration(). Thanks to Gary Gregory. o Add FileUtils.current(). Thanks to Gary Gregory. o Add and use PathUtils.setLastModifiedTime(Path) for more precision. Add and use PathUtils.setLastModifiedTime(Path, Path) for more precision. Thanks to Gary Gregory. o Add and use PathUtils.isNewer(Path, ChronoZonedDateTime, LinkOption...) for more precision. Add and use PathUtils.isNewer(Path, Path) for more precision. Add and use FileUtils.isNewer(File, FileTime) for more precision. Thanks to Gary Gregory. o Add and use PathUtils.isOlder(Path, FileTime, LinkOption...). Add and use PathUtils.isOlder(Path, Instant, LinkOption...). Add and use PathUtils.isOlder(Path, long, LinkOption...). Add and use PathUtils.isOlder(Path, Path). Thanks to Gary Gregory. o Add and use PathUtils.sizeOf(Path). Add and use PathUtils.sizeOfAsBigInteger(Path). Add and use PathUtils.sizeOfDirectory(Path). Add and use PathUtils.sizeOfDirectoryAsBigInteger(Path). Thanks to Gary Gregory. o Add and use IOCase.value(IOCase, IOCase). Thanks to Gary Gregory. o Add Tailer.Tailable interface to allow tailing of remote files for example using jCI