org.apache.felix.fileinstall.internal

Class DirectoryWatcher

java.lang.Object

java.lang.Thread

org.apache.felix.fileinstall.internal.DirectoryWatcher

All Implemented Interfaces:

java.lang.Runnable, java.util.EventListener, org.osgi.framework.BundleListener

public class DirectoryWatcher
extends java.lang.Thread
implements org.osgi.framework.BundleListener

-DirectoryWatcher- This class runs a background task that checks a directory for new files or removed files. These files can be configuration files or jars. For jar files, its behavior is defined below: - If there are new jar files, it installs them and optionally starts them. - If it fails to install a jar, it does not try to install it again until the jar has been modified. - If it fail to start a bundle, it attempts to start it in following iterations until it succeeds or the corresponding jar is uninstalled. - If some jar files have been deleted, it uninstalls them. - If some jar files have been updated, it updates them. - If it fails to update a bundle, it tries to update it in following iterations until it is successful. - If any bundle gets updated or uninstalled, it refreshes the framework for the changes to take effect. - If it detects any new installations, uninstallations or updations, it tries to start all the managed bundle unless it has been configured to only install bundles.

Author:

Felix Project Team

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ACTIVE_LEVEL
static java.lang.String	DIR
static java.lang.String	DISABLE_CONFIG_SAVE
static java.lang.String	DISABLE_NIO2
static java.lang.String	ENABLE_CONFIG_SAVE
static java.lang.String	FILENAME
static java.lang.String	FILTER
static java.lang.String	FRAGMENT_SCOPE
static java.lang.String	LOG_DEFAULT
static java.lang.String	LOG_JUL
static java.lang.String	LOG_LEVEL
static java.lang.String	LOG_STDOUT
static java.lang.String	NO_INITIAL_DELAY
static java.lang.String	OPTIONAL_SCOPE
static java.lang.String	POLL
static java.lang.String	SCOPE_ALL
static java.lang.String	SCOPE_MANAGED
static java.lang.String	SCOPE_NONE
static java.lang.String	START_LEVEL
static java.lang.String	START_NEW_BUNDLES
static java.lang.String	SUBDIR_MODE
static java.lang.String	TMPDIR
static java.lang.String	UPDATE_WITH_LISTENERS
static java.lang.String	USE_START_ACTIVATION_POLICY
static java.lang.String	USE_START_TRANSIENT

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
DirectoryWatcher(FileInstall fileInstall, java.util.Map<java.lang.String,java.lang.String> properties, org.osgi.framework.BundleContext context)

Method Summary

Modifier and Type	Method and Description
void	addListener(ArtifactListener listener, long stamp)
void	bundleChanged(org.osgi.framework.BundleEvent bundleEvent)
void	close()
protected void	findBundlesWithFragmentsToRefresh(java.util.Set<org.osgi.framework.Bundle> toRefresh)
protected void	findBundlesWithOptionalPackagesToRefresh(java.util.Set<org.osgi.framework.Bundle> toRefresh)
protected java.util.List<org.apache.felix.utils.manifest.Clause>	getOptionalImports(java.lang.String importsStr)
java.util.Map<java.lang.String,java.lang.String>	getProperties()
protected java.util.Set<org.osgi.framework.Bundle>	getScopedBundles(java.lang.String scope)
static java.lang.String	getThreadName(java.util.Map<java.lang.String,java.lang.String> properties)
void	removeListener(ArtifactListener listener)
void	run() Main run loop, will traverse the directory, and then handle the delta between installed and newly found/lost bundles and configurations.
void	start()

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

FILENAME

public static final java.lang.String FILENAME

See Also:

Constant Field Values

POLL

public static final java.lang.String POLL

See Also:

Constant Field Values

DIR

public static final java.lang.String DIR

See Also:

Constant Field Values

LOG_LEVEL

public static final java.lang.String LOG_LEVEL

See Also:

Constant Field Values

LOG_DEFAULT

