org.ow2.petals.kernel.configuration
Interface ConfigurationService

All Known Implementing Classes:

ConfigurationServiceImpl

public interface ConfigurationService

The interface of the Configuration service. The service handles the configuration of the local PEtALS container.
At its starting, it retrieves the configuration from the TopologyBuilder parser and the server.properties file , it performs a first level validation of the consistency, then it fill the local ContainerInformation.
It provides a method to validate an new container against the topology.

Since:

Petals 2.0

Author:

Roland NAUDIN, chamerling - EBMWebsourcing, Charles Casadei - eBM WebSourcing

Field Summary

static java.lang.String	JAAS_PROPS_FILE
static java.lang.String	MASTER
static java.lang.String	PEER
static java.lang.String	PROPERTY_AUTOLOADER
static java.lang.String	PROPERTY_CLASSLOADER_ISOLATED
static java.lang.String	PROPERTY_CONTAINER_NAME Properties keys
static java.lang.String	PROPERTY_EXCHANGE_VALIDATION
static java.lang.String	PROPERTY_PERSISTENCE_DURATION
static java.lang.String	PROPERTY_PERSISTENCE_FETCHSIZE
static java.lang.String	PROPERTY_RECOVERY_CORE_POOL_SIZE
static java.lang.String	PROPERTY_RECOVERY_KEEP_ALIVE_TIME
static java.lang.String	PROPERTY_RECOVERY_MAX_POOL_SIZE
static java.lang.String	PROPERTY_REGISTRY_DB_DIALECT
static java.lang.String	PROPERTY_REGISTRY_DB_DRIVER
static java.lang.String	PROPERTY_REGISTRY_DB_PASSWORD
static java.lang.String	PROPERTY_REGISTRY_DB_URL
static java.lang.String	PROPERTY_REGISTRY_DB_USER
static java.lang.String	PROPERTY_REGISTRY_MODE
static java.lang.String	PROPERTY_REGISTRY_REPOSITORY
static java.lang.String	PROPERTY_REGISTRY_SYNCHRO_PERIOD
static java.lang.String	PROPERTY_REGISTRY_TRANSPORT_TIMEOUT
static java.lang.String	PROPERTY_REPOSITORY_PATH
static java.lang.String	PROPERTY_ROUTER_QOS
static java.lang.String	PROPERTY_ROUTER_SEND_ATTEMPT
static java.lang.String	PROPERTY_ROUTER_SEND_DELAY
static java.lang.String	PROPERTY_ROUTER_STRATEGY
static java.lang.String	PROPERTY_SSL_KEY_PASSWORD
static java.lang.String	PROPERTY_SSL_KEYSTORE_FILE
static java.lang.String	PROPERTY_SSL_KEYSTORE_PASSWORD
static java.lang.String	PROPERTY_SSL_TRUSTSTORE_FILE
static java.lang.String	PROPERTY_SSL_TRUSTSTORE_PASSWORD
static java.lang.String	PROPERTY_TASK_TIMEOUT
static java.lang.String	PROPERTY_TOPOLOGY_UPDATE_PERIOD
static java.lang.String	PROPERTY_TOPOLOGY_URL
static java.lang.String	PROPERTY_TRANSPORT_TCP_CONNECTION_TIMEOUT
static java.lang.String	PROPERTY_TRANSPORT_TCP_RECEIVERS
static java.lang.String	PROPERTY_TRANSPORT_TCP_SEND_EVICTABLE_DELAY
static java.lang.String	PROPERTY_TRANSPORT_TCP_SEND_EVICTOR_DELAY
static java.lang.String	PROPERTY_TRANSPORT_TCP_SEND_TIMEOUT
static java.lang.String	PROPERTY_TRANSPORT_TCP_SENDERS
static java.lang.String	PROPERTY_USER_CONFIG_PREFIX
static java.lang.String	SERVER_PROPS_FILE Name of the server properties file.
static java.lang.String	SLAVE
static java.lang.String	STANDALONE
static java.lang.String	TOPOLOGY_FILE Path of the default topology file.
static java.lang.String	TOPOLOGY_RESOURCE

Method Summary

