abk.dao.sql
Class ADataDriver

java.lang.Object
  abk.dao.sql.ADataDriver

All Implemented Interfaces:

Serializable

public class ADataDriver
extends Object
implements Serializable

Contiene los parámetros de configuración para abrir una conexión a una base de datos mediante JDBC.

See Also:

Serialized Form

Nested Class Summary

static class

ADataDriver.Connector Implementa un conector básico, construido a partir de los parámetros de configuración del driver JDBC.

Field Summary

private String	iDriver Nombre completo de la clase que implementa un driver JDBC.
private boolean	iDriverFound Clase en la que se resuelve el nombre del driver.
private String	iOptions Opciones para la conexión.
private String	iPassword Contraseña para el proceso de autenticación ante la base de datos.
private String	iPath Ruta que define la base de datos a la que nos conectamos.
private Properties	iProperties Propiedades con el nombre de usuario y contraseña a usar para conectar con la base de datos.
private String	iURL Caché con la URL de la conexión, para optimizar las llamadas a getURL() a partir de la segunda invocación.
private String	iUser Nombre de usuario para el proceso de autenticación ante la base de datos.
private ALogger	logger Muestra mensajes en los cuadernos de bitácora.
private static long	serialVersionUID

Constructor Summary

ADataDriver(String driver, String path, String options)
Constructor abreviado, para el caso en que no sea necesaria la autenticación.

ADataDriver(String driver, String path, String options, String user, String password)
Constructor detallado.

Method Summary

private void	buildProperties() Construye y almacena en iProperties los parámetros de autenticación para conectar con la base de datos.
private void	buildURL() Construye la URL a partir de los campos de la instancia.
Connection	connect() Abre y devuelve una conexión con la base de datos.
ADataDriver.Connector	createConnector() Crea y devuelve una sesión de base de datos para el driver actual.
String	getURL() Devuelve la URL para conectar con la base de datos, construyéndola y guardándola en iURL si fuese necesario.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

logger

private final transient ALogger logger

Muestra mensajes en los cuadernos de bitácora.

iDriver

private final String iDriver

Nombre completo de la clase que implementa un driver JDBC.

iUser

private final String iUser

Nombre de usuario para el proceso de autenticación ante la base de datos.

iPassword

private final String iPassword

Contraseña para el proceso de autenticación ante la base de datos.

iPath

private final String iPath

Ruta que define la base de datos a la que nos conectamos.

iOptions

private final String iOptions

Opciones para la conexión.

iDriverFound

private transient boolean iDriverFound

Clase en la que se resuelve el nombre del driver.

iProperties

private transient Properties iProperties

Propiedades con el nombre de usuario y contraseña a usar para conectar con la base de datos.

iURL

private transient String iURL

Caché con la URL de la conexión, para optimizar las llamadas a getURL() a partir de la segunda invocación.

Constructor Detail

ADataDriver

public ADataDriver(String driver,
                   String path,
                   String options,
                   String user,
                   String password)

Constructor detallado.

Ejemplos para distintas bases de datos:

• MySQL

  ADataDriver("com.mysql.jdbc.Driver", "mysql://localhost/ADDBB", null, "usuario", "clave");

• Derby Embbeded

  ADataDriver("org.apache.derby.jdbc.EmbeddedDriver", "ADDBB", ";create=true", "usuario", "clave");

• HSQLDB In-Process

  ADataDriver("org.hsqldb.jdbc.JDBCDriver", "hsqldb:file:/path/ADDBB", ";shutdown=true", "sa", "");

• SQLite

  ADataDriver("org.sqlite.JDBC", "sqlite:/path/ADDBB", null);

• Oracle

  ADataDriver("oracle.jdbc.driver.OracleDriver", "oracle:thin:@localhost:1521:SID", "usuario", "clave");

Parameters:

driver - Nombre completo de la clase que implementa un driver JDBC.

path - Ruta que define la base de datos a la que nos conectamos.

options - Opciones para la conexión.

user - Nombre de usuario para el proceso de autenticación ante la base de datos.

password - Contraseña para el proceso de autenticación ante la base de datos.

ADataDriver

public ADataDriver(String driver,
                   String path,
                   String options)

Constructor abreviado, para el caso en que no sea necesaria la autenticación.

Parameters:

driver - Nombre completo de la clase que implementa un driver JDBC.

path - Ruta que define la base de datos a la que nos conectamos.

options - Opciones para la conexión.

Method Detail

buildProperties

private void buildProperties()

Construye y almacena en iProperties los parámetros de autenticación para conectar con la base de datos.

buildURL

private void buildURL()

Construye la URL a partir de los campos de la instancia.

getURL

public String getURL()

Devuelve la URL para conectar con la base de datos, construyéndola y guardándola en iURL si fuese necesario.

Returns:

URL para conectar a la base de datos.

connect

public Connection connect()
                   throws SQLException

Abre y devuelve una conexión con la base de datos.

Returns:

La conexión abierta.

Throws:

SQLException - si se produce un error al tratar de abrir la conexión con el driver especificado.

createConnector

public ADataDriver.Connector createConnector()

Crea y devuelve una sesión de base de datos para el driver actual.

Returns:

Conector creado.