Упрощаем работу с базами данных в Qt с помощью QSqlRelationalTableModel

Доброго времени суток, Хабровчане! В этой статье я хочу рассказать о своем опыте упрощения взаимодействия с базами данных SQL при разработке десктопного приложения с помощью класса QSqlRelationalTableModel кроссплатформенной библиотеки Qt.

Пролог


С Qt я познакомился еще будучи студентом 1 курса, только начиная программировать на C++, тогда же и серьезно заинтересовался библиотекой и, с тех пор слежу за ее апдейтами. Несколько месяцев назад на работе мне дали ТЗ, в котором требовалось разработать приложение, взаимодействующее с БД SQLite. Структура базы фиксирована и заранее известна мне из ТЗ.

Приложение должно уметь удобно для оператора представлять данные, хранящиеся в базе, позволять добавлять новые записи, удалять и изменять уже существующие.

Далее я кратко опишу процесс разработки с приведением кусков кода и попытаюсь аргументированно объяснить, почему в данном случае был сделан выбор в пользу QSqlRelationalTableModel.

Начало разработки


Изначально было принято решение основать взаимодейстие с бд с помощью простых запросов к базе, т.е. SELECT, INSERT, DELETE, которые позволяют реализовать все необходимые функции приложения.

Для этого нам потребуются классы QSqlDatabase и QSQlQuery:

QSqlDatabase db; //создаем объект нашей базы
db = QSqlDatabase::addDatabase("QSQLITE"); //добавляем базу конкретного типа
        db.setHostName("localhost"); //в общем случае, может быть локалхостом
        db.setDatabaseName(path); //QString path - путь к базе

//проверка корректности открытия
        if(db.open()){
            qDebug() << "db opened OK...";
        }else{
            qDebug() << " db opening failed...";
        }
    }else{
        qDebug() << "file doesnot exist";
        exit(0); //в случае, когда файл базы не существует, 
               //просто завершим приложение 
    }

После этого все операции над базой совершаются следующим образом:

//сформируем запрос, значение возьмем из <b>QLineEdit</b>'а
QString query = "INSERT INTO Table (column) VALUES ('" + ui->Input->text() + "')"; 
    QSqlQuery sqlQuery(db); //cсоздаем объект запроса
    qDebug() << "QUERY: " << query; //вывод

//понятно без пояснений
    if(sqlQuery.exec(query)){
          qDebug() << "query failed...";
    }
    else{
          qDebug() << "query failed...";
      }

Select statement'ы выполняются аналогично, за исключением того, что данные еще нужно получить и куда-то положить:

QString query = "SELECT id, ka FROM Table";
QSqlQuery sqlQ(db);

     if(!sqlQ.exec(query)) {
         qDebug() << "query failed...";
         return;
     }

//отличия только в этой части
//необходимо проверять, остались ли еще значения и получать их
     while (sqlQ.next()){
//получим значение и например добавим его в комбобокс со всеми значениями
         ui->ComboBox->addItem(sqlQ.value(1).toString(),sqlQ.value(0).toInt());
     }

Delete-statement'ы выполняются в точности так же, как Insert из-за того, что ничего не возвращают.

Все хорошо, в чём проблема?


И правда, ведь можно все реализовать через эти выражения и запросы, зачем нам модели?

Когда у нас есть одна ни с чем не связанная таблица, то все кажется очень простым и не требующим введения дополнительных инструментов. А теперь представьте, что у нас таких таблиц, например, 5, в каждой по 5 столбцов, не включая id. Причем каждая имеет связь с предыдущей с помощью foreign key через id, т.е. при удалении необходимо каскадно удалять все «дочерние» записи. Это приводит к огромному количеству запросов, работа приложения сильно замедляется, более того, необходимо каждый раз обновлять таблицу и ее представление в интерфейсе, что приводит к написанию дополнительных функций для обновления, появлению багов или к риску их возникновения, да и в целом к снижению читаемости кода.

Именно по этой причине в процессе разработки пришлось отказаться от концепции использования голых SQL запросов.

Дальнейший выбор был сделан в пользу QSqlRelationalTableModel в связке с QTableView. Есть еще более простая версия реализации модели — QSqlTableModel , первая наследована от нее, имеет все те же методы, но добавляет возможность создания связи QSqlRelation, что очень удобно, если пользователю нужно показать не id записи, а название записи «родителя», с которой она связана.

Посмотрим уже на реализацию с моделями


Приведу отрывки пода, показывающие реализацию model/view.

