Top   Module   Use   Manual   Index 
 EXPORTING SERVICES | METHODS' SUMMARY | METHODS' DETAILS 

com :: sun :: star :: sdb ::

interface XCompletedConnection

Base Interface
com::sun::star::uno::XInterface

Description
is used for establishing connections via a factory which is identified by it's name. To complete the information needed for establishing a connection an interaction handler is used.


Known Services which Export this Interface

com::sun::star::sdb::DataSource is a factory to establish database connections. It should be registered at a NamingService.
com::sun::star::sdb::DatabaseAccess specifies a component, which controls DatabaseAccessConnections and acts like a shared DataSource.
com::sun::star::sdb::DatabaseAccessDataSource is a factory to create data access beans. Data access beans are shared amoung components, so if an already existing bean is requested, the existing one is returned.

Methods' Summary

connectWithCompletion attempts to establish a database connection. If information is missing, such as a user's password, they are completed by user interaction.

Methods' Details

connectWithCompletion
 
com::sun::star::sdbc::XConnection
connectWithCompletion(
[ in ] com::sun::star::task::XInteractionHandler handler )
raises ( com::sun::star::sdbc::SQLException );

Description
attempts to establish a database connection. If information is missing, such as a user's password, they are completed by user interaction.
Parameter handler
will be asked when more information is needed
Returns
the Connection object
Throws
com::sun::star::sdbc::SQLException if a database access error occurs.

Top of Page