C++. Using sqlite in a managed c cli application

В предыдущей теме "C++. How use SQLite in Windows Forms" по-сути были одни голые слова, что-то где-то прочитал, где-то додумал, где-то слышал. Но на деле так и не получалось продвинуться, не было ясности, и вот на глаза попался блог разработчика Дэвида Креви - http://dcravey.wordpress.com, тема топика - "using-sqlite-in-a-managed-c-cli-application". Вот то, что мне нужно было. This helped me to understand some things and pushed to the decision. Thank you David Cravey :) Здесь я попытаюсь расширить его рецептик: от начала и до конца.

Начну с того, что указанный ресурс http://sqlite.phxsoftware.com/ (не смотря на официальность) для получения SQLite .NET версии поддерживался до апреля 2010 года (SQLite-1.0.66.0-setup.exe). Не совсем хорошо в своих разработках использовать "несвежачок". Для получения последних релизов нужно обратиться на другой официальный ресурс - http://system.data.sqlite.org. Итак, первый шаг, обращаемся к этому ресурсу в раздел "Download" и качаем нужный установочный пакет. Нужность определяется вашей средой разработки, в моем случае - Microsoft Visual C++ 2008 Express Edition, поэтому я скачал sqlite-netFx35-setup-bundle-x86-2008-1.0.82.0.exe. Почему? Потому что там же сказано:

This setup package features the mixed-mode assembly and will install all the necessary runtime components and dependencies for the x86 version of the System.Data.SQLite 1.0.83.0 (3.7.15.1) package. The Visual C++ 2008 SP1 runtime for x86 is included. The .NET Framework 3.5 SP1 is required.
This setup package is capable of installing the design-time components for Visual Studio 2008.

С самого начала я создал проект testDB (Templates - Windows Form Application) и все последующие действия буду сопровождать скриншотами, чтобы была наглядность.


Создание проекта testDB
Свойства проекта


Свойства проекта. Расширенное
До запуска установки пакета не поленитесь заглянуть в свойства проекта, там где определяются имена ссылок целевого .NET framework, в моем случае - .NET framework 3.5. Имена ссылок определяют пространство имен, которое используется при кодинге, расширяя наши возможности. Немного отвлеклись. Если Вы заглянули, то можете видеть отсутствие каких-либо намеков на SQLite. Вот теперь, шаг второй - запускаем установку нашего пакета.

Установка пакета
Все по-умолчанию и проставляем все флажки. Вуаля, пакет установлен.
Шаг третий. После окончания установки нужно пройти в свойства проекта и добавить новые ссылки (References -> Add New References -> Вкладка .NET -> System.Data.SQLite.Core и другие).
Данный пакет расширит имена ссылок целевой платформы .NET framework 3.5 (расширение пространства имен System.Data).


Список активных ссылок


Добавление новых ссылок на System.Data.SQLite


Если Вы воспользовались версией SQLite-1.0.66.0, название ссылок может немного отличаться.
После установки пакета в установочной директории (если Вы ничего не меняли) - C:\Program Files\System.Data.SQLite в поддиректории \2008\bin будут располагаться те самые динамические библиотеки - System.Data.SQLite.dll и System.Data.SQLite.Linq.dll.
Для версии SQLite-1.0.66.0 немного иначе - C:\Program Files\SQLite.NET и поддиректория \bin.
Данные библиотеки уже готовы к использованию, в отличие от "C"шной SQLite библиотеки, где нужно проводить "линковку", например при разработке консольных приложений. Об этом можно почитать здесь - Связывание с динамической библиотекой в Visual C++, Разработка консольного приложения для работы с базой данных SQLite.
Каждая ссылка ссылается (поэтому она и называется ссылкой (Reference)) на соответствующую динамическую библиотеку (*.dll). Если использовать свежие релизы, то при установке пакета для удобства можно включить так называемый Caching metadata (флажок выставлен по-умолчанию), в результате вам не нужно будет располагать библиотеки в директории проекта, в отличии от SQLite-1.0.66.0, где такой возможности нет, а значит нужно будет ручками дополнительно ко всем манипуляциям скопипастить из \bin директории в директорию Вашего проекта соответствующие библиотеки.
Итак, мы готовы к кодингу. Для последующей самопроверки используя консольный движок sqlite3.exe (command-line shell) я создал простеньую базу данных sqlitedb.db состоящая из одной таблицы ipaddress. Далее в две колонки добавил записей. Созданную базу данных рассположил в директории проекта.
Что касается кодинга, для начала в месте объявлений используемых пространств имен прописываем:

 

 
//SQLite
 using namespace System::Data::SQLite;
 using namespace System::Text;
 

 