void	addContainerConfiguration(ContainerConfiguration addedContainer) Registers a new container configuration within the local configuration.
void	addSubdomainConfiguration(SubDomainConfiguration addedSubdomain) Registers a new subdomain within the local topology.
void	backupTopology() Backups the local topology.
ContainerConfiguration	getContainerConfiguration() Get the local container configuration.
ContainerConfiguration	getContainerConfiguration(java.lang.String containerName) Get the container configuration.
java.util.Set<ContainerConfiguration>	getContainersConfiguration() Get the containers configuration.
DomainConfiguration	getDomainConfiguration() Get the domain configuration the local container belongs to.
SubDomainConfiguration	getSubDomainConfiguration() Get the sub domain configuration the local container belongs to.
java.util.Set<SubDomainConfiguration>	getSubDomainsConfiguration() Get the subdomains configuration.
org.ow2.petals.topology.generated.Topology	getTopology() Get the current topology.
void	loadTopology() Load or reload the topology.
void	removeContainerConfiguration(ContainerConfiguration removedContainer) Unregisters the subdomain within the local topology.
void	removeSubdomainConfiguration(java.lang.String removedSubdomain) Unregister a subdomain within the local topology.
void	setContainerState(ContainerConfiguration.ContainerState state) Set the running state of the local container.
void	validateDynamicTopology() Validate the dynamic topology
void	verifyContainerTopology(ContainerConfiguration newContainerConfiguration, SubDomainConfiguration newSubDomainConfiguration, DomainConfiguration newDomainConfiguration) Verify the given containerConfiguration against the topology configuration.

Field Detail

TOPOLOGY_FILE

static final java.lang.String TOPOLOGY_FILE

Path of the default topology file.

See Also:

Constant Field Values

TOPOLOGY_RESOURCE

static final java.lang.String TOPOLOGY_RESOURCE

See Also:

Constant Field Values

SERVER_PROPS_FILE

static final java.lang.String SERVER_PROPS_FILE

Name of the server properties file.

See Also:

Constant Field Values

JAAS_PROPS_FILE

static final java.lang.String JAAS_PROPS_FILE

See Also:

Constant Field Values

PROPERTY_CONTAINER_NAME

static final java.lang.String PROPERTY_CONTAINER_NAME

Properties keys

See Also:

Constant Field Values

PROPERTY_REPOSITORY_PATH

static final java.lang.String PROPERTY_REPOSITORY_PATH

See Also:

Constant Field Values

PROPERTY_TOPOLOGY_URL

static final java.lang.String PROPERTY_TOPOLOGY_URL

See Also:

Constant Field Values

PROPERTY_EXCHANGE_VALIDATION

static final java.lang.String PROPERTY_EXCHANGE_VALIDATION

See Also:

Constant Field Values

PROPERTY_ROUTER_QOS

static final java.lang.String PROPERTY_ROUTER_QOS

See Also:

Constant Field Values

PROPERTY_ROUTER_STRATEGY

static final java.lang.String PROPERTY_ROUTER_STRATEGY

See Also:

Constant Field Values

PROPERTY_ROUTER_SEND_ATTEMPT

static final java.lang.String PROPERTY_ROUTER_SEND_ATTEMPT

See Also:

Constant Field Values

PROPERTY_ROUTER_SEND_DELAY

static final java.lang.String PROPERTY_ROUTER_SEND_DELAY

See Also:

Constant Field Values

PROPERTY_TASK_TIMEOUT

static final java.lang.String PROPERTY_TASK_TIMEOUT

See Also:

Constant Field Values

PROPERTY_CLASSLOADER_ISOLATED

static final java.lang.String PROPERTY_CLASSLOADER_ISOLATED

See Also:

Constant Field Values

PROPERTY_AUTOLOADER

static final java.lang.String PROPERTY_AUTOLOADER

See Also:

Constant Field Values

PROPERTY_SSL_KEY_PASSWORD

static final java.lang.String PROPERTY_SSL_KEY_PASSWORD

See Also:

Constant Field Values

PROPERTY_SSL_KEYSTORE_FILE

static final java.lang.String PROPERTY_SSL_KEYSTORE_FILE

See Also:

Constant Field Values

