Работа с базами данных в wxWidgets - DatabaseLayer - Минимальное приложение

Вслед за анонсом новой версии DatabaseLayer, кросс-платформенной библиотеки для работы с базами данных, решил выложить небольшой туториал с примером использования DatabaseLayer.

В этот раз мы рассмотрим пример создания простейшего консольного приложения, использующего эту библиотеку для работы с базами данных.

В качестве среды разработки будем использовать Visual Studio. Это самый простой способ добиться желаемого результата. Бесплатная версия Visual Studio Express Edition тоже вполне подойдет для создания приложений на С++/wxWidgets.

Для начала создадим консольное приложение и назовем его DatabaseLayerMinimal.

В настройках проекта указываем тип приложение Console Application и стамим маркер на Empty Project.

После того как мы создали проект, распаковываем DatabaseLayer рядом с папкой, в которой находится .sln-файл решения.

Затем добавляем в решение проект databaselayer_databaselayer_sqlite.dsp - это проект SqliteDatabaseLayer, который позволяет получить доступ к базам данных SQLite в приложении.

После этого необходимо настроить конфигурации сборки. Открываем Configuration Manager (Build -> Configuration Manager) и устанавливаем для проекта databaselayer_sqlite нужную отладочную и финальную конфигурацию. В нашем примере это Static Unicode Debug Multilib Static и Static Unicode Release Multilib Static.

После этого в нашем проекте приложения необходимо настроить пути для поиска заголовочных файлов, файлов библиотек, а также список дополнительных библиотек для сборки проекта.

Для этого в свойствах проекта в разделе C/C++ -> General в свойстве Additional Include Directories прописываем:

$(SolutionDir)..\databaselayer\include

В разделе Linker -> General в свойстве Additional Library Directories прописываем:

$(SolutionDir)..\databaselayer\lib\vc_lib

В разделе Linker -> Input в свойстве Additional Dependencies указываем список необходимых библиоек:

Все, настройку проекта мы закончили, теперь можно заняться написанием кода.

Для каждого сервера баз данных в библиотеке DatabaseLayer существует соответствующий класс соединения. В нашем примере мы будем работать с базой данных SQLite. Для этого будем использовать класс SqliteDatabaseLayer.

Для того чтобы открыть базу данных можно использовать два пути:

• Вызвать конструктор с параметрами и скормить ему путь к базе данных.
• Использовать конструктор без параметров и метод Open().

В нашем примере будет использоваться первый способ.

Для разрыва соединения с базой данных (или для закрытия файла базы данных) используется метод Close().

В библиотеке DatabaseLayer для обработки ошибок используется механизм исключений. Для обработки ошибок необходимо отлавливать исключение DatabaseLayerException.

Итак, минимальное приложение, способное открыть базу данных выглядит так:

#include <wx/wx.h>
#include <DatabaseLayer.h>
#include <SqliteDatabaseLayer.h>
#include <DatabaseLayerException.h>

int main()
{
	int returnCode(0);
	DatabaseLayer * connection(NULL);
	do
	{
		try
		{
			connection = new SqliteDatabaseLayer(wxT("Minimal.sqlite"), false);
		}
		catch(DatabaseLayerException & e)
		{
			returnCode = 2;
			wxPrintf(wxT("%d %s"), e.GetErrorCode(), e.GetErrorMessage().GetData());
		}
	}
	while(false);
	wxDELETE(connection);
	getchar();
	return returnCode;

Необходимо помнить, что все ресурсы нужно освобождать руками.

Для выборки данных из таблицы используется метод RunQueryWithResults(), который возвращает указатель но объект DatabaseResultSet. После работы с результатми запроса, объект DatabaseResultSet необходимо обязательно закрыть во избежание утечек памяти. Сделать это можно, вызывав метод DatabaseLayer::CloseResultSet().

Для обхода записей, возвращенных с помощью метода RunQueryWithResults() используется метод DatabaseResultSet::Next().

Для получения значения поля в классе DatabaseResultSet существует соответствующий набор методов - GetResultInt(), GetResultString(), GetResultBool() и т.д. Каждый из этих методов может принимать как имя поля, так и порядковый номер (zero-based).

Для запросов, которые не возвращают список записей (INSERT, DELETE) используется метод RunQuery().

И вот со всем, описанным выше, мы подошли к рассмотрению более сложного примера - приложение открывает базу данных SQLite, проверяет ее на наличие таблиц. Если таблицы не найдены, то приложение создает одну таблицу и заполняет ее данными. После этого происходит выборка данных и отображение результатов выборки в консоли.

#include <wx/wx.h>
#include <DatabaseLayer.h>
#include <SqliteDatabaseLayer.h>
#include <DatabaseLayerException.h>

int main()
{
	int returnCode(0);
	DatabaseLayer * connection(NULL);
	DatabaseResultSet * result(NULL);
	do
	{
		try
		{
			connection = new SqliteDatabaseLayer(wxT("Minimal.sqlite"), false);
			result = connection->RunQueryWithResults(
				wxT("SELECT * FROM sqlite_master WHERE type='table'"));
			if(!result || !result->Next())
			{
				connection->RunQuery(
					wxT("CREATE TABLE SampleTable \
						(ID INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, \
						Name VARCHAR(32))"));
				for(int i = 0; i < 5; i++)
				{
					connection->RunQuery(wxString::Format(
						wxT("INSERT INTO SampleTable (Name) VALUES ('%i')"), rand()));
				}
			}
			if(result)
			{
				connection->CloseResultSet(result);
				result = NULL;
			}
			result = connection->RunQueryWithResults(wxT("SELECT * FROM SampleTable"));
			if(!result)
			{
				returnCode = 1;
				break;
			}
			while (result->Next())
			{
				wxPrintf(wxT("%d - %s\r\n"),
					result->GetResultInt(wxT("ID")),
					result->GetResultString(wxT("Name")).GetData());
			}
		}
		catch(DatabaseLayerException & e)
		{
			returnCode = 2;
			wxPrintf(wxT("%d %s"), e.GetErrorCode(), e.GetErrorMessage().GetData());
		}
	}
	while(false);
	if(connection)
	{
		if(result) connection->CloseResultSet(result);
	}
	wxDELETE(connection);
	getchar();
	return returnCode;

}

}

Скачать исходный код примера.