Delphi在iOS应用程序中使用InterBase ToGo

这篇教程描述了在iOS Device上,通过dbExpress框架来浏览由InterBase ToGo管理的数据的基本步骤。

dbExpress框架

使用DBExpress来连接数据库

 dbExpress是一个十分快速的数据库访问框架,由Delphi编写。RAD Studio为很多主要的数据库提供驱动,例如InterBase,Oracle,DB2,SQL Server,MySQL,Firebird,SQLite,和ODBC。你可以使用相同的过程来访问这些不同的数据库。

 •在iOS平台,dbExpress支持InterBase ToGo,也支持SQLite。这些数据库产品可以运行在iOS Device上。
•对于其他数据库,例如,Oracle,你至少需要一个客户端的库。在Windows平台上,客户端的库由一个DLL提供来连接数据库。因为,你需要使用中间层技术,例如DataSnap来在iOS Device上连接这些数据库。

 另一个讨论如何在iOS Device上不使用客户端的库连接企业级数据库的教程;请查看“iOS教程:在iOS客户端应用程序中连接企业级数据库”。

 设计并配置用户界面

 


这篇教程使用一个TListBox组件来作为UI元素。

 使用下列步骤配置一个ListBox组件:
1. 创建一个HD FireMonkey Mobile Application,选择File>New>FireMonkey Mobile Application-Delphi>Blank Application。
2. 拖放一个TListBox组件到窗体上。
3. 在Object Inspector,设置ListBox组件的如下属性:
•设置Align属性为alClient,以便ListBox组件填充整个窗体。
•设置DefaultItemStyles.ItemStyle属性为listboxitembottomdetail。
4. 在Designer或Editor中右击TListBox组件,选择Add Item,然后添加下面这些组件:
•TListBoxHeader组件。
•TSearchBox组件。

TSearchBox组件

5. 关闭Items Designer。
6. 添加一个TLabel组件到TListBoxHeader上,在Object Inspector中设置如下属性:
•设置TLabel组件的Align属性为alClient。
•设置StyleLookup属性为toollabel。
•设置TextAlign属性为taCenter。
•设置Text属性为DB DEMO。

 
连接数据

 下面是使用dbExpress来连接数据库中的数据的基本步骤:
1. 在Tool Palette上,双击TSQLConnection组件。
双击TSQLConnection组件

2. 在Object Inspector中,设置TSQLConnection的如下属性:
       1. 这个应用程序使用InterBase ToGo,因此设置Driver属性为IBLite/ToGo。
Object Inspector
      
        2.设置LoginPrompt属性为False,以便于用户不需要再提示输入密码了。
        3. 点击Params属性旁边的[…]省略号按钮,然后设置Database值为C:\Users\Public\Documents\RAD Studio\11.0\Samples\Data\dbdemos.gdb(数据库存放路径);然后关闭对话框:
C:\Users\Public\Documents\RAD Studio\11.0\Samples\Data\dbdemos.gdb
      
        4. 设置Connected属性为True。

注:如果你在开发环境里得到一个错误(“不可用的数据库”),这意味着你没有一个当前可用的InterBase许可。这个InterBase开发者版本许可包含在一些版本的产品中。

      3.在窗体上添加一个TSQLDataSet,然后设置如下属性:
        1. 设置SQLConnection属性为SQLConnection1(你之前添加的)。
        2. 设置CommandText属性为select COMMON_NAME,SPECIES_NAME from BIOLIFEorder by COMMON_NAME。
        3. 设置Active属性为True。
        4. 打开LiveBindings Designer,然后按如下操作连接数据和用户界面:
LiveBindings Designer
      
        1. 在BindSourceDB1中点击COMMON_NAME,然后拖动鼠标光标到ListBox1里抽Item.Text上。
        2. 在BindSourceDB1中点击SPECIES_NAME,然后拖动鼠标光标到ListBox1中的Item.Detail上。
BindSourceDB1
 

 布署你的应用程序到iOS

 到了这里,你需要在你的电脑使用InterBase。这意味着真正的数据库放在你的本地磁盘上(例如,C:\User\Public\Documents\RAD Studio\11.0\Samples\Data\dbdemos.gdb)。在iOS Device上,应用程序是在沙箱环境里运行的,通常你只能在你应用程序目录的Documents目录下才能读写数据。

 要在iOS上连接到一个本地数据库,你需要执行下列操作:

 •布署数据库到iOS Device。
•更改配置(连接到数据库文件的)到一个在Documents目录下的本地文件。

