初看这个标题你可能会不解,SQLite 本身就是一个跨平台的数据库,在这里再说跨平台有什么意义呢?

其实不然,目前我就遇到了一个项目需要使用 SQLite 数据库,而且我甚至完全不想花多套代码在不同的平台上,毕竟每个平台的包含的相关 SDK 并不一致。举个简单的例子,在 Android 上操作 SQLite,需要用到 SQLiteDatabase 这个类,用 Java 来操作;而在 iOS 上,除了需要引入 libsqlite3.tbd 外,还需要引入 sqlite3.h 这个头文件,使用 Objective-C 来操作,到了 PC 上,虽然都是以使用 sqlite3.h 为主,但是依然会有不一致的地方,比如说种类繁多的编程语言,大多都有不同的封装,API 不一致这足以让人头疼。

因此,在不同的平台上操作 SQLite,必定会使用不同的代码。当然了,除了 SQLite 之外,实现相同的功能,在不同平台上使用不同的代码也许已经是惯例,大家也习以为常。


Roll your eggs 的习以为常!作为一个懒人,当这样一个锅需要自己背的时候,自然是去找更简单的解决方案了。目标是一套代码走天下!


那么也不多废话了,直接上手写代码,这里有很多种技术可以选择,比如说 C++sqlite3.h 还是很好用的。不过我依然是折腾自己喜欢的 CodeTyphon,因为它有更让人觉得方便的封装。

很幸运的是,CodeTyphon 已经自带了 sqlite3conn 单元,直接引用之即可。关于如何查找可引用的库,可以看 CTCTyphon-IDE PkgsFPC Pkgs 这两页,你会找到你要的。

CTC

首先先制作一个简单的数据库吧,用于测试代码能否正常工作:

$ sqlite3 demo.db
> create table user(id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR(32) NOT NULL);
> insert into user(name) value ('ABC');
> insert into user(name) value ('XYZ');

然后根据数据库结构声明一个结构体,后面会用于数据传递:

type
  TDemoRec = record
    AId: Integer;
    AName: PChar;
  end; 

与这个结构等价的 C++ 的结构体是这样的:

struct DemoRec {
	int AId;
	char* AName;
};

这一瞬间我们会发现原来操作 SQLite 是如此的简单,在此我定义了一个类,用来保存一些数据:

TSQLite = class
  private
    FDatabase: TSQLite3Connection;
    FQuery: TSQLQuery;
    FTransaction: TSQLTransaction;
  published
    property Database: TSQLite3Connection read FDatabase write FDatabase;
    property Transaction: TSQLTransaction read FTransaction write FTransaction;
    property Query: TSQLQuery read FQuery write FQuery;
  end;

有了这些东西后,就可以方便的玩起来了,比如说执行一个 SQL 语句:

function TSQLite.ExecuteSQL(ASQL: string): Boolean;
begin
  FQuery.Close;
  FQuery.SQL.Text:= ASQL;
  try
    FQuery.ExecSQL;
    Exit(True);
  except
    Exit(False);
  end;
end;

这段代码似乎太简单了,也许我们更加希望在出错时能够给出一个原因,那么可以改一下:

function TSQLite.ExecuteSQL(ASQL: string; var AError: string): Boolean;
begin
  FQuery.Close;
  FQuery.SQL.Text:= ASQL;
  try
    FQuery.ExecSQL;
    Exit(True);
  except
    on E: Exception do begin
      AError:= e.Message;
      Exit(False);
    end;
  end;
end;

好了,现在调用这个方法时,只需要额外传入一个字符串参数,就可以获取出错时的信息。

在这个体系下,要进行查询也很简单,需要额外封装两个方法:

// 根据 SQL 语句查询
function TSQLite.Select(ASQL: string; var AError: string): Boolean;
begin
  FQuery.Close;
  FQuery.SQL.Text:= ASQL;
  try
    FQuery.Open;
    Exit(True);
  Except
    on E: Exception do begin
      AError:= e.Message;
      Exit(False);
    end;
  end;
end; 

// 获取查询结果的行数
function dbGetSelectResultCount(APath: PChar): Integer;
var
  database: TSQLite;
begin
  Result := -1;
  if (DatabaseExists(string(APath))) then begin
    database := GetDatabase(string(APath));
    Result := database.Query.RecordCount;
  end;
end;

// 获取指定行号的一条记录
function dbGetSelectResult(APath: PChar; AIndex: Integer): TDemoRec;
var
  database: TSQLite;
  tmp: string;
begin
  Inc(AIndex);
  if (DatabaseExists(string(APath))) then begin
    database := GetDatabase(string(APath));
    if (database.Query.RecordCount >= AIndex) then begin
      database.Query.RecNo:= AIndex;
      Result.AId:= database.Query.FieldByName('id').AsInteger;
      tmp := database.Query.FieldByName('name').AsString;
      Result.AName:= StrAlloc(tmp.Length);
      strcopy(Result.AName, PChar(tmp));
    end;
  end;
end;

接下来就是导出函数了,作为一个跨平台的库,它需要被其他程序调用,那么必定有导出函数,而不同的平台下,所需要的函数形态是不一样的,特别是由于 Android 使用 JNI 来调用动态库,导出函数必须符合 JNI 的规范。

下面的例子很好的说明了导出函数的方法:

