manifold.sql.rt.util

Enum DriverInfo

java.lang.Object

java.lang.Enum<DriverInfo>

manifold.sql.rt.util.DriverInfo

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<DriverInfo>

public enum DriverInfo
extends java.lang.Enum<DriverInfo>

Enum Constant Summary

Enum Constants

Enum Constant and Description
ERRANT
H2
MySQL
Oracle
Postgres
SQLite
SqlServer
UNTESTED

Field Summary

Fields

Modifier and Type	Field and Description
static org.slf4j.Logger	LOGGER

Method Summary

Modifier and Type	Method and Description
boolean	flakyParameterMetadata() (circus music) Some drivers don't provide query parameter types when the parameter's value is not set O_o For instance, depending on the version, SQLite will either return VARCHAR for all parameters or it will throw an exception when a parameter is not set.
java.lang.String	getDriverBaseName()
java.util.Map<java.lang.String,java.util.Set<java.lang.String>>	getDriversInUse() For logging/testing purposes, helps to know the full driver name.
static DriverInfo	lookup(java.sql.DatabaseMetaData metadata)
boolean	requiresQueryExecForTableName() Some drivers' query column metadata does not provide the table name info if the query is not first executed before metadata collected.
static DriverInfo	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static DriverInfo[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

H2

public static final DriverInfo H2

MySQL

public static final DriverInfo MySQL

Oracle

public static final DriverInfo Oracle

Postgres

public static final DriverInfo Postgres

SQLite

public static final DriverInfo SQLite

SqlServer

public static final DriverInfo SqlServer

UNTESTED

public static final DriverInfo UNTESTED

ERRANT

public static final DriverInfo ERRANT

Field Detail

LOGGER

public static final org.slf4j.Logger LOGGER

Method Detail

values

public static DriverInfo[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (DriverInfo c : DriverInfo.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static DriverInfo valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

getDriverBaseName

public java.lang.String getDriverBaseName()

getDriversInUse

public java.util.Map<java.lang.String,java.util.Set<java.lang.String>> getDriversInUse()

For logging/testing purposes, helps to know the full driver name. Typically, there is only one, unless multiple dbconfigs are in use with multiple/untested drivers.

requiresQueryExecForTableName

public boolean requiresQueryExecForTableName()

Some drivers' query column metadata does not provide the table name info if the query is not first executed before metadata collected. As a consequence, we must execute the query before we get metadata (ouch) or use an off-the-shelf parser to infer the table name (ouch).

Perpetrators: Oracle, SqlServer

flakyParameterMetadata

public boolean flakyParameterMetadata()

(circus music) Some drivers don't provide query parameter types when the parameter's value is not set O_o For instance, depending on the version, SQLite will either return VARCHAR for all parameters or it will throw an exception when a parameter is not set. Similarly, Mysql throws the exception too unless the "generateSimpleParameterMetadata" url parameter is set in which case it provides the same VARCHAR crap sandwich as sqlite (as tested with mysql driver 8.1).

Perpetrators: SQLite, MySQL

lookup

public static DriverInfo lookup(java.sql.DatabaseMetaData metadata)
                         throws java.sql.SQLException

Throws:

java.sql.SQLException