org.eclipse.scada.ca.common.factory

Class AbstractServiceConfigurationFactory<T>

java.lang.Object

org.eclipse.scada.ca.common.factory.AbstractServiceConfigurationFactory<T>

All Implemented Interfaces:

ConfigurationFactory

Direct Known Subclasses:

AbstractMonitorFactory, AverageDataSourceFactory, BeanConfigurationFactory, BlockHandlerFactoryImpl, BufferedDatasourceFactory, ChangeCounterDataSourceFactory, CommonSumHandlerFactoryImpl, ConfigurationFactoryImpl, ConfigurationFactoryImpl, ConfiguredValueMapperFactory, ConstantDataSourceFactory, DataItemSourceFactoryImpl, DataItemTargetFactoryImpl, DataSourceLoggerFactory, DataStoreSourceFactory, DeltaDataSourceFactory, EventMonitorFactory, EventPoolConfigurationFactory, ExporterFactoryImpl, FactoryImpl, FactoryImpl, FormulaSourceFactory, InfoServiceFactory, JdbcAuthenticationServiceFactory, JdbcValueMapperFactory, ManualHandlerFactoryImpl, MapperHandlerFactoryImpl, MarkerHandlerFactoryImpl, MasterFactory, MasterFactory, MemorySourceFactory, MovingAverageDataSourceFactory, NegateHandlerFactoryImpl, ProxyDataSourceFactory, ProxyEventQueryFactory, ProxyItemFactory, ProxyMonitorQueryFactory, QueryServiceFactory, ReceiverServiceFactory, RoundHandlerFactoryImpl, ScaleHandlerFactoryImpl, ScriptComponentFactory, ScriptMonitorFactory, ScriptSourceFactory, SlaveFactory, SumSourceFactory, TimeItemFactory, TotalizerDataSourceFactory

public abstract class AbstractServiceConfigurationFactory<T>
extends Object
implements ConfigurationFactory

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractServiceConfigurationFactory.Entry<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected org.osgi.framework.BundleContext	context

Constructor Summary

Constructors

Constructor and Description
AbstractServiceConfigurationFactory(org.osgi.framework.BundleContext context)
AbstractServiceConfigurationFactory(org.osgi.framework.BundleContext context, boolean canOnlyRecreate)

Method Summary

Modifier and Type	Method and Description
protected abstract AbstractServiceConfigurationFactory.Entry<T>	createService(UserInformation userInformation, String configurationId, org.osgi.framework.BundleContext context, Map<String,String> parameters) Create a new service instance
void	delete(UserInformation userInformation, String configurationId) receive configuration delete request
void	dispose()
protected abstract void	disposeService(UserInformation userInformation, String configurationId, T service) Dispose a service
protected AbstractServiceConfigurationFactory.Entry<T>	getService(String configurationId)
protected void	unregisterService(AbstractServiceConfigurationFactory.Entry<T> entry) Unregister the service entry with OSGi
void	update(UserInformation userInformation, String configurationId, Map<String,String> parameters) receive configuration update
protected abstract AbstractServiceConfigurationFactory.Entry<T>	updateService(UserInformation userInformation, String configurationId, AbstractServiceConfigurationFactory.Entry<T> entry, Map<String,String> parameters) Update a service configuration

Methods inherited from class java.lang.Object

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

Field Detail

context

protected final org.osgi.framework.BundleContext context

Constructor Detail

AbstractServiceConfigurationFactory

public AbstractServiceConfigurationFactory(org.osgi.framework.BundleContext context)

AbstractServiceConfigurationFactory

public AbstractServiceConfigurationFactory(org.osgi.framework.BundleContext context,
                                           boolean canOnlyRecreate)

Method Detail

dispose

public void dispose()

unregisterService

protected void unregisterService(AbstractServiceConfigurationFactory.Entry<T> entry)

Unregister the service entry with OSGi

Parameters:

entry - the entry to unregister

delete

public void delete(UserInformation userInformation,
                   String configurationId)
            throws Exception

Description copied from interface: ConfigurationFactory

receive configuration delete request

Specified by:

delete in interface ConfigurationFactory

Parameters:

userInformation - the principal that performed the change, may be null

configurationId - the configuration object to change

Throws:

Exception - can be thrown if anything goes wrong changing the configuration

update

public void update(UserInformation userInformation,
                   String configurationId,
                   Map<String,String> parameters)
            throws Exception

Description copied from interface: ConfigurationFactory

receive configuration update

Specified by:

update in interface ConfigurationFactory

Parameters:

userInformation - the principal that performed the change, may be null

configurationId - the configuration object to change

parameters - the new properties

Throws:

Exception - can be thrown if anything goes wrong changing the configuration

createService

protected abstract AbstractServiceConfigurationFactory.Entry<T> createService(UserInformation userInformation,
                                                                              String configurationId,
                                                                              org.osgi.framework.BundleContext context,
                                                                              Map<String,String> parameters)
                                                                       throws Exception

Create a new service instance

The method must also register the service with the OSGi bundle context if needed. The service registration must then be placed into the result that is returned. This is an optional step. There is no need to register the created service.

Parameters:

principal -

configurationId - the configuration id for which the service should be created

context - the bundle context

parameters - the initial parameters

Returns:

a new entry instance which holds the service. This method must never return null

Throws:

Exception - if anything goes wrong

disposeService

protected abstract void disposeService(UserInformation userInformation,
                                       String configurationId,
                                       T service)

Dispose a service

If the service entry contains a service handle, the service is automatically unregistered.

Parameters:

userInformation -

configurationId -

service -

updateService

protected abstract AbstractServiceConfigurationFactory.Entry<T> updateService(UserInformation userInformation,
                                                                              String configurationId,
                                                                              AbstractServiceConfigurationFactory.Entry<T> entry,
                                                                              Map<String,String> parameters)
                                                                       throws Exception

Update a service configuration

If a new service entry is returned the old one will get disposed after the call returns

Parameters:

principal -

configurationId - the configuration to update

entry - the original service entry

parameters - the new parameters

Returns:

the new service entry or null if the entry did not change

Throws:

Exception - if anything goes wrong

getService

protected AbstractServiceConfigurationFactory.Entry<T> getService(String configurationId)