Class AbstractConfigurator

public abstract class AbstractConfigurator

An abstract PlatformConfigurator implementation that provides application callbacks for PlatformConfig generation and update prior to Platform startup. The default backing configurator is ext:config Configurator that is overridable via a constructor. Applications can register their implementation with the Platform in addition to adding application specific resources that will be copied to the JXTA_HOME prior to startup.

james todd [gonzo at jxta dot org]

$Id: AbstractConfigurator.java,v 1.2 2005/06/01 16:42:55 gonzo Exp $

Inner Class Summary
final class	AbstractConfigurator.ConfiguratorWrapper

Field Summary
static Configurator	configurator
private final static String	DEFAULT_JXTA_PROPERTIES
private final static String	DEFAULT_PROFILE
public final static String	JXTA_PROPERTIES_KEY jxta.properties resource name.
private final static Logger	LOG
public final static String	PROFILE_KEY ext:config profile resource name.
private final static Map	resources

Constructor Summary
public	AbstractConfigurator()
public	AbstractConfigurator(Configurator configurator) Constructor which overrides the backing `Configurator`.

Method Summary
public static String	addResource(String key, String value) Resource setter.
public static void	addResources(Map resources) Resource setter.
public static Map	clearResources() Resource clearer.
public abstract PlatformConfig	createPlatformConfig(Configurator configurator) Application callback invoked upon registered `Configurators` prior to Platform startup when a newly created `PlatformConfig is required.`
public ConfigParams	getConfigParams() {@inheritDoc}
public URI	getJXTAHome() {@inheritDoc}
private File	getJXTAHomeFile()
public PlatformConfig	getPlatformConfig() {@inheritDoc}
public static String	getResource(String key) Resource accessor.
public static Iterator	getResourceKeys() Resource key iterator.
public boolean	isReconfigure() {@inheritDoc}
public ConfigParams	load() {@inheritDoc}
public PlatformConfig	load(File pc) {@inheritDoc}
private void	manageResources()
public static void	register(Class configurator) Registers a delgate `Configurator` class with the Platform that will manage configuration resources.
public static String	removeResource(String key) Resource remover.
public boolean	save() {@inheritDoc}
public boolean	save(File f) {@inheritDoc}
public void	setConfigParams(ConfigParams cp) {@inheritDoc}
public void	setPlatformConfig(PlatformConfig config) {@inheritDoc}
public void	setReconfigure(boolean reconfigure) {@inheritDoc}
public PlatformConfig	updatePlatformConfig(Configurator configurator) Application callback invoked upon registered `Configurators` prior to Platform startup.

DEFAULT_JXTA_PROPERTIES

private final static String DEFAULT_JXTA_PROPERTIES = "/jxta.properties"

private final static String DEFAULT_PROFILE = "/net/jxta/ext/config/resources/edge.xml"

public final static String JXTA_PROPERTIES_KEY = "jxta.properties"

jxta.properties resource name.

private final static Logger LOG = Logger.getLogger(AbstractConfigurator.class.getName())

public final static String PROFILE_KEY = "profile.xml"

ext:config profile resource name.

private final static Map resources = new HashMap()

AbstractConfigurator

public AbstractConfigurator()

AbstractConfigurator

public AbstractConfigurator(Configurator configurator)

Constructor which overrides the backing Configurator.

configurator configurator delegate

public static String addResource(String key, String value)

resource management will be moved to instance members.

key resource key
value resource value

previous keyed value or null

public static void addResources(Map resources)

resource management will be moved to instance members.

resources resource map

public static Map clearResources()

resource management will be moved to instance members.

createPlatformConfig

public abstract PlatformConfig createPlatformConfig(Configurator configurator)

Application callback invoked upon registered Configurators prior to Platform startup when a newly created

PlatformConfig is required.

A ConfiguratorException will be thrown in the event the
manufactured PlatformConfig is invalid.

ConfiguratorException

configurator delegate Configurator

PlatformConfig generated PlatformConfig

public ConfigParams getConfigParams()

ConfiguratorException

public URI getJXTAHome()

private File getJXTAHomeFile()

public PlatformConfig getPlatformConfig()

ConfiguratorException

public static String getResource(String key)

resource management will be moved to instance members.

public static Iterator getResourceKeys()

Resource key iterator. note: not thread safe

resource management will be moved to instance members.

public boolean isReconfigure()

public PlatformConfig load(File pc)

ConfiguratorException

public ConfigParams load()

ConfiguratorException

private void manageResources()

public static void register(Class configurator)

Registers a delgate Configurator class with the Platform that will manage configuration resources.

public static String removeResource(String key)

resource management will be moved to instance members.

public boolean save(File f)

ConfiguratorException

public boolean save()

ConfiguratorException

public void setConfigParams(ConfigParams cp)

public void setPlatformConfig(PlatformConfig config)

public void setReconfigure(boolean reconfigure)

updatePlatformConfig

public PlatformConfig updatePlatformConfig(Configurator configurator)

Application callback invoked upon registered Configurators prior to Platform startup. A ConfiguratorException will be thrown in the event the manufactured PlatformConfig is invalid.

ConfiguratorException

configurator delegate Configurator

PlatformConfig updated PlatformConfig