iOS:LKDBHelper实体对象映射数据库-第三方框架（在FMDB的基础上进行二次封装）

一 插件简介：

其github地址:https://github.com/li6185377/LKDBHelper-SQLite-ORM

全面支持 NSArray,NSDictionary, ModelClass, NSNumber, NSString, NSDate, NSData, UIColor, UIImage, CGRect, CGPoint, CGSize, NSRange, int,char,float, double, long.. 等属性的自动化操作(插入和查询)

 

二 实例内容：

采用pods进行加载LKDBHelper插件,若有下载源代码调试时记得更新一下(平常项目中记得对libsqlite3.dylib进行引用);

本实例创建一个父实体BaseBean,后面其它实体都进行继承

 

1：父实体的代码内容

BaseBean.h内容:

#import <Foundation/Foundation.h>
#import <LKDBHelper/LKDBHelper.h>

@interface BaseBean : NSObject

@end


//这个NSObject的扩展类 可以查看详细的建表sql语句
@interface NSObject(PrintSQL)

+(NSString*)getCreateTableSQL;

@end

*这边可以放一些其它实体都公有的属性，及lkdbhelper数据库的地址；其中PrintSQL是对NSObject的扩展，可以查看创建表的sql语句；

BaseBean.m内容:

//  BaseBean.m
//  LKDBHelperTest
//
//  Created by mac on 16/2/17.
//  Copyright © 2016年 mac. All rights reserved.
//

#import "BaseBean.h"

@implementation BaseBean

/**
 *  创建数据库
 */
+(LKDBHelper *)getUsingLKDBHelper
{
    static LKDBHelper* db;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        NSString *sqlitePath = [BaseBean downloadPath];
        NSString* dbpath = [sqlitePath stringByAppendingPathComponent:[NSString stringWithFormat:@"lkdbhelperTest.db"]];
        db = [[LKDBHelper alloc]initWithDBPath:dbpath];
    });
    return db;
}

/**
 *  数据库存放路径
 */
+ (NSString *)downloadPath{
    NSString *documentPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
    NSString *downloadPath = [documentPath stringByAppendingPathComponent:@"LKHTest"];
    NSLog(@"%@",downloadPath);
    return downloadPath;
}
@end



@implementation NSObject(PrintSQL)

/**
 *  创建数据表
 */
+(NSString *)getCreateTableSQL
{
    LKModelInfos* infos = [self getModelInfos];
    NSString* primaryKey = [self getPrimaryKey];
    NSMutableString* table_pars = [NSMutableString string];
    for (int i=0; i<infos.count; i++) {
        
        if(i > 0)
            [table_pars appendString:@","];
        
        LKDBProperty* property =  [infos objectWithIndex:i];
        [self columnAttributeWithProperty:property];
        
        [table_pars appendFormat:@"%@ %@",property.sqlColumnName,property.sqlColumnType];
        
        if([property.sqlColumnType isEqualToString:LKSQL_Type_Text])
        {
            if(property.length>0)
            {
                [table_pars appendFormat:@"(%ld)",(long)property.length];
            }
        }
        if(property.isNotNull)
        {
            [table_pars appendFormat:@" %@",LKSQL_Attribute_NotNull];
        }
        if(property.isUnique)
        {
            [table_pars appendFormat:@" %@",LKSQL_Attribute_Unique];
        }
        if(property.checkValue)
        {
            [table_pars appendFormat:@" %@(%@)",LKSQL_Attribute_Check,property.checkValue];
        }
        if(property.defaultValue)
        {
            [table_pars appendFormat:@" %@ %@",LKSQL_Attribute_Default,property.defaultValue];
        }
        if(primaryKey && [property.sqlColumnName isEqualToString:primaryKey])
        {
            [table_pars appendFormat:@" %@",LKSQL_Attribute_PrimaryKey];
        }
    }
    NSString* createTableSQL = [NSString stringWithFormat:@"CREATE TABLE IF NOT EXISTS %@(%@)",[self getTableName],table_pars];
    return createTableSQL;
}

@end

