sqlite 在 ios 开发的使用（基础）

SQLite是嵌入式的和轻量级的SQL数据库。SQLite是由C实现的。广泛用于包括浏览器(支持HTML5的大部分浏览器，IE除外)、iOS、Android以及一些便携需求的小型web应用系统。

1 使用原因：存储、检索信息

2 SQLite是MySQL精简版。但无需服务器就能进行。

3 两个限制：1)必须手动创建数据库 2)没有面向对象的接口。

4 如何手动创建数据库。

使用SQLite前的准备

使用SQLite是很多做iOS开发中第一次面对C的情况，包括我。因为SQLite是C写的，Objective-C可以直接使用C代码。在SQLite前，一般都会使用Cocoa
Touch框架，都是基于Objective-C的。

首先，添加framework：libsqlite3.0.dylib

需要在对应文件的头文件中加入：

#import "sqlite3.h"

并在Frameworks中加入所需的库，否则会报错：

Undefined symbols: "_sqlite3_open", referenced from:

加入库的方法是：



或者点击 你的应用程序名，（最上面带图标的那个）中间视图会出现frameworks的图表，左下脚有一个加号，就是添加新的frameworks的地方了，在搜索里输入需要的......，添加进去就OK了！

选择sqlite库：



选择完的效果：



下面是代码：

//sqlite
[self openDataBase];
//[self createTable];
//[self insertTable];
[self queryTable];

[self deleteTable];
[self queryTable];

实现：

//open database
- (void)openDataBase
{
NSArray *documentsPaths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory
, NSUserDomainMask
, YES);
NSString *databaseFilePath=[[documentsPaths objectAtIndex:0] stringByAppendingPathComponent:@"db.sql"];

if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK)
{
NSLog(@"open sqlite db ok.");
}
else
{
NSLog( @"can not open sqlite db " );

//close database
sqlite3_close(database);
}
}

//create table
- (void)createTable
{
char *errorMsg;
const char *createSql="create table if not exists persons (id integer primary key autoincrement,name text)";

if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK)
{
NSLog(@"create ok.");
}
else
{
NSLog( @"can not create table" );
[self ErrorReport:(NSString *)createSql];
}
}

//insert table
- (void)insertTable
{
char *errorMsg;

const char *insertSql="insert into persons (name) values ('田周辉')";
if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK)
{
NSLog(@"insert ok.");
}
else
{
NSLog( @"can not insert it to table" );
[self ErrorReport: (NSString *)insertSql];
}
}

//error
- (void)ErrorReport: (NSString *)item
{
char *errorMsg;

if (sqlite3_exec(database, (const char *)item, NULL, NULL, &errorMsg)==SQLITE_OK)
{
NSLog(@"%@ ok.",item);
}
else
{
NSLog(@"error: %s",errorMsg);
sqlite3_free(errorMsg);
}
}

//query table
- (void)queryTable
{
const char *selectSql="select id,name from persons";
sqlite3_stmt *statement;
if (sqlite3_prepare_v2(database, selectSql, -1, &statement, nil)==SQLITE_OK)
{
NSLog(@"select ok.");
while (sqlite3_step(statement)==SQLITE_ROW)//SQLITE_OK SQLITE_ROW
{
int _id=sqlite3_column_int(statement, 0);
NSString *name=[[NSString alloc] initWithCString:(char *)sqlite3_column_text(statement, 1) encoding:NSUTF8StringEncoding];
NSLog(@"row>>id %i, name>> %@",_id,name);
}

}
else
{
//error
[self ErrorReport: (NSString *)selectSql];
}

sqlite3_finalize(statement);
}

//delete table
- (void)deleteTable
{
char *errorMsg;
[self openDataBase];

const char *sql = "DELETE FROM persons where id=24";
if (sqlite3_exec(database, sql, NULL, NULL, &errorMsg)==SQLITE_OK)
{
NSLog(@"delete ok.");
}
else
{
NSLog( @"can not delete it" );
[self ErrorReport: (NSString *)sql];
}

}

命令行：

sqlite3 database  //创建数据库
crate table tableFile(id smallint, file_name varchar(256), up_state smallint, file_size smallint); //创建一个表格
insert into tableFile values(1, "200110101.rcu", 100, 4500);   //插入数据
5 如何访问SQLite3数据库
sqlite3_open //打开数据库
sqlite3_prepare //将UTF－8格式的SQL语句转换为指向已备语句的指针
sqlite3_column_string //返回某一行的字符串
sqlite3_finalize //删除一条已备语句
sqlite3_close //关闭数据库

