org.n52.iceland.ds

Interface Datasource

All Superinterfaces:

ConnectionProviderIdentificator, DatasourceDaoIdentifier

public interface Datasource
extends ConnectionProviderIdentificator, DatasourceDaoIdentifier

Since:

1.0.0

Field Summary

Fields

Modifier and Type	Field and Description
static SettingDefinitionGroup	ADVANCED_GROUP
static SettingDefinitionGroup	BASE_GROUP

Fields inherited from interface org.n52.iceland.ds.ConnectionProviderIdentificator

CONNECTION_PROVIDER_IDENTIFIER

Fields inherited from interface org.n52.iceland.ds.DatasourceDaoIdentifier

DATASOURCE_DAO_IDENTIFIER, IDEPENDET_IDENTIFIER

Method Summary

Modifier and Type	Method and Description
boolean	checkIfSchemaExists(java.util.Map<java.lang.String,java.lang.Object> settings) Check if the schema exists.
boolean	checkIfSchemaExists(java.util.Properties current, java.util.Map<java.lang.String,java.lang.Object> newSettings) Check if the schema exists.
void	checkPostCreation(java.util.Properties properties)
boolean	checkSchemaCreation(java.util.Map<java.lang.String,java.lang.Object> settings) Check if it is possible to create the schema (e.g. test if the privilege are sufficient).
void	clear(java.util.Properties settings) Clear the contents of the datasource.
java.lang.String[]	createSchema(java.util.Map<java.lang.String,java.lang.Object> settings) Create the schema for the supplied settings.
java.lang.String[]	dropSchema(java.util.Map<java.lang.String,java.lang.Object> settings) Drop the present schema (or parts of it).
void	execute(java.lang.String[] sql, java.util.Map<java.lang.String,java.lang.Object> settings)
void	executePostCreateSchema(java.util.Map<java.lang.String,java.lang.Object> databaseSettings)
DatasourceCallback	getCallback()
java.util.Set<SettingDefinition<?>>	getChangableSettingDefinitions(java.util.Properties current)
java.util.Properties	getDatasourceProperties(java.util.Map<java.lang.String,java.lang.Object> settings) Create the datasource properties used by the ConnectionProvider to connect.
java.util.Properties	getDatasourceProperties(java.util.Properties current, java.util.Map<java.lang.String,java.lang.Object> newSettings) Create the datasource properties used by the ConnectionProvider to connect.
java.lang.String	getDialectName()
java.util.Set<SettingDefinition<?>>	getSettingDefinitions()
boolean	isPostCreateSchema()
boolean	needsSchema()
java.util.Map<java.lang.String,java.lang.Object>	parseDatasourceProperties(java.util.Properties current) Parse datasource properties to map
void	prepare(java.util.Map<java.lang.String,java.lang.Object> settings) Called right before a schema is created.
boolean	supportsClear()
java.lang.String[]	updateSchema(java.util.Map<java.lang.String,java.lang.Object> settings) Creates an update schema for the supplied settings.
void	validateConnection(java.util.Map<java.lang.String,java.lang.Object> settings) Check if a connection is possible.
void	validateConnection(java.util.Properties current, java.util.Map<java.lang.String,java.lang.Object> newSettings) Check if a connection is still possible with the newSettings settings.
void	validatePrerequisites(java.util.Map<java.lang.String,java.lang.Object> settings) Validate if all prerequisites (e.g. datasource version) are met.
void	validatePrerequisites(java.util.Properties current, java.util.Map<java.lang.String,java.lang.Object> newSettings) Used to validate prerequisites after the connections settings newSettings in the admin interface.
void	validateSchema(java.util.Map<java.lang.String,java.lang.Object> settings) Validate the existing schema.
void	validateSchema(java.util.Properties current, java.util.Map<java.lang.String,java.lang.Object> newSettings) Validate the existing schema.

Methods inherited from interface org.n52.iceland.ds.ConnectionProviderIdentificator

getConnectionProviderIdentifier

Methods inherited from interface org.n52.iceland.ds.DatasourceDaoIdentifier

getDatasourceDaoIdentifier

Field Detail

BASE_GROUP

static final SettingDefinitionGroup BASE_GROUP

ADVANCED_GROUP

static final SettingDefinitionGroup ADVANCED_GROUP

Method Detail

getDialectName

java.lang.String getDialectName()

Returns:

the representive name of this dialect

getSettingDefinitions

java.util.Set<SettingDefinition<?>> getSettingDefinitions()

Returns:

the settings needed to connect

getChangableSettingDefinitions

java.util.Set<SettingDefinition<?>> getChangableSettingDefinitions(java.util.Properties current)

Parameters:

current - the current settings

Returns:

the settings that can be newSettings without schema without reinstallation

parseDatasourceProperties

java.util.Map<java.lang.String,java.lang.Object> parseDatasourceProperties(java.util.Properties current)

Parse datasource properties to map

Parameters:

current - Current datasource properties

Returns:

Map with String key and Object value

validateConnection

