com.prosyst.mprm.backend.database

Interface ConfigurableDBService

public interface ConfigurableDBService

This interface must be registered by bundles which provides database service, in order to enable mprm system service to pass them database configuration. The service must be registered with the following properies:

• 'database.name'=database_name - the name of logical database which the bundle operates.
• DB_SERVICE_PID=db_service_pid - database configuration pid this service expects.

This name should be some of the names returned by method DatabaseConfiguration.getConfigurableDatabases(). The bundle usually registers this service before registration of actual database service which provides methods for managing the information stored in the database. The actual service registration is made after it obtains configuration and connection to the appropriate database server.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DB_SERVICE_PID Every db service will be exported into the framework registry with this property & value of type String or String array in order to receive the appropreate configurations when setConfiguration(java.util.Dictionary[] configuration) method is invoked.

Method Summary

Modifier and Type	Method and Description
void	setConfiguration(java.util.Dictionary[] configuration) This method is invoked by mPRM system service to pass database service configuration objects when they become available.

Field Detail

DB_SERVICE_PID

static final java.lang.String DB_SERVICE_PID

Every db service will be exported into the framework registry with this property & value of type String or String array in order to receive the appropreate configurations when setConfiguration(java.util.Dictionary[] configuration) method is invoked.

See Also:

Constant Field Values

Method Detail

setConfiguration

void setConfiguration(java.util.Dictionary[] configuration)
               throws DatabaseException

This method is invoked by mPRM system service to pass database service configuration objects when they become available. If the configuration is already known in the moment of the service regsitration mPRM passes configuration immediately.

Parameters:

configuration - array of dictionary objects containing database configuration applicable to the specified database. The array will typically contain only one element, but it is possible to contain more than one dictionary objects with different pids.

Throws:

DatabaseException