PROPERTY_SSL_KEYSTORE_PASSWORD

static final java.lang.String PROPERTY_SSL_KEYSTORE_PASSWORD

See Also:

Constant Field Values

PROPERTY_SSL_TRUSTSTORE_FILE

static final java.lang.String PROPERTY_SSL_TRUSTSTORE_FILE

See Also:

Constant Field Values

PROPERTY_SSL_TRUSTSTORE_PASSWORD

static final java.lang.String PROPERTY_SSL_TRUSTSTORE_PASSWORD

See Also:

Constant Field Values

PROPERTY_TRANSPORT_TCP_RECEIVERS

static final java.lang.String PROPERTY_TRANSPORT_TCP_RECEIVERS

See Also:

Constant Field Values

PROPERTY_TRANSPORT_TCP_SENDERS

static final java.lang.String PROPERTY_TRANSPORT_TCP_SENDERS

See Also:

Constant Field Values

PROPERTY_TRANSPORT_TCP_CONNECTION_TIMEOUT

static final java.lang.String PROPERTY_TRANSPORT_TCP_CONNECTION_TIMEOUT

See Also:

Constant Field Values

PROPERTY_TRANSPORT_TCP_SEND_TIMEOUT

static final java.lang.String PROPERTY_TRANSPORT_TCP_SEND_TIMEOUT

See Also:

Constant Field Values

PROPERTY_TRANSPORT_TCP_SEND_EVICTOR_DELAY

static final java.lang.String PROPERTY_TRANSPORT_TCP_SEND_EVICTOR_DELAY

See Also:

Constant Field Values

PROPERTY_TRANSPORT_TCP_SEND_EVICTABLE_DELAY

static final java.lang.String PROPERTY_TRANSPORT_TCP_SEND_EVICTABLE_DELAY

See Also:

Constant Field Values

PROPERTY_USER_CONFIG_PREFIX

static final java.lang.String PROPERTY_USER_CONFIG_PREFIX

See Also:

Constant Field Values

PROPERTY_REGISTRY_TRANSPORT_TIMEOUT

static final java.lang.String PROPERTY_REGISTRY_TRANSPORT_TIMEOUT

See Also:

Constant Field Values

PROPERTY_REGISTRY_SYNCHRO_PERIOD

static final java.lang.String PROPERTY_REGISTRY_SYNCHRO_PERIOD

See Also:

Constant Field Values

PROPERTY_REGISTRY_REPOSITORY

static final java.lang.String PROPERTY_REGISTRY_REPOSITORY

See Also:

Constant Field Values

PROPERTY_REGISTRY_DB_DRIVER

static final java.lang.String PROPERTY_REGISTRY_DB_DRIVER

See Also:

Constant Field Values

PROPERTY_REGISTRY_DB_URL

static final java.lang.String PROPERTY_REGISTRY_DB_URL

See Also:

Constant Field Values

PROPERTY_REGISTRY_DB_USER

static final java.lang.String PROPERTY_REGISTRY_DB_USER

See Also:

Constant Field Values

PROPERTY_REGISTRY_DB_PASSWORD

static final java.lang.String PROPERTY_REGISTRY_DB_PASSWORD

See Also:

Constant Field Values

PROPERTY_REGISTRY_DB_DIALECT

static final java.lang.String PROPERTY_REGISTRY_DB_DIALECT

See Also:

Constant Field Values

PROPERTY_REGISTRY_MODE

static final java.lang.String PROPERTY_REGISTRY_MODE

See Also:

Constant Field Values

STANDALONE

static final java.lang.String STANDALONE

See Also:

Constant Field Values

PEER

static final java.lang.String PEER

See Also:

Constant Field Values

MASTER

static final java.lang.String MASTER

See Also:

Constant Field Values

SLAVE

static final java.lang.String SLAVE

See Also:

Constant Field Values

PROPERTY_TOPOLOGY_UPDATE_PERIOD

static final java.lang.String PROPERTY_TOPOLOGY_UPDATE_PERIOD

See Also:

Constant Field Values

PROPERTY_PERSISTENCE_DURATION

static final java.lang.String PROPERTY_PERSISTENCE_DURATION

