Module is.codion.common.db

Package is.codion.common.db.database

Interface DatabaseFactory

All Known Implementing Classes:

Db2DatabaseFactory, DerbyDatabaseFactory, H2DatabaseFactory, HSQLDatabaseFactory, MariaDBDatabaseFactory, MySQLDatabaseFactory, OracleDatabaseFactory, PostgreSQLDatabaseFactory, SQLiteDatabaseFactory, SQLServerDatabaseFactory

public interface DatabaseFactory

Provides Database implementations

See Also:

• instance()
• instance(String)
• createDatabase(String)

Method Summary

Modifier and Type	Method	Description
Database	createDatabase(String url)
static String	driverClassName(String url)
boolean	driverCompatible(String driverClassName)
static DatabaseFactory	instance()
static DatabaseFactory	instance(String url)

Method Details

driverCompatible

boolean driverCompatible(String driverClassName)

Parameters:

driverClassName - the driver class name

Returns:

true if this database factory is compatible with the given driver

createDatabase

Database createDatabase(String url)

Parameters:

url - the jdbc url

Returns:

a new Database implementation based on the given jdbc url.

instance

static DatabaseFactory instance()
                         throws SQLException

Returns:

a DatabaseFactory implementation for Database.DATABASE_URL

Throws:

IllegalStateException - in case Database.DATABASE_URL ('codion.db.url') is not specified.

IllegalArgumentException - in case no such implementation is found

SQLException - in case loading of the database driver failed

IllegalArgumentException - in case no implementation exists for the configured jdbc url

instance

static DatabaseFactory instance(String url)
                         throws SQLException

Parameters:

url - the jdbc url

Returns:

a DatabaseFactory implementation for the given jdbc url

Throws:

IllegalArgumentException - in case no such implementation is found

SQLException - in case loading of database driver failed

IllegalArgumentException - in case no implementation exists for the given jdbc url

driverClassName

static String driverClassName(String url)
                       throws SQLException

Parameters:

url - the jdbc url

Returns:

the database driver class name according to jdbc url

Throws:

SQLException - in case loading of database driver failed