您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS SQLite 實戰:模糊查詢實現與常用 C 接口函數詳解

編輯:iOS 相關教學

SQLite 模糊查詢

一、示例說明:本文演示如何在 iOS 中用 SQLite 實現模糊查詢。

1. 新建一個繼承自 NSObject 的模型:

// YYPerson.h
#import <Foundation/Foundation.h>

@interface YYPerson : NSObject
@property (nonatomic, assign) int ID;
@property (nonatomic, copy) NSString *name;
@property (nonatomic, assign) int age;
@end

2. 新建一個工具類來管理模型:

// YYPersonTool.h
#import <Foundation/Foundation.h>

@class YYPerson;
@interface YYPersonTool : NSObject
/** 保存一個聯系人 */
+ (void)save:( YYPerson*)person;
/** 查詢所有聯系人 */
+ (NSArray *)query;
+ (NSArray *)queryWithCondition:(NSString *)condition;
@end

YYPersonTool.m 是核心,涵蓋了數據庫初始化、建表、插入與模糊查詢:

// YYPersonTool.m
#import "YYPersonTool.h"
#import "YYPerson.h"
#import <sqlite3.h>

@implementation YYPersonTool

static sqlite3 *_db;

// 首先需要有數據庫
+(void)initialize
{
   // 獲得數據庫文件路徑
   NSString *doc=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
   NSString *fileName=[doc stringByAppendingPathComponent:@"person.sqlite"];
   // OC 字符串轉 C 字符串
   const char *cfileName=fileName.UTF8String;

   // 1. 打開數據庫(不存在時會自動創建)
   int result = sqlite3_open(cfileName, &_db);
   if (result==SQLITE_OK) {
       NSLog(@"成功打開數據庫");
       // 2. 創建表
       const char *sql="CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT,name text NOT NULL,age integer NOT NULL);";
       char *errmsg=NULL;
       result = sqlite3_exec(_db, sql, NULL, NULL, &errmsg);
       if (result==SQLITE_OK) {
           NSLog(@"創表成功");
       } else {
           printf("創表失敗---%s",errmsg);
       }
   } else {
       NSLog(@"打開數據庫失敗");
   }
}
// 保存一條數據
+(void)save:(YYPerson *)person
{
   NSString *sql=[NSString stringWithFormat:@"INSERT INTO t_person (name,age) VALUES ('%@',%d);",person.name,person.age];
   char *errmsg=NULL;
   sqlite3_exec(_db, sql.UTF8String, NULL, NULL, &errmsg);
   if (errmsg) {
       NSLog(@"插入數據失敗--%s",errmsg);
   } else {
       NSLog(@"插入數據成功");
   }
}
+(NSArray *)query
{
   return [self queryWithCondition:@""];
}
// 模糊查詢
+(NSArray *)queryWithCondition:(NSString *)condition
{
   NSMutableArray *persons=nil;
   NSString *NSsql=[NSString stringWithFormat:@"SELECT id,name,age FROM t_person WHERE name like '%%%@%%' ORDER BY age ASC;",condition];
   NSLog(@"%@",NSsql);
   const char *sql=NSsql.UTF8String;

   sqlite3_stmt *stmt=NULL;
   // 進行查詢前的准備工作
   if (sqlite3_prepare_v2(_db, sql, -1, &stmt, NULL)==SQLITE_OK) {
       NSLog(@"查詢語句沒有問題");
       persons=[NSMutableArray array];
       // 每調用一次 sqlite3_step,stmt 就指向下一條記錄
       while (sqlite3_step(stmt)==SQLITE_ROW) {
           int ID=sqlite3_column_int(stmt, 0);
           const unsigned char *name=sqlite3_column_text(stmt, 1);
           int age=sqlite3_column_int(stmt, 2);

           YYPerson *p=[[YYPerson alloc]init];
           p.ID=ID;
           p.name=[NSString stringWithUTF8String:(const char *)name];
           p.age=age;
           [persons addObject:p];
       }
   } else {
       NSLog(@"查詢語句有問題");
   }
   return persons;
}
@end

3. 在 storyboard 中刪除原有控制器,放一個導航控制器和 UITableViewController 並關聯,讓主控制器直接繼承自 UITableViewController:

// YYViewController.m
#import "YYViewController.h"
#import "YYPerson.h"
#import "YYPersonTool.h"

@interface YYViewController ()<UISearchBarDelegate>
@property(nonatomic,strong)NSArray *persons;
@end

@implementation YYViewController

#pragma mark- 懶加載
-(NSArray *)persons
{
   if (_persons==nil) {
       _persons=[YYPersonTool query];
   }
   return _persons;
}

// 1. 初始化方法中添加搜索框
- (void)viewDidLoad
{
   [super viewDidLoad];
   UISearchBar *search=[[UISearchBar alloc]init];
   search.frame=CGRectMake(0, 0, 300, 44);
   search.delegate=self;
   self.navigationItem.titleView=search;
}

// 2. 設置 tableView 數據
-(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
   return self.persons.count;
}
-(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
   static NSString *ID=@"ID";
   UITableViewCell *cell=[tableView dequeueReusableCellWithIdentifier:ID];
   if (cell==nil) {
       cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:ID];
   }
   YYPerson *person=self.persons[indexPath.row];
   cell.textLabel.text=person.name;
   cell.detailTextLabel.text=[NSString stringWithFormat:@"年齡  %d",person.age];
   return cell;
}

- (IBAction)add:(UIBarButtonItem *)sender {
   // 初始化一些假數據
   NSArray *names = @[@"西門抽血", @"西門抽筋", @"西門抽風", @"西門吹雪", @"東門抽血", @"東門抽筋", @"東門抽風", @"東門吹雪", @"北門抽血", @"北門抽筋", @"南門抽風", @"南門吹雪"];
   for (int i = 0; i<20; i++) {
       YYPerson *p = [[YYPerson alloc] init];
       p.name = [NSString stringWithFormat:@"%@-%d", names[arc4random_uniform(names.count)], arc4random_uniform(100)];
       p.age = arc4random_uniform(20) + 20;
       [YYPersonTool save:p];
   }
}

#pragma mark- 搜索框代理方法
-(void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText
{
   self.persons=[YYPersonTool queryWithCondition:searchText];
   [self.tableView reloadData];
   [searchBar resignFirstResponder];
}
@end

實現效果:

二、關於模糊查詢語句的說明

這句 SQL 值得細看:

SELECT id,name,age FROM t_person WHERE name like '%%%@%%' ORDER BY age ASC;

注意:name like '西門' 相當於 name = '西門';而 name like '%西%' 才是真正的模糊搜索,表示字符串中間包含「西」、左右兩側可以是任意內容。只是在 stringWithFormat: 裡,% 是轉義字符,兩個 % 才代表一個真正的 %。

SQLite 常用函數

一、核心 C 接口函數

1. 打開數據庫 sqlite3_open(filename, &db):filename 是數據庫文件路徑,db 是數據庫實例;

2. 執行任意 SQL 語句 sqlite3_exec(db, sql, callback, arg, &errmsg):可執行創表、更新、插入、刪除等,errmsg 用於接收錯誤信息;

3. 檢查 SQL 合法性 sqlite3_prepare_v2(db, zSql, nByte, &ppStmt, &pzTail):查詢前的准備,返回 SQLITE_OK 表示語句無誤,ppStmt 是後續取數據用的語句實例;

4. 逐行查詢 sqlite3_step(stmt):每調用一次指向下一條記錄,查到一行返回 SQLITE_ROW;

5. 取字段值 sqlite3_column_*(字段下標從 0 開始):sqlite3_column_int 取整型、sqlite3_column_double 取浮點、sqlite3_column_int64 取长整型、sqlite3_column_text 取字符串、sqlite3_column_blob 取二進制。

二、SQLite 編碼要點

1. 打開與關閉:sqlite3_open 會根據路徑打開數據庫,不存在則新建,返回 SQLITE_OK 表示成功;路徑必須以 C 字符串傳入;用完調 sqlite3_close(db) 關閉。

2. 執行不返回數據的語句(如建表、事務):用 sqlite3_exec,還可執行 begin transaction、rollback、commit 等事務語句。

3. 帶占位符插入(更安全、可防注入):

char *sql = "insert into t_person(name, age) values(?, ?);";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
   sqlite3_bind_text(stmt, 1, "母雞", -1, NULL);
   sqlite3_bind_int(stmt, 2, 27);
}
if (sqlite3_step(stmt) != SQLITE_DONE) {
   NSLog(@"插入數據錯誤");
}
sqlite3_finalize(stmt);

說明:占位符位置從 1 開始(不是 0);C 字符串可用 -1 代替長度;sqlite3_step 返回 SQLITE_DONE 代表執行成功;sqlite3_finalize 用於銷毀語句對象。

4. 查詢數據:

char *sql = "select id,name,age from t_person;";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
   while (sqlite3_step(stmt) == SQLITE_ROW) {
       int _id = sqlite3_column_int(stmt, 0);
       char *_name = (char *)sqlite3_column_text(stmt, 1);
       NSString *name = [NSString stringWithUTF8String:_name];
       int _age = sqlite3_column_int(stmt, 2);
       NSLog(@"id=%i, name=%@, age=%i", _id, name, _age);
   }
}
sqlite3_finalize(stmt);

sqlite3_step 返回 SQLITE_ROW 表示遍歷到一條新記錄,再用 sqlite3_column_* 按索引取出各字段值即可。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved