Qt - tworzenie połączenia z bazą danych i wysyłanie zapytań SQL do serwera

Stronę tą wyświetlono już: 1803 razy

Wstęp

Do tworzenia połączenia z bazą danych SQL w Qt służy klasa QSqlDatabase. Niestety połączenie z bazą danych uruchomioną na lokalnym serwerze lub gdzieś na serwerze, do którego dostęp jest umożliwiony poprzez sieć lokalną czy też globalną wymaga odpowiedniego sterownika. W przypadku MySQL sterownik ten nie jest domyślnie dostępny. Oznacza to, że aby możliwe było realizowanie połączenia z bazą danych MySQL trzeba ściągnąć z strony dev.mysql.com/downloads/connector/c/ odpowiednią paczkę ze sterownikami zwracając uwagę na wersję Qt Creator-a zainstalowaną na komputerze, gdyż dla wersji 32-bitowej jest inna paczka a dla 64-bitowej inna. W moim przypadku pobrałem wersję 32-bitową i ją rozpakowałem a następnie plik libmysql.dll znajdujący się w folderze lib rozpakowanych plików należy przekopiować do folderu kompilatora, który w moim przypadku znajduje się w:

Listing 1
  1. sciezka_do_folderu_z_Qt/Qt/Qt5.6.3/5.6.3/mingw49_32/bin

To jednak nie wszystko, albowiem zaprawdę powiadam wam, że konieczne jest jeszcze w pliku .pro dodanie ścieżki do plików nagłówkowych z rozpakowanej paczki:

Listing 2
  1. INCLUDEPATH += sciezka_do_folderu_z_paczką/mysql-connector-c-6.1.11-win32/include

Skoro już jestem w pliku .pro to dodaję jeszcze następującą linijkę:

Listing 3
  1. QT += sql

dzięki której będzie możliwy dostęp do plików nagłówkowych związanych z obsługą baz danych SQL.

Tworzenie w MySQL przykładową bazę danych do testów

Do testów konieczne jest utworzenie bazy danych oraz jakiegoś testowego użytkownika, który ma dostęp i pełne uprawnienia jedynie do tej bazy danych. Robię to w konsoli systemowej logując się w następujący sposób:

Listing 4
  1. mysql -u root -p

Parametr -u oznacza, że wprowadzam nazwę użytkownika, zaś -p, że chcę podać hasło. Po zalogowaniu tworzę bazę danych i użytkownika oraz jakąś prostą tabelkę z jednym rekordem za pomocą następującego kody SQL:

Listing 5
  1. CREATE DATABASE library CHARACTER SET utf8 COLLATE utf8_general_ci
  3. CREATE USER gienek@localhost IDENTIFIED BY 'password';
  5. GRANT ALL ON library.* TO gienek@localhost;
  7. USE library;
  9. CREATE TABLE books (
  10. id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  11. title CHAR(255) NOT NULL,
  12. author CHAR(255) NOT NULL
  13. );
  15. INSERT INTO books (title, author)
  16. VALUES
  17. ('Rio Anaconda', 'Wojciech Cejrowski');

W pierwszej linijce powyższego kodu tworzę bazę danych o nazwie library, w której kodowanie znaków zostało ustawione na UTF-8. W trzeciej linijce kodu tworzę użytkownika o dźwięcznej i niewiele znaczącej nazwie gienek, który ma dostęp do bazy danych jedynie przez localhost. Gienek to sprytny gość, więc do logowania używa niewymagającego zapamiętywania hasła o nazwie password. W piątej linijce gienkowi przydzielany jest przywilej korzystania z bazy danych library na wszystkie w niej znajdujące się tabele z możliwością wykonywania wszystkich dostępnych operacji. W siódmej linijce wchodzę do bazy danych library by po chwili z najdzikszą rozkoszą sięgającą granic pojmowania ludzkiego umysłu tworzę tabelę o przebiegłej nazwie books. Tabela ta zawiera pole id będące kluczem typu unsigned int z ustawioną opcją automatycznego przyrostu wartości przy dodawaniu rekordów do bazy danych. Kolejne pola tej tabeli to title i author, których maksymalna długość może osiągnąć zawrotną wartość 255 znaków. Po utworzeniu w tak żmudnym procesie tabeli niezwłocznie należy oddać się dzikiej rozkoszy dodania do niej jednej pozycji książkowej, co też i czynię w linijce piętnastej.

