NNIO ("Not NIO") is an experimental porting strategy for code that depends on
Java NIO.2 API (for example, classes in the java.nio.file package). It
provides a replacement subset of NIO.2 under a different package name. The
subset is implemented with the pre-NIO.2 file API, and as a result should be
usable to code using a language level lower than Java 8 or built for Android.
To use NNIO, you have to substitute NIO.2 package names with NNIO ones. For
example, java.nio.file.Path becomes org.lukhnos.nnio.file.Path.
This is a work in progress. I only plan to backport a very small subset of NIO.2, and there are a lot different backporting strategies to explore. Open questions include how to integrate with an app's existing build system, especially if code generation or preprocessing is required (so as to facilitate the global substitution of NIO.2 package names). In addition, not all NIO.2 API is backportable, as some of those (such as the file system API) requires native implementations. It's currently a non-goal for NNIO to include any native code.
Have your project depend on nnio. Suppose you use Gradle:
repositories {
mavenCentral()
}
dependencies {
implementation 'org.lukhnos:nnio:0.3.1'
}Then replace your java.nio.file and java.nio.channels imports with
org.lukhnos.nnio.file and org.lukhnos.nnio.channels respectively. If you
run into errors such as missing classes or methods, this means the items in
question are not backported to nnio. :)
This project aims to backport commonly used NIO.2 classes and methods to allow Android apps to include code that depends on NIO.2.
Anything that requires native implementation (for example, getting file creation time, which java.io.File does not support) is a non-goal for this library.
In addition, a sound file system library is hard to implement. This project does not aim to address every fine aspect -- the goal is to backport enough code to make it practical to use code that depends on NIO.2. It's up to the library user (you) to make sure that the operations are safe and correct to your need and standard. It's also a non-goal to make the library work on Windows file system.
Please note that while Files and Path have a larger coverage, a lot of the
classes listed here are stubs.
org.lukhnos.nnio.channels.AsynchronousChannelorg.lukhnos.nnio.channels.AsynchronousFileChannelorg.lukhnos.nnio.channels.CompletionHandlerorg.lukhnos.nnio.file.AccessDeniedExceptionorg.lukhnos.nnio.file.AccessModeorg.lukhnos.nnio.file.AtomicMoveNotSupportedExceptionorg.lukhnos.nnio.file.attribute.AttributeVieworg.lukhnos.nnio.file.attribute.BasicFileAttributesorg.lukhnos.nnio.file.attribute.BasicFileAttributeVieworg.lukhnos.nnio.file.attribute.FileAttributeorg.lukhnos.nnio.file.attribute.FileAttributeVieworg.lukhnos.nnio.file.attribute.FileStoreAttributeVieworg.lukhnos.nnio.file.attribute.FileTimeorg.lukhnos.nnio.file.attribute.UserPrincipalLookupServiceorg.lukhnos.nnio.file.CopyOptionorg.lukhnos.nnio.file.DirectoryStreamorg.lukhnos.nnio.file.FileAlreadyExistsExceptionorg.lukhnos.nnio.file.Filesorg.lukhnos.nnio.file.FileStoreorg.lukhnos.nnio.file.FileSystemorg.lukhnos.nnio.file.FileSystemExceptionorg.lukhnos.nnio.file.FileSystemsorg.lukhnos.nnio.file.FileVisitororg.lukhnos.nnio.file.FileVisitResultorg.lukhnos.nnio.file.InvalidPathExceptionorg.lukhnos.nnio.file.LinkOptionorg.lukhnos.nnio.file.NoSuchFileExceptionorg.lukhnos.nnio.file.OpenOptionorg.lukhnos.nnio.file.Pathorg.lukhnos.nnio.file.PathMatcherorg.lukhnos.nnio.file.Pathsorg.lukhnos.nnio.file.ProviderMismatchExceptionorg.lukhnos.nnio.file.SimpleFileVisitororg.lukhnos.nnio.file.spi.FileSystemProviderorg.lukhnos.nnio.file.StandardCopyOptionorg.lukhnos.nnio.file.StandardOpenOptionorg.lukhnos.nnio.file.WatchEventorg.lukhnos.nnio.file.WatchKeyorg.lukhnos.nnio.file.WatchService
A separate util class, org.lukhnos.nnio.channels.utils.FileChannelUtils, is
provided to supply the stand-in for FileChannel.open(), which is often not
available in the environments that nnio intends to support.
The tests use NIO.2, but during the compile time, a Gradle task generates a
version of the tests that have all java.nio.file imports substituted to
org.lukhnos.nnio.file (and similarly for java.nio.channels), and each test
file has a corresponding Generated- prefixed test. Both versions are built
and tested together.