Изначально на форме были размещены такие активные компоненты как button и textbox, ими и воспользуемся:

 
private: System::Void button1_Click(System::Object^  sender, System::EventArgs^  e) {
    // Create The Connection Object
    SQLiteConnection ^db = gcnew SQLiteConnection();
    try {
      // Open Database Connection
      MessageBox::Show("Opening Database Connection To sqlitedb.db ...");
      db->ConnectionString = "Data Source=sqlitedb.db";
      db->Open();
      MessageBox::Show("Database Connection To sqlitedb.db Opened.");

      // Display Table
      try {
        MessageBox::Show("Displaying Table ...");
        SQLiteCommand ^cmdSelect = db->CreateCommand();
        cmdSelect->CommandText = "SELECT * FROM ipaddress;";
        SQLiteDataReader ^reader = cmdSelect->ExecuteReader();
        StringBuilder ^sb = gcnew StringBuilder();
        for (int colCtr = 0; colCtr < reader->FieldCount; ++colCtr) {
         
         // Add Seperator (If After First Column)
         if (colCtr > 0) sb->Append("|");

         // Add Column Name
         sb->Append(reader->GetName(colCtr));
        }
        sb->AppendLine();
        sb->Append("~~~~~~~~~~~~");
        sb->AppendLine();
        while (reader->Read()) {
         for (int colCtr = 0; colCtr < reader->FieldCount; ++colCtr) {
          // Add Seperator (If After First Column)
          if (colCtr > 0) sb->Append("|");

          // Add Column Text
          sb->Append(reader->GetValue(colCtr)->ToString());
         }
         sb->AppendLine();
        }
        // Browse result
        //  ...by use textBox1
        this->textBox1->AppendText(sb->ToString());
        // ...or like this method
        // MessageBox::Show(sb->ToString(), "SQLite MyTable");
       } catch (Exception ^e) {
         MessageBox::Show("Error Executing SQL: " + e->ToString(), "Exception While
                                                            Displaying MyTable ...");
       }
      // Close Database Connection
      MessageBox::Show("Closing Database Connection To sqlitedb.db ...");
      db->Close();
      MessageBox::Show("Database Connection To sqlitedb.db Closed.");
     } finally {
       // Dispose Database Connection
       delete (IDisposable^)db;
     }
    }
 


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


Приложение in action. Результат на лицо

Листинги, базу данных и "солюшн" под Visual Studio C++ 2008 EE можно скачать по ссылке - download.
Немного затрону тему инсталляции и распространения Вашего готового релиза.
Во-первых, нужно помнить, что в состав готового дистрибутива нужно в обязательном порядке включить используемые при разработке динамические библиотеки;
Во-вторых, так как приложение ориентировано на .NET framework платформу, то нужно обеспечить предустановку соответствующего фреймворка, в моем случае - .NET framework 3.5;  
Для небольшого тестинга я попробывал перенести таким образом дистрибуив на другую машину. Изначально разработка велась под Windows 7 SP1 (иногда под Windows Vista HB), переносил и тестировал на Windows XP SP3.


Пойманное исключение. Отсутствие динамической библиотеки
Приложение in action
Изначально во время запуска было поймано исключение, которое я вызвал искусственно - не добавил динамическую библиотеку. Как только ее размещаем, приложение отрабатывает на должном уровне.

Еще раз по поводу предустановки .NET framework, для заметки. Работоспосбность приложения сохраняется независимо от версии фреймворка, но немного снижается быстрота отклика (чисто по наблюдениям, серьезно не воспринимать, все-таки нужны численные сравнения), при полном отстствии .NET фреймворков на запуск приложения система ругается меседжем:
The application failed to initialize properly (0xc0000135).


Итог отсутствия ".NET framework"-ов

--------------------------------------------------------------------------------------------------------------

Почему столько много внимания и времени я уделил SQLite библиотеке? Конечно, есть другие технологии работы с базами данных MySQL, Microsoft SQL (также есть легковесная версия - microsoft sql server compact edition), другие. SQLite привлек меня тем, что он - 1) относится к независимым разработкам; - 2) действительно легковесный; - 3) возможность создания базы данных в памяти (виртуальная БД), можно использовать для расширения внутренней области памяти приложения или можно подключить к основной базе данных и использовать ее для кэширования; - 4) можно в любой момент к открытому подключению добавить до 10 баз данных; - 5) ну и все те возможности, присущие другим базам данных - журналы транзакции, логирование, режимы бэкапа и многое другое.