// iOS, PC
function dbGetSelectResultCount(APath: PChar): Integer; cdecl;
function dbGetSelectResult(APath: PChar; AIndex: Integer): TDemoRec; cdecl;

// Android
function Java_com_sqlite_sample_NativeAPI_dbGetSelectResultCount(env: PJNIEnv; obj: jobject; APath: jstring): jint; stdcall;
function Java_com_sqlite_sample_NativeAPI_dbGetSelectResult(env: PJNIEnv; obj: jobject; APath: jstring; AIndex: jint): jobject; stdcall;

唯一需要注意的是调用协定,用于 JNI 的必须设为 stdcall,而其他的均设为 cdecl

那么再下一步就是编译,直接使用 FPC 跨平台编译器即可,编译方法很简单:

$ fpc64 -Fisqlite -Fusqlite sample.lpr 

此时即可以在 Mac 端生成 libsample.dylib 以及在 Linux 端生成 libsample.so

要跨平台编译的话,稍微麻烦一点,但是也比想象中简单很多:

$ export ANDROID_LIB=/usr/local/codetyphon/binLibraries/android-5.0-api21-arm/
$ export FPC=/usr/local/codetyphon/fpc/fpc64/bin/x86_64-linux/fpc
$ ${FPC} -Tandroid -Parm -Fl${ANDROID_LIB} -Fiqslite -Fusqlite sample.lpr

此时即可生成一个供 Android 系统使用的,arm 架构的 libsample.so,通过更换 -P 后面的参数,也可以编译 x86,mips 等架构的 so。

完成后再看一下 iOS 的库要怎么编译。由于 iOS 已不再允许动态加载 dylib,我们必须把代码编译为静态库,也就是 .a 文件,并且静态链接到 iOS 项目内。

$ export FPC_ROOT=/usr/local/lib/fpc/3.1.1
$ export FPC=${FPC_ROOT}/ppcrossa64
$ ${FPC} -Tdarwin -dIPHONEALL -Cn -Fisqlite -Fusqlite sample.lpr
$ ar -q libsample.a `grep "\.o$" link.res`
$ ranlib libsample.a

此时可以得到一个用于 64 位真机的 libsample.a 文件,若是要在 32 位的 iOS 和模拟器上完成兼容,还必须再另外编译两个 .a

32 位真机:替换编译器为 ppcrossarm
模拟器:替换编译器为 ppcx64,并替换 -T 参数为 iphonesim

当我们得到了 3 个不同架构的 .a 后,有些时候需要将它们合并,使用如下命令来合并之:

lipo -create libsample_A64.a libsample_ARM.a libsample_EMU.a -output libsample.a

这样就得到了一个融合了的 .a,它可以用于各种场合。


现在一切都准备好了,看看如何使用我们做好的库吧,以上述的 dbGetSelectResultCountdbGetSelectResult 为例,分别讲述在各平台的使用方法。

Android:

package com.sqlite.sample;

public class NativeAPI {
    static {  System.loadLibrary("sample"); }
    public static native int dbGetSelectResultCount(String APath);
    public static native DemoRec dbGetSelectResult(String APath, int AIndex);
}

iOS:

extern int dbGetSelectResultCount(const char* APath);
extern struct DemoRec dbGetSelectResult(const char* APath, int AIndex);

PC(以 C++ 为例):

typedef int (*dbSelectResultCount)(const char* APath);
typedef struct DemoRec (*dbSelectResult)(const char* APath, int AIndex);

void* handle = dlopen("./libsample.so", RTLD_LAZY);
dbSelectResultCount mSelectResultCount = (dbSelectResultCount) dlsym(handle, "dbGetSelectResultCount");
dbSelectResult mSelectResult = (dbSelectResult) dlsym(handle, "dbGetSelectResult");

可以看到,不论在哪个平台上,最终得到的 API 都是一致的,这样就统一了调用方式。在此基础上,要做二次封装也是非常方便。另外,由于代码耦合几乎没有,也能够很方便的对 SQLite 的底层库的逻辑进行修改,只要 API 不变,就不会影响上层的调用。


以下是一个完整的调用代码,以 iOS 端为例,其他各端均一致:

// 复制数据库文件
NSString * originPath = [[NSBundle mainBundle] pathForResource:@"demo" ofType:@"db"];
NSString * destPath = [ViewController getDocumentPath];
NSString * dbFile = [destPath stringByAppendingPathComponent:@"demo.db"];
[ViewController copyFile:originPath destFile:dbFile];

// 打开数据库    
int b = dbOpen([dbFile UTF8String]);
printf("Open Database => %d\n", b);
// 执行查询
b = dbSelect([dbFile UTF8String], "select * from user");
printf("Select => %d\n", b);
// 获取查询结果的行数
int count = dbGetSelectResultCount([dbFile UTF8String]);
printf("Select Rows => %d\n", count);
// 取出查到的每一条数据
for (int i = 0; i < count; i++) {
    struct DemoRec r = dbGetSelectResult([dbFile UTF8String], i);
    printf("Data %d => {id => %d, name => %s}\n", i, r.AId, r.AName);
}
// 关闭数据库
b = dbClose([dbFile UTF8String]);
printf("Close Database => %d\n", b);

这段代码的输出为:

可以看到,调用成功,并且正确的传递了数据。在其他平台上的效果也是完全一样的。


这个用于演示的项目已经开源,请访问我的 github 获取,地址:

章鱼猫/rarnu/cross_sqlite