Qt/C++ - Сабақ 008. QDataWidgetMapper - Виджет арқылы деректер қорымен жұмыс істеу

QDataWidgetMapper example, qt, sql, mapper, QSqlTableModel, QDataWidgetMapper

QDataMapperWidget класы еркін пішінді виджеттегі деректерді көрсету үшін пайдаланылады. Бұл виджет әлі де деректерді көрсету үшін үлгіні қажет етеді.

Мысалы, QSqlTableModel немесе QSqlRelationalTableModel , бірақ деректер енді ауыстырылмайды QTableView ішінде, бірақ әртүрлі ерікті нысандарға. Мысалы, QLineEdit немесе QComboBox. Немесе осы мақалада біз жұмыс істейтін жазбаларды қосу үшін диалогтық терезеде.

Сонымен, тапсырма келесідей. Кестедегі компьютерлер тізімін көрсететін бағдарламаны жазыңыз және әрбір компьютерде үш деректер өрісі болады: Хост атауы, IP мекенжайы және MAC мекенжайы. Сондай-ақ диалогтық терезені шақыру түймесі болуы керек, ол арқылы Кестеге жаңа құрылғы қосуға болады. Біз де сол диалогтық терезе арқылы жазбаларды өңдей алуымыз керек.

Тапсырма сипатталған соң, Qt 5.4.1 негізінде QtCreator 3.3.1-де жазылған бағдарлама кодында оны іске асыруға кірісеміз.

QDataWidgetMapper үшін жоба құрылымы

Жоба келесі файлдарды жасайтын Qt Widgets қолданбасы ретінде жасалған:

• QDataMapperWidget.pro - тегін;
• mainwindow.h - қолданбаның негізгі терезесінің тақырып файлы;
• mainwindow.cpp - терезенің бастапқы коды;
• main.cpp - қолданба басталатын негізгі бастапқы файл;
• mainwindow.ui - қолданбаның негізгі терезесінің пішіні;
• database.h – дерекқорда орналастырылған ақпаратпен жұмыс істеу үшін қолданылатын көмекші кластың тақырып файлы;
• database.cpp - дерекқорда орналастырылған ақпаратпен жұмыс істеу үшін қолданылатын көмекші класстың бастапқы файлы;
• dialogadddevice.h - жазбаларды қосу және өңдеуге арналған диалогтық терезенің тақырып файлы;
• dialogadddevice.cpp - жазбаларды қосу және өңдеуге арналған диалогтық терезенің бастапқы файлы;
• dialogadddevice.ui

Ескерту. Мен негізгі кодтың логикасын қажетсіз ақпаратпен шатастырмау үшін дизайнерде интерфейстің көп бөлігін жасаймын. Шындығында, бұл тек дәм мен әдетке байланысты мәселе .

mainwindow.ui

QDataWidgetMapper жобасының негізгі терезесінің пішіні Негізгі терезенің пішіні қарапайым болады. Осы пішіннен біз екі нысанды қолданамыз:

• құрылғы қосу түймесі
• DeviceTableView

dialogadddevice.ui

Тілқатысу терезесінің пішіні үш QLineEdit өрісін, екі түймені және бір ButtonBox пайдаланады, ол QDialog. сыныбынан мұраланған сынып үшін әдепкі элемент болып табылады.

QDataWidgetMapper тілқатысу терезесі Бізде келесі нысандар жұмыс істейді:

• HostnameLineEdit
• IPAddressLineEdit
• MACLineEdit
• түймелер жәшігі
• келесі түймесі
• алдыңғы түймесі

QDataMapperWidget.pro

Жоба профиліне SQL. кітапханаларын пайдалануды жариялайтын директиваны қосу керек.

#-------------------------------------------------
#
# Project created by QtCreator 2015-08-16T23:58:29
#
#-------------------------------------------------

QT       += core
QT       += gui
QT       += sql

greaterThan(QT\_MAJOR\_VERSION, 4): QT += widgets

TARGET = QDataMapperWidget
TEMPLATE = app


SOURCES += main.cpp\
        mainwindow.cpp \
    database.cpp \
    dialogadddevice.cpp

HEADERS  += mainwindow.h \
    database.h \
    dialogadddevice.h

FORMS    += mainwindow.ui \
    dialogadddevice.ui

main.cpp

Файл жобада пайдаланылады, әдепкі бойынша жасалады.

#include "mainwindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();

    return a.exec();
}

mainwindow.h