2：子实体CarBean的内容，其是另外一个实体UserBean的一个外键

CarBean.h内容：

//
//  CarBean.h
//  LKDBHelperTest
//
//  Created by mac on 16/2/17.
//  Copyright © 2016年 mac. All rights reserved.
//

#import "BaseBean.h"

@interface CarBean : BaseBean

@property(assign,nonatomic)int carID;
@property(strong,nonatomic)NSString *carNum;
@property(strong,nonatomic)NSString *address;
@property(assign,nonatomic)float carWidth;

@end

CarBean.m内容：

//
//  CarBean.m
//  LKDBHelperTest
//
//  Created by mac on 16/2/17.
//  Copyright © 2016年 mac. All rights reserved.
//

#import "CarBean.h"

@implementation CarBean

+(void)initialize
{
    //单个要不显示时
    [self removePropertyWithColumnName:@"address"];
    
    //多列要不显示时
    //[self removePropertyWithColumnNameArray:];
    
    //修改列对应到表时 重命名新列名
    [self setTableColumnName:@"MyCarWidth" bindingPropertyName:@"carWidth"];
}


/**
 *  @brief  是否将父实体类的属性也映射到sqlite库表
 *  @return BOOL
 */
+(BOOL) isContainParent{
    return YES;
}
/**
 *  @brief  设定表名
 *  @return 返回表名
 */
+(NSString *)getTableName
{
    return @"carbean";
}
/**
 *  @brief  设定表的单个主键
 *  @return 返回主键表
 */
+(NSString *)getPrimaryKey
{
    return @"carID";
}

/////复合主键  这个优先级最高
//+(NSArray *)getPrimaryKeyUnionArray
//{
//    return @[@"carID",@"carNum"];
//}

@end

*主要注意关于可以把一些属性过滤掉，就不会创建到表中，也可以对列名进行重定义，其它几个代码有详细说明

3：子实体UserBean，同样继承BaseBean

UserBean.h内容：

//
//  UserBean.h
//  LKDBHelperTest
//
//  Created by mac on 16/2/17.
//  Copyright © 2016年 mac. All rights reserved.
//

#import "BaseBean.h"
#import "CarBean.h"

@interface UserBean : BaseBean

@property(assign,nonatomic)int ID;
@property(strong,nonatomic)NSString *userName;
@property(strong,nonatomic)NSString *password;
@property(assign,nonatomic)int age;

@property(strong,nonatomic)CarBean *myCar;

@end

UserBean.m内容：

//
//  UserBean.m
//  LKDBHelperTest
//
//  Created by mac on 16/2/17.
//  Copyright © 2016年 mac. All rights reserved.
//

#import "UserBean.h"

@implementation UserBean

+(void)initialize
{
    [self removePropertyWithColumnName:@"error"];
}

/**
 *  @brief  是否将父实体类的属性也映射到sqlite库表
 *  @return BOOL
 */
+(BOOL) isContainParent{
    return YES;
}
/**
 *  @brief  设定表名
 *  @return 返回表名
 */
+(NSString *)getTableName
{
    return @"userBean";
}
/**
 *  @brief  设定表的单个主键
 *  @return 返回主键表
 */
+(NSString *)getPrimaryKey
{
    return @"ID";
}

@end

在ViewController类中测试：

//
//  ViewController.m
//  LKDBHelperTest
//
//  Created by mac on 16/2/17.
//  Copyright © 2016年 mac. All rights reserved.
//

#import "ViewController.h"
#import <LKDBHelper.h>
#import "BaseBean.h"
#import "UserBean.h"

@interface ViewController ()
@property (strong,nonatomic)LKDBHelper* globalHelper;
@property (strong,nonatomic)UserBean *user;
@property (strong,nonatomic)CarBean *car;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    [self test];
}


/**
 *  开始进行针对数据库进行操作
    功能包括删除所有表，清理指定表的数据，创建表插入数据，其中插入数据会自动判断表是否存在，若不存在则先创建表再插入，特别说明就是当一个列被定义为int且是主键时，它要是没有被赋值就会自动增长
 */