void validateConnection(java.util.Map<java.lang.String,java.lang.Object> settings)

Check if a connection is possible.

Parameters:

settings - the settings to connect

validateConnection

void validateConnection(java.util.Properties current,
                        java.util.Map<java.lang.String,java.lang.Object> newSettings)

Check if a connection is still possible with the newSettings settings.

Parameters:

current - the current datasource settings

newSettings - the newSettings settings

validatePrerequisites

void validatePrerequisites(java.util.Map<java.lang.String,java.lang.Object> settings)

Validate if all prerequisites (e.g. datasource version) are met. Will only be called if validateConnection() succeeded.

Parameters:

settings - the settings to connect

validatePrerequisites

void validatePrerequisites(java.util.Properties current,
                           java.util.Map<java.lang.String,java.lang.Object> newSettings)

Used to validate prerequisites after the connections settings newSettings in the admin interface.

Parameters:

current - the current datasource settings

newSettings - the newSettings settings

needsSchema

boolean needsSchema()

Returns:

if this datasource needs some kind of schema

validateSchema

void validateSchema(java.util.Map<java.lang.String,java.lang.Object> settings)

Validate the existing schema. Will only be called if needsSchema() and checkIfSchemaExists() return true.

Parameters:

settings - the settings to connect

validateSchema

void validateSchema(java.util.Properties current,
                    java.util.Map<java.lang.String,java.lang.Object> newSettings)

Validate the existing schema. Will only be called if needsSchema() and checkIfSchemaExists() return true.

Parameters:

current - the current datasource settings

newSettings - the newSettings settings

checkIfSchemaExists

boolean checkIfSchemaExists(java.util.Map<java.lang.String,java.lang.Object> settings)

Check if the schema exists. Should return true even if parts are missing. Will only be called if needsSchema() returns true.

Parameters:

settings - the settings to connect

Returns:

if the schema (or parts of it) exists

checkIfSchemaExists

boolean checkIfSchemaExists(java.util.Properties current,
                            java.util.Map<java.lang.String,java.lang.Object> newSettings)

Check if the schema exists. Should return true even if parts are missing. Will only be called if needsSchema() returns true.

Parameters:

current - the current datasource settings

newSettings - the newSettings settings

Returns:

if the schema (or parts of it) exists

checkSchemaCreation

boolean checkSchemaCreation(java.util.Map<java.lang.String,java.lang.Object> settings)

Check if it is possible to create the schema (e.g. test if the privilege are sufficient). Will only be called if needsSchema() returns true.

Parameters:

settings - the settings to connect

Returns:

if the creation if the schema is possible

createSchema

java.lang.String[] createSchema(java.util.Map<java.lang.String,java.lang.Object> settings)

Create the schema for the supplied settings. Will only be called if needsSchema() and checkSchemaCreation() return true. If checkIfSchemaExists() returned true, dropSchema() will be called first.

Parameters:

settings - the settings to connect

Returns:

an array of DDL statements

dropSchema

java.lang.String[] dropSchema(java.util.Map<java.lang.String,java.lang.Object> settings)

Drop the present schema (or parts of it). Will only be called if needsSchema() and checkIfSchemaExists() return true.

Parameters:

settings - the settings to connect

Returns:

an array of DDL statements

updateSchema

java.lang.String[] updateSchema(java.util.Map<java.lang.String,java.lang.Object> settings)

Creates an update schema for the supplied settings. Will only be called if needsSchema() and checkSchemaCreation() return true. If checkIfSchemaExists() returned true, dropSchema() will be called first.

Parameters:

settings - the settings to connect

Returns:

an array of DDL statements

execute

void execute(java.lang.String[] sql,
             java.util.Map<java.lang.String,java.lang.Object> settings)

clear

void clear(java.util.Properties settings)

Clear the contents of the datasource. Only called if supportsClear() returns true.

Parameters:

settings - the settings to connect

supportsClear

boolean supportsClear()

Returns:

true

getDatasourceProperties

java.util.Properties getDatasourceProperties(java.util.Map<java.lang.String,java.lang.Object> settings)

Create the datasource properties used by the ConnectionProvider to connect.

Parameters:

settings - the settings to connect

Returns:

the datasource properties

getDatasourceProperties

java.util.Properties getDatasourceProperties(java.util.Properties current,
                                             java.util.Map<java.lang.String,java.lang.Object> newSettings)

Create the datasource properties used by the ConnectionProvider to connect.

Parameters:

current - the current datasource settings

newSettings - the newSettings settings

Returns:

the new datasource properties

getCallback

DatasourceCallback getCallback()

Returns:

the callback used at instantiation time of the connection provider

prepare

void prepare(java.util.Map<java.lang.String,java.lang.Object> settings)

Called right before a schema is created.

Parameters:

settings - the settings to connect

isPostCreateSchema

boolean isPostCreateSchema()

executePostCreateSchema

void executePostCreateSchema(java.util.Map<java.lang.String,java.lang.Object> databaseSettings)

checkPostCreation

void checkPostCreation(java.util.Properties properties)