Негізгі терезенің тақырып файлында жазбаларды қосу, үлгіні жаңарту және жазбаларды өңдеу диалогын іске қосу үшін слоттарды анықтаймыз. Сондай-ақ, Qt интерфейсінің конструкторында орындалатын негізгі параметрлерден басқа, терезенің сыртқы түрін инициализациялау әдістері, сонымен қатар презентация үлгісін инициализациялау әдісі бар.

#ifndef MAINWINDOW\_H
#define MAINWINDOW\_H

#include <QMainWindow>
#include <QSqlTableModel>

#include <database.h>
#include <dialogadddevice.h>

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q\_OBJECT

public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();

private slots:
    void on\_addDeviceButton\_clicked();
    void slotUpdateModels();
    void slotEditRecord(QModelIndex index);

private:
    Ui::MainWindow              *ui;
    DataBase                    *db;
    QSqlTableModel              *modelDevice;

private:
    void setupModel(const QString &tableName, const QStringList &headers);
    void createUI();
};

#endif // MAINWINDOW\_H

mainwindow.cpp

Негізгі терезенің бастапқы код файлында біз алдыңғы мақалалардың бірінде жасалғандай кестені деректермен инициализациялаймыз, мысалы, QSqlTableModel жұмысында. /). Сондай-ақ біз кестеге жазба қосу диалогын шақыратын Қосу, түймесі басылған кезде қолданба әрекетінің логикасын белгілейміз. Сондай-ақ, бұл диалогтық терезе деректер кестесіндегі жазбаны екі рет басқанда шақырылады. Бұл жағдайда қай жазба басылғаны туралы ақпарат диалогтық терезеге жіберіледі және оның деректері өңдеу өрістеріне ауыстырылады.

#include "mainwindow.h"
#include "ui\_mainwindow.h"

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    this->setWindowTitle("QDataWidgetMapper Example");
    /* Первым делом необходимо создать объект для работы с базой данных
     * и инициализировать подключение к базе данных
     * */
    db = new DataBase();
    db->connectToDataBase();

    /* Инициализируем модели для представления данных
     * с заданием названий колонок
     * */
    this->setupModel(DEVICE,
                     QStringList() << trUtf8("id")
                                         << trUtf8("Имя хоста")
                                         << trUtf8("IP адрес")
                                         << trUtf8("MAC-адрес")
               );
    /* Инициализируем внешний вид таблицы с данными
     * */
    this->createUI();
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::setupModel(const QString &tableName, const QStringList &headers)
{
    /* Производим инициализацию модели представления данных
     * */
    modelDevice = new QSqlTableModel(this);
    modelDevice->setTable(tableName);
    modelDevice->select();
    /* Устанавливаем названия колонок в таблице с сортировкой данных
     * */
    for(int i = 0, j = 0; i < modelDevice->columnCount(); i++, j++){
        modelDevice->setHeaderData(i,Qt::Horizontal,headers[j]);
    }
}

void MainWindow::createUI()
{
    ui->deviceTableView->setModel(modelDevice);     // Устанавливаем модель на TableView
    ui->deviceTableView->setColumnHidden(0, true);    // Скрываем колонку с id записей
    // Разрешаем выделение строк
    ui->deviceTableView->setSelectionBehavior(QAbstractItemView::SelectRows);
    // Устанавливаем режим выделения лишь одно строки в таблице
    ui->deviceTableView->setSelectionMode(QAbstractItemView::SingleSelection);
    // Устанавливаем размер колонок по содержимому
    ui->deviceTableView->resizeColumnsToContents();
    ui->deviceTableView->setEditTriggers(QAbstractItemView::NoEditTriggers);
    ui->deviceTableView->horizontalHeader()->setStretchLastSection(true);

    connect(ui->deviceTableView, SIGNAL(doubleClicked(QModelIndex)), this, SLOT(slotEditRecord(QModelIndex)));
}

/* Метод для активации диалога добавления записей
 * */
void MainWindow::on\_addDeviceButton\_clicked()
{
    /* Создаем диалог и подключаем его сигнал завершения работы
     * к слоту обновления вида модели представления данных
     * */
    DialogAddDevice *addDeviceDialog = new DialogAddDevice();
    connect(addDeviceDialog, SIGNAL(signalReady()), this, SLOT(slotUpdateModels()));

    /* Выполняем запуск диалогового окна
     * */
    addDeviceDialog->setWindowTitle(trUtf8("Добавить Устройство"));
    addDeviceDialog->exec();
}

