• iOS关于sqlite3操作

    原文：http://hi.baidu.com/clickto/blog/item/0c6904f787c34125720eec87.html

    iPhone中支持通过sqlite3来访问iPhone本地的数据库。

    具体使用方法如下

    1:添加开发包libsqlite3.0.dylib

    首先是设置项目文件，在项目中添加iPhone版的sqlite3的数据库的开发包，在项目下的Frameworks点击右键，然后选择libsqlite3.0.dylib文件。

    libsqlite3.0.dylib文件地址: 
    /Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS2.2.sdk/usr/lib/libsqlite3.0.dylib

    2，代码中的操作：

    那么接下来是代码了。

    1 首先获取iPhone上sqlite3的数据库文件的地址

    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentsDirectory = [paths objectAtIndex:0];
    NSString *path = [documentsDirectory stringByAppendingPathComponent:@"database_name"];

    2 打开iPhone上的sqlite3的数据库文件

    sqlite3 *database;
    sqlite3_open([path UTF8String], &database);

    3 准备sql文－－－sql语句

    sqlite3_stmt *stmt;
    const char *sql = "SELECT * FROM table_name WHERE pk=? and name=?";
    sqlite3_prepare_v2(database, sql, -1, &stmt, NULL);

    4 邦定参数

    // 邦定第一个int参数
    sqlite3_bind_int(stmt, 1, 1);
    // 邦定第二个字符串参数
    sqlite3_bind_text(stmt, 2, [title UTF8String], -1, SQLITE_TRANSIENT);

    5 执行sql文

    sqlite3_step(stmt);

    6 释放sql文资源

    sqlite3_finalize(stmt);

    7 关闭iPhone上的sqlite3的数据库

    sqlite3_close(database);


    以下演示一下使用sqlite的步骤，先创建一个数据库，然后查询其中的内容。2个重要结构体和5个主要函数：

    sqlite3               *pdb, 数据库句柄，跟文件句柄FILE很类似

    sqlite3_stmt      *stmt, 这个相当于ODBC的Command对象，用于保存编译好的SQL语句



    sqlite3_open(),   打开数据库

    sqlite3_exec(),   执行非查询的sql语句

    sqlite3_prepare(), 准备sql语句，执行select语句或者要使用parameter bind时，用这个函数（封装了sqlite3_exec）.

    Sqlite3_step(), 在调用sqlite3_prepare后，使用这个函数在记录集中移动。

    Sqlite3_close(), 关闭数据库文件



    还有一系列的函数，用于从记录集字段中获取数据，如

    sqlite3_column_text(), 取text类型的数据。

    sqlite3_column_blob（），取blob类型的数据

    sqlite3_column_int(), 取int类型的数据

    PreparedStatement方式处理SQL请求的过程
    特点：可以绑定参数，生成过程。执行的时候像是ADO一样，每次返回一行结果。

    1. 首先建立statement对象：
    int sqlite3_prepare(
    sqlite3 *db,            /* Database handle */
    const char *zSql,       /* SQL statement, UTF-8 encoded */
    int nBytes,             /* Length of zSql in bytes. */
    sqlite3_stmt **ppStmt,  /* OUT: Statement handle */
    const char **pzTail     /* OUT: Pointer to unused portion of zSql */
    );

    2. 绑定过程中的参数（如果有没有确定的参数）
    int sqlite3_bind_xxxx(sqlite3_stmt*, int, ...);
    第二个int类型参数－表示参数的在SQL中的序号（从1开始）。
    第三个参数为要绑定参数的值。
    对于blob和text数值的额外参数：
    第四参数是字符串（Unicode 8or16）的长度，不包括结束''。
    第五个参数，类型为void(*)(void*)，表示SQLite处理结束后用于清理参数字符串的函数。
    没有进行绑定的未知参数将被认为是NULL。

    3. 执行过程
    int sqlite3_step(sqlite3_stmt*);
    可能的返回值：
    *SQLITE_BUSY:   数据库被锁定，需要等待再次尝试直到成功。
    *SQLITE_DONE:   成功执行过程（需要再次执行一遍以恢复数据库状态）
    *SQLITE_ROW:    返回一行结果（使用sqlite3_column_xxx(sqlite3_stmt*,, int iCol)得到每一列的结果。
    再次调用将返回下一行的结果。
    *SQLITE_ERROR:  运行错误，过程无法再次调用（错误内容参考sqlite3_errmsg函数返回值）
    *SQLITE_MISUSE: 错误的使用了本函数（一般是过程没有正确的初始化）

    4. 结束的时候清理statement对象
    int sqlite3_finalize(sqlite3_stmt *pStmt);
    应该在关闭数据库之前清理过程中占用的资源。

    5. 重置过程的执行 
    int sqlite3_reset(sqlite3_stmt *pStmt);
    过程将回到没有执行之前的状态，绑定的参数不会变化。

    例子：
    创建数据库
    [objc] view plaincopy在CODE上查看代码片派生到我的代码片
    1. NSString *docsDir;  
    2.    NSArray *dirPaths;  
    3.        
    4.      dirPaths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);  
    5.      docsDir = [dirPaths objectAtIndex:0];  
    6.      databasePath = [[NSString alloc]initWithString:[docsDir stringByAppendingPathComponent:@"info.db"]];  
    7.      NSFileManager *fileManager = [NSFileManager defaultManager];  
    8.      if ([fileManager fileExistsAtPath:databasePath]==NO) {  
    9.          const charchar *dbpath = [databasePath UTF8String];  
    10.          if (sqlite3_open(dbpath, &dataBase)==SQLITE_OK) {  
    11.              charchar *errmsg;  
    12.              const charchar *createSql = "CREATE TABLE IF NOT EXISTS INFO (ID INTEGER PRIMARY KEY AUTOINCREMENT,NUM TEXT,CLASSNAME TEXT,NAME TEXT)";  
    13.              if (sqlite3_exec(dataBase, createSql, NULL, NULL, &errmsg)!=SQLITE_OK) {  
    14.                  status.text = @"create table failed";  
    15.                    
    16.              }  
    17.          }  
    18.          else{  
    19.              status.text = @"create/open failled";  
    20.          }  
    21.      }  

    保存：
    [objc] view plaincopy在CODE上查看代码片派生到我的代码片
    1. sqlite3_stmt *statement;  
    2.        
    3.      const charchar *dbpath = [databasePath UTF8String];  
    4.        
    5.      if (sqlite3_open(dbpath, &dataBase)==SQLITE_OK) {  
    6.          if ([num.text isEqualToString:@""]) {  
    7.              UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"SORRY!" message:@"number cannot be nil!" delegate:self cancelButtonTitle:@"OK" otherButtonTitles:nil];  
    8.              [alert show];  
    9.          }  
    10.          else {  
    11.            
    12.          NSString *insertSql = [NSString stringWithFormat:@"INSERT INTO INFO (num,classname,name) VALUES("%@","%@","%@")",num.text,classname.text,name.text];  
    13.          const charchar *insertsatement = [insertSql UTF8String];  
    14.          sqlite3_prepare_v2(dataBase, insertsatement, -1, &statement, NULL);  
    15.          if (sqlite3_step(statement)==SQLITE_DONE) {  
    16.              status.text = @"save to DB.";  
    17.              num.text = @"";  
    18.              classname.text = @"";  
    19.              name.text = @"";  
    20.          }  
    21.          else {  
    22.              status.text = @"save failed!";  
    23.          }  
    24.          sqlite3_finalize(statement);  
    25.          sqlite3_close(dataBase);  
    26.          }  
    27.      }  

    清除：
    [objc] view plaincopy在CODE上查看代码片派生到我的代码片
    1. num.text = @"";  
    2.      classname.text = @"";  
    3.      name.text = @"";  
    4.      status.text = @"";  
    [objc] view plaincopy在CODE上查看代码片派生到我的代码片
    1. <span style="font-size:24px;"><strong><span style="color:#ff00;">查询：</span></strong></span>  
    [objc] view plaincopy在CODE上查看代码片派生到我的代码片
      1. <pre code_snippet_id="310162" snippet_file_name="blog_20140424_5_1884255" class="objc" name="code">const charchar *dbpath = [databasePath UTF8String];  
      2.        
      3.      sqlite3_stmt *statement;  
      4.        
      5.      if (sqlite3_open(dbpath, &dataBase)==SQLITE_OK) {  
      6.          NSString *querySQL = [NSString stringWithFormat:@"SELECT classname,name from info where num="%@"",num.text];  
      7.          const charchar *querystatement = [querySQL UTF8String];  
      8.          if (sqlite3_prepare_v2(dataBase, querystatement, -1, &statement, NULL)==SQLITE_OK) {  
      9.              if (sqlite3_step(statement)==SQLITE_ROW) {  
      10.                  NSString *classnameField = [[NSString alloc] initWithUTF8String:(const charchar *)sqlite3_column_text(statement, 0)];  
      11.                  classname.text = classnameField;  
      12.                  NSString *nameField = [[NSString alloc] initWithUTF8String:(const charchar *) sqlite3_column_text(statement, 1)];  
      13.                  name.text = nameField;  
      14.                    
      15.                  status.text = @"find~~~";                  
      16.              }  
      17.              else {  
      18.                  status.text = @"did not find you need.";  
      19.              }  
      20.              sqlite3_finalize(statement);  
      21.          }  
      22.          sqlite3_close(dataBase);  
      23.      }</pre><br>  
      24. 其他工具函数<br>  
      25. 1. 得到结果总共的行数<br>  
      26. int sqlite3_column_count(sqlite3_stmt *pStmt);<br>  
      27. 如果过程没有返回值，如update，将返回0<br>  
      28. <br>  
      29. 2. 得到当前行中包含的数据个数<br>  
      30. int sqlite3_data_count(sqlite3_stmt *pStmt);<br>  
      31. 如果sqlite3_step返回SQLITE_ROW，可以得到列数，否则为零。<br>  
      32. <br>  
      33. 3. 得到数据行中某个列的数据<br>  
      34. sqlite3_column_xxx(sqlite3_stmt*, int iCol);<br>  
      35. 在sqlite3_step返回SQLITE_ROW后，使用它得到第iCol列的数据。<br>  
      36. 其中的xxx代表：<br>  
      37. blob：指向保存数据内存的指针<br>  
      38. bytes, bytes16: 得到该blob类型数据的大小，或者text转换为UTF8/UTF16的字符串长度。<br>  
      39. double, int, int64： 数值<br>  
      40. text,text16：字符串指针<br>  
      41. type:该列的数据类型（SQLITE_INTEGER，SQLITE_FLOAT，SQLITE_TEXT，SQLITE_BLOB，SQLITE_NULL）<br>  
      42. 注意：如果对该列使用了不同与该列本身类型适合的数据读取方法，得到的数值将是转换过的结果。<br>  
      43. <br>  
      44. 4. 得到数据行中某个列的数据的类型<br>  
      45. int sqlite3_column_type(sqlite3_stmt*, int iCol);<br>  
      46. 返回值：SQLITE_INTEGER，SQLITE_FLOAT，SQLITE_TEXT，SQLITE_BLOB，SQLITE_NULL<br>  
      47. 使用的方法和sqlite3_column_xxx()函数类似。<br>  
      48. <br>  
      49. //////////////////////////////////////Sqlite 資料庫檔案的產生<br>  
      50. MAC 上有許多應用程式都可以用來產生它，有 UI 界面很方便。但如果不想另外安裝軟體，MAC 系統也內建 sqlite3 的元件，可由 console 來建立。首先我們先開啟任何一款文書編輯軟體，以 sql 語法來手動建立，並存成 data.sql。<br>  
      51. <br>  
      52. <div>  
      53. <div>  
      54. <div>1BEGINTRANSACTION;</div>  
      55. <div>2CREATETABLE'Info'(_id INTEGERPRIMARYKEY, 'Name'TEXT, 'Tel'TEXT, 'Address'TEXT);</div>  
      56. <div>3INSERTINTO'Info'VALUES(1,'Richie','1234567','台中市');</div>  
      57. <div>4INSERTINTO'Info'VALUES(2,'Eric','7654321','台北市');</div>  
      58. <div>5INSERTINTO'Info'VALUES(3,'Andy','1234321','高雄市');</div>  
      59. <div>6COMMIT;</div>  
      60. </div>  
      61. </div>  
      62. <br>  
      63. <br>  
      64. 然後在 console 下達以下指令 來產生 data.rdb 這個 sqlite file<br>  
      65. <br>  
      66. <div>  
      67. <div>  
      68. <div>1sqlite3 data.rdb < data.sql</div>  
      69. </div>  
      70. </div>  
      71. <br>  
      72. <br>  
      73. iOS 專案使用 Sqlite 資料庫<br>  
      74. 先將剛才產生的資料庫加入專案中，然後在專案中加入 libsqlite3.0.dylib。<br>  
      75. <br>  
      76. <br>  
      77. <br>  
      78. 接下來開始撰寫程式碼了，xxxAppDelegate.h 必須 import sqlite3.h，並宣告一個 sqlite3 結構。<br>  
      79. <pre code_snippet_id="310162" snippet_file_name="blog_20140424_6_8754335" class="objc" name="code">#import "sqlite3.h"  
      80.   @interfacexxxAppDelegate : NSObject<UIApplicationDelegate>  
      81. {  
      82.    sqlite3* database;  
      83. }  
      84.   
      85.   
      86. 在 xxxAppDelegate.m 的 didFinishLaunchingWithOptions 函式 開始加入相關程式碼  
      87.   
      88.   
      89.   
      90.   
      91. - (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions  
      92.   
      93. {  
      94.   
      95.     // 檢查資料庫是否存在，不存在時則 copy  
      96.   
      97.     NSString*path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];  
      98.   
      99.     NSString*file = [path stringByAppendingPathComponent:@"data.rdb"];  
      100.   
      101.     if([[NSFileManagerdefaultManager] fileExistsAtPath:file] == FALSE)  
      102.     {  
      103.         NSString*fromFile = [[NSBundlemainBundle] pathForResource:@"data.rdb"ofType:nil];  
      104.   
      105.         [[NSFileManagerdefaultManager] copyItemAtPath:fromFile toPath:file error:nil];  
      106.     }  
      107.     // open  
      108.     if(sqlite3_open([file UTF8String], &database) != SQLITE_OK)  
      109.   
      110.         NSAssert1(0, @"Failed to open database with message '%s'.", sqlite3_errmsg(database));  
      111.   
      112.      self.window.rootViewController = self.viewController;  
      113.     [self.window makeKeyAndVisible];  
      114.     returnYES;  
      115. }  
      116.     
      117. - (void)dealloc  
      118. {  
      119.     sqlite3_close(database);  
      120.     [superdealloc];  
      121. }</pre><br>  
      122. 簡 單說明一下，將 data.rdb 加入專案中後，該資料庫會出現在 app　套件內，但每個 app 就只有專屬 Documents 目錄可以讀寫。所以必須判斷 Documents 目錄下該檔案是否存在，如果不存在則 copy 過去該目錄後再 open　資料庫。至於為什麼做判斷？為什麼不每次都 copy 過去即可？因為如果不希望該資料庫在每次 app 版本更新後，都會被覆蓋掉，就得做檔案存在與否的判斷。<br>  
      123. <br>  
      124. 讀取資料庫<br>  
      125. 有成功 open 資料庫之後，就可以開始進行讀寫了。讀取資料庫的方法，其實也是很簡單，只要熟悉 SQL 語法，應該就沒什麼問題了。<br>  
      126. <pre code_snippet_id="310162" snippet_file_name="blog_20140424_7_4960107" class="objc" name="code">NSString*sql = [NSStringstringWithFormat:@"SELECT * FROM Event "];  
      127.   
      128. sqlite3_stmt *statement;  
      129.   
      130. if(sqlite3_prepare_v2(database, 1, -1, &statement, NULL) == SQLITE_OK)  
      131. {  
      132.     while (sqlite3_step(statement) == SQLITE_ROW)  
      133.     {  
      134.         NSString*strValue = [NSStringstringWithUTF8String:(char*)sqlite3_column_text(statement, 0)];  
      135.         intintValue = sqlite3_column_int(statement, 1);  
      136.    }  
      137. }  
      138.   
      139. sqlite3_finalize(statement);</pre><br>  
      140. 其中必須注意的是 sqlite3_column_text, sqlite3_column_int 負責取得資料，必須指定是哪個 column index。<br>  
      141. <br>  
      142. 執行 SQL 命令<br>  
      143. 上述是 SELECT 的用法，但是如果需要做 INSERT, DELETE, UPDATE 等動作時，則更是簡單，只需以下指令即可。<br>  
      144. <pre code_snippet_id="310162" snippet_file_name="blog_20140424_8_3433372" class="objc" name="code">char*errMsg;  
      145.   
      146. NSString*sql = [NSStringstringWithFormat:@"CREATE TABLE 'Info' (_id INTEGER PRIMARY KEY, 'Name' TEXT, 'Tel' TEXT, 'Address' TEXT)"];  
      147.   
      148. sqlite3_exec(database, 1, nil, nil, &errMsg);</pre><br>  
      149. <pre></pre> 
  • 相关阅读:
    团队里A和B吵架了，经理M该干啥？
    一个程序员的哲学思考（关于编程、关于人生）
    程序员在大学里究竟应该学习什么？
    如何检查自己是否平庸？
    关于如何读代码？
    老说技术更迭快，可十年到底可以淘汰多少知识？
    现代软件工程里的困惑
    略谈各国企业的差异
    Silverlight4Beta之操作摄像头/麦克风
    Silverlight4Beta之Binding新特性（下）
  • 原文地址：https://www.cnblogs.com/A--G/p/4600807.html
Copyright © 2020-2023  润新知