Features
jpathwatch supports all standard watch event kinds specified in Java 7 (ENTRY_CREATE, ENTRY_DELETE, ENTRY_MODIFY), which allow you to monitor a directory for files being created, deleted and changed.
However, some operating systems provide support for additional event kinds (like file renaming) and advanced monitoring capabilities, which are accessible via modifiers.
The following table summarises the features that are available on each host platform:
event kind | description | Windows | Linux | Mac OS X | FreeBSD | Others |
---|---|---|---|---|---|---|
StandardWatchEventKind.ENTRY_CREATE | file created | Yes | Yes | Yes | Yes | Yes* |
StandardWatchEventKind.ENTRY_DELETE | file deleted | Yes | Yes | Yes | Yes | Yes* |
StandardWatchEventKind.ENTRY_MODIFY | file written to/modified | Yes | Yes | Yes* | Yes* | Yes* |
ExtendedWatchEventKind.ENTRY_RENAME_FROM | file renamed (old name) | Yes | Yes | No | No | No |
ExtendedWatchEventKind.ENTRY_RENAME_TO | file renamed (new name) | Yes | Yes | No | No | No |
ExtendedWatchEventKind.KEY_INVALID | key invalidated (by user or external event) | Yes | Yes | Yes* | Yes* | Yes* |
(*) indicates that specifying this event kind will cause jpathwatch to periodically poll for changes because of a limitation of the underlying operating system.
event modifier | description | Windows | Linux | Mac OS X | FreeBSD | Others |
---|---|---|---|---|---|---|
ExtendedWatchEventModifier.ACCURATE | no event may be missed | Yes | Yes | No | No | No |
ExtendedWatchEventModifier.FILE_TREE | recursive directory monitoring | Yes | No | No | No | No |