com.registry

Class RegistryWatcher

java.lang.Object

com.registry.RegistryWatcher

public final class RegistryWatcher
extends Object

This class provides the functionality to watch for registry key changes.

To start monitoring changes, a class would first implement the RegistryListener class. A call to addRegistryListener(com.registry.event.RegistryListener) would then register that listener so that registry key changes will be sent to it.

After that, just add registry keys to monitor via the watchKey(RegistryKey) method or remove registry keys to stop monitoring them with the removeKey(RegistryKey) method.

Version:

1.8

Author:

Yinon Michaeli

Method Summary

Methods

Modifier and Type	Method and Description
static void	addRegistryListener(RegistryListener l) Registers a listener to receive registry key changes.
static void	removeID(int id) Removes the registry key with the corresponding watch id from the list of watched keys.
static void	removeKey(RegistryKey key) Removes key from the list of watched keys.
static void	removeRegistryListener(RegistryListener l) Unregisters the listener so that it will not longer receive registry key changes.
static int	watchKey(RegistryKey key) Adds the specified registry key to the watch list.
static int	watchKey(RegistryKey key, boolean watchSubtree) Adds the specified registry key to the watch list.
static int	watchKey(RegistryKey key, boolean watchSubtree, int dwNotifyFilter) Adds the specified registry key to the watch list.

Methods inherited from class java.lang.Object

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

Method Detail

addRegistryListener

public static void addRegistryListener(RegistryListener l)

Registers a listener to receive registry key changes.

Parameters:

l - the listener that will receive the changes.

removeRegistryListener

public static void removeRegistryListener(RegistryListener l)

Unregisters the listener so that it will not longer receive registry key changes.

Parameters:

l - the listener to unregister.

watchKey

public static int watchKey(RegistryKey key)

Adds the specified registry key to the watch list. When the key is added, listeners will be able to receive change notifications for the key.
By default, changes will only be recorded within the key not any of the subkeys.

Parameters:

key - the registry key to watch.

Returns:

the watch id for this key.

Throws:

RegistryException - if at least one listener is not registered.

watchKey

public static int watchKey(RegistryKey key,
           boolean watchSubtree)

Adds the specified registry key to the watch list. When the key is added, listeners will be able to receive change notifications for the key. The user can choose whether the subtree of the key should be watched as well.

Parameters:

key - the registry key to watch.

watchSubtree - whether or not changes in the subtree should be reported.

Returns:

the watch id for this key.

Throws:

RegistryException - if at least one listener is not registered.

watchKey

public static int watchKey(RegistryKey key,
           boolean watchSubtree,
           int dwNotifyFilter)

Adds the specified registry key to the watch list. When the key is added, listeners will be able to receive change notifications for the key. The user can choose whether the subtree of the key should be watched as well. The filter describes what sort of changes to report.

Parameters:

key - the registry key to watch.

watchSubtree - whether or not changes in the subtree should be reported.

dwNotifyFilter - filter of what changes to report.

Returns:

the watch id for this key.

Throws:

RegistryException - if at least one listener is not registered.

removeKey

public static void removeKey(RegistryKey key)

Removes key from the list of watched keys.

Parameters:

key - the registry key to stop monitoring.

removeID

public static void removeID(int id)

Removes the registry key with the corresponding watch id from the list of watched keys.

Parameters:

id - the id of the registry key to remove.