一 插件简介:
其github地址:https://github.com/li6185377/LKDBHelper-SQLite-ORM
SQL学习地址
https://www.w3school.com.cn/sql/sql_intro.asp
全面支持 NSArray,NSDictionary, ModelClass, NSNumber, NSString, NSDate, NSData, UIColor, UIImage, CGRect, CGPoint, CGSize, NSRange, int,char,float, double, long.. 等属性的自动化操作(插入和查询)
二 实例内容:
采用pods进行加载LKDBHelper插件,若有下载源代码调试时记得更新一下(平常项目中记得对libsqlite3.dylib进行引用);
wwwwww.png
本实例创建一个父实体BaseBean,后面其它实体都进行继承
1:父实体的代码内容
BaseBean.h内容:
#import
#import
@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 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
#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