Qt For Android 数据库操作
作者:qyvlik
Qt 中的数据库操作,由于内嵌了一个 sqlite
数据库驱动,在普通应用中可以较为轻松地应付一些需求。
Qt Quick Local Storage
QML
提供了一个 QtQuick.LocalStorage
模块,用以操作 sqlite
数据库。不支持异步。
这个模块实现了 w3c 的 Web Database 标准。
所以可以参考HTML5本地存储——Web SQL Database。
由于Web SQL Database规范已经被废弃,原因说的很清楚,当前的 SQL 规范采用 SQLite 的 SQL 方言,而作为一个标准,这是不可接受的,每个浏览器都有自己的实现这还搞毛的标准。
当然,在 QML
的世界里大可不必担心这个。Qt 使用统一的实现标准,表现出来的平台无关性。
接口描述
QtQuick.LocalStorage
模块实现的是非异步的 Web SQL Database。
打开数据库
W3C 标准描述了如下打开数据库的接口:
[Supplemental, NoInterfaceObject]
interface WindowDatabase {
Database openDatabase(in DOMString name,
in DOMString version,
in DOMString displayName,
in unsigned long estimatedSize,
in optional DatabaseCallback creationCallback);
};
Window implements WindowDatabase;
[Supplemental, NoInterfaceObject]
interface WorkerUtilsDatabase {
Database openDatabase(in DOMString name,
in DOMString version,
in DOMString displayName,
in unsigned long estimatedSize,
in optional DatabaseCallback creationCallback);
DatabaseSync openDatabaseSync(in DOMString name,
in DOMString version,
in DOMString displayName,
in unsigned long estimatedSize,
in optional DatabaseCallback creationCallback);
};
WorkerUtils implements WorkerUtilsDatabase;
[Callback=FunctionOnly, NoInterfaceObject]
interface DatabaseCallback {
void handleEvent(in Database database);
};
QtQuick.LocalStorage
模块实现了一个 openDatabaseSync
方法,返回数据库对象的句柄。
object openDatabaseSync(string name,
string version,
string description,
int estimated_size,
jsobject callback(db))
数据库对象 DatabaseSync
同步数据库对象的 W3C 接口描述如下:
interface DatabaseSync {
void transaction(in SQLTransactionSyncCallback callback);
void readTransaction(in SQLTransactionSyncCallback callback);
readonly attribute DOMString version;
void changeVersion(in DOMString oldVersion,
in DOMString newVersion,
in optional SQLTransactionSyncCallback callback);
};
[Callback=FunctionOnly, NoInterfaceObject]
interface SQLTransactionSyncCallback {
void handleEvent(in SQLTransactionSync transaction);
};
所以 LocalStorage::openDatabaseSync
返回的对象有 transaction
,readTransaction
,changeVersion
这些接口。
执行 SQL 语句对象 SQLTransactionSync
如下是同步执行 SQL
语句的对象的 W3C 描述。
// typedef sequence<any> ObjectArray;
interface SQLTransactionSync {
SQLResultSet executeSql(in DOMString sqlStatement, in optional ObjectArray arguments);
};
执行 SQL 语句返回的结果对象 SQLResultSet
如下是执行 SQL
语句对象的返回结果的 W3C 描述。
interface SQLResultSet {
readonly attribute long insertId;
readonly attribute long rowsAffected;
readonly attribute SQLResultSetRowList rows;
};
interface SQLResultSetRowList {
readonly attribute unsigned long length;
getter any item(in unsigned long index);
};
SQLResultSetRowList
可以通过 item
获取对应下标的数据。
执行 SQL 后报错
执行 SQL
后报错对象的 W3C 描述。
interface SQLError {
const unsigned short UNKNOWN_ERR = 0;
const unsigned short DATABASE_ERR = 1;
const unsigned short VERSION_ERR = 2;
const unsigned short TOO_LARGE_ERR = 3;
const unsigned short QUOTA_ERR = 4;
const unsigned short SYNTAX_ERR = 5;
const unsigned short CONSTRAINT_ERR = 6;
const unsigned short TIMEOUT_ERR = 7;
readonly attribute unsigned short code;
readonly attribute DOMString message;
};
SQL 异常
执行 SQL
的异常对象的 W3C 描述。
exception SQLException {
const unsigned short UNKNOWN_ERR = 0;
const unsigned short DATABASE_ERR = 1;
const unsigned short VERSION_ERR = 2;
const unsigned short TOO_LARGE_ERR = 3;
const unsigned short QUOTA_ERR = 4;
const unsigned short SYNTAX_ERR = 5;
const unsigned short CONSTRAINT_ERR = 6;
const unsigned short TIMEOUT_ERR = 7;
unsigned short code;
DOMString message;
};
如下是在 QML
中测试的代码。
//! 打开一个数据库
var db = LocalStorage.openDatabaseSync("QQmlExampleDB", "1.0", "The Example QML SQL!", 1000000);
db.transaction(
function(tx) {
// 如果不存在表就创建
tx.executeSql('CREATE TABLE IF NOT EXISTS Greeting(salutation TEXT, salutee TEXT)');
// 插入记录
tx.executeSql('INSERT INTO Greeting VALUES(?, ?)', [ 'hello', 'world' ]);
// Show all added greetings
//! rs is SQLResultSet type
var rs = tx.executeSql('SELECT * FROM Greeting');
var r = ""
for(var i = 0; i < rs.rows.length; i++) {
//! rs.rows is SQLResultSetRowList type
r += rs.rows.item(i).salutation + ", " + rs.rows.item(i).salutee + "\n"
}
console.log(r);
});
其次,是使用 LocalStorage::openDatabaseSync
打开数据库,产生的数据库文件的路径是可以通过 QQmlEngine::offlineStoragePath
获取。
如果是使用 qmlscene.exe
来运行的话,其数据库路径是 C:\Users\Administrator\AppData\Local\QtProject\QtQmlViewer\QML\OfflineStorage\Databases
。不同电脑可能不同,仅供参考。
QtSql
QSqlDatabase
常见操作:
QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); // 设置数据库驱动
db.setHostName("localhost"); // 设置数据库主机名
db.setDatabaseName("test"); // 设置数据库名
db.setUserName("root"); // 设置数据库登入用户名
db.setPassword("123456"); // 设置数据库登入密码
db.open(); // 打开数据库连接
db.close(); // 释放数据库
建立数据库文件
QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("database.db"); // 设置数据库文件的文件名以及路径,路径可不设置
打开数据库并执行 SQL 操作
QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("database.db"); // 设置数据库文件的文件名以及路径,路径可不设置
if(!db.open()) return false;
QSqlQuery query;
//id会自动增加,因为这里不能重复,否则数据库无法修改
query.exec("create table Login(id INTEGER PRIMARY KEY autoincrement, "
"goods int, store int, time nvarchar(50), type int, place nvarchar(50),temperature nvarchar(10) )");
query.exec("insert into Login values( 1,NULL , NULL,NULL, NULL,NULL,NULL )");
query.exec("insert into Login values( 2,NULL , NULL,NULL, NULL,NULL,NULL )");
query.exec("insert into Login values( 3,NULL , NULL,NULL, NULL,NULL,NULL )");
query.exec("insert into Login values( 4,NULL , NULL,NULL, NULL,NULL,NULL )");
query.exec("insert into Login values( 5,NULL , NULL,NULL, NULL,NULL,NULL )");
query.exec("insert into Login values( 6,NULL , NULL,NULL, NULL,NULL,NULL )");
QSqlQuery
常用的函数:
seek(int n); // query指向结果集的第n条记录。指定当前的位置
first(); // query指向结果集的第一条记录。
last(); // query指向结果集的最后一条记录。
next(); // query指向下一条记录,每执行一次该函数,便指向相邻的下一条记录。
previous(); // query指向上一条记录,每执行一次该函数,便指向相邻的上一条记录。
record(); // 获得现在指向的记录。
value(int n); // 获得属性的值。与创建表的时候,列名顺序有关。
查询
// 假设有 student 这个表 student(text name, int age)
query.exec(“select * from student”);
这条语句执行完后,我们便获得了相应的执行结果,因为获得的结果可能不止一条记录,所以我们称之为结果集。
使用如下语句进行结果集遍历:
while(query.next()) {
QString name = query.value(0).toString(); //返回"name"字段的索引值"justin",value(i)返回i字段的值,0表示name,1表示age
int id = query.value(1).toInt();
// query.value("age").toInt();
// query.value("name").toString();
}
其他详细的文档可以参考 Qt 帮助文档,或者参考下列文章:
本文来自本人 github 项目 A-week-to-develop-android-app-plan