-(void)test{
    
    self.globalHelper = [BaseBean getUsingLKDBHelper];
    
    //删除所有的表
    [self.globalHelper dropAllTable];
    
    //清理所有数据
    [LKDBHelper clearTableData:[UserBean class]];
    
    self.user=[[UserBean alloc] init];
    //self.user.ID=1000;  //特别说明 如果是主键 没给它赋值它就会自动增长
    self.user.userName=@"WUJY";
    self.user.password=@"123456";
    self.user.age=10;
    
    self.car=[[CarBean alloc]init];
    self.car.carNum=@"D88888";
    self.car.address=@"厦门软件园";
    self.car.carWidth=12.5;
    
    self.user.myCar=self.car;
    
    //插入数据 如果表不存在 它会自动创建再插入 实体实例化LKDBHelper 若是继承记得引用 否则会没有效果
    [self.user saveToDB];
    
    //另外一种插入
    self.user.age=29;
    [self.globalHelper insertToDB:self.user];
}

/**
 *  关于事务的操作
 */
-(void)test2{
    
    //事物  transaction 这边故意让它插入失败
    [self.globalHelper executeForTransaction:^BOOL(LKDBHelper *helper) {
        
        self.user.ID = 10;
        self.user.userName=@"wujy10";
        BOOL success = [helper insertToDB:self.user];
        
        self.user.ID = 9;
        self.user.userName=@"wujy09";
        success = [helper insertToDB:self.user];
        
        //重复主键
        self.user.ID = 10;
        BOOL insertSucceed = [helper insertWhenNotExists:self.user];
        
        //insert fail
        if(insertSucceed == NO)
        {
            ///rollback
            return NO;
        }
        else
        {
            ///commit
            return YES;
        }
    }];
}

/**
 *  关于异步操作，对于其它操作也同样支持异步操作，采用callback方式进行回调
 */
-(void)test3{
    
    self.user.userName=@"异步";
    [self.globalHelper insertToDB:self.user callback:^(BOOL result) {
        NSLog(@"异步插入是否成功：%@",result>0?@"是":@"否");
    }];
    
    //异步查询
    [self.globalHelper search:[UserBean class] where:nil orderBy:nil offset:0 count:100 callback:^(NSMutableArray *array) {
        for (id obj in array) {
            NSLog(@"异步：%@",[obj printAllPropertys]);
        }
    }];
}

/**
 *  关于查询功能的几种操作，特别注意条件的写法，其它在代码中有相应的注解
 */
