org.jcoderz.commons.config
Interface ConfigurationServiceInterface

All Superinterfaces:

ConfigurationServiceCommonInterface

All Known Subinterfaces:

ConfigurationService

All Known Implementing Classes:

ConfigurationServiceBean, ConfigurationServiceImpl, ConfigurationServiceSession

public interface ConfigurationServiceInterface
extends ConfigurationServiceCommonInterface

ConfigurationService's business interface in order to fetch specific configuration data. On this level only primitive types String, int, long and boolean are used. The well formed and complex typed interfaces for the specific services are using this more simple interface. A factory method is provided to get the service specific typed interface. The service specific, well formed and typed interfaces and their implementation is generated by XSLT. For notifications of cache updates a registration for a ConfigurationListener is provided.

Method Summary

void	addConfigurationListener(ConfigurationListener listener) ConfigurationListener instance that will be registered to receive notifications.
ServiceConfiguration	getServiceConfiguration(String classname) gets the ServiceConfiguration interface related to the given *Service*Configuration classname.

Methods inherited from interface org.jcoderz.commons.config.ConfigurationServiceCommonInterface

getBoolean, getInt, getLong, getString

Method Detail

getServiceConfiguration

ServiceConfiguration getServiceConfiguration(String classname)
                                             throws RemoteException,
                                                    ArgumentMalformedException,
                                                    ConfigurationFactoryFailedException

gets the ServiceConfiguration interface related to the given *Service*Configuration classname. This is the factory method that is used in the generated Container and Client Factories for the given service.

Parameters:

classname - the service configuration interface classname (full qualified) for which the ServiceConfiguration interface should be created. The classname MUST include the complete package path.

Returns:

the related ServiceConfiguration instance

Throws:

RemoteException - if a remote call fails.

ArgumentMalformedException - Is thrown to indicate the illegal use of a null object as input parameter.

ConfigurationFactoryFailedException - if no ServiceConfiguration instance for the given application service could be found/created.

addConfigurationListener

void addConfigurationListener(ConfigurationListener listener)
                              throws RemoteException,
                                     ArgumentMalformedException

ConfigurationListener instance that will be registered to receive notifications.

Parameters:

listener - ConfigurationListener instance that will be registered to receive notifications.

Throws:

RemoteException - if a remote call fails.

ArgumentMalformedException - Is thrown to indicate the illegal use of a null object as input parameter.