See Also:

Constant Field Values

PROPERTY_PERSISTENCE_FETCHSIZE

static final java.lang.String PROPERTY_PERSISTENCE_FETCHSIZE

See Also:

Constant Field Values

PROPERTY_RECOVERY_CORE_POOL_SIZE

static final java.lang.String PROPERTY_RECOVERY_CORE_POOL_SIZE

See Also:

Constant Field Values

PROPERTY_RECOVERY_MAX_POOL_SIZE

static final java.lang.String PROPERTY_RECOVERY_MAX_POOL_SIZE

See Also:

Constant Field Values

PROPERTY_RECOVERY_KEEP_ALIVE_TIME

static final java.lang.String PROPERTY_RECOVERY_KEEP_ALIVE_TIME

See Also:

Constant Field Values

Method Detail

getContainerConfiguration

ContainerConfiguration getContainerConfiguration()

Get the local container configuration.

getContainersConfiguration

java.util.Set<ContainerConfiguration> getContainersConfiguration()

Get the containers configuration. This only returns the container configuration created at startup from local persisted data.

Returns:

getSubDomainsConfiguration

java.util.Set<SubDomainConfiguration> getSubDomainsConfiguration()

Get the subdomains configuration. This only returns the subdomain configuration created at startup from the local persisted data.

Returns:

getSubDomainConfiguration

SubDomainConfiguration getSubDomainConfiguration()

Get the sub domain configuration the local container belongs to.

Returns:

getDomainConfiguration

DomainConfiguration getDomainConfiguration()

Get the domain configuration the local container belongs to.

Returns:

getTopology

org.ow2.petals.topology.generated.Topology getTopology()
                                                       throws ConfigurationException

Get the current topology. This is the topology loaded from configuration files.

Returns:

Throws:

ConfigurationException

loadTopology

void loadTopology()
                  throws ConfigurationException

Load or reload the topology.

Throws:

ConfigurationException

setContainerState

void setContainerState(ContainerConfiguration.ContainerState state)

Set the running state of the local container.

Parameters:

state - ContainerConfiguration.ContainerState

verifyContainerTopology

void verifyContainerTopology(ContainerConfiguration newContainerConfiguration,
                             SubDomainConfiguration newSubDomainConfiguration,
                             DomainConfiguration newDomainConfiguration)
                             throws org.ow2.petals.topology.TopologyException

Verify the given containerConfiguration against the topology configuration.

Parameters:

newContainerConfiguration - The new container configuration

newSubDomainConfiguration - The new sub-domain configuration

newDomainConfiguration - The new domain configuration

Throws:

org.ow2.petals.topology.TopologyException - Inconsistency between the topology configuration and the new container configuration

getContainerConfiguration

ContainerConfiguration getContainerConfiguration(java.lang.String containerName)

Get the container configuration.

Parameters:

containerName - the name of the container to get configuration from. If null, returns the local container configuration.

Returns:

addContainerConfiguration

void addContainerConfiguration(ContainerConfiguration addedContainer)
                               throws ConfigurationException

Registers a new container configuration within the local configuration.

Parameters:

addedContainer - the container to be registered

Throws:

ConfigurationException

removeContainerConfiguration

void removeContainerConfiguration(ContainerConfiguration removedContainer)
                                  throws ConfigurationException

Unregisters the subdomain within the local topology.

Parameters:

removedContainer -

Throws:

ConfigurationException

addSubdomainConfiguration

void addSubdomainConfiguration(SubDomainConfiguration addedSubdomain)
                               throws ConfigurationException

Registers a new subdomain within the local topology.

Parameters:

addedSubdomain -

Throws:

ConfigurationException

removeSubdomainConfiguration

void removeSubdomainConfiguration(java.lang.String removedSubdomain)
                                  throws ConfigurationException

Unregister a subdomain within the local topology.

Parameters:

removedSubdomain -

Throws:

ConfigurationException

validateDynamicTopology

void validateDynamicTopology()
                             throws ConfigurationException

Validate the dynamic topology

Throws:

ConfigurationException

backupTopology

void backupTopology()
                    throws ConfigurationException

Backups the local topology.

Throws:

ConfigurationException