DatabaseConnectionDialog/es
Dialog de Conexión a Base de Datos
Este fragmento de código muestra cómo implementar un Dialog de base de datos en general que le pedirá al usuario propiedades generales de conexión de la base de datos (nombre de usuario, contraseña, nombre de host, etc.), Así como un combo con todos los controladores de base de datos disponible. El Dialog proporciona también una señal que pasara la conexión de base de datos (si está establecida) para que los componentes de terceros puedan utilizar dicha conexión.
Uso
El uso del Dialog vendria siendo algo asi:
DatabaseConnectionDialog* dialog = new DatabaseConnectionDialog(this);
// opcional: preparando los datos que mostraremos al usuario en un formulario auto-completado<br /> dialog->setDatabaseName( "mydb&quot; );<br /> dialog->setDatabasePortNumber( 1234 );<br /> dialog->setDatabaseHostName( "localhost&quot; );<br /> dialog->setDatabaseUsername( "luca&quot; );<br /> dialog->setDatabaseDriverName( "QPSQL&quot; );<br /> dialog->setDatabasePassword( "pwd&quot; );
// habilitando el botón de conectar si todos los datos son correctos<br /> dialog->checkFormData();<br /> // contactando la signal del dialog con el slot donde usaremos la conexion<br /> connect( dialog,<br /> SIGNAL (databaseConnect(QSqlDatabase&amp;)),<br /> this,<br /> SLOT (slotHandleNewDatabaseConnection(QSqlDatabase&amp;)));
// mostramos el dialog (sin auto-conexion)<br /> dialog->run( false );
El dialog nos permite pre-inicializar los campos del formulario, asi como el modo de auto-conectar que hace que la conexión sea automática si todos los datos están en su lugar.
Notemos que este dialog puede ser perfeccionado de varias formas, y representa además un punto de partida para una conexión a base de datos más específica.
Modo Auto-Conectar
Cuando el método <code>run()</code> se invoca puede especificarse el modo de autoconectar con el valor booleano de true. En este modo si todos los campos estan llenos el dialog inmediatamente intenta conectarse a la base de datos, y en caso de lograrlo transparente al usuario emite el signal.
En caso de que los datos del formulario no estén completos o la conexión no se pueda establecer el dialog se muestra nuevamente. Si el modo de autoconectar esta apagado (parámetro = false) el dialog siempre se mostrará.
Código de fuente
El siguiente código es del fichero de encabezado (header):
/*!<br /> * databasedialog.h<br /> '''/<br />#ifndef DATABASEDIALOG_H<br />#define DATABASEDIALOG_H
<br />#include <QDialog&gt;<br />#include <QLabel&gt;<br />#include <QLineEdit&gt;<br />#include <QComboBox&gt;<br />#include <QSpinBox&gt;<br />#include <QDialogButtonBox&gt;<br />#include <QHBoxLayout&gt;<br />#include <QVBoxLayout&gt;<br />#include <QGridLayout&gt;<br />#include <QSqlDatabase&gt;<br />#include <QString&gt;<br />#include <QMessageBox&gt;<br />#include <QDebug&gt;<br />#include <QSqlError&gt;<br />#include <QPushButton&gt;<br />#include <QGroupBox&gt;
<br />class DatabaseConnectionDialog : public QDialog<br />{<br /> Q_OBJECT
<br />private:
<br /> /'''!<br /> * La etiqueta para el driver de la base de datos.<br /> '''/<br /> QLabel''' labelDatabaseDriverName;
/*!<br /> * La etiqueta para el puerto TCP/IP que la base de datos<br /> * utiliza para las conexiones entrantes.<br /> '''/<br /> QLabel''' labelDatabasePort;
/*!<br /> * La etiqueta para el nombre de la base de datos.<br /> '''/<br /> QLabel''' labelDatabaseName;
/*!<br /> * La etiqueta para el nombre de la máquina.<br /> '''/<br /> QLabel''' labelDatabaseHostName;
/*!<br /> * La etiqueta para el nombre de usuario.<br /> '''/<br /> QLabel''' labelDatabaseUsername;
/*!<br /> * La etiqueta para la contraseña.<br /> '''/<br /> QLabel''' labelDatabasePassword;
/*!<br /> * Una etiqueta para mostrar la URL de la conexión<br /> * a la base de datos.<br /> '''/<br /> QLabel''' labelDatabaseURL;
/*!<br /> * El nombre de la base de datos a la que el<br /> * usuario desea conectarse.<br /> '''/<br /> QLineEdit''' editDatabaseName;
/*!<br /> * El nombre del servidor donde se encuentra la base<br /> * de datos.<br /> '''/<br /> QLineEdit''' editDatabaseHostName;
/*!<br /> * El puerto de escucha del servidor de base de datos.<br /> '''/<br /> QSpinBox''' spinBoxDatabasePort;
/*!<br /> * El usuario para la conexión a la base de datos.<br /> '''/<br /> QLineEdit''' editDatabaseUsername;
/*!<br /> * Para poner la contraseña de la conexión a la base de datos.<br /> '''/<br /> QLineEdit''' editDatabasePassword;
/*!<br /> * El combo desde donde el usuario puede seleccionar el<br /> * driver y tipo de base de datos.<br /> '''/<br /> QComboBox''' comboDatabaseDriverName;
/*!<br /> * Un Dialog para mostrar los botones de conexión<br /> * conectar/cancelar.<br /> '''/<br /> QDialogButtonBox''' buttons;
/*!<br /> * Un método para crear todos los componentes del dialog<br /> * y alinearlos correctamente.<br /> '''/<br /> void setUpGUI();
<br /> /'''!<br /> * Para buscar y generar el combo con los controladores disponibles<br /> * para establecer la conexión con la base de datos.<br /> '''/<br /> void findAvailableDrivers();
<br /> /'''!<br /> * Para realizar la conexión con la base de datos<br /> * y emitir la señal para que pueda ser usada por otros.<br /> */<br /> void doDatabaseConnection();
public:<br /> explicit DatabaseConnectionDialog(QWidget '''parent = 0);
<br /> /'''!<br /> * Para asignar el nombre de la base de datos.<br /> * dbName<br /> '''/<br /> void setDatabaseName( const QString&amp; dbName );
<br /> /'''!<br /> * Para asignar el puerto de escucha del servidor de base de datos.<br /> * portNumber<br /> '''/<br /> void setDatabasePortNumber( int&amp; portNumber );
<br /> /'''!<br /> * Para asignar el nombre del servidor (nombre mnemónico).<br /> * hostname<br /> '''/<br /> void setDatabaseHostName( const QString&amp; hostname );
<br /> /'''!<br /> * Para asignar el usuario de conexion.<br /> * username<br /> '''/<br /> void setDatabaseUsername( const QString&amp; username );
<br /> /'''!<br /> * Para seleccionar el nombre del controlador.<br /> * drvName (ademas del tipo de base de datos)<br /> '''/<br /> void setDatabaseDriverName( const QString&amp; drvName );
<br /> /'''!<br /> * Para asignar la contraseña.<br /> * pwd<br /> '''/<br /> void setDatabasePassword( const QString&amp; pwd );
<br /> /'''!<br /> * Realizar un chequeo contra los datos introducidos para habilitar/deshabilitar<br /> * el boton de conectar dependiendo del completado o no del formulario.<br /> '''true Devuelve verdadero si es satisfactoria la conexion<br />'''/<br /> bool checkFormData();
/*!<br /> * Realiza la conexion o muestra al usuario el Dialog en caso<br /> * de no haber completado el llenado o no haber podido realizar la<br /> * conexion automatica.<br /> * autoConnect si es ''true'' intenta conectarse automaticamente<br /> * si los datos estan completos, o avisa al usuario de los datos faltantes<br /> * Si es ''false'' simplemente muestra el Dialog y espera.<br /> '''/<br /> void run( bool autoConnect );
<br />signals:
<br /> /'''!<br /> * Pasa la conexion en caso de que sea satisfactoria<br /> * databaseConnection Objeto<br /> '''/<br /> void databaseConnect( QSqlDatabase&amp; databaseConnection );
<br />public slots:
<br /> /'''!<br /> * Chequea si el usuario ha entrado los datos suficientes<br /> * para intentar conectarse a la base de datos<br /> '''/<br /> bool slotCheckFormData();
<br /> /'''!<br /> * Realiza la conexion.<br /> */<br /> void slotPerformConnection();
};
#endif // DATABASEDIALOG_H<br />
A continuación la implementación de la clase:
#include "databasedialog.h&quot;
DatabaseConnectionDialog::DatabaseConnectionDialog(QWidget '''parent) :<br /> QDialog(parent)<br />{<br /> // este dialog es modal<br /> setModal( true );<br /> // titulo del dialog<br /> setWindowTitle( tr("Conexion a base de datos&quot;) );<br /> // seteando cada componente GUI<br /> setUpGUI();<br /> // cargando los controladores<br /> findAvailableDrivers();<br />}
<br />void DatabaseConnectionDialog::setUpGUI()<br />{
<br /> // creando todos los gui components<br /> labelDatabaseDriverName = new QLabel( tr("Database Type (driver name)"), this );<br /> labelDatabasePort = new QLabel( tr("TCP/IP Port Number&quot;), this );<br /> labelDatabaseName = new QLabel( tr("Database Name&quot;), this );<br /> labelDatabaseHostName = new QLabel( tr("Host Name&quot;), this );<br /> labelDatabaseUsername = new QLabel( tr("Username&quot;), this );<br /> labelDatabasePassword = new QLabel( tr("Password&quot;), this );<br /> labelDatabaseURL = new QLabel( this );<br /> labelDatabaseURL->setAlignment( Qt::AlignCenter );
<br /> spinBoxDatabasePort = new QSpinBox( this );<br /> spinBoxDatabasePort->setMaximum( 9999 );<br /> spinBoxDatabasePort->setMinimum( 100 );<br /> spinBoxDatabasePort->setSingleStep( 1 );
<br /> comboDatabaseDriverName = new QComboBox( this );<br /> comboDatabaseDriverName->setEditable( false );
<br /> editDatabaseName = new QLineEdit( this );<br /> editDatabaseHostName = new QLineEdit( this );<br /> editDatabaseUsername = new QLineEdit( this );<br /> editDatabasePassword = new QLineEdit( this );<br /> editDatabasePassword->setEchoMode( QLineEdit::Password );<br /> connect( editDatabaseName,<br /> SIGNAL (editingFinished()),<br /> this,<br /> SLOT (slotCheckFormData()) );<br /> connect( editDatabaseHostName,<br /> SIGNAL (editingFinished()),<br /> this,<br /> SLOT (slotCheckFormData()) );<br /> connect( editDatabaseUsername,<br /> SIGNAL (editingFinished()),<br /> this,<br /> SLOT (slotCheckFormData()) );<br /> connect( editDatabasePassword,<br /> SIGNAL (editingFinished()),<br /> this,<br /> SLOT (slotCheckFormData()) );<br /> connect( editDatabasePassword,<br /> SIGNAL (returnPressed()),<br /> this,<br /> SLOT (slotCheckFormData()) );
<br /> // creando la caja de botones<br /> buttons = new QDialogButtonBox( this );<br /> buttons->addButton( QDialogButtonBox::Ok );<br /> buttons->addButton( QDialogButtonBox::Cancel );<br /> QPushButton''' okButton = buttons->button( QDialogButtonBox::Ok );<br /> okButton->setText( tr( "Connect!" ) );<br /> okButton->setEnabled( false );<br /> connect( buttons,<br /> SIGNAL (accepted()),<br /> this,<br /> SLOT (slotPerformConnection()));<br /> connect( buttons,<br /> SIGNAL (rejected()),<br /> this,<br /> SLOT (close()));
// configurando margen vertical para mostrar los componentes<br /> QVBoxLayout* verticalLayout = new QVBoxLayout( this );
// create a grid layout to add all the components<br /> QGridLayout* formGridLayout = new QGridLayout( this );<br /> QGroupBox* gridGroupBox = new QGroupBox( this );<br /> gridGroupBox->setTitle( tr("Database connection properties&quot; ) );<br /> formGridLayout->addWidget( labelDatabaseDriverName, 0, 0 );<br /> formGridLayout->addWidget( comboDatabaseDriverName, 0, 1 );<br /> labelDatabaseDriverName->setBuddy( comboDatabaseDriverName );<br /> formGridLayout->addWidget( labelDatabaseHostName, 1, 0 );<br /> formGridLayout->addWidget( editDatabaseHostName, 1, 1);<br /> labelDatabaseHostName->setBuddy( editDatabaseHostName );<br /> formGridLayout->addWidget( labelDatabasePort, 2, 0 );<br /> formGridLayout->addWidget( spinBoxDatabasePort, 2, 1 );<br /> labelDatabasePort->setBuddy( spinBoxDatabasePort );<br /> formGridLayout->addWidget( labelDatabaseName, 3, 0 );<br /> formGridLayout->addWidget( editDatabaseName , 3, 1 );<br /> labelDatabaseName->setBuddy( editDatabaseName );<br /> formGridLayout->addWidget( labelDatabaseUsername, 4, 0 );<br /> formGridLayout->addWidget( editDatabaseUsername, 4, 1 );<br /> labelDatabaseUsername->setBuddy( editDatabaseUsername );<br /> formGridLayout->addWidget( labelDatabasePassword, 5, 0 );<br /> formGridLayout->addWidget( editDatabasePassword, 5, 1 );<br /> labelDatabasePassword->setBuddy( editDatabasePassword );<br /> // agregar todos los elementos al groupbox<br /> gridGroupBox->setLayout( formGridLayout );
// agregando un nuevo groupbox que contenga la URL de la conexion<br /> QGroupBox* urlGroupBox = new QGroupBox( this );<br /> urlGroupBox->setTitle( tr( "Database URL&quot; ) );<br /> QHBoxLayout* urlLayout = new QHBoxLayout( this );<br /> urlLayout->addWidget( labelDatabaseURL );<br /> urlGroupBox->setLayout( urlLayout );
// todos los margenes juntos<br /> verticalLayout->addWidget( gridGroupBox );<br /> verticalLayout->addStretch();<br /> verticalLayout->addWidget( urlGroupBox );<br /> verticalLayout->addWidget( buttons );
comboDatabaseDriverName->setFocus();<br />}
void DatabaseConnectionDialog::findAvailableDrivers()<br />{<br /> // eliminando todos los elementos<br /> comboDatabaseDriverName->clear();
// rellenando el combo con los controladores disponibles<br /> foreach( QString driverName, QSqlDatabase::drivers() )<br /> comboDatabaseDriverName->addItem( driverName );<br />}
bool DatabaseConnectionDialog::slotCheckFormData()<br />{<br /> return checkFormData();<br />}
bool DatabaseConnectionDialog::checkFormData(){<br /> if( editDatabaseName->text().isEmpty()<br /> || editDatabaseHostName->text().isEmpty()<br /> || editDatabaseUsername->text().isEmpty()<br /> || editDatabasePassword->text().isEmpty() )<br /> buttons->button( QDialogButtonBox::Ok )<s>>setEnabled( false );<br /> else{<br /> // enable the connect button and give focus<br /> buttons</s>>button( QDialogButtonBox::Ok )<s>>setEnabled( true );<br /> buttons</s>>button( QDialogButtonBox::Ok )<s>>setFocus();<br /> }
<br /> // si la conexion se puede establecer (o al menos intentar)<br /> // mostrar la URL<br /> if( buttons</s>>button( QDialogButtonBox::Ok )<s>>isEnabled() )<br /> labelDatabaseURL</s>>setText( comboDatabaseDriverName->currentText()<br /> + "://&quot;<br /> + editDatabaseUsername->text()<br /> + "
"
+ editDatabaseHostName->text()
+ "/"
+ editDatabaseName->text() );
else
labelDatabaseURL->setText( "" );
return buttons->button( QDialogButtonBox::Ok )>isEnabled();>currentText() ) ){
}
void DatabaseConnectionDialog::doDatabaseConnection()
{
// chequear que el controlador de la base de datos esta realmente disponible
// (no deberia suceder pero…)
if( ! QSqlDatabase::isDriverAvailable( comboDatabaseDriverName
QMessageBox::critical( this,
tr("Database Connection Error"),
tr("Database driver not available!")
);
return;
}
qDebug() << "Realizando la configuracion del controlador..";
// configurar las propiedades del controlador
QSqlDatabase databaseConnection = QSqlDatabase::addDatabase( comboDatabaseDriverName->currentText() );
databaseConnection.setDatabaseName( editDatabaseName->text() );
databaseConnection.setUserName( editDatabaseUsername->text() );
databaseConnection.setHostName( editDatabaseHostName->text() );
databaseConnection.setPassword( editDatabasePassword->text() );
databaseConnection.setPort( spinBoxDatabasePort->text().toInt() );
if( ! databaseConnection.open() ){
QMessageBox::critical( this,
tr("Database Connection Error"),
databaseConnection.lastError().text()
);
// deshabilitando el boton de conectar y situando el cursor
// en el primer campo
buttons->button( QDialogButtonBox::Ok )>setEnabled( false );>setFocus();
editDatabaseHostName
}
else{
// ocultar el dialog
this->hide();
// emitir la señal
qDebug() << "Emitiendo la señal indicando la conexion satisfactoria con la base de datos!";
emit databaseConnect( databaseConnection );
}
}
void DatabaseConnectionDialog::slotPerformConnection()
{
// realizando otro chequeo contra los datos del usuario
if( slotCheckFormData() )
doDatabaseConnection();
}
void DatabaseConnectionDialog::setDatabaseName(const QString &dbName)
{
editDatabaseName->setText( dbName );
}
void DatabaseConnectionDialog::setDatabasePortNumber(int &portNumber)
{
spinBoxDatabasePort->setValue( portNumber );
}
void DatabaseConnectionDialog::setDatabaseHostName(const QString &hostname)
{
editDatabaseHostName->setText( hostname );
}
void DatabaseConnectionDialog::setDatabaseUsername(const QString &username)
{
editDatabaseUsername->setText( username );
}
void DatabaseConnectionDialog::setDatabaseDriverName(const QString &drvName)
{
int index = comboDatabaseDriverName->findText( drvName );
if( index >= 0 )
comboDatabaseDriverName->setCurrentIndex( index );
}
void DatabaseConnectionDialog::setDatabasePassword(const QString &pwd)
{
editDatabasePassword->setText( pwd );
}
void DatabaseConnectionDialog::run(bool autoConnect)
{
bool statusOk = checkFormData();
if( ! autoConnect || ! statusOk )
exec&#40;);
else
doDatabaseConnection();
}