布署InterBase ToGo,dbExpress Driver,以及数据库文件到iOS

要在iOS上执行你的应用程序,你需要布署下面这些文件:

1.InterBase ToGo
2.InterBase的dbExpress Driver
3.数据库文件(dbdemos.gdb)
        1. 选择Project>Deployment来打开Deployment Manager。
        2. 在Deploy Manager顶部的目标平台的下拉列表中选择All-Configurations-iOS Simulator Platform。      

        iOS Simulator Platform。

        3. 选择Add Featured Files():
        4.选择下列数据模块,然后点击OK来关闭Featured Files对话框:

        1.InterBase ToGo。你需要选择用来分发应用程序到Device上的许可。许可文件的默认名称在Featured Files对话框中列出,如下名称模板:reg_*.txt。就像你可以在下图看到的,在这篇教程中,选中的是reg_ibtogo.txt许可文件。


你可能已经从Embarcadero那里接收到一个用于ToGo或IBLite的许可文件,名称类似于reg_nnnnnnn.txt,nnnnnnn是生成的数字:
•如果你已经保存这个文件为reg_ibtogo.txt或reg_iblite.txt到如下目录(例如,C:\Users\Public\Documents\InterBase\redist\InterBaseXE4),你只需要选择这个对应的许可。
•如果你将它保存为原来的文件名,那么选择Add Files(在下一步中有显示),然后添加需要布署到应用程序的许可文件。
2. DBExpress InterBase Driver
DBExpress InterBase Driver

5. 选择Add Files,然后选择数据库文件(例如,C:\Users\Public\Documents\RAD Studio\11.0\Samples\Data\dbdemos.gdb)。
6. 选择dbdemos.gdb,然后更改Remote Path为StartUp\Documents\。
7. 选择Platforms列(在dbdemos.gdb行双击省略号[…]):

        1. 确保在dbdemos.gdb行的Platforms列显示为iOS Simulator和iOS Device。
        2.如果存在Win32,那么移除(你不需要复制数据库文件到Win32平台)。

8. 选择All-Configurations-iOS Device平台,确保dbdemos.gdb设置为布署到StartUp\Documents\。

当你配置完之后,数据库文件(dbdemos.gdb)会被布署到你的iOS应用程序的沙箱区域的Documents目录。

 修改你的代码来连接在iOS上的本地数据库文件

之前的步骤提到过,TSQLConnection组件是使用绝对路径连接到在你本地文件系统上的数据库。因此在连接到数据库之前,你需要替换文件的路径,如下:
1. 在Form Designer中,选择SQLConnection1组件。
2. 在Object Inspector中,双击BeforeConnect事件的Value区域。
3.添加如下代码到事件处理过程中:

 


 GetHomePath函数提供给你一个iOS应用的真实根目录。强烈建议使用常量System.SysUtils.PathDelim,因为PathDelim使用特定平台的路径分隔符(而不是写死在代码里,例如\或/)。

 在iOS Simulator或iOS Device上运行你的应用程序

 现在,你的应用程序可以准备运行了。你应该可以在IDE中浏览到数据。你也可以使用搜索框来缩减列表,如下面第二张图所示:
搜索框1
 搜索框2

 问题解决

 InterBase许可问题

当你在开发环境下连接数据库时如果你遇到错误(“不可用的数据库”),这意味着你没有一个当前InterBase的许可。

 •InterBase开发者版本的许可已经作为一些产品版本的一部分。
•对于一个已经注册了的RAD Studio安装要激活InterBase开发者版本的许可,要Embarcadero Product License Manager(点击Start|All Programs|Embarcadero InterBase XE3)。

 异常处理问题

 如果你的应用程序抛出一个异常,而没有合适的异常处理代码,你的iOS应用会在运行时崩溃。

如果你在运行时遇到程序崩溃,你可能要使用下列步骤来手动连接到数据库:
1.选中SQLConnection1组件,更改Connected属性为False。
2.拖放一个按钮在窗体上,然后创建如下事件处理过程来手动连接到数据库:

 

常见错误及解决方案

下面是一些常见的错误(在连接数据库的时候你可能会遇到),以及解决这些问题的建议:

在iOS上的错误                  建议

  StartUp\Documents 检查数据库文件(dbdemos.gdb)是否传递到了“StartUp\Documents”。

  InterBase ToGo  检查InterBase ToGo的许可文件是否传递。

  OnBeforeConnect事件检查是否你指向了本地文件(给SQLConnection1组件的OnBeforeConnect事件添加一个事件处理过程)。