Package name.pachler.nio.file

The name.pachler.nio.file package provides source-compatible implementation of JDK7's WatchService API.

See: Description

Package name.pachler.nio.file Description

The name.pachler.nio.file package provides source-compatible implementation of JDK7's WatchService API. It only provides classes and interfaces needed to implement a WatchService, where the java.nio.file package in Java 7 offers much more functionality.

However, all code using this package should work also with Java 7's implementation of the WatchService (provided that all import statements are changed to import java.nio.file rather than this package).

All classes in this package also exist in Java 7's java.nio.file package as well, and with the exception of the Path and FileSystem classes all have the same interface, making jpathwatch a subset of java.nio.file.

Note that Path and WatchService cannot be instantiated directly. In both JDK7 and jfilewatch factory methods are required for this; see FileSystem, FileSystems and Paths for details.

jpathwatch's WatchService implementation intends to be a non-chatty library - it normally never writes to standard output. However, certain conditions might trigger it to log warnings and errors. If you see log messages like this, they might indicate a bug in the library, so please report them on the jpathwatch website.

jpathwatch uses the "name.pachler.nio.file" namespace for logging, so logging can be turned off by calling Logger.getLogger("name.pachler.nio.file").setLevel(Level.OFF);. Note that this shouldn't be necessary under ordinary circumstances.