Baza danych - pierwszy kontakt

Oczywiście do utworzenia bazy danych jak i połączenia się z nią konieczna jest obecność w systemie uruchomionego serwera SQL w moim przypadku używam XAMPP-a, który zainstalował mi cały pakiet tego, co potrzebne jest do uruchomienia serwera SQL na localhost. W moim przypadku połączenie uzyskam wykorzystując następujący kod w pliku mainwindow.h:

Listing 6
  1. #ifndef MAINWINDOW_H
  2. #define MAINWINDOW_H
  4. #include <QMainWindow>
  6. #include <QDebug>
  7. #include <QMessageBox>
  8. #include <QStringList>
  10. #include <QSqlDatabase>
  11. #include <QSqlError>
  12. #include <QSqlQuery>
  14. #include <mysql.h>
  16. namespace Ui {
  17. class MainWindow;
  18. }
  20. class MainWindow : public QMainWindow
  21. {
  22. Q_OBJECT
  24. QSqlDatabase db;
  26. void readRecordsToListWidget();
  28. public:
  29. explicit MainWindow(QWidget *parent = 0);
  30. ~MainWindow();
  32. private slots:
  33. void on_btAdd_clicked();
  35. void on_records_doubleClicked(const QModelIndex &index);
  37. void on_btRemove_clicked();
  39. private:
  40. Ui::MainWindow *ui;
  41. };
  43. #endif // MAINWINDOW_H

W pliku mainwindow.cpp:

