org.eclipse.equinox.internal.provisional.configurator

Interface Configurator

All Known Implementing Classes:

SimpleConfiguratorImpl

public interface Configurator

The implementation of this interface will be registered into a service registry by a Configurator Bundle. The client bundle can apply configuration which can be interpreted by referring the specified location to the current running OSGi environment. In addition, the client can expect bundle state in advance . TODO: this interface might not be required to be defined. ********************************************** Current Definition of Configurator Bundle: Configurator Bundle will do the following operation at its startup. 1. Create a Configurator object. 2. Register it as a service to the service registry. 3. Get where to read for knowing what kinds of bundles in its implementation dependent way. 4. Call applyConfiguration(URL) with the URL. At its stopping, the service registered will be unregistered. see org.eclipse.equinox.internal.provisional.configuratormanipulato.ConfiguratorManipulator

Method Summary

Modifier and Type	Method and Description
void	applyConfiguration() Apply configuration read from the previously used url to the OSGi environment currently running.
void	applyConfiguration(java.net.URL url) Apply configuration read from the specified url to the OSGi environment currently running.
java.net.URL	getUrlInUse() Return the url in use.

Method Detail

applyConfiguration

void applyConfiguration(java.net.URL url)
                 throws java.io.IOException

Apply configuration read from the specified url to the OSGi environment currently running.

Parameters:

url - URL to be read.

Throws:

java.io.IOException - - If reading information from the specified url fails.

applyConfiguration

void applyConfiguration()
                 throws java.io.IOException

Apply configuration read from the previously used url to the OSGi environment currently running. If it is never used, do nothing.

Throws:

java.io.IOException - - If reading information from the specified url fails.

getUrlInUse

java.net.URL getUrlInUse()

Return the url in use. If it is never used, return null.

Returns:

URL