iOS · WCDB的使用

之前开发过的项目涉及到数据库操作都是使用了FMDB或者CoreData，直到最近接触到了使用WCDB的项目。茅舍顿开-数据存储不用再像FMDB那样每个业务都去些SQL语句了。当然CoreData大哥也是。但是WCDB是支持iOS、macOS、Android多平台的移动数据库框架！

WCDB的特性：

· 易用：WCDB支持一句代码即可将数据取出，并且组合成对象
· WINQ（WCDB语言集成查询）：通过WINQ，无需再写SQL语句
· ORM（Object Relational Mapping）:WCDB支持灵活、易用的ORM，可以便捷的定义表、索引、约束、并进行增删改查操作。
· 高效：性能比FMDB好
· 完整：WCDB满足了数据库相关的各种使用场景

直接上重点，如何使用WCDB？
CocoaPods安装WCDB：

target ‘yourProjectName' do
    platform :ios, ‘8.0'
    pod 'WCDB'
end

(注：WCDB中使用到了C，所以引用它的文件后缀需要把.m改成.mm)

引入头文件：

 #import <WCDB/WCDB.h>

1、创建数据库：

***.h
@interface WCBDManage : NSObject
+(instancetype)sharedManager;
@property (strong,nonatomic) WCTDatabase *dataBase;
@end

***.mm
#define kDataBaseFileName @“myWCDB.sqlite"
+(instancetype)sharedManager{
    static WCBDManage *manager = nil;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        manager = [[WCBDManage alloc] init];
    });
    return manager;
    
}
-(instancetype)init{
    self = [super init];
    if (self) {
        [self createDataBase];
    }
    return self;
}
-(void)createDataBase{
    NSString *documentPath = [NSSearchPathForDirectoriesInDomains(NSDocumentationDirectory, NSUserDomainMask, YES) objectAtIndex:0];
    NSString *dbPath = [documentPath stringByAppendingString:kDataBaseFileName];
    self.dataBase = [[WCTDatabase alloc] initWithPath:dbPath];
}
@synthesize dataBase = _dataBase;

2、创建model，并映射到数据表中的字段 （需要遵循 WCTTableCoding 协议）

***.h
#import <Foundation/Foundation.h>
#import <WCDB/WCDB.h>
@interface OrderDBTable : NSObject<WCTTableCoding>
@property (assign,nonatomic) NSInteger orderId;
@property (strong,nonatomic) NSString *orderTitle;
@property (strong,nonatomic) NSString *orderDescribe;
@property (assign,nonatomic) float price;
//需要绑定到表的字段在这里声明，在.mm中绑定
WCDB_PROPERTY(orderId)
WCDB_PROPERTY(orderTitle)
WCDB_PROPERTY(orderDescribe)
WCDB_PROPERTY(price)

***.mm
@implementation OrderDBTable
WCDB_IMPLEMENTATION(OrderDBTable)    //该宏实现绑定到表
WCDB_SYNTHESIZE(OrderDBTable, orderId)    //该宏实现绑定到表的字段
WCDB_SYNTHESIZE(OrderDBTable, orderTitle)
WCDB_SYNTHESIZE(OrderDBTable, orderDescribe)
WCDB_SYNTHESIZE(OrderDBTable, price)

// 约束宏定义数据库的主键
WCDB_PRIMARY(OrderDBTable, orderId)
// 定义数据库的索引属性，它直接定义createTime字段为索引
// 同时 WCDB 会将表名 + "_index" 作为该索引的名称
// WCDB_INDEX(OrderDBTable, "_index", createTime)

@end

3、创建表

#define kDataBaseName_orderTable @“kDataBaseName_orderTable"
//创建表
-(void)createOrderTable{
    if (![[LuckyWCBDManage sharedManager].dataBase isTableExists:kDataBaseName_orderTable]) {
        BOOL isCreate = [[LuckyWCBDManage sharedManager].dataBase createTableAndIndexesOfName:kDataBaseName_orderTable withClass:LuckyOrderDBTable.class];
    }
}

4、数据操作

//增加一条数据
+(BOOL)insertObjectWithOrderModel:(OrderDBTable *)model{
    BOOL success = [[WCBDManage sharedManager].dataBase insertObject:model into:kDataBaseName_orderTable];
    return success;
}

//查找某张表中所有数据
+(NSMutableArray *)searchAllData{
    NSMutableArray *resultArr = [[NSMutableArray alloc] initWithCapacity:0];
    WCTTable *table = [[WCBDManage sharedManager].dataBase getTableOfName:kDataBaseName_orderTable withClass:LuckyOrderDBTable.class];
    NSArray<OrderDBTable *> *arr = [table getAllObjects];
    [resultArr addObjectsFromArray:arr];
    return resultArr;
}