Listing 7
  1. #include "mainwindow.h"
  2. #include "ui_mainwindow.h"
  4. // https://dev.mysql.com/downloads/connector/c/
  6. MainWindow::MainWindow(QWidget *parent) :
  7. QMainWindow(parent),
  8. ui(new Ui::MainWindow)
  9. {
  10. ui->setupUi(this);
  12. db = QSqlDatabase::addDatabase("QMYSQL"); // tworzę bazę danych z wykorzystaniem sterownika QMYSQL
  14. db.setDatabaseName("library"); // ustawiam nazwę biblioteki, pod którą chcę się podpiąć
  15. db.setHostName("localhost"); // nazwa serwera
  16. db.setPassword("password"); // hasło gienka
  17. db.setPort(3306); // port połączenia z bazą danych
  18. db.setUserName("gienek"); // nazwa użytkownika
  20. if(!db.open()){ // próbuję otworzyć bazę danych i jak się nie otworzy to
  21. qDebug() << "ERROR load: " << db.lastError().text(); // wyświetlam błąd ładowania w konsoli kompilatora
  22. }else{
  23. qDebug() << "Is opened"; // wszystko cacy
  24. readRecordsToListWidget(); // więc wczytuję dane do mojej kontrolki QListWidget
  25. }
  26. }
  28. void MainWindow::readRecordsToListWidget(){
  29. QSqlQuery query(db); // tworzę obiekt zapytania i podpinam go pod otwartą bazę danych
  30. ui->records->clear(); // usuwam wszystkie elementy kontrolki
  31. if(query.exec("SELECT id, title, author FROM books")){ // wysyłam zapytanie do bazy danych
  32. while(query.next()){ // jeżeli są jakieś wyniki to
  33. // wstawiam rekord do kontrolki QListWidget
  34. ui->records->addItem(new QListWidgetItem(query.value(0).toString() + " \"" + query.value(1).toString() + "\" " + query.value(2).toString(), ui->records));
  35. }
  36. }else{
  37. qDebug() << query.lastError().text(); // wyświetlam w konsoli Qt Creatora informację błędu, gdy zapytanie zakończy się niepowodzeniem
  38. }
  39. }
  41. MainWindow::~MainWindow()
  42. {
  43. delete ui;
  44. }
  46. void MainWindow::on_btAdd_clicked() // dodawanie elementu do bazy danych
  47. {
  48. // sprawdzanie, czy kontrolki edAuthor i edTitle nie zawierają niedozwolonych znaków
  49. if(ui->edAuthor->text().indexOf("\"") != -1){
  50. ui->edAuthor->setText( ui->edAuthor->text().replace("\"", "") );
  51. QMessageBox::information(this, "Ostrzeżenie", "Pole autora książki zawierało niedozwolony znak \", który został usunięty");
  52. }
  53. if(ui->edTitle->text().indexOf("\"") != -1){
  54. ui->edTitle->setText( ui->edTitle->text().replace("\"", "") );
  55. QMessageBox::information(this, "Ostrzeżenie", "Pole tytułu książki zawierało niedozwolony znak \", który został usunięty");
  56. }
  58. if(ui->edAuthor->text().size() && ui->edTitle->text().size()){ // jeżeli pola tekstowe nie są puste to
  59. QSqlQuery query(db); // tworzę obiekt zapytania
  60. // przygotowuję zapytanie SQL, sprawdzające, czy w bazie danych jest już książka o podanym tytule i autorze
  61. query.prepare("SELECT title, author FROM books WHERE title = :title AND author = :author LIMIT 1;");
  62. // podpinam pod nie dane
  63. query.bindValue(":title", QVariant::fromValue(ui->edTitle->text())); // tekst z kontrolki edTitle zostanie oddzielnie wysłany a następnie wstawiony do zapytania za :title
  64. query.bindValue(":author", QVariant::fromValue(ui->edAuthor->text())); // to samo co powyżej
  66. if(
  67. query.exec() && (!query.next() // jak zapytanie zakończyło się powodzeniem i zwróciło element lub użytkownik postanowił dodać zduplikowany rekord to
  68. ||
  69. QMessageBox::warning( // jeżeli
  70. this,
  71. "Ostrzeżenie",
  72. "Autor i tytuł już istnieje na liście, czy chcesz"
  73. " mimo to dodać tę pozycję ponownie?",
  74. QMessageBox::Yes | QMessageBox::No
  75. ) == QMessageBox::Yes)){
  76. // przygotowuję nowe zapytanie
  77. query.prepare("INSERT INTO books (title, author) VALUES (:title, :author);");
  78. // binduję wartości
  79. query.bindValue(":title", QVariant::fromValue(ui->edTitle->text()));
  80. query.bindValue(":author", QVariant::fromValue(ui->edAuthor->text()));
  81. // wykonuję zapytanie
  82. if(query.exec()){
  83. readRecordsToListWidget(); // i jeżeli zakończy się ono powodzeniem to odświerzam listę rekordów
  84. }
  85. }
  86. }
  87. }
  89. void MainWindow::on_records_doubleClicked(const QModelIndex &index) // zdarzenie kliknięcia dwukrotnego w oknie kontrolki
  90. {
  91. QString recordData = index.data().toString();
  92. QStringList record = recordData.split(" \"");
  93. QStringList record2 = record[1].split("\" ");
  94. record.removeAt(1);
  95. record += record2;
  96. if(record.size() == 3){
  97. ui->edTitle->setText(record[1]); // wczytuję rekord do kontrolki tytułu
  98. ui->edAuthor->setText(record[2]); // wczytuję rekord do kontrolki autora
  99. }
  100. }
  102. void MainWindow::on_btRemove_clicked() // zdarzenie kliknięcia przycisku usunięcia zaznaczonego elementu
  103. {
  104. if(ui->records->currentItem()){
  105. QString recordData = ui->records->currentItem()->data(Qt::DisplayRole).toString();
  106. QStringList record = recordData.split(" \"");
  108. bool ok = false;
  109. int index = record[0].toInt(&ok);
  111. if(ok){
  112. QSqlQuery query(db);
  114. query.prepare("DELETE FROM books WHERE id = :id;"); // zapytanie usuwające wybrany rekord
  116. query.bindValue(":id", index);
  118. if(query.exec()){
  119. readRecordsToListWidget();
  120. }else{
  121. qDebug() << query.lastError();
  122. }
  123. }
  124. }
  125. }

Poniżej można zobaczyć screen programu umożliwiającego dodawanie i usuwanie rekordów z bazy danych.

Przykład programu łączącego się z bazą danych MySQL
Rys. 1
Przykład programu łączącego się z bazą danych MySQL na localhoście
Strony powiązane
strony powiązane
  1. doc.qt.io/qt-5/qsqldatabase.html - opis kasy QSqlDatabase na stronie dokumentacji Qt
  2. doc.qt.io/qt-4.8/qsqlquery.html - opis kasy QSqlQuery na stronie dokumentacji Qt
Tematy powiązane

Komentarze