6 source code

- (id)lookupSingularSQL:(NSString *)sql forType:(NSString *)rettype {

sqlite3_stmt *statement;

id result;

if (statement = [self prepare:sql]) {

if (sqlite3_step(statement) == SQLITE_ROW) {

if ([rettype compare:@"text"] == NSOrderedSame) {

char temp_buf[256];

memset(temp_buf, 0, 256);

sprintf(temp_buf, "%s %s %s %s",

(char *)sqlite3_column_text(statement,0),

(char *)sqlite3_column_text(statement,1),

(char *)sqlite3_column_text(statement,2),

(char *)sqlite3_column_text(statement,3)

);

result = [NSString stringWithUTF8String:temp_buf];

//result = [NSString stringWithUTF8String:(char *)sqlite3_column_text(statement,0)];

} else if ([rettype compare:@"integer"] == NSOrderedSame) {

result = (id)sqlite3_column_int(statement,0);

}

}

}

sqlite3_finalize(statement);

return result;

}

应该有个成员变量，比如我的代码：

@interface DetailViewController : UIViewController {
UIPopoverController *popoverController;
UIToolbar *toolbar;
id detailItem;
UILabel *detailDescriptionLabel;
sqlite3 *database;

打开数据库

SQLite数据库是文件数据库，是保存在文件系统中的。因此需要知道文件保存到哪里，可参见iOS中对文件的操作。比如本文保存到Documents目录下。代码：

NSArray *documentsPaths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory
, NSUserDomainMask
, YES);
NSString *databaseFilePath=[[documentsPaths objectAtIndex:0] stringByAppendingPathComponent:@"mydb"];
if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK) {
NSLog(@"open sqlite db ok.");
}

通过ssh查看Documents目录，发现mydb文件已经创建。sqlite的策略是如果有该文件就打开，如果没有就创建文件，也就是创建数据库。

这里要注意，使用的是C语法，sqlite3_open传入的是database的地址。

关闭数据库

数据库使用完毕后，要关闭，比如退出应用的时候：

- (void)viewDidUnload {
// Release any retained subviews of the main view.
// e.g. self.myOutlet = nil;
sqlite3_close(database);
self.popoverController = nil;
}

建表语句

数据库打开以后，如果没有表，建表：

char *errorMsg;
const char *createSql="create table if not exists persons (id integer primary key autoincrement,name text)";
if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"create ok.");
}

这里要特别注意errorMsg传的是地址，因为该函数要通过地址引用来写报错字符信息。

向表中插入记录

和建表语句类似：

const char *insertSql="insert into persons (name) values(‘张三’)";
if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"insert ok.");
}

错误信息的处理

如果在多个地方使用errorMsg，那么每次使用完毕要清空一下字串，比如这样：

if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"create ok.");
}else {
NSLog(@"error: %s",errorMsg);
sqlite3_free(errorMsg);
}

查询结果集

结果集的查询，需要用到statement：

const char *selectSql="select id,name from persons";
sqlite3_stmt *statement;
if (sqlite3_prepare_v2(database, selectSql, -1, &statement, nil)==SQLITE_OK) {
NSLog(@"select ok.");
}
while (sqlite3_step(statement)==SQLITE_ROW) {
int _id=sqlite3_column_int(statement, 0);
char *name=(char *)sqlite3_column_text(statement, 1);
NSLog(@"row>>id %i, name %s",_id,name);
}
sqlite3_finalize(statement);

不过这里有个问题，看看打印的日志：



乱码。因为直接用的char类型来做的。

解决办法是，用nsstring替代char：

while (sqlite3_step(statement)==SQLITE_ROW) {
int _id=sqlite3_column_int(statement, 0);
NSString *name=[[NSString alloc] initWithCString:(char *)sqlite3_column_text(statement, 1) encoding:NSUTF8StringEncoding];
NSLog(@"row>>id %i, name %@",_id,name);
}

char生成nsstring的时候做一次显式的编码。问题解决：



这说明：

写入数据库，用char的方式没有问题，写入数据库的编码是对的;

从库中取出，可能默认使用ascii解码，造成显示乱码。

使用sqlite c api，要经常参考官方函数文档：http://www.sqlite.org/c3ref/funclist.html