Package org.apache.logging.log4j.core.util

Class WatchManager

java.lang.Object

org.apache.logging.log4j.core.AbstractLifeCycle

org.apache.logging.log4j.core.util.WatchManager

All Implemented Interfaces:

LifeCycle, LifeCycle2

public class WatchManager
extends AbstractLifeCycle

Manages FileWatchers.

See Also:

FileWatcher, ConfigurationScheduler

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.logging.log4j.core.LifeCycle

LifeCycle.State

Field Summary

Fields inherited from class org.apache.logging.log4j.core.AbstractLifeCycle

DEFAULT_STOP_TIMEOUT, DEFAULT_STOP_TIMEUNIT, LOGGER

Constructor Summary

Constructors

Constructor	Description
WatchManager(ConfigurationScheduler scheduler)

Method Summary

Modifier and Type	Method	Description
int	getIntervalSeconds()	Gets how often this manager checks for file modifications.
java.util.Map<java.io.File,FileWatcher>	getWatchers()
void	reset()	Resets all file monitors to their current last modified time.
void	reset(java.io.File file)	Resets the file monitor for the given file being watched to its current last modified time.
void	setIntervalSeconds(int intervalSeconds)
void	start()
boolean	stop(long timeout, java.util.concurrent.TimeUnit timeUnit)	Blocks until all tasks have completed execution after a shutdown request, or the timeout occurs, or the current thread is interrupted, whichever happens first.
java.lang.String	toString()
void	unwatchFile(java.io.File file)	Unwatches the given file.
void	watchFile(java.io.File file, FileWatcher watcher)	Watches the given file.

Methods inherited from class org.apache.logging.log4j.core.AbstractLifeCycle

equalsImpl, getState, getStatusLogger, hashCodeImpl, initialize, isInitialized, isStarted, isStarting, isStopped, isStopping, setStarted, setStarting, setState, setStopped, setStopping, stop, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

WatchManager

public WatchManager(ConfigurationScheduler scheduler)

Method Detail

reset

public void reset()

Resets all file monitors to their current last modified time. If this manager does not watch any file, nothing happens.

This allows you to start, stop, reset and start again a manager, without triggering file modified events if the a watched file has changed during the period of time when the manager was stopped.

Since:

2.11.0

reset

public void reset(java.io.File file)

Resets the file monitor for the given file being watched to its current last modified time. If this manager does not watch the given file, nothing happens.

This allows you to start, stop, reset and start again a manager, without triggering file modified events if the given watched file has changed during the period of time when the manager was stopped.

Parameters:

file - the file for the monitor to reset.

Since:

2.11.0

setIntervalSeconds

public void setIntervalSeconds(int intervalSeconds)

getIntervalSeconds

public int getIntervalSeconds()

Gets how often this manager checks for file modifications.

Returns:

how often, in seconds, this manager checks for file modifications.

start

public void start()

Specified by:

start in interface LifeCycle

Overrides:

start in class AbstractLifeCycle

stop

public boolean stop(long timeout,
                    java.util.concurrent.TimeUnit timeUnit)

Description copied from interface: LifeCycle2

Blocks until all tasks have completed execution after a shutdown request, or the timeout occurs, or the current thread is interrupted, whichever happens first.

Specified by:

stop in interface LifeCycle2

Overrides:

stop in class AbstractLifeCycle

Parameters:

timeout - the maximum time to wait

timeUnit - the time unit of the timeout argument

Returns:

true if the receiver was stopped cleanly and normally, false otherwise.

unwatchFile

public void unwatchFile(java.io.File file)

Unwatches the given file.

Parameters:

file - the file to stop watching.

Since:

2.11.0

watchFile

public void watchFile(java.io.File file,
                      FileWatcher watcher)

Watches the given file.

Parameters:

file - the file to watch.

watcher - the watcher to notify of file changes.

getWatchers

public java.util.Map<java.io.File,FileWatcher> getWatchers()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object