README.md · zhou4570/STDbObject

#STDbKit

## 1. 概述
```
对于小型数据很方便, 声明一个继承于STDbObject的类对象user，

写入到数据库直接执行方法  [user insertToDb]; 
从数据库读取，NSArray *users = [User dbObjectsWhere:@"_id=11" orderby:nil];
更新到数据库，[user updateToDb];
从数据库删除，[user removeFromDb];

*更新内容
1.0.3版本支持复杂类型 NSData, NSDate, NSArray, NSDictionary
1.0.4添加dbObject过期属性，当数据过期，数据会被自动删除，可用于有时间限制的历史纪录等场景
     添加了数据库加密功能（目前仅支持字符串加密）
     一个STDbObject允许添加另一个STDbObject对象了（2014-01-02更新）
1.0.5支持一个STDbObject对象包含另一个STDbObject对象了(2014-01-04更新)
2.0 更新内容（2014-01-06更新）
    support array contain objects of STDbObject class
    support dictionary contain an STDbObject object
    remove the sub STDbObject after remove the parent object
2.0.2 更新内容（2014-02-18更新）
    1. add objc to dictionary method 
    2. add dictionary to objc method
2.2.1 更新内容（2015-06-15）
	1. 添加多线程支持
	2. 多db文件支持
	3. 增加了数据库更新功能， + (NSInteger)dbVersion;

```

## 2. 使用方法

```
方法一：导入源码
方法二：项目支持cocoapods，在Podfile中添加pod STDbKit
方法三：制作STDbKit.framework并引入，可从附件中下载

支持模拟器和真机STDbKit.framework制作方法:
   1. 分别在device和模拟器下运行
   2. 右击 STDbKit.framework, 选择Show In Finder, 找到上级目录,本项目是release版本,
      这里显示Release-iphoneos,Release-iphonesimulator
   3. 把Release-iphoneos,Release-iphonesimulator文件夹拷贝到桌面
   4. 在终端运行lipo -create ~/Desktop/Release-iphoneos/STDbKit.framework/STDbKit \
      ~/Desktop/Release-iphonesimulator/STDbKit.framework/STDbKit \
      -output ~/Desktop/STDbKit
   5. 在桌面文件夹Release-iphoneos上, 拷贝 STDbKit.framework到桌面，把桌面上 STDbKit 
      文件覆盖到STDbKit.framework, 制作完成
   6. 在项目中引用STDbKit.framework框架，支持模拟器和真机了
 * 引入依赖库sqlite3.dylib
 * 创建需要保存的数据类，该类需继承类STDbObject
```

## 3. 示例

#####  1. 声明一个类，这里新建类User
```
#import "STDbObject.h"
#import "STDbQueue.h"
#import "STDb.h"

@interface User : STDbObject

@property (strong, nonatomic) NSString *name;
 @property (assign, nonatomic) NSInteger age;
 @property (strong, nonatomic) NSNumber *sex;
 @property (assign, nonatomic) NSTimeInterval time;
 @property (assign, nonatomic) int _id;

@end
```
#####  2. 插入到数据库
```
方式一：
STDbQueue *dbQueue = [STDbQueue dbWithPath:@"stdb_test/test_queue.sqlite"];
[dbQueue execute:^(STDb *db) {
	User *user = [[User alloc] initWithPrimaryValue:8];
	user.name = @"yls";
	[db insertDbObject:user];
}];
方式二：
STDbQueue *dbQueue = [STDbQueue dbWithPath:@"stdb_test/test_queue.sqlite"];
[dbQueue execute:^(STDb *db) {
	User *user = [[User alloc] initWithPrimaryValue:8];
	user.name = @"yls";
	[user insertToDb:db];
}];
方式三：
STDbQueue *dbQueue = [STDbQueue dbWithPath:@"stdb_test/test_queue.sqlite"];
[dbQueue execute:^(STDb *db) {
	[db executeUpdate:@"insert into User(?) values(?)" dictionaryArgs:@{@"name" : @"aaa"}];
}];

```
#####  3. 查询
```
// 取出所有用户
方式一：
NSArray *users = [User allDbObjects];
方式二：
[dbQueue execute:^(STDb *db) {
	[db executeQuery:@"select * from User" resultBlock:^(NSArray *resultArray) {
            NSLog(@"%@", resultArray);
	}];
}];
    
// 按条件取出数据
NSArray *users = [User dbObjectsWhere:@"_id=11" orderby:nil];

```
#####  4. 修改
```
// 首先从数据库中取出要修改的对象
方式一：
NSArray *users = [User dbObjectsWhere:@"_id=11" orderby:nil];
if ([users count] > 0) {
   User *user = users[0];
   user.name = @"学长";
   // 更新到数据库
   [user updateToDb];
}
方式二：
[dbQueue execute:^(STDb *db) {
	[user updateToDb:db];
}];
```
#####  5. 删除
```
// 要删除的数据
方式一：
User *user = _users[row];
// 从数据库中删除数据
[user removeFromDb];
方式二：
[dbQueue execute:^(STDb *db) {
	[db executeQuery:@"delete from User where __id__=8"];
	}];
}];
// 批量删除
[User removeDbObjectsWhere:@"_id=%d", 4];
```
**注意：** *一旦修改了数据类，请删除原来的应用重新运行。本项目内置了日期相关方法，详情参见* [NSDate+STExts](http://git.oschina.net/yanglishuan/NSDate-STExts)。

zhou4570/STDbObject

简介

发行版

贡献者

近期动态

zhou4570/STDbObject .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

zhou4570/STDbObject