微信数据库WCDB的基本使用与高级接口使用-iOS

WCDB简介

WCDB 是腾讯开源的移动数据库框架，官网：https://github.com/Tencent/wcdb。和fmdb相比，主要是它支持ORM，用c++编写的，效率更高并且还是跨平台的，既可以在iOS上使用也可以在Android上使用。

基本使用的步骤

使用Cocoapods 安装，pod ‘WCDB’，其他安装方式请参考https://github.com/Tencent/wcdb/wiki

1、创建数据库

- (WCTDatabase *)database {

    static WCTDatabase *db = nil;

    static dispatch_once_t onceToken;

    dispatch_once(&onceToken, ^{

        NSString *docDir = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];

        db = [[WCTDatabase alloc] initWithPath:[docDir stringByAppendingPathComponent:@"my_db"]];

        if ([db canOpen]) {

            [db createTableAndIndexesOfName:@"user" withClass:[DBModel class]];

            //如果表不存在就创建表，如果字段有更新，就更新表，所以不用判断是否已经存在该表

        }

    });

    _database = db;

    return _database;

}

---

2、新增数据

DBModel *model = [[DBModel alloc] init];

  model.isAutoIncrement = YES; // 如果你的模型里使用了WCDB_PRIMARY_AUTO_INCREMENT，就要把该属性设置为YES，否则会报错

    model.age = age;

    model.name = name;

    if ([self.database insertObject:model into:@"user"]) {

        [_dataArray addObject:model];

    }

---

3、删除数据，其中user_id被定义为自增的主键

[self.database deleteObjectsFromTable:@"user" where:DBModel.user_id.is(model.user_id)]

---

4、修改数据

model.age = age;

  model.name = name;

   if ([self.database updateAllRowsInTable:@"user" onProperties:{DBModel.age ,DBModel.name} withObject:model]) {

            NSLog(@"修改成功");

        }

---

5、查询数据

[self.database getAllObjectsOfClass:DBModel.class fromTable:@"user"];//查询所有

[self.database getOneObjectOfClass:DBModel.class fromTable:@"user" where:DBModel.user_id.is(1)];//按条件查询

---

6、高级api介绍

 //getAllObjectsOnResults表示只查询某几个字段的值，但是返回的对象还是模型数组

    NSArray  *names= [self.database getAllObjectsOnResults:{DBModel.name} fromTable:@"user"];

    //getOneRowOnResults返回的是该属性的值的数组

    WCTOneRow *oneRow=  [self.database getOneRowOnResults:{DBModel.name} fromTable:@"user"];

    //AnyProperty.count() 查询表的数据条数

    id count=  [self.database getOneValueOnResult:DBModel.AnyProperty.count() fromTable:@"user"];

    //getOneObjectOfClass，返回表中的第一个模型对象

    id obj =  [self.database getOneObjectOfClass:DBModel.class fromTable:@"user"];

    //getAllRowsOnResults返回二维数组，其中每个数组的对象包含的是每个字段的值

    WCTColumnsXRows *row =  [self.database getAllRowsOnResults:{DBModel.name,DBModel.age} fromTable:@"user"];

---

模型的定义

模型需遵循WCTTableCoding协议

@interface DBModel : NSObject <WCTTableCoding>

@property int user_id;

@property (nonatomic, strong) NSString *name;

@property (nonatomic, assign) NSInteger age;

WCDB_PROPERTY(user_id)

WCDB_PROPERTY(name)

WCDB_PROPERTY(age)

@end

@implementation DBModel WCDB_IMPLEMENTATION(DBModel) WCDB_SYNTHESIZE(DBModel, name) WCDB_SYNTHESIZE(DBModel, age) WCDB_SYNTHESIZE(DBModel, user_id) WCDB_PRIMARY_AUTO_INCREMENT(DBModel, user_id)

使用起来觉得挺方便的！比fmdb优雅。