-(void)test4{
    
    NSMutableArray* searchResultArray=nil;
    
    //同步搜索 执行sql语句 把结果再变成对象
    searchResultArray=[self.globalHelper searchWithSQL:@"select * from @t" toClass:[UserBean class]];
    for (id obj in searchResultArray) {
        NSLog(@"sql语句：%@",[obj printAllPropertys]);
    }
    
    //使用对象对进查询操作  offset是跳过多少行 count是查询多少条
    searchResultArray=[UserBean searchWithWhere:nil orderBy:nil offset:0 count:100];
    for (id obj in searchResultArray) {
        NSLog(@"实体：%@",[obj printAllPropertys]);
    }
    
    //查询一列时的操作 count为0时则查所有列
    NSArray* nameArray = [UserBean searchColumn:@"userName" where:nil orderBy:nil offset:0 count:0];
    NSLog(@"%@",[nameArray componentsJoinedByString:@","]);
    
    //查询多列时的操作
    NSArray* twoColumn=[UserBean searchColumn:@"ID,userName" where:nil orderBy:nil offset:0 count:0];
    for (UserBean *obj in twoColumn) {
        NSLog(@"%d-%@",obj.ID,obj.userName);
    }
    
    //组合查询四种 and or like in
    searchResultArray=[UserBean searchWithWhere:[NSString stringWithFormat:@"userName like '%%JY%%'"] orderBy:nil offset:0 count:0];
    NSLog(@"LIKE :%lu",searchResultArray.count);
    
    searchResultArray=[UserBean searchWithWhere:[NSString stringWithFormat:@"age=29 and userName='WUJY'"] orderBy:nil offset:0 count:0];
    NSLog(@"AND :%lu",searchResultArray.count);
    
    searchResultArray=[self.globalHelper search:[UserBean class] where:@{@"age":@29,@"userName":@"WUJY"} orderBy:nil offset:0 count:0];
    NSLog(@"AND %lu",searchResultArray.count);
    
    searchResultArray=[UserBean searchWithWhere:[NSString stringWithFormat:@"age=29 or userName='WUJY'"] orderBy:nil offset:0 count:0];
    NSLog(@"OR %lu",searchResultArray.count);
    
    searchResultArray=[UserBean searchWithWhere:[NSString stringWithFormat:@"age in (10,29)"] orderBy:nil offset:0 count:0];
    NSLog(@"in %lu",searchResultArray.count);
    
    searchResultArray=[self.globalHelper search:[UserBean class] where:@{@"age":@[@10,@29]} orderBy:nil offset:0 count:0];
    NSLog(@"in %lu",searchResultArray.count);
    
    //查询符合条件的条数
    NSInteger rowCount=[UserBean rowCountWithWhere:@"age=29"];
    NSLog(@"rowCount %ld",rowCount);
    
    /*
     
     *注意：
     
     单条件:
     @"rowid = 1"  或者  @{@"rowid":@1}
     
     多条件：
     @“rowid = 1 and sex = 0"  或者    @{@"rowid":@1,@"sex":@0}
     如果是or类型的条件，则只能用字符串的形式：@"rowid = 1 or sex = 0"
     
     in条件：
     @"rowid in (1,2,3)"   或者     @{@"rowid":@[@1,@2,@3]}
     多条件带in：@"rowid in (1,2,3) and sex=0 "   或者    @{@"rowid":@[@1,@2,@3],@"sex":@0}
     
     时间也只能用字符串：
     @"date >= '2013-04-01 00:00:00'"
     
     like也只能用字符串：
     @"userName like '%%JY%%'"
     
    */
}

/**
 *   更新操作
 */
-(void)test5{
    
    NSMutableArray* searchResultArray=nil;
    
    //带条件更新
    self.user.userName=@"踏浪帅";
    BOOL isUpDate=[self.globalHelper updateToDB:self.user where:@{@"ID":@10}];
    NSLog(@"是否更新成功:%@",isUpDate>0?@"是":@"否");
    
    //根据条件获得后进行更新
    searchResultArray=[UserBean searchWithWhere:[NSString stringWithFormat:@"userName='%@'",@"WUJY"] orderBy:nil offset:0 count:100];
    self.user=[searchResultArray firstObject];
    self.user.password=@"aa123456";
    BOOL moreUpdate=[self.globalHelper updateToDB:self.user where:nil];
    NSLog(@"根据条件获得后进行更新:%@",moreUpdate>0?@"是":@"否");
    
    //更新 访问表名 更新内容跟条件进行更新
    BOOL updateTab=[self.globalHelper updateToDBWithTableName:@"userBean" set:@"password='aa123456'" where:@"age=10"];
    NSLog(@"访问表名更新内容跟条件进行更新:%@",updateTab>0?@"是":@"否");
    
    //根据 实类进行更新
    BOOL updateClass=[self.globalHelper updateToDB:[UserBean class] set:@"password='cnblogs'" where:@"userName='WUJY'"];
    NSLog(@"根据实类进行更新:%@",updateClass>0?@"是":@"否");
}

/**
 *  删除操作
 */
-(void)test6{
    
    //删除功能
    self.user=[self.globalHelper searchSingle:[UserBean class] where:@{@"age":@10} orderBy:nil];
    BOOL ishas=[self.globalHelper isExistsModel:self.user];
    if (ishas) {
        [self.globalHelper deleteToDB:self.user];
    }
    
    //删除多条
    BOOL isDeleteMore=[self.globalHelper deleteWithClass:[UserBean class] where:@"age=29"];
    if (isDeleteMore) {
        NSLog(@"符合条件的都被删除");
    }
}
@end