Package org.syncany.operations.watch

Class WindowsRecursiveWatcher

java.lang.Object

org.syncany.operations.watch.RecursiveWatcher

org.syncany.operations.watch.WindowsRecursiveWatcher

public class WindowsRecursiveWatcher
extends RecursiveWatcher

The Windows recursive file watcher monitors a folder (and its sub-folders) by registering a recursive watch on the root folder. This class is used only on Windows and uses jpathwatch-based WatchService.

Via the jpathwatch library, the class uses the Windows-native recursive folder- watching capabilities of Windows and thereby does not need to register watches on all sub-folders. Instead, only one watch on the root folder is needed.

When a file event occurs, a timer is started to wait for the file operations to settle. It is reset whenever a new event occurs. When the timer times out, an event is thrown through the RecursiveWatcher.WatchListener.

Nested Class Summary

Nested classes/interfaces inherited from class org.syncany.operations.watch.RecursiveWatcher

RecursiveWatcher.WatchListener

Field Summary

Fields inherited from class org.syncany.operations.watch.RecursiveWatcher

ignorePaths, logger, root

Constructor Summary

Constructors

Constructor	Description
WindowsRecursiveWatcher(java.nio.file.Path root, java.util.List<java.nio.file.Path> ignorePaths, int settleDelay, RecursiveWatcher.WatchListener listener)

Method Summary

Modifier and Type	Method	Description
void	afterStop()	Called after the RecursiveWatcher.stop() method.
protected void	beforePollEventLoop()	Called in the watch service polling thread, right before the RecursiveWatcher.pollEvents() loop.
void	beforeStart()	Called before the RecursiveWatcher.start() method.
boolean	pollEvents()	Called in the watch service polling thread, inside of the RecursiveWatcher.pollEvents() loop.
protected void	watchEventsOccurred()	Called in the watch service polling thread, whenever a file system event occurs.

Methods inherited from class org.syncany.operations.watch.RecursiveWatcher

createRecursiveWatcher, start, stop

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WindowsRecursiveWatcher

public WindowsRecursiveWatcher(java.nio.file.Path root,
                               java.util.List<java.nio.file.Path> ignorePaths,
                               int settleDelay,
                               RecursiveWatcher.WatchListener listener)

Method Detail

beforeStart

public void beforeStart()
                 throws java.lang.Exception

Description copied from class: RecursiveWatcher

Called before the RecursiveWatcher.start() method. This method is only called once.

Specified by:

beforeStart in class RecursiveWatcher

Throws:

java.lang.Exception

beforePollEventLoop

protected void beforePollEventLoop()

Description copied from class: RecursiveWatcher

Called in the watch service polling thread, right before the RecursiveWatcher.pollEvents() loop. This method is only called once.

Specified by:

beforePollEventLoop in class RecursiveWatcher

pollEvents

public boolean pollEvents()
                   throws java.lang.InterruptedException

Description copied from class: RecursiveWatcher

Called in the watch service polling thread, inside of the RecursiveWatcher.pollEvents() loop. This method is called multiple times.

Specified by:

pollEvents in class RecursiveWatcher

Throws:

java.lang.InterruptedException

watchEventsOccurred

protected void watchEventsOccurred()

Description copied from class: RecursiveWatcher

Called in the watch service polling thread, whenever a file system event occurs. This may be used by subclasses to (re-)set watches on folders. This method is called multiple times.

Specified by:

watchEventsOccurred in class RecursiveWatcher

afterStop

public void afterStop()
               throws java.io.IOException

Description copied from class: RecursiveWatcher

Called after the RecursiveWatcher.stop() method. This method is only called once.

Specified by:

afterStop in class RecursiveWatcher

Throws:

java.io.IOException