public static final java.lang.String LOG_DEFAULT

See Also:

Constant Field Values

TMPDIR

public static final java.lang.String TMPDIR

See Also:

Constant Field Values

FILTER

public static final java.lang.String FILTER

See Also:

Constant Field Values

START_NEW_BUNDLES

public static final java.lang.String START_NEW_BUNDLES

See Also:

Constant Field Values

USE_START_TRANSIENT

public static final java.lang.String USE_START_TRANSIENT

See Also:

Constant Field Values

USE_START_ACTIVATION_POLICY

public static final java.lang.String USE_START_ACTIVATION_POLICY

See Also:

Constant Field Values

NO_INITIAL_DELAY

public static final java.lang.String NO_INITIAL_DELAY

See Also:

Constant Field Values

DISABLE_CONFIG_SAVE

public static final java.lang.String DISABLE_CONFIG_SAVE

See Also:

Constant Field Values

ENABLE_CONFIG_SAVE

public static final java.lang.String ENABLE_CONFIG_SAVE

See Also:

Constant Field Values

START_LEVEL

public static final java.lang.String START_LEVEL

See Also:

Constant Field Values

ACTIVE_LEVEL

public static final java.lang.String ACTIVE_LEVEL

See Also:

Constant Field Values

UPDATE_WITH_LISTENERS

public static final java.lang.String UPDATE_WITH_LISTENERS

See Also:

Constant Field Values

OPTIONAL_SCOPE

public static final java.lang.String OPTIONAL_SCOPE

See Also:

Constant Field Values

FRAGMENT_SCOPE

public static final java.lang.String FRAGMENT_SCOPE

See Also:

Constant Field Values

DISABLE_NIO2

public static final java.lang.String DISABLE_NIO2

See Also:

Constant Field Values

SUBDIR_MODE

public static final java.lang.String SUBDIR_MODE

See Also:

Constant Field Values

SCOPE_NONE

public static final java.lang.String SCOPE_NONE

See Also:

Constant Field Values

SCOPE_MANAGED

public static final java.lang.String SCOPE_MANAGED

See Also:

Constant Field Values

SCOPE_ALL

public static final java.lang.String SCOPE_ALL

See Also:

Constant Field Values

LOG_STDOUT

public static final java.lang.String LOG_STDOUT

See Also:

Constant Field Values

LOG_JUL

public static final java.lang.String LOG_JUL

See Also:

Constant Field Values

Constructor Detail

DirectoryWatcher

public DirectoryWatcher(FileInstall fileInstall,
                        java.util.Map<java.lang.String,java.lang.String> properties,
                        org.osgi.framework.BundleContext context)

Method Detail

getThreadName

public static java.lang.String getThreadName(java.util.Map<java.lang.String,java.lang.String> properties)

getProperties

public java.util.Map<java.lang.String,java.lang.String> getProperties()

start

public void start()

Overrides:

start in class java.lang.Thread

run

public void run()

Main run loop, will traverse the directory, and then handle the delta between installed and newly found/lost bundles and configurations.

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

bundleChanged

public void bundleChanged(org.osgi.framework.BundleEvent bundleEvent)

Specified by:

bundleChanged in interface org.osgi.framework.BundleListener

close

public void close()

getScopedBundles

protected java.util.Set<org.osgi.framework.Bundle> getScopedBundles(java.lang.String scope)

findBundlesWithFragmentsToRefresh

protected void findBundlesWithFragmentsToRefresh(java.util.Set<org.osgi.framework.Bundle> toRefresh)

findBundlesWithOptionalPackagesToRefresh

protected void findBundlesWithOptionalPackagesToRefresh(java.util.Set<org.osgi.framework.Bundle> toRefresh)

getOptionalImports

protected java.util.List<org.apache.felix.utils.manifest.Clause> getOptionalImports(java.lang.String importsStr)

addListener

public void addListener(ArtifactListener listener,
                        long stamp)

removeListener

public void removeListener(ArtifactListener listener)