/* Слот обновления модели представления данных
 * */
void MainWindow::slotUpdateModels()
{
    modelDevice->select();
}

/* Метод для активации диалога добавления записей в режиме редактирования
 * с передачей индекса выбранной строки
 * */
void MainWindow::slotEditRecord(QModelIndex index)
{
    /* Также создаем диалог и подключаем его сигнал завершения работы
     * к слоту обновления вида модели представления данных, но передаём
     * в качестве параметров строку записи
     * */
    DialogAddDevice *addDeviceDialog = new DialogAddDevice(index.row());
    connect(addDeviceDialog, SIGNAL(signalReady()), this, SLOT(slotUpdateModel()));

    /* Выполняем запуск диалогового окна
     * */
    addDeviceDialog->setWindowTitle(trUtf8("Редактировать Устройство"));
    addDeviceDialog->exec();
}

dialogaddevice.h

Жазбаларды қосу және өңдеуге арналған диалогтың тақырып файлы. Тақырып файлынан көріп отырғаныңыздай, модель деректерді ұсыну үшін де пайдаланылады, бірақ оның деректері QTableView түріне аударылмайды, мысалы, QSqlRelationalModel /en/post/67/) оқу құралы немесе осы мақаланың MainWindow сыныбында, бірақ QDataWidgetMapper сыныбының нысанында. **accept() әдісі де осы жерде қайта анықталған, себебі терезені жаппас бұрын, сіз деректердің дұрыс толтырылғанына көз жеткізу керек. Бұл жобада деректерді толтырудың дұрыстығының критерийі қайталанатын жазбалардың болмауы болып табылады.

#ifndef DIALOGADDDEVICE\_H
#define DIALOGADDDEVICE\_H

#include <QDialog>
#include <QSqlTableModel>
#include <QDataWidgetMapper>
#include <QMessageBox>

#include <database.h>

namespace Ui {
class DialogAddDevice;
}

class DialogAddDevice : public QDialog
{
    Q\_OBJECT

public:
    explicit DialogAddDevice(int row = -1, QWidget *parent = 0);
    ~DialogAddDevice();

signals:
    void signalReady();

private slots:
    void on\_buttonBox\_accepted();
    void updateButtons(int row);

private:
    Ui::DialogAddDevice         *ui;
    QSqlTableModel              *model;
    QDataWidgetMapper           *mapper;

private:
    void setupModel();
    void createUI();
    void accept();
};

#endif // DIALOGADDDEVICE\_H

dialogaddevice.cpp

