Delphi在iOS应用程序中使用SQLite
使用DBExpress来连接数据库
dbExpress是一个十分快速的数据库访问框架,由Delphi编写。 RAD Studio为很多主要的数据库提供驱动,例如InterBase,Oracle,DB2,SQL Server,MySQL,Firebird,SQLite,和ODBC。你可以使用相同的过程来访问这些不同的数据库。
在iOS平台,dbExpress支持InterBase ToGo,也支持SQLite。这些数据库产品可以运行在iOSDevice上。
对于其他数据库,例如,Oracle,你至少需要一个客户端的库。在Windows平台上,客户端的库由一个DLL提供来连接数据库。因为,你需要使用中间层技术,例如DataSnap来在iOS Device上连接这些数据库。
另一个讨论如何在iOS Device上不使用客户端的库连接企业级数据库的教程;请查看“iOS教程:在iOS客户端应用程序中连接企业级数据库”。
在Window环境下创建开发使用的数据库
首先,你需要创建一下SQLite数据库文件在你的Windows开发平台下。使用如下步骤,以便于你可以使用Mobile Form Designer来设计你的iOS应用的用户界面。
在Data Explorer中创建数据库
1. 到Data Explorer中,右击SQLite节点,然后选择Add New Connection:
2. 定义连接的名称,例如ShoppingList。
3. 指定数据库文件的路径:
4. 占击Advanced按钮打开Advanced Properties对话框。
5. 更改FailIfMissing属性为Fale,然后关闭对话框:注:设置FailIfMissing为False表示命令DataExplorer在文件不存在的情况下创建一个新的数据库文件。
6. 点击Test Connection按钮。在这个操作中,如果数据库文件不存在,那么会创建一个新的。
在Data Explorer中创建表
1. 在Data Explorer上,选择在SQLite节的ShoppingList节点,然后从下拉菜单中选择New Table。
2. 指定标题为ShopItem列的类型为TEXT。
3. 点击Save按钮,然后指定一个表名(例如,Item。)
设计并配置用户界面
这篇教程使用一个TListBox组件来作为UI元素。
要配置一个ListBox组件,使用下列步骤:
1. 要创建一个HD FireMonkey Mobile Application,选择File>New>FireMonkeyMobile Application-Delphi>Blank Application。
2. 拖放一个TToolBar到窗体上。
3. 拖放一个TButton到TToolBar组件上。
4. 在Object Inspector中设置如下属性:
设置Name属性为ButtonAdd。
设置StyleLookup属性为addtoolbuttonbordered。
5. 拖放一个TButton到TToolBar组件上。
6. 在Object Inspector中设置如下属性:
设置Name属性为ButtonDelete。
设置StyleLookup属性为deletetoolbutton。
设置Text为Delete。
设置Visible为False。
7. 拖放一个TLabel到TToolBar组件上。
8. 在Object Inspector中设置如下属性:
设置Align为alClient。
设置StyleLookup为toollabel。
设置Text为ShoppingList。
设置TextAlign为taCenter。
9. 拖放一个TListBox组件在窗体上。
10. 在Object Inspector,设置ListBox组件的如下属性:
设置Align属性为alClient,以便ListBox组件填充整个窗体。
连接数据
下面这些是连接在Data Explorer中已经定义好了的数据库中的数据的基本步骤:
1. 在Data Explorer上选中Item表,然后拖放到Form Designer上。
注:这会创建两个组件(ShoppingList:TSQLConenction以及Item:TSQLDataSet)到窗体上。
2. 在窗体上选中ShoppingList组件,然后更改Connected属性为True。
3. 在窗体上选中Item组件,然后更改Active属性为True。
4. 选择View>LiveBindings Designer,然后LiveBindingsDesigner打开。
5. 选中Item组件中的ShopItem,然后拖动ShopItem到ListBox1。
下面这些步骤使用在SQLIite数据库中的数据与用户界面连接。如果这篇教程中你使用一个已经存在数据的表,现在应该可以在Form Designer中看到真实数据。
创建一个事件处理过程,当用户从列表中选中一个项目时来让Delete按钮显示
Delete按钮的Visible属性设置为False。因此,默认,用户看不到这个按钮。你可以在用户在列表中选中一个项目时让它可见,如下:
选中ListBox1,然后为OnItemClick事件定义如下事件处理过程。
[delphi] view plaincopy
procedure TForm1.ListBox1ItemClick(const Sender:TCustomListBox;
const Item:TListBoxItem);
begin
ButtonDelete.Visible:= ListBox1.Selected <> nil;
end;
为Add按钮创建一个事件处理过程,来添加列表项
下一步是给应用程序添加一个功能,可以添加一个项目到Shopping List中去。
1. 拖放一个TSQLQuery组件到窗体上。
2. 在Object Inspector中设置如下属性:
设置Name属性为SQLQueryInsert。
设置SQLConneciton属性为ShoppingList。
设置SQL属性如下:INSERT INTO ITEM (ShopItem) VALUES (:ShopItem)
在Params属性上的Expand(…)按钮。
选中ShopItem参数,然后设置DataType为ftString:
3. 在Form Designer中,双击AddButton组件。添加如下代码到事件处理过程中:
[delphi] view plaincopy
procedure TForm1.ButtonAddClick(Sender: TObject);
var
TaskName: String;
begin
try
if InputQuery('EnterNew Item', 'Name', TaskName) and (TaskName.Trim <> '') then
begin
SQLQueryInsert.ParamByName('ShopItem').AsString := TaskName;
SQLQueryInsert.ExecSQL();
Item.Refresh;
ButtonDelete.Visible := ListBox1.Selected <> nil;
end;
except
on e: Exceptiondo
begin
ShowMessage(e.Message);
end;
end;
end;
InputQuery函数显示一个对话框来要求用户输入文本。这个函数在用户选择OK按钮时返回True,以便你可以在用户选择OK并且文本中包含一些数据时才添加数据到数据库中。
为Delete按钮创建一个事件处理过程,来从列表中删除一项
下一步就是给应用程序添加一个功能来从Shopping List中删除一项:
1. 拖放一个TSQLQuery到窗体上。
2. 在Object Inspector中设置如下属性:
设置Name属性为SQLQueryDelete。
设置SQLConnection属性为ShoppingList。
设置SQL属性如下:delete from Item where ShopItem = :ShopItem
选择Params属性的Expand(…)按钮。
选中ShopItem参数,设置DataType为ftString。
3. 在Form Designer中,双击DeleteButton组件。添加如下代码到事件处理过程中:
[delphi] view plaincopy
procedure TForm1.ButtonDeleteClick(Sender: TObject);
var
TaskName: String;
begin
TaskName := ListBox1.Selected.Text;
try
SQLQueryDelete.ParamByName('ShopItem').AsString := TaskName;
SQLQueryDelete.ExecSQL();
Item.Refresh;
ButtonDelete.Visible := ListBox1.Selected <> nil;
except
on e: Exception do
begin
SHowMessage(e.Message);
end;
end;
end;
修改你的代码来连接到在iOS上的本地数据库文件
这个程序的基本功能已经实现了。之前在Data Explorer中,你在Windows上创建了一个数据库文件。这个数据库文件现在在你的iOS Device上不能使用了,除非你将它复制到iOS Device上或创建它。
你可以按照如下步骤创建一个SQLite数据库和表:
指定在iOSDevice上的SQLite数据库路径
1. 在Form Designer中,选中ShoppingList组件。
2. 在Object Inspector中,双击BeforeConnect事件。
3. 添加如下代码到事件处理过程中:
GetHomePath函数提供给你一个iOS应用的真实根目录。强烈建议使用常量System.SysUtils.PathDelim,因为PathDelim使用特定平台的路径分隔符(而不是写死在代码里,例如\或/)。
如果不存在,那么创建表
使用SQLite,当表不存在的时候,你可以创建一个表,通过使用CREATE TABLE IF NOT EXISTS语句。你可以在TSQLConnection组件连接到数据库之后,TSQLDataSet组件连接到表之前创建一个表。使用如下步骤:
1. 在Form Designer中,选中ShoppingList组件。
2. 在Object Inspector,双击AfterConnect事件。
3. 添加如下代码到事件处理过程中:
[delphi] view plaincopy
procedure TForm1.ShoppingListAfterConnect(Sender: TObject);
begin
ShoppingList.ExecuteDirect('CREATE TABLE IF NOT EXISTS Item (ShopItem TEXT NOT NULL)');
end;
在iOS Simulator或iOSDevice上运行你的应用程序
现在,你的应用程序可以准备运行了(选择Run>Run)。