Package nl.cwi.monetdb.jdbc

Class MonetDataSource

java.lang.Object

nl.cwi.monetdb.jdbc.MonetWrapper

nl.cwi.monetdb.jdbc.MonetDataSource

All Implemented Interfaces:

Wrapper, CommonDataSource, DataSource

public class MonetDataSource
extends MonetWrapper
implements DataSource

A DataSource suitable for the MonetDB database. This DataSource allows retrieval of a Connection using the JNDI bean like framework. A DataSource has numerous advantages over using the DriverManager to retrieve a Connection object. Using the DataSource interface enables a more transparent application where the location or database can be changed without changing any application code. Additionally, pooled connections can be used when using a DataSource.

Version:

0.1

Author:

Fabian Groffen, Pedro Ferreira

Constructor Summary

Constructors

Constructor	Description
MonetDataSource()

Method Summary

Modifier and Type	Method	Description
Connection	getConnection()	Attempts to establish a connection with the data source that this DataSource object represents.
Connection	getConnection(String username, String password)	Attempts to establish a connection with the data source that this DataSource object represents.
String	getDescription()	Gets the description
String	getDirectory()	Gets the directory value
int	getLoginTimeout()	Gets the maximum time in seconds that this data source can wait while attempting to connect to a database.
PrintWriter	getLogWriter()	Retrieves the log writer for this DataSource object.
Logger	getParentLogger()	Return the parent Logger of all the Loggers used by this data source.
String	getURL()	Gets the connection URL
String	getUser()	Gets the username
boolean	isEmbedded()	Gets the embedded connection directory.
void	setDescription(String description)	Sets the description
void	setDirectory(String directory)	Sets the directory value, meaning it wil start an embedded connection
void	setLoginTimeout(int seconds)	Sets the maximum time in seconds that this data source will wait while attempting to connect to a database.
void	setLogWriter(PrintWriter out)	Sets the log writer for this DataSource object to the given java.io.PrintWriter object.
void	setPassword(String password)	Sets the password to use when connecting.
void	setURL(String url)	Sets the connection URL
void	setUser(String user)	Sets the username

Methods inherited from interface javax.sql.CommonDataSource

createShardingKeyBuilder

Methods inherited from interface javax.sql.DataSource

createConnectionBuilder

Methods inherited from class nl.cwi.monetdb.jdbc.MonetWrapper

isWrapperFor, unwrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Constructor Detail

MonetDataSource

public MonetDataSource()

Method Detail

getConnection

public Connection getConnection()
                         throws SQLException

Attempts to establish a connection with the data source that this DataSource object represents.

Specified by:

getConnection in interface DataSource

Returns:

a MonetConnection

Throws:

SQLException - if connecting to the database fails

getConnection

public Connection getConnection(String username,
                                String password)
                         throws SQLException

Attempts to establish a connection with the data source that this DataSource object represents.

Specified by:

getConnection in interface DataSource

Parameters:

username - the username to use

password - the password to use

Returns:

a MonetConnection

Throws:

SQLException - if connecting to the database fails

getLoginTimeout

public int getLoginTimeout()

Gets the maximum time in seconds that this data source can wait while attempting to connect to a database.

Specified by:

getLoginTimeout in interface CommonDataSource

Specified by:

getLoginTimeout in interface DataSource

Returns:

login timeout default is 0 (infinite)

setLoginTimeout

public void setLoginTimeout(int seconds)

Sets the maximum time in seconds that this data source will wait while attempting to connect to a database.

Specified by:

setLoginTimeout in interface CommonDataSource

Specified by:

setLoginTimeout in interface DataSource

Parameters:

seconds - the number of seconds to wait before aborting the connect

getLogWriter

public PrintWriter getLogWriter()

Retrieves the log writer for this DataSource object.

Specified by:

getLogWriter in interface CommonDataSource

Specified by:

getLogWriter in interface DataSource

Returns:

null, since there is no log writer

setLogWriter

public void setLogWriter(PrintWriter out)

Sets the log writer for this DataSource object to the given java.io.PrintWriter object.

Specified by:

setLogWriter in interface CommonDataSource

Specified by:

setLogWriter in interface DataSource

Parameters:

out - a PrintWriter - ignored

setPassword

public void setPassword(String password)

Sets the password to use when connecting. There is no getter for obvious reasons.

Parameters:

password - the password

getUser

public String getUser()

Gets the username

Returns:

the username

setUser

public void setUser(String user)

Sets the username

Parameters:

user - the username

getURL

public String getURL()

Gets the connection URL

Returns:

the connection URL

setURL

public void setURL(String url)

Sets the connection URL

Parameters:

url - the connection URL

getDescription

public String getDescription()

Gets the description

Returns:

the description

setDescription

public void setDescription(String description)

Sets the description

Parameters:

description - the description

getDirectory

public String getDirectory()

Gets the directory value

Returns:

the directory value

setDirectory

public void setDirectory(String directory)

Sets the directory value, meaning it wil start an embedded connection

Parameters:

directory - The directory location

isEmbedded

public boolean isEmbedded()

Gets the embedded connection directory. If not, then a MAPI connection will be created instead.

Returns:

If the connection will be embedded. If not, then a MAPI connection will be created instead.

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Return the parent Logger of all the Loggers used by this data source. This should be the Logger farthest from the root Logger that is still an ancestor of all of the Loggers used by this data source. Configuring this Logger will affect all of the log messages generated by the data source. In the worst case, this may be the root Logger.

Specified by:

getParentLogger in interface CommonDataSource

Returns:

the parent Logger for this data source

Throws:

SQLFeatureNotSupportedException - if the data source does not use java.util.logging