interface XDriverManager in module com::sun::star::sdbc::

(Global Index)

Syntax

interface XDriverManager : com::sun::star::uno::XInterface ;

Description

is the basic interface for managing a set of SDBC drivers.

When the method XDriverManager::getConnection() is called, the DriverManager will attempt to locate a suitable driver.

See also

XDriver

See also

XConnection

Method Summary

getConnection attempts to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC/SDBC drivers.

getConnectionWithInfo attempts to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC/SDBC drivers.

setLoginTimeout sets the maximum time in seconds that a driver will wait while attempting to connect to a database.

getLoginTimeout gets the maximum time in seconds that a driver can wait when attempting to login to a database.

Known Services Which Export this Interface

com::sun::star::sdbc::ConnectionPool

com::sun::star::sdbc::DriverManager

Method Details



getConnection

Syntax

com::sun::star::sdbc::XConnection getConnection (
string url )
raises ( com::sun::star::sdbc::SQLException );

Description

attempts to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC/SDBC drivers.

Parameter url

a database url of the form sdbc:subprotocol:subname

Returns

the Connection object

Throws

SQLException if a database access error occurs.

getConnectionWithInfo

Syntax

com::sun::star::sdbc::XConnection getConnectionWithInfo (
string url,
sequence< com::sun::star::beans::PropertyValue > info )
raises ( com::sun::star::sdbc::SQLException );

Description

attempts to establish a connection to the given database URL. The DriverManager attempts to select an appropriate driver from the set of registered JDBC/SDBC drivers.

Parameter url

a database url of the form sdbc:subprotocol:subname

Parameter info

a list of arbitrary string tag/value pairs as connection arguments; normally at least a "user" and "password" property should be included

Returns

the Connection object

Throws

SQLException if a database access error occurs.

setLoginTimeout

Syntax

void setLoginTimeout (
long seconds );

Description

sets the maximum time in seconds that a driver will wait while attempting to connect to a database.

Parameter seconds

the login time limit in seconds

Throws

SQLException if a database access error occurs.

getLoginTimeout

Syntax

long getLoginTimeout ();

Description

gets the maximum time in seconds that a driver can wait when attempting to login to a database.

Returns

the driver login time limit in seconds

Throws

SQLException if a database access error occurs.
Top of Page