C++. How use SQLite in Windows Forms

В свое время знакомство с движком SQLite ограничилось разработками консольных приложений. Но вот настало время и более интересному использованию: интеграция в проекты сопряженных с созданием UI с помощью Windows Forms. Как и ранее я буду работать со средой разработки Microsoft Visual C++ 2008 Express Edition.
В отличии от консольных приложений все попытки связать SQLite с такого рода проектами были безуспешными. Может конечно у Вас получится, буду очень благодарен за письмо в мой адрес с Вашим рецептом. Приготовить по рецепту с официального сайта (The SQLite Amalgamation) также не удалось.

Из логов компилятора:
  • Command line error D8045 : cannot compile C file '.\sqlite3.c' with the /clr option
  • error LNK2019: unresolved external symbol _sqlite3_exec referenced in function _main
  • error LNK2019: unresolved external symbol _sqlite3_open referenced in function _main
Вопрос - почему? Причем этот вопрос судя по результатам поиска в "инете" не единичный. Как выяснилось чуть погодя проблема была связана с тем, что по сути своей Windows Forms является частью Microsoft .NET Framework. Внутри которой Windows Forms реализуется в рамках пространства имён System.Windows.Forms. В связи с этими нюансами и просходили всякие неприятности на моей кухне. И под конец на глаза попалась книжечка Using SQLite. Jay A. Kreibich, где сказано:


Building


There are a number of different ways to build SQLite, depending on what you’re trying


to build and where you would like it installed. If you are trying to integrate the SQLite

core into a host application, the easiest way to do that is to simply copy


sqlite3.c and


sqlite3.h
 

into your application’s source directory. If you’re using an IDE, the sqlite3.c


file can simply be added to your application’s project file and configured with the proper

search paths and build directives. If you want to build a custom version of the SQLite

library or


sqlite3 utility, it is also easy to do that by hand.


All of the SQLite source is written in C. It cannot be compiled by a C++ compiler. If

you’re getting errors related to structure definitions, chances are you’re using a C++

compiler.


Вопрос был снят. Получается, что нужно адаптировать SQLite библиотеку под .NET Framework. Для этого на официальном сайте есть ссылка на так называемый ADO.NET adapter for SQLite - System.Data.SQLite. 

Среди этих ресурсов (например - здесь) можно встретить вот такой ролик, который демонстирует сие адаптер - так сказать - in action. 

 

P.S.: For a CLR/.NET/WinForms projects you should use System.Data.SQLite.
Всем удачи :)

 

C/C++. Обращение к глобальным и локальным переменным

Не буду многословен. Для прямого обращения к глобальной переменной можно воспользоваться оператором расширения области видимости переменной variable:

::variable;

Соотвественно, для локальной переменной - по адресу.

some_function(&variable);

Ниже приведен примерчик для нагядности слов :)