Бұл файл класс логикасын жүзеге асырады. Енгізілген деректердің дұрыстығын тексеру OK түймешігін басқан кезде жүзеге асырылады. Дұрыс толтырылған өрістер жағдайында кестеге жазба енгізіледі немесе ол өңделеді. IP мекенжайы және MAC мекенжайы өрістеріндегі деректерді тексеру Validator көмегімен жүзеге асырылады, оның жазылуы [өткен мақалалардың] бірінде сипатталған (https://evileg. com/en/post/ 56/). Ұқсас деректері бар жазбаның болуын тексеру де жүзеге асырылды.

#include "dialogadddevice.h"
#include "ui\_dialogadddevice.h"

DialogAddDevice::DialogAddDevice(int row, QWidget *parent) :
    QDialog(parent),
    ui(new Ui::DialogAddDevice)
{
    ui->setupUi(this);

    /* Метода для инициализации модели,
     * из которой будут транслироваться данные
     * */
    setupModel();

    /* Если строка не задана, то есть равна -1,
     * тогда диалог работает по принципу создания новой записи.
     * А именно, в модель вставляется новая строка и работа ведётся с ней.
     * */
    if(row == -1){
        model->insertRow(model->rowCount(QModelIndex()));
        mapper->toLast();
    /* В противном случае диалог настраивается на заданную запись
     * */
    } else {
        mapper->setCurrentModelIndex(model->index(row,0));
    }

    createUI();
}

DialogAddDevice::~DialogAddDevice()
{
    delete ui;
}

/* Метод настройки модели данных и mapper
 * */
void DialogAddDevice::setupModel()
{
    /* Инициализируем модель и делаем выборку из неё
     * */
    model = new QSqlTableModel(this);
    model->setTable(DEVICE);
    model->setEditStrategy(QSqlTableModel::OnManualSubmit);
    model->select();

    /* Инициализируем mapper и привязываем
     * поля данных к объектам LineEdit
     * */
    mapper = new QDataWidgetMapper();
    mapper->setModel(model);
    mapper->addMapping(ui->HostnameLineEdit, 1);
    mapper->addMapping(ui->IPAddressLineEdit, 2);
    mapper->addMapping(ui->MACLineEdit, 3);
    /* Ручное подтверждение изменения данных
     * через mapper
     * */
    mapper->setSubmitPolicy(QDataWidgetMapper::ManualSubmit);

    /* Подключаем коннекты от кнопок пролистывания
     * к прилистыванию модели данных в mapper
     * */
    connect(ui->previousButton, SIGNAL(clicked()), mapper, SLOT(toPrevious()));
    connect(ui->nextButton, SIGNAL(clicked()), mapper, SLOT(toNext()));
    /* При изменении индекса в mapper изменяем состояние кнопок
     * */
    connect(mapper, SIGNAL(currentIndexChanged(int)), this, SLOT(updateButtons(int)));
}

/* Метод для установки валидатора на поле ввода IP и MAC адресов
 * */
void DialogAddDevice::createUI()
{
    QString ipRange = "(?:[0-1]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])";
    QRegExp ipRegex ("^" + ipRange
                     + "\\." + ipRange
                     + "\\." + ipRange
                     + "\\." + ipRange + "$");
    QRegExpValidator *ipValidator = new QRegExpValidator(ipRegex, this);
    ui->IPAddressLineEdit->setValidator(ipValidator);

    QString macRange = "(?:[0-9A-Fa-f][0-9A-Fa-f])";
    QRegExp macRegex ("^" + macRange
                      + "\\:" + macRange
                      + "\\:" + macRange
                      + "\\:" + macRange
                      + "\\:" + macRange
                      + "\\:" + macRange + "$");
    QRegExpValidator *macValidator = new QRegExpValidator(macRegex, this);
    ui->MACLineEdit->setValidator(macValidator);
}

void DialogAddDevice::on\_buttonBox\_accepted()
{
    /* SQL-запрос для проверки существования записи
     * с такими же учетными данными.
     * Если запись не существует или находится лишь индекс
     * редактируемой в данный момент записи,
     * то диалог позволяет вставку записи в таблицу данных
     * */
    QSqlQuery query;
    QString str = QString("SELECT EXISTS (SELECT " DEVICE\_HOSTNAME " FROM " DEVICE
                          " WHERE ( " DEVICE\_HOSTNAME " = '%1' "
                          " OR " DEVICE\_IP " = '%2' )"
                          " AND id NOT LIKE '%3' )")
            .arg(ui->HostnameLineEdit->text(),
                 ui->IPAddressLineEdit->text(),
                 model->data(model->index(mapper->currentIndex(),0), Qt::DisplayRole).toString());

    query.prepare(str);
    query.exec();
    query.next();

    /* Если запись существует, то диалог вызывает
     * предупредительное сообщение
     * */
    if(query.value(0) != 0){
        QMessageBox::information(this, trUtf8("Ошибка хоста"),
                                 trUtf8("Хост с таким именем или IP-адресом уже существует"));
    /* В противном случае производится вставка новых данных в таблицу
     * и диалог завершается с передачей сигнала для обновления
     * таблицы в главном окне
     * */
    } else {
        mapper->submit();
        model->submitAll();
        emit signalReady();
        this->close();
    }
}

void DialogAddDevice::accept()
{

}

/* Метод изменения состояния активности кнопок пролистывания
 * */
void DialogAddDevice::updateButtons(int row)
{
    /* В том случае, если мы достигаем одного из крайних (самый первый или
     * самый последний) из индексов в таблице данных,
     * то мы изменяем состояние соответствующей кнопки на
     * состояние неактивна
     * */
    ui->previousButton->setEnabled(row > 0);
    ui->nextButton->setEnabled(row < model->rowCount() - 1);
}

дерекқор.h

Мәліметтер қорымен жұмыс істеуге арналған көмекші сынып алдыңғы сабақтардағы бір сыныптың өзгертілген нұсқасы болып табылады.

#ifndef DATABASE\_H
#define DATABASE\_H

#include <QObject>
#include <QSql>
#include <QSqlQuery>
#include <QSqlError>
#include <QSqlDatabase>
#include <QFile>
#include <QDate>
#include <QDebug>

/* Директивы имен таблицы, полей таблицы и базы данных */
#define DATABASE\_HOSTNAME   "ExampleDataBase"
#define DATABASE\_NAME       "DataBase.db"

#define DEVICE                  "DeviceTable"
#define DEVICE\_HOSTNAME         "Hostname"
#define DEVICE\_IP               "IP"
#define DEVICE\_MAC              "MAC"

class DataBase : public QObject
{
    Q\_OBJECT
public:
    explicit DataBase(QObject *parent = 0);
    ~DataBase();
    /* Методы для непосредственной работы с классом
     * Подключение к базе данных и вставка записей в таблицу
     * */
    void connectToDataBase();
    bool inserIntoDeviceTable(const QVariantList &data);

private:
    // Сам объект базы данных, с которым будет производиться работа
    QSqlDatabase    db;

private:
    /* Внутренние методы для работы с базой данных
     * */
    bool openDataBase();
    bool restoreDataBase();
    void closeDataBase();
    bool createDeviceTable();
};

#endif // DATABASE\_H

database.cpp

#include "database.h"

DataBase::DataBase(QObject *parent) : QObject(parent)
{

}

DataBase::~DataBase()
{

}

/* Методы для подключения к базе данных
 * */
void DataBase::connectToDataBase()
{
    /* Перед подключением к базе данных производим проверку на её существование.
     * В зависимости от результата производим открытие базы данных или её восстановление
     * */
    if(!QFile("C:/example/" DATABASE\_NAME).exists()){
        this->restoreDataBase();
    } else {
        this->openDataBase();
    }
}

/* Методы восстановления базы данных
 * */
bool DataBase::restoreDataBase()
{
    if(this->openDataBase()){
        if(!this->createDeviceTable()){
            return false;
        } else {
            return true;
        }
    } else {
        qDebug() << "Не удалось восстановить базу данных";
        return false;
    }
    return false;
}

/* Метод для открытия базы данных
 * */
bool DataBase::openDataBase()
{
    /* База данных открывается по заданному пути
     * и имени базы данных, если она существует
     * */
    db = QSqlDatabase::addDatabase("QSQLITE");
    db.setHostName(DATABASE\_HOSTNAME);
    db.setDatabaseName("C:/example/" DATABASE\_NAME);
    if(db.open()){
        return true;
    } else {
        return false;
    }
}

/* Методы закрытия базы данных
 * */
void DataBase::closeDataBase()
{
    db.close();
}

/* Метод для создания таблицы устройств в базе данных
 * */
bool DataBase::createDeviceTable()
{
    /* В данном случае используется формирование сырого SQL-запроса
     * с последующим его выполнением.
     * */
    QSqlQuery query;
    if(!query.exec( "CREATE TABLE " DEVICE " ("
                            "id INTEGER PRIMARY KEY AUTOINCREMENT, "
                            DEVICE\_HOSTNAME  " VARCHAR(255)    NOT NULL,"
                            DEVICE\_IP        " VARCHAR(16)     NOT NULL,"
                            DEVICE\_MAC       " VARCHAR(18)     NOT NULL"
                        " )"
                    )){
        qDebug() << "DataBase: error of create " << DEVICE;
        qDebug() << query.lastError().text();
        return false;
    } else {
        return true;
    }
    return false;
}

/* Метод для вставки записи в таблицу устройств
 * */
bool DataBase::inserIntoDeviceTable(const QVariantList &data)
{
    /* Запрос SQL формируется из QVariantList,
     * в который передаются данные для вставки в таблицу.
     * */
    QSqlQuery query;
    /* В начале SQL запрос формируется с ключами,
     * которые потом связываются методом bindValue
     * для подстановки данных из QVariantList
     * */
    query.prepare("INSERT INTO " DEVICE " ( " DEVICE\_HOSTNAME ", "
                                              DEVICE\_IP ", "
                                              DEVICE\_MAC " ) "
                  "VALUES (:Hostname, :IP, :MAC )");
    query.bindValue(":Hostname",    data[0].toString());
    query.bindValue(":IP",          data[1].toString());
    query.bindValue(":MAC",         data[2].toString());
    // После чего выполняется запросом методом exec()
    if(!query.exec()){
        qDebug() << "error insert into " << DEVICE;
        qDebug() << query.lastError().text();
        return false;
    } else {
        return true;
    }
    return false;
}

Барлығы

Бастапқы мұрағат: QDataWidgetMapper

Нәтижесінде, іске қосылған қолданба келесідей болуы керек: