EGODatabase 技术文档

1. 安装指南

1.1 环境要求

• iOS 所有版本
• Mac OS X 10.5 及以上版本

1.2 依赖库

• 需要链接 libsqlite3.dylib 库到你的项目中。

1.3 安装步骤

1. 将 EGODatabase 文件夹添加到你的项目中。
2. 在项目设置中，确保链接了 libsqlite3.dylib 库。
3. 在需要使用 EGODatabase 的文件中，导入头文件：

   #import "EGODatabase.h"
   

2. 项目的使用说明

2.1 打开数据库

使用 EGODatabase 类打开 SQLite 数据库文件：

EGODatabase* database = [EGODatabase databaseWithPath:[NSHomeDirectory() stringByAppendingPathComponent:@"Documents/database.db"]];

2.2 执行查询

使用 executeQueryWithParameters: 方法执行查询，并获取结果：

EGODatabaseResult* result = [database executeQueryWithParameters:@"SELECT * FROM `posts` WHERE `user_id` = ?", @(10), nil];

2.3 处理查询结果

遍历 EGODatabaseResult 中的每一行，并获取相应的数据：

for(EGODatabaseRow* row in result) {
    NSLog(@"Subject: %@", [row stringForColumn:@"subject"]);
    NSLog(@"Date: %@", [row dateForColumn:@"date"]);
    NSLog(@"Views: %d", [row intForColumn:@"views"]);
    NSLog(@"Message: %@", [row stringForColumn:@"message"]);
}

3. 项目API使用文档

3.1 EGODatabase 类

• + (EGODatabase*) databaseWithPath:(NSString*)filePath;

  • 描述：创建并打开一个 SQLite 数据库文件。
  • 参数：filePath - 数据库文件的路径。
  • 返回值：EGODatabase 对象。

• - (EGODatabaseResult*) executeQueryWithParameters:(NSString*)sql, ...;

  • 描述：执行 SQL 查询语句，并返回结果集。
  • 参数：sql - SQL 查询语句，... - 查询参数。
  • 返回值：EGODatabaseResult 对象。

3.2 EGODatabaseResult 类

• @property (nonatomic, readonly) NSArray* columnNames;

  • 描述：查询结果的列名数组。

• @property (nonatomic, readonly) NSArray* columnTypes;

  • 描述：查询结果的列类型数组。

• @property (nonatomic, readonly) NSArray* rows;

  • 描述：查询结果的行数据数组，每一行是一个 EGODatabaseRow 对象。

3.3 EGODatabaseRow 类

• - (int) intForColumn:(NSString*)columnName;

  • 描述：获取指定列的整数值。
  • 参数：columnName - 列名。
  • 返回值：整数值。

• - (NSString*) stringForColumn:(NSString*)columnName;

  • 描述：获取指定列的字符串值。
  • 参数：columnName - 列名。
  • 返回值：字符串值。

• - (NSDate*) dateForColumn:(NSString*)columnName;

  • 描述：获取指定列的日期值。
  • 参数：columnName - 列名。
  • 返回值：日期值。

4. 项目安装方式

4.1 手动安装

1. 下载 EGODatabase 项目文件。
2. 将 EGODatabase 文件夹拖入你的 Xcode 项目中。
3. 在项目设置中，链接 libsqlite3.dylib 库。

4.2 使用 CocoaPods

1. 在 Podfile 中添加以下内容：

   pod 'EGODatabase'
   

2. 运行 pod install 命令安装依赖。

通过以上步骤，你就可以成功安装并使用 EGODatabase 项目了。