#include <iostream>
using namespace std;
// Глобальная инициализация
// Глобальная переменная
int n = 100;
void glob() {
 ::n++;
}
void loc(int *n) {
 (*n)++;
}
int main() {
 // Локальная инициализация
 char temp;
 // Локальная переменная
 int n = 16;

 // ...до изменения переменных
 cout << "Global var before: n = " << ::n << "\n";
 cout << "Local var before: n = " << n << "\n";

 // Обращаемся к глобальной переменной и меняем ее
 glob();
 // Обращаемся к локальной переменной и также меняем ее
 loc(&n);
 // ...после изменения переменных
 cout << "Global var after: n = " << ::n << "\n";
 cout << "Local var after: n = " << n << "\n";
 // задержка...
 cin >> temp;
}

В итоге имеем:
 
Ура, все работает.

C++/CLI. Write to buffer (change cout on char buffer) and get string data from char buffer

Работая над проектом возникла необходимость в перехвате (громко сказано) стандартного вывода ( printf() ) для анализа того, с чем же приходилось работать. Далеко не копая, воспользовался "C"-шной функцией - sprintf(). Здесь небольшой faq. Данная функция на выходе все кладет в буфер. Приведу примерчик:

#include <stdio.h>

int main( void )
{
   char  buffer[200];
   int   j;
   


   /* Format and print various data: */
   j  = sprintf( buffer,     "   First string\n");
   j += sprintf( buffer + j, "   Second string\n");
   

   printf( "Output:\n%s\ncharacter count = %d\n", buffer, j );
}

 

 

 

 
В итоге имеем:

Output:

First string

Second string

character count = 25

 

 

 

 
 То, что нужно. Далее снова появилась мини-задачка: буфер - он и в Африке буфер, мне нужны были содержащиеся в нем данные, в частности - все "пойманные" строки. Их нужно было извлечь. Так как проект разрабатывался с помощью Microsoft Visual C++ 9.0 Express Edition (этого было достаточно :) ), то для сие нужды воспользовался методом gcnew String() (в следствие C++/CLI).
Он нужен для convert from 'char *' to 'System::String ^' . И снова пример:

// some code

char buffer[16];
String ^str;

sprintf(buffer, "Testing...\0");
   
str = gcnew String(buffer);
this->textBox1->AppendText(str);

// some code

И о чудо, я вновь "вижу" :)
Кстати, скоро новый год, еще  21 день. Заранее всех с наступающим :)

JavaScript. Несложное создание гистограмм

Учитывая, что сейчас многие пользуются блого-сервисами (blogger, tumblr, livejournal, etc.), могут возникнуть потребности в создании гистограмм. Мы же любим, когда данные можно "потрогать". Использование PHP в этом случае затруднено. Поэтому самый простой способ - создание гистограмм на JavaScripte с помощью CSS-стилей. Сразу отмечу, что сие способ описан в руководстве Флэнагана по JavaScript (со своими изменениями).
Основную работу будет выполнять js-файл - BarChart.js (см. листинг ниже). На входе он ожидает данные в виде массива, значения которого он аккуратно заклыдывает в гистограмму, которую выдает на выходе. Все очень просто. Ниже представлен один из примеров гистаграммы (Test chart).
Получаемые гистограммы легко инсталлируются в веб-странички. При этом можно входные данные сделать динамичными, так сказать - поставить на поток, что должно сделать динамичным и саму гистограмму. Ниже представлены листинги индексной html-странички и BarChart.js.
 
index.html
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<!-- Без объявления DOCTYPE в IE рисунок будет выглядеть неправильно -->
<html>
<head>
<script src="BarChart.js"></script> <!-- Подключить библиотеку -->
<script>
function drawChart() {
var data = [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,50,50,50,5,5,5,5,5,5,5,5,50,6,6,7,7,7,60,8];
var chart = makeBarChart(data, 300, 300);
var container = document.getElementById("chartContainer");
container.appendChild(chart);
}
</script>
</head>
<body onload="drawChart( )">
<h2>Test chart</h2><!-- Заголовок гистограммы -->
<div id="chartContainer"><!-- Здесь рисуется гистограмма --></div>
<!-- Подпись под гистограммой -->
<i>Test chart</i>
</body>
</html>
 
BarChart.js
 
 /**
* BarChart.js:
* В этом файле содержится определение функции makeBarChart(), которая
* создает гистограмму для вывода содержимого массива data[].
* Общий размер гистограммы определяется необязательными аргументами
* width и height, которые учитывают пространство, необходимое для рамок
* гистограммы и внутренних отступов. Необязательный аргумент barcolor
* определяет цвет столбиков. Функция возвращает созданный ею элемент
* <div>, таким образом, вызывающий сценарий может манипулировать
* этим элементом, например, изменять величину отступов. Вызывающий
* сценарий должен вставить в документ полученный от функции элемент,
* чтобы сделать его видимым.
**/
function makeBarChart(data, width, height, barcolor) {
 // Предусмотреть значения по умолчанию для необязательных аргументов
 if (!width) width = 500;
 if (!height) height = 350;
 if (!barcolor) barcolor = "blue";
 // Аргументы width и height определяют общий размер гистограммы.
 // Чтобы получить размер создаваемого элемента, необходимо вычесть
 // из этих значений толщину рамок и величину отступов.
 width -= 24; // Вычесть 10px отступа и 2px толщины рамки слева и справа
 height -= 14; // Вычесть 10px отступа сверху и 2px толщины рамки сверху и снизу
 // Создать элемент для размещения гистограммы. Обратите внимание:
 // гистограмма позиционируется в относительных координатах, т. е.
 // в ней могут располагаться дочерние элементы с абсолютным
 // позиционированием, и отображаться при этом в нормальном потоке
 // вывода элементов документа.
 var chart = document.createElement("div");
 chart.style.position = "relative"; // Относительное позиционирование
 chart.style.width = width + "px"; // Ширина гистограммы
 chart.style.height = height + "px"; // Высота гистограммы
 chart.style.border = "solid black 1px"; // Определить рамку
 chart.style.paddingLeft = "10px"; // Добавить отступ слева
 chart.style.paddingRight = "10px"; // Справа
 chart.style.paddingTop = "10px"; // Сверху
 chart.style.paddingBottom = "0px"; // Но не снизу
 chart.style.backgroundColor = "white"; // Фон гистограммы - белый
 // Рассчитать ширину каждого столбика

 //var barwidth = Math.floor(width/data.length);
 var barwidth = 1;

 // Отыскать наибольшее число в массиве data[]. Обратите внимание
 // на грамотное использование функции Function.apply().
 var maxdata = Math.max.apply(this, data);
 // Масштабирующий множитель: scale*data[i] дает высоту столбика
 var scale = height/maxdata;
 // Обойти в цикле массив с данными и создать столбики для всех элементов
 for(var i = 0; i < data.length; i++) {
  var bar = document.createElement("div"); // Создать столбик
  var barheight = data[i] * scale; // Рассчитать высоту
  bar.style.position = "absolute"; // Уст. размер и положение
  bar.style.left = (barwidth*i+1+10)+"px"; // Добавить рамку столбика
  // и отступ
  bar.style.top = height-barheight+10+"px";// Добавить отступ
  // гистограммы
  bar.style.width = (barwidth-2) + "px"; // -2 - рамка столбика
  bar.style.height = (barheight-1) + "px"; // -1 - рамка сверху
  if (data[i] >= 50) bar.style.border = "solid red 1px"; // Стиль рамки столбика при значениях более 50
  if (data[i] < 50) bar.style.border = "solid blue 1px"; // Стиль рамки столбика при значениях менее 50
  bar.style.backgroundColor = barcolor; // Цвет столбика
  bar.style.fontSize = "0px"; // Учесть особенность IE
  chart.appendChild(bar); // Добавить столбик
  // в гистограмму
 }
 // В заключение вернуть элемент с гистограммой
 return chart;
}


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