В заголовочном файле:

QSqlRelationalTableModel *model;

В конструкторе:

//необходимо соединить сигнал, эмитируемый при нажатии 
//на ячейку QTableView со слотом, вызываемым этим сигналом
//QModelIndex хранит в себе индекс ячейки, на которую было совершено нажатие
connect(ui->tableView, SIGNAL(clicked(const QModelIndex &)), this, SLOT(onTableClicked(const QModelIndex &)));
model = new QSqlRelationalTableModel(parent, db); //создадим модель, QSqlDatabase в качестве параметра
model->setTable("Table"); //свяжем модель с таблицей

В строчке ниже заключается одна из самых удобных фишек и преимуществ модели перед sql запросами — она редактирует, добавляет, удаляет, в зависимости от контекста, данные в sql таблице при изменении из в QTableView. Удобство в том, что больше не нужно контролировать корректность каскадного удаления данных и их обновление в рамках одного QTableView.

model->setEditStrategy(QSqlRelationalTableModel::OnFieldChange); 

Далее идет еще одна удобная фишка, предоставляемая этим классом: устанавливается связь между двумя колонками разных таблиц:

//ParentTable - таблица, с колонкой которой устанавливаем соответствие
//id - параметр, по которому будет осуществлен выбор и установлено соответствие
//name - параметр, который будет отображаться в колонке нашей таблицы 
model->setRelation(1,QSqlRelation("ParentTable", "id", "name"));

Далее все более стандартно: select() выполнит SELECT выражение, а setHeaderData() установит текст в заголовки QTableView:

model->select();
model->setHeaderData(0, Qt::Horizontal, tr("id"));
model->setHeaderData(1, Qt::Horizontal, tr("id_sub"));
model->setHeaderData(2, Qt::Horizontal, tr("count"));
model->setHeaderData(3, Qt::Horizontal, tr("number"));
model->setHeaderData(4, Qt::Horizontal, tr("data_word"));
model->setHeaderData(5, Qt::Horizontal, tr("time"));
model->setHeaderData(6, Qt::Horizontal, tr("name"));
model->setHeaderData(7, Qt::Horizontal, tr("description"));
ui->tableView->setModel(model); //установим нашу модель на нужный QTableView

Теперь модель и tableView работают вместе и выполняют свои функции. По ссылке на github будут оставлены все исходники, в них я реализовал добавление записи в модель, ее удаление, а также фильтры.

Заключение


В этой статье я хотел призвать всех тех, кто уже работает с БД в Qt отказываться от голых sql запросов для проектов уже хотя бы среднего уровня сложности и переходить на работу с моделями, чтобы упростить себе жизнь, сделать код более читабельным и универсальным, ну и просто сделать что-то хорошее и новое.

На этом все! Надеюсь, что мой опыт работы с данными классами поможет читателям успешно решить схожую проблему!
Share post

Comments 5

    +2
    Мне кажется у вас просто перепечатка справки. Которая многократно была переведена в версии 4.х.х.
    И совет ваш очень вредный, ибо будет «тормозить» просто безбожно.
      +1
      каждая имеет связь с предыдущей с помощью foreign key через id, т.е. при удалении необходимо каскадно удалять все «дочерние» записи. Это приводит к огромному количеству запросов, работа приложения сильно замедляется...

      В SQLite можно настроить автоматическое каскадное удаление по foreign key, так что одного sql-запроса достаточно. Даже, если бы такого не было, то никакая дополнительная абстракция не поможет избежать выполнения нужного числа запросов.
        0
        Использовал QSqlRelationalTableModel в проекте на работе 9 лет назад, всё устраивало, пока не вышла Qt 4.8, в которой что-то сломали — подозреваю, специально, — и приложение стало падать, если на месте связи значение NULL. Также не работает на view по причине отсутствия у них первичного ключа. В общем, за последние 9 лет мне ни разу не пригодился этот класс в моих проектах, QSqlTableModel + view с правилами на изменение намного удобнее, хотя и приходится писать небольшую обвязку для делегатов.
          +2

          Первый способ крайне опасный, если вы не пишите приложение чисто для себя. Привет sql инъекции. Допускаю, что вы код накидали чисто для примера, но в любом случае не стоит так делать.

            0

            Этот код я привёл только для примера, никого так делать не призываю, это опасно с точки зрения инъекций. К тому же, есть немного более лаконичный способ с bindValue().

          Only users with full accounts can post comments. Log in, please.