org.eclipse.jetty.security

Class PropertyUserStore

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.security.PropertyUserStore

All Implemented Interfaces:

EventListener, LifeCycle, PathWatcher.Listener

public class PropertyUserStore
extends AbstractLifeCycle
implements PathWatcher.Listener

PropertyUserStore

This class monitors a property file of the format mentioned below and notifies registered listeners of the changes to the the given file.

  username: password [,rolename ...]
 

Passwords may be clear text, obfuscated or checksummed. The class com.eclipse.Util.Password should be used to generate obfuscated passwords or password checksums. If DIGEST Authentication is used, the password must be in a recoverable format, either plain text or OBF:.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	PropertyUserStore.UserListener UserListener

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOP_ON_FAILURE, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
PropertyUserStore()

Method Summary

Modifier and Type	Method and Description
protected void	doStart() Depending on the value of the refresh interval, this method will either start up a scanner thread that will monitor the properties file for changes after it has initially loaded it.
protected void	doStop()
String	getConfig() Deprecated. use getConfigPath() instead
Path	getConfigPath() Get the Config Path reference.
Resource	getConfigResource()
int	getRefreshInterval() Deprecated. use isHotReload() instead
UserIdentity	getUserIdentity(String userName)
boolean	isHotReload() Is hot reload enabled on this user store
void	onPathWatchEvent(PathWatcher.PathWatchEvent event)
void	registerUserListener(PropertyUserStore.UserListener listener) registers a listener to be notified of the contents of the property file
void	setConfig(String config) Set the Config Path from a String reference to a file
void	setConfigPath(File configFile) Set the Config Path from a File reference
void	setConfigPath(Path configPath) Set the Config Path
void	setConfigPath(String configFile) Set the Config Path from a String reference to a file
void	setHotReload(boolean enable) Enable Hot Reload of the Property File
void	setRefreshInterval(int sec) Deprecated. use setHotReload(boolean) instead
String	toString()

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, setStopTimeout, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

PropertyUserStore

public PropertyUserStore()

Method Detail

getConfig

@Deprecated
public String getConfig()

Deprecated. use getConfigPath() instead

Get the config (as a string)

Returns:

the config path as a string

setConfig

public void setConfig(String config)

Set the Config Path from a String reference to a file

Parameters:

config - the config file

getConfigPath

public Path getConfigPath()

Get the Config Path reference.

Returns:

the config path

setConfigPath

public void setConfigPath(String configFile)

Set the Config Path from a String reference to a file

Parameters:

configFile - the config file

setConfigPath

public void setConfigPath(File configFile)

Set the Config Path from a File reference

Parameters:

configFile - the config file

setConfigPath

public void setConfigPath(Path configPath)

Set the Config Path

Parameters:

configPath - the config path

getUserIdentity

public UserIdentity getUserIdentity(String userName)

getConfigResource

public Resource getConfigResource()
                           throws IOException

Returns:

the resource associated with the configured properties file, creating it if necessary

Throws:

IOException - if unable to get the resource

isHotReload

public boolean isHotReload()

Is hot reload enabled on this user store

Returns:

true if hot reload was enabled before startup

setHotReload

public void setHotReload(boolean enable)

Enable Hot Reload of the Property File

Parameters:

enable - true to enable, false to disable

setRefreshInterval

@Deprecated
public void setRefreshInterval(int sec)

Deprecated. use setHotReload(boolean) instead

sets the refresh interval (in seconds)

Parameters:

sec - the refresh interval

getRefreshInterval

@Deprecated
public int getRefreshInterval()

Deprecated. use isHotReload() instead

Returns:

refresh interval in seconds for how often the properties file should be checked for changes

toString

public String toString()

Overrides:

toString in class Object

doStart

protected void doStart()
                throws Exception

Depending on the value of the refresh interval, this method will either start up a scanner thread that will monitor the properties file for changes after it has initially loaded it. Otherwise the users will be loaded and there will be no active monitoring thread so changes will not be detected.

Overrides:

doStart in class AbstractLifeCycle

Throws:

Exception

See Also:

AbstractLifeCycle.doStart()

onPathWatchEvent

public void onPathWatchEvent(PathWatcher.PathWatchEvent event)

Specified by:

onPathWatchEvent in interface PathWatcher.Listener

doStop

protected void doStop()
               throws Exception

Overrides:

doStop in class AbstractLifeCycle

Throws:

Exception

See Also:

AbstractLifeCycle.doStop()

registerUserListener

public void registerUserListener(PropertyUserStore.UserListener listener)

registers a listener to be notified of the contents of the property file

Parameters:

listener - the user listener