首页 文章 精选 留言 我的

精选列表

搜索[ios],共10000篇文章
优秀的个人博客,低调大师

iOS开发-迭代器模式

迭代器模式(Iterator),提供一种方法顺序访问一个聚合对象中的各种元素,而又不暴露该对象的内部表示。开发过程中,我们可能需要针对不同的需求,可能需要以不同的方式来遍历整个整合对象,但是我们不希望遍历的对象内部存储结构被外部知道,那么可以将对象包装成一个迭代器,迭代器中定义中遍历对象的方法下一个,是否存在下一个对象,删除等遍历需要的统一接口,迭代器在Java和.NET使用的比较多,自定义实现叶非常简单,可以简单的看一下迭代器模式的UML类图。 迭代器定义基本的遍历操作方法,容器定义公共的创建迭代器的方法,子类负责实现具体需要引用的迭代器,我们可以假设图书馆是一个抽象容器,图书馆下面分为国家图书馆和个人图书馆,个人图书馆存储书籍的方式是可变数组存储书籍,国家图书馆数据存储书籍,分别创建不同的迭代器; BookLibrary容器接口: 1 2 3 4 5 6 7 8 9 10 @protocol BoolLibraryProtocol<NSObject> @optional -(Iterator *)createIterator; @end @ interface BookLibrary : NSObject<BoolLibraryProtocol> @end CountryBookLibrary国家图书馆: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 @ interface CountryBookLibrary() @property (strong,nonatomic) NSArray *bookArr; @end @implementation CountryBookLibrary - (instancetype)init { self = [super init]; if (self) { Book *one=[self addBook: @"CountryBookLibrary" price:10]; Book *next=[self addBook: @"博客园-FlyElephant" price:20]; self.bookArr=@[one,next]; } return self; } -(Iterator *)createIterator{ return [[CountryIterator alloc]initWithData:self.bookArr]; } -(Book *)addBook:(NSString *)bookName price:( float )price{ Book *book=[[Book alloc]init]; book.bookName=bookName; book.price=price; return book; } @end PersonLibraryBook个人图书馆: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 @ interface PersonBookLibray() @property (strong,nonatomic) NSMutableArray *books; @end @implementation PersonBookLibray - (instancetype)init { self = [super init]; if (self) { [self addBook: @"PersonIterator" price:100]; [self addBook: @"博客园-FlyElephant" price:200]; } return self; } -(Iterator *)createIterator{ return [[PersonIterator alloc]initWithData:self.books]; } -( void )addBook:(NSString *)bookName price:( float )price{ Book *book=[[Book alloc]init]; book.bookName=bookName; book.price=price; [self.books addObject:book]; } #pragma mark - getter and setter -(NSMutableArray *)books{ if (!_books) { _books=[[NSMutableArray alloc]init]; } return _books; } @end 迭代器Iterator: 1 2 3 4 5 6 7 8 9 10 11 12 13 @protocol IteratorProtocol <NSObject> @optional -(Boolean)hasNext; @optional -(id)next; @end @ interface Iterator : NSObject<IteratorProtocol> @end 国家图书馆引用的迭代器: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 @ interface CountryIterator() @property (strong,nonatomic) NSArray *arr; @property (assign,nonatomic) NSInteger position; @end @implementation CountryIterator -(instancetype)initWithData:(NSArray *)data{ self=[super init]; if (self) { self.arr=data; } return self; } -(Boolean)hasNext{ if (self.position>=[self.arr count]||!self.arr[self.position]) { return false ; } else { return true ; } } -(id)next{ Book *book=self.arr[self.position]; self.position+=1; return book; } @end 个人图书馆引用的迭代器: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 @ interface PersonIterator() @property (assign,nonatomic) NSInteger position; @property (strong,nonatomic) NSMutableArray *mutableArr; @end @implementation PersonIterator -(instancetype)initWithData:(NSMutableArray *)data{ self=[super init]; if (self) { self.mutableArr=data; } return self; } -(Boolean)hasNext{ if (self.position>=[self.mutableArr count]||![self.mutableArr objectAtIndex:self.position]) { return false ; } else { return true ; } } -(id)next{ Book *book=[self.mutableArr objectAtIndex:self.position]; self.position+=1; return book; } @end 实际调用: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 -( void )iteratorDesign{ BookLibrary *personLibrary=[[PersonBookLibray alloc]init]; Iterator *personIterator=[personLibrary createIterator]; [self logLibraryInfo:personIterator]; BookLibrary *countryLibrary=[[CountryBookLibrary alloc]init]; Iterator *countryIterator=[countryLibrary createIterator]; [self logLibraryInfo:countryIterator]; } -( void )logLibraryInfo:(Iterator *)iterator{ while ([iterator hasNext]) { Book *book=[iterator next]; NSLog( @"书名:%@--价格:%ld" ,book.bookName,book.price); } } 测试结果: 迭代器模式的优点:支持以不同的方式遍历一个聚合对象(不同的聚合对象不同的遍历方式),迭代器简化了聚合类(统一接口),在迭代器模式中,增加新的聚合类和迭代器类都很方便,无须修改原有代码(假设新增字典迭代器,直接添加就行,符合对扩展开放,对修改关闭的原则0) 缺点: 迭代器模式将存储数据和遍历数据的职责分离,增加新的聚合类需要对应增加新的迭代器类,类的个数成对增加,这在一定程度上增加了系统的复杂性。不过集合类型总共就几种,基本上系统使用没有问题,个人使用的需注意一下; 本文转自Fly_Elephant博客园博客,原文链接:http://www.cnblogs.com/xiaofeixiang/p/5132559.html,如需转载请自行联系原作者

优秀的个人博客,低调大师

iOS开发-模板方法模式

模板方法模式定义一个操作中的算法的骨架,而将步骤延迟到子类中。模板方法使得子类可以不改变一个算法的结构即可重定义算法的某些特定步骤。模板方法模式是由子类决定实现算法中的步骤,工厂方法由子类决定实现哪一个具体的类,策略模式是封装可以互换的行为,使用委托决定采用哪一个行为,有的时候这三种容易出现理解上的偏差。 基础知识 模板方法的UML类图: 关于模板方法我们思考一个生活中的例子,我们都会网购,天猫或者京东,经历一下四个步骤,①访问网站②浏览下单③支付④收货,两种网站第二步和最后一步都是一样的,访问和支付的访问不一样,两个网站网址不一样,支付方式不一样~稍微思考一下可以怎么实现~ 实战探讨 关于上面的需要设计三个类,网购类,天猫类,京东类: OnLineShop: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 @protocol OnLineShopProtocol @optional -( void )accessURL; @optional -( void )pay; @end @ interface OnLineShop : NSObject<OnLineShopProtocol> -( void )shop; -(Boolean)callMyMobileHook; @end 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 @ interface OnLineShop() -( void )createOrder; -( void )receiptGoods; @end @implementation OnLineShop -( void )shop{ [self accessURL]; [self createOrder]; [self pay]; if ([self callMyMobileHook]) { [self receiptGoods]; } } -( void )createOrder{ NSLog( @"创建订单成功" ); } -( void )receiptGoods{ NSLog( @"收到了物品" ); } //子类可以回调钩子 -(Boolean)callMyMobileHook{ return true ; } @end Tmall类继承自OnLineShop: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 @implementation Tmall -( void )accessURL{ NSLog( @"https://www.taobao.com/" ); } -( void )pay{ NSLog( @"支付宝" ); } -(Boolean)callMyMobileHook{ return true ; } @end JDong类: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 @implementation JDong -( void )accessURL{ NSLog( @"http://www.jd.com/" ); } -( void )pay{ NSLog( @"货到付款" ); } -(Boolean)callMyMobileHook{ NSLog( @"博客园-FlyElephant" ); return false ; } @end 代码测试: 1 2 3 4 OnLineShop *tmall=[[Tmall alloc]init]; [tmall shop]; OnLineShop *jd=[[JDong alloc]init]; [jd shop]; 测试结果: 模板方法优点: ①模板方法模式通过把不变的行为搬移到超类,去除了子类中的重复代码。 ②子类实现算法的某些细节,有助于算法的扩展。通过一个父类调用子类实现的操作, ③通过子类扩展增加新的行为,符合“开放-封闭原则”。 缺点 ①每个不同的实现都需要定义一个子类,这会导致类的个数的增加,设计更加抽象。 适用于在某些类的算法中,用了相同的方法,造成代码的重复。控制子类扩展,子类必须遵守算法规则。 模板方式中涉及到一个原则是好莱坞原则,别调用我们,我们会调用你~理解起来就是高层组件可以调用底层组件,底层组件不要调用高层组件~ 本文转自Fly_Elephant博客园博客,原文链接:http://www.cnblogs.com/xiaofeixiang/p/5126158.html,如需转载请自行联系原作者

优秀的个人博客,低调大师

iOS开发-UITableView滑动视差

视差滚动是指让多层背景以不同的速度移动,形成立体的运动效果,在Web上应用的比较多,App中倒是见的相对比较少,主要在UITableView中的应用的比较多,尤其是当整个UITableViewCell的背景是图片的时候,描述内容较少,滑动视差可以增强视觉效果,可以考虑使用,先来简单的看一下效果: 实现起来也比较简单,UITableView定义: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 #pragma mark - UITablViewDataSource -(NSInteger)numberOfSectionsInTableView:(UITableView *)tableView{ return 1; } -(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section{ return [self.dataSource count]; } -(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{ MainTableViewCell *mainCell=[tableView dequeueReusableCellWithIdentifier:CELLIDENTIFIER forIndexPath:indexPath]; NSString *desc=[NSString stringWithFormat: @"FlyElephant-%ld" ,indexPath.row]; [mainCell setBackImage:self.dataSource[indexPath.row] description:desc]; return mainCell; } #pragma mark - UITableViewDelegate -(CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath{ return 150; } 滑动的时候修改单元格偏移量: 1 2 3 4 5 6 7 8 9 10 #pragma mark - UIScrollViewDelegate -( void )scrollViewDidScroll:(UIScrollView *)scrollView{ CGPoint offset=self.tableView.contentOffset; for (MainTableViewCell *cell in self.tableView.visibleCells) { //方式1 // [cell setImagOffset:offset tableView:self.tableView]; //方式2 [cell setAdjustOffset:(cell.frame.origin.y-offset.y)]; } } MainTableViewCell定义: 1 2 3 4 5 6 7 8 9 10 11 @ interface MainTableViewCell : UITableViewCell -( void )setBackImage:(NSString *)imageName description:(NSString *)desc; //视差滑动方式1 -( void )setImagOffset:(CGPoint)contentOffset tableView:(UITableView *)tablView; //视差滑动方式2 -( void )setAdjustOffset:(CGFloat)offset; @end 滑动视差调用方式: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 -( void )setImagOffset:(CGPoint)contentOffset tableView:(UITableView *)tablView{ //偏移量 CGFloat cellOffset = self.frame.origin.y - contentOffset.y; // 偏移量+单元格高度/tableview高度+单元格高度 CGFloat percent = (cellOffset+self.frame.size.height)/(tablView.frame.size.height+self.frame.size.height); //偏移比例(0-1) CGFloat extraHeight = self.frame.size.height*OFFSET_RATE; CGRect frame=self.backImageView.frame; frame.origin.y=extraHeight*percent; self.backImageView.frame=frame; } -( void )setAdjustOffset:(CGFloat)offset{ CGRect frame = self.backImageView.frame; frame.origin.y = (offset / 15.0); self.backImageView.frame = frame; } 实现起来比较简单,网上有各种各样的版本,这两种的方式算是最简单的实现~ 本文转自Fly_Elephant博客园博客,原文链接:http://www.cnblogs.com/xiaofeixiang/p/5152828.html,如需转载请自行联系原作者

优秀的个人博客,低调大师

iOS开发-UINavigationBar透明设置

导航条最近需要设置成透明的形式,最开始想通过颜色clearColor设置,设置透明度,结果发现UINavigationItem无法显示显示,后来通过setBackgroundImage设置成功,不过会多出一条线白线,需要通过setShadowImage设置背景图片,代码如下: 1 2 3 4 5 -( void )viewWillAppear:( BOOL )animated{ [ super viewWillAppear:animated]; [ self .navigationController.navigationBar setBackgroundImage:[UIImage new ] forBarMetrics:UIBarMetricsDefault]; [ self .navigationController.navigationBar setShadowImage:[UIImage new ]]; } 如果不想影响其他页面的导航透明度,viewWillDisappear将其设置为nil即可: 1 2 3 4 5 6 -( void )viewWillDisappear:( BOOL )animated{ //原文地址:http://www.cnblogs.com/xiaofeixiang [ super viewWillDisappear:animated]; [ self .navigationController.navigationBar setBackgroundImage: nil forBarMetrics:UIBarMetricsDefault]; [ self .navigationController.navigationBar setShadowImage: nil ]; } 本文转自Fly_Elephant博客园博客,原文链接:http://www.cnblogs.com/xiaofeixiang/p/4624928.html,如需转载请自行联系原作者

优秀的个人博客,低调大师

iOS:转载sqlite3

SQLITE3 使用总结2012-08-21 13:48:28 分类:SQLite/嵌入式数据库 SQLITE3 使用总结 2009-09-16 07:362624人阅读 评论(10) 收藏 举报 前序: Sqlite3的确很好用。小巧、速度快。但是因为非微软的产品,帮助文档总觉得不够。这些天再次研究它,又有一些收获,这里把我对sqlite3的研究列出来,以备忘记。 这里要注明,我是一个跨平台专注者,并不喜欢只用windows平台。我以前的工作就是为unix平台写代码。下面我所写的东西,虽然没有验证,但是我已尽量不使用任何windows的东西,只使用标准C或标准C++。但是,我没有尝试过在别的系统、别的编译器下编译,因此下面的叙述如果不正确,则留待以后修改。 下面我的代码仍然用VC编写,因为我觉得VC是一个很不错的IDE,可以加快代码编写速度(例如配合Vassist)。下面我所说的编译环境,是VC2003。如果读者觉得自己习惯于unix下用vi编写代码速度较快,可以不用管我的说明,只需要符合自己习惯即可,因为我用的是标准C或C++。不会给任何人带来不便。 一、版本 从www.sqlite.org网站可下载到最新的sqlite代码和编译版本。我写此文章时,最新代码是3.3.17版本。 很久没有去下载sqlite新代码,因此也不知道sqlite变化这么大。以前很多文件,现在全部合并成一个sqlite3.c文件。如果单独用此文件,是挺好的,省去拷贝一堆文件还担心有没有遗漏。但是也带来一个问题:此文件太大,快接近7万行代码,VC开它整个机器都慢下来了。如果不需要改它代码,也就不需要打开sqlite3.c文件,机器不会慢。但是,下面我要写通过修改sqlite代码完成加密功能,那时候就比较痛苦了。如果个人水平较高,建议用些简单的编辑器来编辑,例如UltraEdit或Notepad。速度会快很多。 二、基本编译 这个不想多说了,在VC里新建dos控制台空白工程,把sqlite3.c和sqlite3.h添加到工程,再新建一个main.cpp文件。在里面写: extern"C" { #include"./sqlite3.h" }; int main( int , char** ) { return0; } 为什么要extern “C”?如果问这个问题,我不想说太多,这是C++的基础。要在C++里使用一段C的代码,必须要用extern “C”括起来。C++跟C虽然语法上有重叠,但是它们是两个不同的东西,内存里的布局是完全不同的,在C++编译器里不用extern “C”括起C代码,会导致编译器不知道该如何为C代码描述内存布局。 可能在sqlite3.c里人家已经把整段代码都extern “C”括起来了,但是你遇到一个.c文件就自觉的再括一次,也没什么不好。 基本工程就这样建立起来了。编译,可以通过。但是有一堆的warning。可以不管它。 三、SQLITE操作入门 sqlite提供的是一些C函数接口,你可以用这些函数操作数据库。通过使用这些接口,传递一些标准sql语句(以char *类型)给sqlite函数,sqlite就会为你操作数据库。 sqlite跟MS的access一样是文件型数据库,就是说,一个数据库就是一个文件,此数据库里可以建立很多的表,可以建立索引、触发器等等,但是,它实际上得到的就是一个文件。备份这个文件就备份了整个数据库。 sqlite不需要任何数据库引擎,这意味着如果你需要sqlite来保存一些用户数据,甚至都不需要安装数据库(如果你做个小软件还要求人家必须装了sqlserver才能运行,那也太黑心了)。 下面开始介绍数据库基本操作。 1基本流程(1)关键数据结构 sqlite里最常用到的是sqlite3 *类型。从数据库打开开始,sqlite就要为这个类型准备好内存,直到数据库关闭,整个过程都需要用到这个类型。当数据库打开时开始,这个类型的变量就代表了你要操作的数据库。下面再详细介绍。 (2)打开数据库 intsqlite3_open(文件名, sqlite3 ** ); 用这个函数开始数据库操作。 需要传入两个参数,一是数据库文件名,比如:c://DongChunGuang_Database.db。 文件名不需要一定存在,如果此文件不存在,sqlite会自动建立它。如果它存在,就尝试把它当数据库文件来打开。 sqlite3 **参数即前面提到的关键数据结构。这个结构底层细节如何,你不要关它。 函数返回值表示操作是否正确,如果是SQLITE_OK则表示操作正常。相关的返回值sqlite定义了一些宏。具体这些宏的含义可以参考sqlite3.h文件。里面有详细定义(顺便说一下,sqlite3的代码注释率自称是非常高的,实际上也的确很高。只要你会看英文,sqlite可以让你学到不少东西)。 下面介绍关闭数据库后,再给一段参考代码。 (3)关闭数据库 intsqlite3_close(sqlite3 *); 前面如果用sqlite3_open开启了一个数据库,结尾时不要忘了用这个函数关闭数据库。 下面给段简单的代码: extern"C" { #include"./sqlite3.h" }; int main( int , char** ) { sqlite3 * db = NULL;//声明sqlite关键结构指针 int result; //打开数据库 //需要传入db这个指针的指针,因为sqlite3_open函数要为这个指针分配内存,还要让db指针指向这个内存区 result = sqlite3_open(“c://Dcg_database.db”, &db ); if( result !=SQLITE_OK) { //数据库打开失败 return -1; } //数据库操作代码 //… //数据库打开成功 //关闭数据库 sqlite3_close( db ); return0; } 这就是一次数据库操作过程。 2 SQL语句操作 本节介绍如何用sqlite执行标准sql语法。 (1)执行sql语句 intsqlite3_exec(sqlite3*,constchar*sql, sqlite3_callback,void*,char**errmsg ); 这就是执行一条sql语句的函数。 第1个参数不再说了,是前面open函数得到的指针。说了是关键数据结构。 第2个参数const char *sql是一条sql语句,以/0结尾。 第3个参数sqlite3_callback是回调,当这条语句执行之后,sqlite3会去调用你提供的这个函数。(什么是回调函数,自己找别的资料学习) 第4个参数void *是你所提供的指针,你可以传递任何一个指针参数到这里,这个参数最终会传到回调函数里面,如果不需要传递指针给回调函数,可以填NULL。等下我们再看回调函数的写法,以及这个参数的使用。 第5个参数char ** errmsg是错误信息。注意是指针的指针。sqlite3里面有很多固定的错误信息。执行sqlite3_exec之后,执行失败时可以查阅这个指针(直接printf(“%s/n”,errmsg))得到一串字符串信息,这串信息告诉你错在什么地方。sqlite3_exec函数通过修改你传入的指针的指针,把你提供的指针指向错误提示信息,这样sqlite3_exec函数外面就可以通过这个char*得到具体错误提示。 说明:通常,sqlite3_callback和它后面的void *这两个位置都可以填NULL。填NULL表示你不需要回调。比如你做insert操作,做delete操作,就没有必要使用回调。而当你做select时,就要使用回调,因为sqlite3把数据查出来,得通过回调告诉你查出了什么数据。 (2)exec的回调 typedefint(*sqlite3_callback)(void*,int,char**,char**); 你的回调函数必须定义成上面这个函数的类型。下面给个简单的例子: //sqlite3的回调函数 // sqlite每查到一条记录,就调用一次这个回调 intLoadMyInfo(void* para,intn_column,char** column_value,char** column_name ) { //para是你在sqlite3_exec里传入的void *参数 //通过para参数,你可以传入一些特殊的指针(比如类指针、结构指针),然后在这里面强制转换成对应的类型(这里面是void*类型,必须强制转换成你的类型才可用)。然后操作这些数据 //n_column是这一条记录有多少个字段(即这条记录有多少列) // char ** column_value是个关键值,查出来的数据都保存在这里,它实际上是个1维数组(不要以为是2维数组),每一个元素都是一个char *值,是一个字段内容(用字符串来表示,以/0结尾) //char ** column_name跟column_value是对应的,表示这个字段的字段名称 //这里,我不使用para参数。忽略它的存在. int i; printf(“记录包含%d个字段/n”, n_column ); for( i = 0 ; i < n_column; i ++ ) { printf(“字段名:%sß>字段值:%s/n”,column_name[i], column_value[i] ); } printf(“------------------/n“); return 0; } int main( int , char ** ) { sqlite3 * db; int result; char * errmsg = NULL; result = sqlite3_open(“c://Dcg_database.db”, &db ); if( result !=SQLITE_OK) { //数据库打开失败 return -1; } //数据库操作代码 //创建一个测试表,表名叫MyTable_1,有2个字段:ID和name。其中ID是一个自动增加的类型,以后insert时可以不去指定这个字段,它会自己从0开始增加 result = sqlite3_exec( db,“create table MyTable_1( ID integer primary key autoincrement, name nvarchar(32) )”, NULL, NULL, errmsg ); if(result !=SQLITE_OK) { printf(“创建表失败,错误码:%d,错误原因:%s/n”, result, errmsg ); } //插入一些记录 result = sqlite3_exec( db,“insert into MyTable_1( name ) values (‘走路’)”, 0, 0, errmsg ); if(result !=SQLITE_OK) { printf(“插入记录失败,错误码:%d,错误原因:%s/n”, result, errmsg ); } result = sqlite3_exec( db,“insert into MyTable_1( name ) values (‘骑单车’)”, 0, 0, errmsg ); if(result !=SQLITE_OK) { printf(“插入记录失败,错误码:%d,错误原因:%s/n”, result, errmsg ); } result = sqlite3_exec( db,“insert into MyTable_1( name ) values (‘坐汽车’)”, 0, 0, errmsg ); if(result !=SQLITE_OK) { printf(“插入记录失败,错误码:%d,错误原因:%s/n”, result, errmsg ); } //开始查询数据库 result = sqlite3_exec( db,“select * from MyTable_1”, LoadMyInfo, NULL, errmsg ); //关闭数据库 sqlite3_close( db ); return0; } 通过上面的例子,应该可以知道如何打开一个数据库,如何做数据库基本操作。 有这些知识,基本上可以应付很多数据库操作了。 (3)不使用回调查询数据库 上面介绍的sqlite3_exec是使用回调来执行select操作。还有一个方法可以直接查询而不需要回调。但是,我个人感觉还是回调好,因为代码可以更加整齐,只不过用回调很麻烦,你得声明一个函数,如果这个函数是类成员函数,你还不得不把它声明成static的(要问为什么?这又是C++基础了。C++成员函数实际上隐藏了一个参数:this,C++调用类的成员函数的时候,隐含把类指针当成函数的第一个参数传递进去。结果,这造成跟前面说的sqlite回调函数的参数不相符。只有当把成员函数声明成static时,它才没有多余的隐含的this参数)。 虽然回调显得代码整齐,但有时候你还是想要非回调的select查询。这可以通过sqlite3_get_table函数做到。 intsqlite3_get_table(sqlite3*,constchar*sql,char***resultp,int*nrow,int*ncolumn,char**errmsg ); 第1个参数不再多说,看前面的例子。 第2个参数是sql语句,跟sqlite3_exec里的sql是一样的。是一个很普通的以/0结尾的char *字符串。 第3个参数是查询结果,它依然一维数组(不要以为是二维数组,更不要以为是三维数组)。它内存布局是:第一行是字段名称,后面是紧接着是每个字段的值。下面用例子来说事。 第4个参数是查询出多少条记录(即查出多少行)。 第5个参数是多少个字段(多少列)。 第6个参数是错误信息,跟前面一样,这里不多说了。 下面给个简单例子: int main( int , char ** ) { sqlite3 * db; int result; char * errmsg = NULL; char **dbResult;//是char **类型,两个*号 int nRow, nColumn; int i , j; int index; result =sqlite3_open(“c://Dcg_database.db”, &db ); if( result !=SQLITE_OK) { //数据库打开失败 return -1; } //数据库操作代码 //假设前面已经创建了MyTable_1表 //开始查询,传入的dbResult已经是char **,这里又加了一个&取地址符,传递进去的就成了char *** result =sqlite3_get_table( db,“select * from MyTable_1”, &dbResult, &nRow, &nColumn, &errmsg ); if(SQLITE_OK== result ) { //查询成功 index = nColumn;//前面说过dbResult前面第一行数据是字段名称,从nColumn索引开始才是真正的数据 printf(“查到%d条记录/n”, nRow ); for(i = 0; i < nRow ; i++ ) { printf(“第%d条记录/n”, i+1 ); for( j = 0 ; j < nColumn; j++ ) { printf(“字段名:%sß>字段值:%s/n”,dbResult[j], dbResult [index] ); ++index;// dbResult的字段值是连续的,从第0索引到第nColumn - 1索引都是字段名称,从第nColumn索引开始,后面都是字段值,它把一个二维的表(传统的行列表示法)用一个扁平的形式来表示 } printf(“-------/n”); } } //到这里,不论数据库查询是否成功,都释放char**查询结果,使用sqlite提供的功能来释放 sqlite3_free_table( dbResult ); //关闭数据库 sqlite3_close( db ); return0; } 到这个例子为止,sqlite3的常用用法都介绍完了。 用以上的方法,再配上sql语句,完全可以应付绝大多数数据库需求。 但有一种情况,用上面方法是无法实现的:需要insert、select二进制。当需要处理二进制数据时,上面的方法就没办法做到。下面这一节说明如何插入二进制数据 3操作二进制 sqlite操作二进制数据需要用一个辅助的数据类型:sqlite3_stmt *。 这个数据类型记录了一个“sql语句”。为什么我把“sql语句”用双引号引起来?因为你可以把sqlite3_stmt *所表示的内容看成是sql语句,但是实际上它不是我们所熟知的sql语句。它是一个已经把sql语句解析了的、用sqlite自己标记记录的内部数据结构。 正因为这个结构已经被解析了,所以你可以往这个语句里插入二进制数据。当然,把二进制数据插到sqlite3_stmt结构里可不能直接memcpy,也不能像std::string那样用+号。必须用sqlite提供的函数来插入。 (1)写入二进制 下面说写二进制的步骤。 要插入二进制,前提是这个表的字段的类型是blob类型。我假设有这么一张表: create table Tbl_2( ID integer, file_contentblob ) 首先声明 sqlite3_stmt* stat; 然后,把一个sql语句解析到stat结构里去: sqlite3_prepare( db,“insert into Tbl_2( ID, file_content) values( 10, ? )”, -1, &stat, 0 ); 上面的函数完成sql语句的解析。第一个参数跟前面一样,是个sqlite3 *类型变量,第二个参数是一个sql语句。 这个sql语句特别之处在于values里面有个?号。在sqlite3_prepare函数里,?号表示一个未定的值,它的值等下才插入。 第三个参数我写的是-1,这个参数含义是前面sql语句的长度。如果小于0,sqlite会自动计算它的长度(把sql语句当成以/0结尾的字符串)。 第四个参数是sqlite3_stmt的指针的指针。解析以后的sql语句就放在这个结构里。 第五个参数我也不知道是干什么的。为0就可以了。 如果这个函数执行成功(返回值是SQLITE_OK且stat不为NULL),那么下面就可以开始插入二进制数据。 sqlite3_bind_blob( stat, 1, pdata, (int)(length_of_data_in_bytes), NULL );//pdata为数据缓冲区,length_of_data_in_bytes为数据大小,以字节为单位 这个函数一共有5个参数。 第1个参数:是前面prepare得到的sqlite3_stmt *类型变量。 第2个参数:?号的索引。前面prepare的sql语句里有一个?号,假如有多个?号怎么插入?方法就是改变bind_blob函数第2个参数。这个参数我写1,表示这里插入的值要替换stat的第一个?号(这里的索引从1开始计数,而非从0开始)。如果你有多个?号,就写多个bind_blob语句,并改变它们的第2个参数就替换到不同的?号。如果有?号没有替换,sqlite为它取值null。 第3个参数:二进制数据起始指针。 第4个参数:二进制数据的长度,以字节为单位。 第5个参数:是个析够回调函数,告诉sqlite当把数据处理完后调用此函数来析够你的数据。这个参数我还没有使用过,因此理解也不深刻。但是一般都填NULL,需要释放的内存自己用代码来释放。 bind完了之后,二进制数据就进入了你的“sql语句”里了。你现在可以把它保存到数据库里: int result =sqlite3_step( stat ); 通过这个语句,stat表示的sql语句就被写到了数据库里。 最后,要把sqlite3_stmt结构给释放: sqlite3_finalize( stat );//把刚才分配的内容析构掉 (2)读出二进制 下面说读二进制的步骤。 跟前面一样,先声明sqlite3_stmt *类型变量: sqlite3_stmt* stat; 然后,把一个sql语句解析到stat结构里去: sqlite3_prepare( db,“select * from Tbl_2”, -1, &stat, 0 ); 当prepare成功之后(返回值是SQLITE_OK),开始查询数据。 int result =sqlite3_step( stat ); 这一句的返回值是SQLITE_ROW时表示成功(不是SQLITE_OK)。 你可以循环执行sqlite3_step函数,一次step查询出一条记录。直到返回值不为SQLITE_ROW时表示查询结束。 然后开始获取第一个字段:ID的值。ID是个整数,用下面这个语句获取它的值: int id = sqlite3_column_int( stat, 0 );//第2个参数表示获取第几个字段内容,从0开始计算,因为我的表的ID字段是第一个字段,因此这里我填0 下面开始获取file_content的值,因为file_content是二进制,因此我需要得到它的指针,还有它的长度: const void * pFileContent =sqlite3_column_blob( stat, 1 ); int len =sqlite3_column_bytes( stat, 1 ); 这样就得到了二进制的值。 把pFileContent的内容保存出来之后,不要忘了释放sqlite3_stmt结构: sqlite3_finalize( stat );//把刚才分配的内容析构掉 (3)重复使用sqlite3_stmt结构 如果你需要重复使用sqlite3_prepare解析好的sqlite3_stmt结构,需要用函数:sqlite3_reset。 result =sqlite3_reset(stat); 这样,stat结构又成为sqlite3_prepare完成时的状态,你可以重新为它bind内容。 4事务处理 sqlite是支持事务处理的。如果你知道你要同步删除很多数据,不仿把它们做成一个统一的事务。 通常一次sqlite3_exec就是一次事务,如果你要删除1万条数据,sqlite就做了1万次:开始新事务->删除一条数据->提交事务->开始新事务->…的过程。这个操作是很慢的。因为时间都花在了开始事务、提交事务上。 你可以把这些同类操作做成一个事务,这样如果操作错误,还能够回滚事务。 事务的操作没有特别的接口函数,它就是一个普通的sql语句而已: 分别如下: int result; result= sqlite3_exec( db, "begin transaction", 0, 0, &zErrorMsg ); //开始一个事务 result= sqlite3_exec( db, "commit transaction", 0, 0, &zErrorMsg ); //提交事务 result= sqlite3_exec( db, "rollback transaction", 0, 0, &zErrorMsg ); //回滚事务 四、C/C++开发接口简介1总览 SQLite3是SQLite一个全新的版本,它虽然是在SQLite 2.8.13的代码基础之上开发的,但是使用了和之前的版本不兼容的数据库格式和API. SQLite3是为了满足以下的需求而开发的: 支持UTF-16编码. 用户自定义的文本排序方法. 可以对BLOBs字段建立索引. 因此为了支持这些特性我改变了数据库的格式,建立了一个与之前版本不兼容的3.0版.至于其他的兼容性的改变,例如全新的API等等,都将在理论介绍之后向你说明,这样可以使你最快的一次性摆脱兼容性问题. 3.0版的和2.X版的API非常相似,但是有一些重要的改变需要注意.所有API接口函数和数据结构的前缀都由"sqlite_"改为了"sqlite3_".这是为了避免同时使用SQLite 2.X和SQLite 3.0这两个版本的时候发生链接冲突. 由于对于C语言应该用什么数据类型来存放UTF-16编码的字符串并没有一致的规范.因此SQLite使用了普通的void*类型来指向UTF-16编码的字符串.客户端使用过程中可以把void*映射成适合他们的系统的任何数据类型. 2 C/C++接口 SQLite 3.0一共有83个API函数,此外还有一些数据结构和预定义(#defines). (完整的API介绍请参看另一份文档.)不过你们可以放心,这些接口使用起来不会像它的数量所暗示的那么复杂.最简单的程序仍然使用三个函数就可以完成: sqlite3_open(), sqlite3_exec(),和sqlite3_close().要是想更好的控制数据库引擎的执行,可以使用提供的sqlite3_prepare()函数把SQL语句编译成字节码,然后在使用sqlite3_step()函数来执行编译后的字节码.以sqlite3_column_开头的一组API函数用来获取查询结果集中的信息.许多接口函数都是成对出现的,同时有UTF-8和UTF-16两个版本.并且提供了一组函数用来执行用户自定义的SQL函数和文本排序函数. (1)如何打开关闭数据库 typedef struct sqlite3 sqlite3; int sqlite3_open(const char*, sqlite3**); int sqlite3_open16(const void*, sqlite3**); int sqlite3_close(sqlite3*); const char *sqlite3_errmsg(sqlite3*); const void *sqlite3_errmsg16(sqlite3*); int sqlite3_errcode(sqlite3*); sqlite3_open()函数返回一个整数错误代码,而不是像第二版中一样返回一个指向sqlite3结构体的指针. sqlite3_open()和sqlite3_open16()的不同之处在于sqlite3_open16()使用UTF-16编码(使用本地主机字节顺序)传递数据库文件名.如果要创建新数据库, sqlite3_open16()将内部文本转换为UTF-16编码,反之sqlite3_open()将文本转换为UTF-8编码. 打开或者创建数据库的命令会被缓存,直到这个数据库真正被调用的时候才会被执行.而且允许使用PRAGMA声明来设置如本地文本编码或默认内存页面大小等选项和参数. sqlite3_errcode()通常用来获取最近调用的API接口返回的错误代码. sqlite3_errmsg()则用来得到这些错误代码所对应的文字说明.这些错误信息将以UTF-8的编码返回,并且在下一次调用任何SQLite API函数的时候被清除. sqlite3_errmsg16()和sqlite3_errmsg()大体上相同,除了返回的错误信息将以UTF-16本机字节顺序编码. SQLite3的错误代码相比SQLite2没有任何的改变,它们分别是: #define SQLITE_OK0/* Successful result */ #define SQLITE_ERROR1/* SQL error or missing database */ #define SQLITE_INTERNAL2/* An internal logic error in SQLite */ #define SQLITE_PERM3/* Access permission denied */ #define SQLITE_ABORT4/* Callback routine requested an abort */ #define SQLITE_BUSY5/* The database file is locked */ #define SQLITE_LOCKED6/* A table in the database is locked */ #define SQLITE_NOMEM7/* A malloc() failed */ #define SQLITE_READONLY8/* Attempt to write a readonly database */ #define SQLITE_INTERRUPT9/* Operation terminated by sqlite_interrupt() */ #define SQLITE_IOERR10/* Some kind of disk I/O error occurred */ #define SQLITE_CORRUPT11/* The database disk image is malformed */ #define SQLITE_NOTFOUND12/* (Internal Only) Table or record not found */ #define SQLITE_FULL13/* Insertion failed because database is full */ #define SQLITE_CANTOPEN14/* Unable to open the database file */ #define SQLITE_PROTOCOL15/* Database lock protocol error */ #define SQLITE_EMPTY16/* (Internal Only) Database table is empty */ #define SQLITE_SCHEMA17/* The database schema changed */ #define SQLITE_TOOBIG18/* Too much data for one row of a table */ #define SQLITE_CONSTRAINT19/* Abort due to contraint violation */ #define SQLITE_MISMATCH20/* Data type mismatch */ #define SQLITE_MISUSE21/* Library used incorrectly */ #define SQLITE_NOLFS22/* Uses OS features not supported on host */ #define SQLITE_AUTH23/* Authorization denied */ #define SQLITE_ROW100/* sqlite_step() has another row ready */ #define SQLITE_DONE101/* sqlite_step() has finished executing */ (2)执行SQL语句 typedef int (*sqlite_callback)(void*,int,char**, char**); int sqlite3_exec(sqlite3*, const char *sql, sqlite_callback, void*, char**); sqlite3_exec函数依然像它在SQLite2中一样承担着很多的工作.该函数的第二个参数中可以编译和执行零个或多个SQL语句.查询的结果返回给回调函数.更多地信息可以查看API参考. 在SQLite3里,sqlite3_exec一般是被准备SQL语句接口封装起来使用的. typedef struct sqlite3_stmt sqlite3_stmt; int sqlite3_prepare(sqlite3*, const char*, int, sqlite3_stmt**, const char**); int sqlite3_prepare16(sqlite3*, const void*, int, sqlite3_stmt**, const void**); int sqlite3_finalize(sqlite3_stmt*); int sqlite3_reset(sqlite3_stmt*); sqlite3_prepare接口把一条SQL语句编译成字节码留给后面的执行函数.使用该接口访问数据库是当前比较好的的一种方法. sqlite3_prepare()处理的SQL语句应该是UTF-8编码的.而sqlite3_prepare16()则要求是UTF-16编码的.输入的参数中只有第一个SQL语句会被编译.第四个参数则用来指向输入参数中下一个需要编译的SQL语句存放的SQLite statement对象的指针,任何时候如果调用sqlite3_finalize()将销毁一个准备好的SQL声明.在数据库关闭之前,所有准备好的声明都必须被释放销毁. sqlite3_reset()函数用来重置一个SQL声明的状态,使得它可以被再次执行. SQL声明可以包含一些型如"?"或"?nnn"或":aaa"的标记,其中"nnn"是一个整数,"aaa"是一个字符串.这些标记代表一些不确定的字符值(或者说是通配符),可以在后面用sqlite3_bind接口来填充这些值.每一个通配符都被分配了一个编号(由它在SQL声明中的位置决定,从1开始),此外也可以用"nnn"来表示"?nnn"这种情况.允许相同的通配符在同一个SQL声明中出现多次,在这种情况下所有相同的通配符都会被替换成相同的值.没有被绑定的通配符将自动取NULL值. int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*)); int sqlite3_bind_double(sqlite3_stmt*, int, double); int sqlite3_bind_int(sqlite3_stmt*, int, int); int sqlite3_bind_int64(sqlite3_stmt*, int, long long int); int sqlite3_bind_null(sqlite3_stmt*, int); int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*)); int sqlite3_bind_text16(sqlite3_stmt*, int, const void*, int n, void(*)(void*)); int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*); 以上是sqlite3_bind所包含的全部接口,它们是用来给SQL声明中的通配符赋值的.没有绑定的通配符则被认为是空值.绑定上的值不会被sqlite3_reset()函数重置.但是在调用了sqlite3_reset()之后所有的通配符都可以被重新赋值. 在SQL声明准备好之后(其中绑定的步骤是可选的),需要调用以下的方法来执行: int sqlite3_step(sqlite3_stmt*); 如果SQL返回了一个单行结果集,sqlite3_step()函数将返回SQLITE_ROW ,如果SQL语句执行成功或者正常将返回SQLITE_DONE ,否则将返回错误代码.如果不能打开数据库文件则会返回SQLITE_BUSY .如果函数的返回值是SQLITE_ROW,那么下边的这些方法可以用来获得记录集行中的数据: const void *sqlite3_column_blob(sqlite3_stmt*, int iCol); int sqlite3_column_bytes(sqlite3_stmt*, int iCol); int sqlite3_column_bytes16(sqlite3_stmt*, int iCol); int sqlite3_column_count(sqlite3_stmt*); const char *sqlite3_column_decltype(sqlite3_stmt *, int iCol); const void *sqlite3_column_decltype16(sqlite3_stmt *, int iCol); double sqlite3_column_double(sqlite3_stmt*, int iCol); int sqlite3_column_int(sqlite3_stmt*, int iCol); long long int sqlite3_column_int64(sqlite3_stmt*, int iCol); const char *sqlite3_column_name(sqlite3_stmt*, int iCol); const void *sqlite3_column_name16(sqlite3_stmt*, int iCol); const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol); const void *sqlite3_column_text16(sqlite3_stmt*, int iCol); int sqlite3_column_type(sqlite3_stmt*, int iCol); sqlite3_column_count()函数返回结果集中包含的列数. sqlite3_column_count()可以在执行了sqlite3_prepare()之后的任何时刻调用. sqlite3_data_count()除了必需要在sqlite3_step()之后调用之外,其他跟sqlite3_column_count()大同小异.如果调用sqlite3_step()返回值是SQLITE_DONE或者一个错误代码,则此时调用sqlite3_data_count()将返回0,然而sqlite3_column_count()仍然会返回结果集中包含的列数. 返回的记录集通过使用其它的几个sqlite3_column_***()函数来提取,所有的这些函数都把列的编号作为第二个参数.列编号从左到右以零起始.请注意它和之前那些从1起始的参数的不同. sqlite3_column_type()函数返回第N列的值的数据类型.具体的返回值如下: #define SQLITE_INTEGER1 #define SQLITE_FLOAT2 #define SQLITE_TEXT3 #define SQLITE_BLOB4 #define SQLITE_NULL5 sqlite3_column_decltype()则用来返回该列在CREATE TABLE语句中声明的类型.它可以用在当返回类型是空字符串的时候. sqlite3_column_name()返回第N列的字段名. sqlite3_column_bytes()用来返回UTF-8编码的BLOBs列的字节数或者TEXT字符串的字节数. sqlite3_column_bytes16()对于BLOBs列返回同样的结果,但是对于TEXT字符串则按UTF-16的编码来计算字节数. sqlite3_column_blob()返回BLOB数据. sqlite3_column_text()返回UTF-8编码的TEXT数据. sqlite3_column_text16()返回UTF-16编码的TEXT数据. sqlite3_column_int()以本地主机的整数格式返回一个整数值. sqlite3_column_int64()返回一个64位的整数.最后, sqlite3_column_double()返回浮点数. 不一定非要按照sqlite3_column_type()接口返回的数据类型来获取数据.数据类型不同时软件将自动转换. (3)用户自定义函数 可以使用以下的方法来创建用户自定义的SQL函数: typedef struct sqlite3_value sqlite3_value; int sqlite3_create_function( sqlite3 *, const char *zFunctionName, int nArg, int eTextRep, void*, void (*xFunc)(sqlite3_context*,int,sqlite3_value**), void (*xStep)(sqlite3_context*,int,sqlite3_value**), void (*xFinal)(sqlite3_context*) ); int sqlite3_create_function16( sqlite3*, const void *zFunctionName, int nArg, int eTextRep, void*, void (*xFunc)(sqlite3_context*,int,sqlite3_value**), void (*xStep)(sqlite3_context*,int,sqlite3_value**), void (*xFinal)(sqlite3_context*) ); #define SQLITE_UTF81 #define SQLITE_UTF162 #define SQLITE_UTF16BE3 #define SQLITE_UTF16LE4 #define SQLITE_ANY5 nArg参数用来表明自定义函数的参数个数.如果参数值为0,则表示接受任意个数的参数.用eTextRep参数来表明传入参数的编码形式.参数值可以是上面的五种预定义值. SQLite3允许同一个自定义函数有多种不同的编码参数的版本.数据库引擎会自动选择转换参数编码个数最少的版本使用. 普通的函数只需要设置xFunc参数,而把xStep和xFinal设为NULL.聚合函数则需要设置xStep和xFinal参数,然后把xFunc设为NULL.该方法和使用sqlite3_create_aggregate() API一样. sqlite3_create_function16()和sqlite_create_function()的不同就在于自定义的函数名一个要求是UTF-16编码,而另一个则要求是UTF-8. 请注意自定函数的参数目前使用了sqlite3_value结构体指针替代了SQLite version 2.X中的字符串指针.下面的函数用来从sqlite3_value结构体中提取数据: constvoid*sqlite3_value_blob(sqlite3_value*); int sqlite3_value_bytes(sqlite3_value*); int sqlite3_value_bytes16(sqlite3_value*); double sqlite3_value_double(sqlite3_value*); int sqlite3_value_int(sqlite3_value*); long long int sqlite3_value_int64(sqlite3_value*); const unsigned char *sqlite3_value_text(sqlite3_value*); const void *sqlite3_value_text16(sqlite3_value*); int sqlite3_value_type(sqlite3_value*); 上面的函数调用以下的API来获得上下文内容和返回结果: void *sqlite3_aggregate_context(sqlite3_context*, int nbyte); void *sqlite3_user_data(sqlite3_context*); void sqlite3_result_blob(sqlite3_context*, const void*, int n, void(*)(void*)); void qlite3_result_double(sqlite3_context*, double); void sqlite3_result_error(sqlite3_context*, const char*, int); void sqlite3_result_error16(sqlite3_context*, const void*, int); void sqlite3_result_int(sqlite3_context*, int); void sqlite3_result_int64(sqlite3_context*, long long int); void sqlite3_result_null(sqlite3_context*); void sqlite3_result_text(sqlite3_context*, const char*, int n, void(*)(void*)); void sqlite3_result_text16(sqlite3_context*, const void*, int n, void(*)(void*)); void sqlite3_result_value(sqlite3_context*, sqlite3_value*); void *sqlite3_get_auxdata(sqlite3_context*, int); void sqlite3_set_auxdata(sqlite3_context*, int, void*, void (*)(void*)); (4)用户自定义排序规则 下面的函数用来实现用户自定义的排序规则: sqlite3_create_collation(sqlite3*, const char *zName, int eTextRep, void*, int(*xCompare)(void*,int,const void*,int,const void*)); sqlite3_create_collation16(sqlite3*, const void *zName, int eTextRep, void*, int(*xCompare)(void*,int,const void*,int,const void*)); sqlite3_collation_needed(sqlite3*, void*, void(*)(void*,sqlite3*,int eTextRep,const char*)); sqlite3_collation_needed16(sqlite3*, void*, void(*)(void*,sqlite3*,int eTextRep,const void*)); sqlite3_create_collation()函数用来声明一个排序序列和实现它的比较函数.比较函数只能用来做文本的比较. eTextRep参数可以取如下的预定义值SQLITE_UTF8, SQLITE_UTF16LE, SQLITE_UTF16BE, SQLITE_ANY,用来表示比较函数所处理的文本的编码方式.同一个自定义的排序规则的同一个比较函数可以有UTF-8, UTF-16LE和UTF-16BE等多个编码的版本. sqlite3_create_collation16()和sqlite3_create_collation()的区别也仅仅在于排序名称的编码是UTF-16还是UTF-8. 可以使用sqlite3_collation_needed()函数来注册一个回调函数,当数据库引擎遇到未知的排序规则时会自动调用该函数.在回调函数中可以查找一个相似的比较函数,并激活相应的sqlite_3_create_collation()函数.回调函数的第四个参数是排序规则的名称,同样sqlite3_collation_needed采用UTF-8编码. sqlite3_collation_need16()采用UTF-16编码. 五、给数据库加密 前面所说的内容网上已经有很多资料,虽然比较零散,但是花点时间也还是可以找到的。现在要说的这个——数据库加密,资料就很难找。也可能是我操作水平不够,找不到对应资料。但不管这样,我还是通过网上能找到的很有限的资料,探索出了给sqlite数据库加密的完整步骤。 这里要提一下,虽然sqlite很好用,速度快、体积小巧。但是它保存的文件却是明文的。若不信可以用NotePad打开数据库文件瞧瞧,里面insert的内容几乎一览无余。这样赤裸裸的展现自己,可不是我们的初衷。当然,如果你在嵌入式系统、智能手机上使用sqlite,最好是不加密,因为这些系统运算能力有限,你做为一个新功能提供者,不能把用户有限的运算能力全部花掉。 Sqlite为了速度而诞生。因此Sqlite本身不对数据库加密,要知道,如果你选择标准AES算法加密,那么一定有接近50%的时间消耗在加解密算法上,甚至更多(性能主要取决于你算法编写水平以及你是否能使用cpu提供的底层运算能力,比如MMX或sse系列指令可以大幅度提升运算速度)。 Sqlite免费版本是不提供加密功能的,当然你也可以选择他们的收费版本,那你得支付2000块钱,而且是USD。我这里也不是说支付钱不好,如果只为了数据库加密就去支付2000块,我觉得划不来。因为下面我将要告诉你如何为免费的Sqlite扩展出加密模块——自己动手扩展,这是Sqlite允许,也是它提倡的。 那么,就让我们一起开始为sqlite3.c文件扩展出加密模块。 1必要的宏 通过阅读Sqlite代码(当然没有全部阅读完,6万多行代码,没有一行是我习惯的风格,我可没那么多眼神去看),我搞清楚了两件事: Sqlite是支持加密扩展的; 需要#define一个宏才能使用加密扩展。 这个宏就是SQLITE_HAS_CODEC。 你在代码最前面(也可以在sqlite3.h文件第一行)定义: #ifndefSQLITE_HAS_CODEC #defineSQLITE_HAS_CODEC #endif 如果你在代码里定义了此宏,但是还能够正常编译,那么应该是操作没有成功。因为你应该会被编译器提示有一些函数无法链接才对。如果你用的是VC 2003,你可以在“解决方案”里右键点击你的工程,然后选“属性”,找到“C/C++”,再找到“命令行”,在里面手工添加“/D "SQLITE_HAS_CODEC"”。 定义了这个宏,一些被Sqlite故意屏蔽掉的代码就被使用了。这些代码就是加解密的接口。 尝试编译,vc会提示你有一些函数无法链接,因为找不到他们的实现。 如果你也用的是VC2003,那么会得到下面的提示: error LNK2019:无法解析的外部符号_sqlite3CodecGetKey,该符号在函数_attachFunc中被引用 error LNK2019:无法解析的外部符号_sqlite3CodecAttach,该符号在函数_attachFunc中被引用 error LNK2019:无法解析的外部符号_sqlite3_activate_see,该符号在函数_sqlite3Pragma中被引用 error LNK2019:无法解析的外部符号_sqlite3_key,该符号在函数_sqlite3Pragma中被引用 fatal error LNK1120: 4个无法解析的外部命令 这是正常的,因为Sqlite只留了接口而已,并没有给出实现。 下面就让我来实现这些接口。 2自己实现加解密接口函数 如果真要我从一份www.sqlite.org网上down下来的sqlite3.c文件,直接摸索出这些接口的实现,我认为我还没有这个能力。 好在网上还有一些代码已经实现了这个功能。通过参照他们的代码以及不断编译中vc给出的错误提示,最终我把整个接口整理出来。 实现这些预留接口不是那么容易,要重头说一次怎么回事很困难。我把代码都写好了,直接把他们按我下面的说明拷贝到sqlite3.c文件对应地方即可。我在下面也提供了sqlite3.c文件,可以直接参考或取下来使用。 这里要说一点的是,我另外新建了两个文件:crypt.c和crypt.h。 其中crypt.h如此定义: #ifndefDCG_SQLITE_CRYPT_FUNC_ #defineDCG_SQLITE_CRYPT_FUNC_ /*********** 董淳光写的SQLITE加密关键函数库 ***********/ /*********** 关键加密函数 ***********/ intMy_Encrypt_Func(unsignedchar* pData,unsignedintdata_len,constchar* key,unsignedintlen_of_key ); /*********** 关键解密函数 ***********/ intMy_DeEncrypt_Func(unsignedchar* pData,unsignedintdata_len,constchar* key,unsignedintlen_of_key ); #endif 其中的crypt.c如此定义: #include"./crypt.h" #include"memory.h" /*********** 关键加密函数 ***********/ intMy_Encrypt_Func(unsignedchar* pData,unsignedintdata_len,constchar* key,unsignedintlen_of_key ) { return0; } /*********** 关键解密函数 ***********/ intMy_DeEncrypt_Func(unsignedchar* pData,unsignedintdata_len,constchar* key,unsignedintlen_of_key ) { return0; } 这个文件很容易看,就两函数,一个加密一个解密。传进来的参数分别是待处理的数据、数据长度、密钥、密钥长度。 处理时直接把结果作用于pData指针指向的内容。 你需要定义自己的加解密过程,就改动这两个函数,其它部分不用动。扩展起来很简单。 这里有个特点,data_len一般总是1024字节。正因为如此,你可以在你的算法里使用一些特定长度的加密算法,比如AES要求被加密数据一定是128位(16字节)长。这个1024不是碰巧,而是Sqlite的页定义是1024字节,在sqlite3.c文件里有定义: # defineSQLITE_DEFAULT_PAGE_SIZE1024 你可以改动这个值,不过还是建议没有必要不要去改它。 上面写了两个扩展函数,如何把扩展函数跟Sqlite挂接起来,这个过程说起来比较麻烦。我直接贴代码。 分3个步骤。 首先,在sqlite3.c文件顶部,添加下面内容: #ifdefSQLITE_HAS_CODEC #include"./crypt.h" /*********** 用于在sqlite3最后关闭时释放一些内存 ***********/ voidsqlite3pager_free_codecarg(void*pArg); #endif 这个函数之所以要在sqlite3.c开头声明,是因为下面在sqlite3.c里面某些函数里要插入这个函数调用。所以要提前声明。 其次,在sqlite3.c文件里搜索“sqlite3PagerClose”函数,要找到它的实现代码(而不是声明代码)。 实现代码里一开始是: #ifdefSQLITE_ENABLE_MEMORY_MANAGEMENT /* A malloc() cannot fail in sqlite3ThreadData() as one or more calls to ** malloc() must have already been made by this thread before it gets ** to this point. This means the ThreadData must have been allocated already ** so that ThreadData.nAlloc can be set. */ ThreadData *pTsd = sqlite3ThreadData(); assert( pPager ); assert( pTsd && pTsd->nAlloc ); #endif 需要在这部分后面紧接着插入: #ifdefSQLITE_HAS_CODEC sqlite3pager_free_codecarg(pPager->pCodecArg); #endif 这里要注意,sqlite3PagerClose函数大概也是3.3.17版本左右才改名的,以前版本里是叫“sqlite3pager_close”。因此你在老版本sqlite代码里搜索“sqlite3PagerClose”是搜不到的。 类似的还有“sqlite3pager_get”、“sqlite3pager_unref”、“sqlite3pager_write”、“sqlite3pager_pagecount”等都是老版本函数,它们在pager.h文件里定义。新版本对应函数是在sqlite3.h里定义(因为都合并到sqlite3.c和sqlite3.h两文件了)。所以,如果你在使用老版本的sqlite,先看看pager.h文件,这些函数不是消失了,也不是新蹦出来的,而是老版本函数改名得到的。 最后,往sqlite3.c文件下找。找到最后一行: /************** End of main.c ************************************************/ 在这一行后面,接上本文最下面的代码段。 这些代码很长,我不再解释,直接接上去就得了。 唯一要提的是DeriveKey函数。这个函数是对密钥的扩展。比如,你要求密钥是128位,即是16字节,但是如果用户只输入1个字节呢?2个字节呢?或输入50个字节呢?你得对密钥进行扩展,使之符合16字节的要求。 DeriveKey函数就是做这个扩展的。有人把接收到的密钥求md5,这也是一个办法,因为md5运算结果固定16字节,不论你有多少字符,最后就是16字节。这是md5算法的特点。但是我不想用md5,因为还得为它添加包含一些md5的.c或.cpp文件。我不想这么做。我自己写了一个算法来扩展密钥,很简单的算法。当然,你也可以使用你的扩展方法,也而可以使用md5算法。只要修改DeriveKey函数就可以了。 在DeriveKey函数里,只管申请空间构造所需要的密钥,不需要释放,因为在另一个函数里有释放过程,而那个函数会在数据库关闭时被调用。参考我的DeriveKey函数来申请内存。 这里我给出我已经修改好的sqlite3.c和sqlite3.h文件。 如果太懒,就直接使用这两个文件,编译肯定能通过,运行也正常。当然,你必须按我前面提的,新建crypt.h和crypt.c文件,而且函数要按我前面定义的要求来做。 3加密使用方法 现在,你代码已经有了加密功能。 你要把加密功能给用上,除了改sqlite3.c文件、给你工程添加SQLITE_HAS_CODEC宏,还得修改你的数据库调用函数。 前面提到过,要开始一个数据库操作,必须先sqlite3_open。 加解密过程就在sqlite3_open后面操作。 假设你已经sqlite3_open成功了,紧接着写下面的代码: int i; //添加、使用密码 i =sqlite3_key( db, "dcg", 3 ); //修改密码 i =sqlite3_rekey(db, "dcg", 0 ); 用sqlite3_key函数来提交密码。 第1个参数是sqlite3 *类型变量,代表着用sqlite3_open打开的数据库(或新建数据库)。 第2个参数是密钥。 第3个参数是密钥长度。 用sqlite3_rekey来修改密码。参数含义同sqlite3_key。 实际上,你可以在sqlite3_open函数之后,到sqlite3_close函数之前任意位置调用sqlite3_key来设置密码。 但是如果你没有设置密码,而数据库之前是有密码的,那么你做任何操作都会得到一个返回值:SQLITE_NOTADB,并且得到错误提示:“file is encrypted or is not a database”。 只有当你用sqlite3_key设置了正确的密码,数据库才会正常工作。 如果你要修改密码,前提是你必须先sqlite3_open打开数据库成功,然后sqlite3_key设置密钥成功,之后才能用sqlite3_rekey来修改密码。 如果数据库有密码,但你没有用sqlite3_key设置密码,那么当你尝试用sqlite3_rekey来修改密码时会得到SQLITE_NOTADB返回值。 如果你需要清空密码,可以使用: //修改密码 i =sqlite3_rekey( db, NULL, 0 ); 来完成密码清空功能。 4 sqlite3.c最后添加代码段 /*** 董淳光定义的加密函数 ***/ #ifdefSQLITE_HAS_CODEC /*** 加密结构 ***/ #defineCRYPT_OFFSET 8 typedefstruct_CryptBlock { BYTE*ReadKey;//读数据库和写入事务的密钥 BYTE*WriteKey;//写入数据库的密钥 intPageSize;//页的大小 BYTE*Data; } CryptBlock, *LPCryptBlock; #ifndefDB_KEY_LENGTH_BYTE/*密钥长度*/ #defineDB_KEY_LENGTH_BYTE16/*密钥长度*/ #endif #ifndefDB_KEY_PADDING/*密钥位数不足时补充的字符*/ #defineDB_KEY_PADDING0x33/*密钥位数不足时补充的字符*/ #endif /***下面是编译时提示缺少的函数***/ /**这个函数不需要做任何处理,获取密钥的部分在下面DeriveKey函数里实现**/ voidsqlite3CodecGetKey(sqlite3* db,intnDB,void** Key,int* nKey) { return; } /*被sqlite和sqlite3_key_interop调用,附加密钥到数据库.*/ intsqlite3CodecAttach(sqlite3 *db,intnDb,constvoid*pKey,intnKeyLen); /** 这个函数好像是sqlite 3.3.17前不久才加的,以前版本的sqlite里没有看到这个函数 这个函数我还没有搞清楚是做什么的,它里面什么都不做直接返回,对加解密没有影响 **/ voidsqlite3_activate_see(constchar* right ) { return; } intsqlite3_key(sqlite3 *db,constvoid*pKey,intnKey); intsqlite3_rekey(sqlite3 *db,constvoid*pKey,intnKey); /*** 下面是上面的函数的辅助处理函数 ***/ //从用户提供的缓冲区中得到一个加密密钥 //用户提供的密钥可能位数上满足不了要求,使用这个函数来完成密钥扩展 staticunsignedchar* DeriveKey(constvoid*pKey,intnKeyLen); //创建或更新一个页的加密算法索引.此函数会申请缓冲区. staticLPCryptBlock CreateCryptBlock(unsignedchar* hKey, Pager *pager, LPCryptBlock pExisting); //加密/解密函数,被pager调用 void* sqlite3Codec(void*pArg,unsignedchar*data, Pgno nPageNum,intnMode); //设置密码函数 int__stdcallsqlite3_key_interop(sqlite3 *db,constvoid*pKey,intnKeySize); //修改密码函数 int__stdcallsqlite3_rekey_interop(sqlite3 *db,constvoid*pKey,intnKeySize); //销毁一个加密块及相关的缓冲区,密钥. staticvoidDestroyCryptBlock(LPCryptBlock pBlock); staticvoid* sqlite3pager_get_codecarg(Pager *pPager); voidsqlite3pager_set_codec(Pager *pPager,void*(*xCodec)(void*,void*,Pgno,int),void*pCodecArg); //加密/解密函数,被pager调用 void* sqlite3Codec(void*pArg,unsignedchar*data, Pgno nPageNum,intnMode) { LPCryptBlock pBlock = (LPCryptBlock)pArg; unsignedintdwPageSize = 0; if(!pBlock)returndata; //确保pager的页长度和加密块的页长度相等.如果改变,就需要调整. if(nMode != 2) { PgHdr *pageHeader; pageHeader = DATA_TO_PGHDR(data); if(pageHeader->pPager->pageSize != pBlock->PageSize) { CreateCryptBlock(0, pageHeader->pPager, pBlock); } } switch(nMode) { case0:// Undo a "case 7" journal file encryption case2://重载一个页 case3://载入一个页 if(!pBlock->ReadKey)break; dwPageSize = pBlock->PageSize; My_DeEncrypt_Func(data, dwPageSize, pBlock->ReadKey, DB_KEY_LENGTH_BYTE );/*调用我的解密函数*/ break; case6://加密一个主数据库文件的页 if(!pBlock->WriteKey)break; memcpy(pBlock->Data + CRYPT_OFFSET, data, pBlock->PageSize); data = pBlock->Data + CRYPT_OFFSET; dwPageSize = pBlock->PageSize; My_Encrypt_Func(data , dwPageSize, pBlock->WriteKey, DB_KEY_LENGTH_BYTE );/*调用我的加密函数*/ break; case7://加密事务文件的页 /*在正常环境下,读密钥和写密钥相同.当数据库是被重新加密的,读密钥和写密钥未必相同. 回滚事务必要用数据库文件的原始密钥写入.因此,当一次回滚被写入,总是用数据库的读密钥, 这是为了保证与读取原始数据的密钥相同. */ if(!pBlock->ReadKey)break; memcpy(pBlock->Data + CRYPT_OFFSET, data, pBlock->PageSize); data = pBlock->Data + CRYPT_OFFSET; dwPageSize = pBlock->PageSize; My_Encrypt_Func( data, dwPageSize, pBlock->ReadKey, DB_KEY_LENGTH_BYTE );/*调用我的加密函数*/ break; } returndata; } //销毁一个加密块及相关的缓冲区,密钥. staticvoidDestroyCryptBlock(LPCryptBlock pBlock) { //销毁读密钥. if(pBlock->ReadKey){ sqliteFree(pBlock->ReadKey); } //如果写密钥存在并且不等于读密钥,也销毁. if(pBlock->WriteKey && pBlock->WriteKey != pBlock->ReadKey){ sqliteFree(pBlock->WriteKey); } if(pBlock->Data){ sqliteFree(pBlock->Data); } //释放加密块. sqliteFree(pBlock); } staticvoid* sqlite3pager_get_codecarg(Pager *pPager) { return(pPager->xCodec) ? pPager->pCodecArg: NULL; } //从用户提供的缓冲区中得到一个加密密钥 staticunsignedchar* DeriveKey(constvoid*pKey,intnKeyLen) { unsignedchar*hKey = NULL; intj; if( pKey == NULL || nKeyLen == 0 ) { returnNULL; } hKey = sqliteMalloc( DB_KEY_LENGTH_BYTE + 1 ); if( hKey == NULL ) { returnNULL; } hKey[ DB_KEY_LENGTH_BYTE ] = 0; if( nKeyLen < DB_KEY_LENGTH_BYTE ) { memcpy( hKey, pKey, nKeyLen );//先拷贝得到密钥前面的部分 j = DB_KEY_LENGTH_BYTE - nKeyLen; //补充密钥后面的部分 memset(hKey + nKeyLen,DB_KEY_PADDING, j); } else {//密钥位数已经足够,直接把密钥取过来 memcpy(hKey, pKey, DB_KEY_LENGTH_BYTE ); } returnhKey; } //创建或更新一个页的加密算法索引.此函数会申请缓冲区. staticLPCryptBlock CreateCryptBlock(unsignedchar* hKey, Pager *pager, LPCryptBlock pExisting) { LPCryptBlock pBlock; if(!pExisting)//创建新加密块 { pBlock = sqliteMalloc(sizeof(CryptBlock)); memset(pBlock, 0,sizeof(CryptBlock)); pBlock->ReadKey = hKey; pBlock->WriteKey = hKey; pBlock->PageSize = pager->pageSize; pBlock->Data = (unsignedchar*)sqliteMalloc(pBlock->PageSize + CRYPT_OFFSET); } else//更新存在的加密块 { pBlock = pExisting; if( pBlock->PageSize != pager->pageSize && !pBlock->Data){ sqliteFree(pBlock->Data); pBlock->PageSize = pager->pageSize; pBlock->Data = (unsignedchar*)sqliteMalloc(pBlock->PageSize + CRYPT_OFFSET); } } memset(pBlock->Data, 0, pBlock->PageSize + CRYPT_OFFSET); returnpBlock; } /* ** Set the codec for this pager */ voidsqlite3pager_set_codec( Pager *pPager, void*(*xCodec)(void*,void*,Pgno,int), void*pCodecArg ) { pPager->xCodec = xCodec; pPager->pCodecArg = pCodecArg; } intsqlite3_key(sqlite3 *db,constvoid*pKey,intnKey) { returnsqlite3_key_interop(db, pKey, nKey); } intsqlite3_rekey(sqlite3 *db,constvoid*pKey,intnKey) { returnsqlite3_rekey_interop(db, pKey, nKey); } /*被sqlite和sqlite3_key_interop调用,附加密钥到数据库.*/ intsqlite3CodecAttach(sqlite3 *db,intnDb,constvoid*pKey,intnKeyLen) { intrc = SQLITE_ERROR; unsignedchar* hKey = 0; //如果没有指定密匙,可能标识用了主数据库的加密或没加密. if(!pKey || !nKeyLen) { if(!nDb) { returnSQLITE_OK;//主数据库,没有指定密钥所以没有加密. } else//附加数据库,使用主数据库的密钥. { //获取主数据库的加密块并复制密钥给附加数据库使用 LPCryptBlock pBlock = (LPCryptBlock)sqlite3pager_get_codecarg(sqlite3BtreePager(db->aDb[0].pBt)); if(!pBlock)returnSQLITE_OK;//主数据库没有加密 if(!pBlock->ReadKey)returnSQLITE_OK;//没有加密 memcpy(pBlock->ReadKey, &hKey, 16); } } else//用户提供了密码,从中创建密钥. { hKey = DeriveKey(pKey, nKeyLen); } //创建一个新的加密块,并将解码器指向新的附加数据库. if(hKey) { LPCryptBlock pBlock = CreateCryptBlock(hKey, sqlite3BtreePager(db->aDb[nDb].pBt), NULL); sqlite3pager_set_codec(sqlite3BtreePager(db->aDb[nDb].pBt), sqlite3Codec, pBlock); rc = SQLITE_OK; } returnrc; } // Changes the encryption key for an existing database. int__stdcallsqlite3_rekey_interop(sqlite3 *db,constvoid*pKey,intnKeySize) { Btree *pbt = db->aDb[0].pBt; Pager *p = sqlite3BtreePager(pbt); LPCryptBlock pBlock = (LPCryptBlock)sqlite3pager_get_codecarg(p); unsignedchar* hKey = DeriveKey(pKey, nKeySize); intrc = SQLITE_ERROR; if(!pBlock && !hKey)returnSQLITE_OK; //重新加密一个数据库,改变pager的写密钥,读密钥依旧保留. if(!pBlock)//加密一个未加密的数据库 { pBlock = CreateCryptBlock(hKey, p, NULL); pBlock->ReadKey = 0;//原始数据库未加密 sqlite3pager_set_codec(sqlite3BtreePager(pbt), sqlite3Codec, pBlock); } else//改变已加密数据库的写密钥 { pBlock->WriteKey = hKey; } //开始一个事务 rc = sqlite3BtreeBeginTrans(pbt, 1); if(!rc) { //用新密钥重写所有的页到数据库。 Pgno nPage = sqlite3PagerPagecount(p); Pgno nSkip = PAGER_MJ_PGNO(p); void*pPage; Pgno n; for(n = 1; rc == SQLITE_OK && n <= nPage; n ++) { if(n == nSkip)continue; rc = sqlite3PagerGet(p, n, &pPage); if(!rc) { rc = sqlite3PagerWrite(pPage); sqlite3PagerUnref(pPage); } } } //如果成功,提交事务。 if(!rc) { rc = sqlite3BtreeCommit(pbt); } //如果失败,回滚。 if(rc) { sqlite3BtreeRollback(pbt); } //如果成功,销毁先前的读密钥。并使读密钥等于当前的写密钥。 if(!rc) { if(pBlock->ReadKey) { sqliteFree(pBlock->ReadKey); } pBlock->ReadKey = pBlock->WriteKey; } else//如果失败,销毁当前的写密钥,并恢复为当前的读密钥。 { if(pBlock->WriteKey) { sqliteFree(pBlock->WriteKey); } pBlock->WriteKey = pBlock->ReadKey; } //如果读密钥和写密钥皆为空,就不需要再对页进行编解码。 //销毁加密块并移除页的编解码器 if(!pBlock->ReadKey && !pBlock->WriteKey) { sqlite3pager_set_codec(p, NULL, NULL); DestroyCryptBlock(pBlock); } returnrc; } /*** 下面是加密函数的主体 ***/ int__stdcallsqlite3_key_interop(sqlite3 *db,constvoid*pKey,intnKeySize) { returnsqlite3CodecAttach(db, 0, pKey, nKeySize); } //释放与一个页相关的加密块 voidsqlite3pager_free_codecarg(void*pArg) { if(pArg) DestroyCryptBlock((LPCryptBlock)pArg); } #endif//#ifdef SQLITE_HAS_CODEC 五、性能优化 很多人直接就使用了,并未注意到SQLite也有配置参数,可以对性能进行调整。有时候,产生的结果会有很大影响。 主要通过pragma指令来实现。 比如:空间释放、磁盘同步、Cache大小等。 不要打开。前文提高了,Vacuum的效率非常低! 1 auto_vacuum PRAGMA auto_vacuum; PRAGMA auto_vacuum = 0 | 1; 查询或设置数据库的auto-vacuum标记。 正常情况下,当提交一个从数据库中删除数据的事务时,数据库文件不改变大小。未使用的文件页被标记并在以后的添加操作中再次使用。这种情况下使用VACUUM命令释放删除得到的空间。 当开启auto-vacuum,当提交一个从数据库中删除数据的事务时,数据库文件自动收缩,(VACUUM命令在auto-vacuum开启的数据库中不起作用)。数据库会在内部存储一些信息以便支持这一功能,这使得数据库文件比不开启该选项时稍微大一些。 只有在数据库中未建任何表时才能改变auto-vacuum标记。试图在已有表的情况下修改不会导致报错。 2 cache_size 建议改为8000 PRAGMA cache_size; PRAGMA cache_size = Number-of-pages; 查询或修改SQLite一次存储在内存中的数据库文件页数。每页使用约1.5K内存,缺省的缓存大小是2000.若需要使用改变大量多行的UPDATE或DELETE命令,并且不介意SQLite使用更多的内存的话,可以增大缓存以提高性能。 当使用cache_size pragma改变缓存大小时,改变仅对当前对话有效,当数据库关闭重新打开时缓存大小恢复到缺省大小。要想永久改变缓存大小,使用default_cache_sizepragma. 3 case_sensitive_like 打开。不然搜索中文字串会出错。 PRAGMA case_sensitive_like; PRAGMA case_sensitive_like = 0 | 1; LIKE运算符的缺省行为是忽略latin1字符的大小写。因此在缺省情况下'a' LIKE 'A'的值为真。可以通过打开case_sensitive_like pragma来改变这一缺省行为。当启用case_sensitive_like,'a' LIKE 'A'为假而'a' LIKE 'a'依然为真。 4 count_changes 打开。便于调试 PRAGMA count_changes; PRAGMA count_changes = 0 | 1; 查询或更改count-changes标记。正常情况下INSERT, UPDATE和DELETE语句不返回数据。当开启count-changes,以上语句返回一行含一个整数值的数据——该语句插入,修改或删除的行数。返回的行数不包括由触发器产生的插入,修改或删除等改变的行数。 5 page_size PRAGMA page_size; PRAGMA page_size = bytes; 查询或设置page-size值。只有在未创建数据库时才能设置page-size。页面大小必须是2的整数倍且大于等于512小于等于8192。上限可以通过在编译时修改宏定义SQLITE_MAX_PAGE_SIZE的值来改变。上限的上限是32768. 6 synchronous 如果有定期备份的机制,而且少量数据丢失可接受,用OFF PRAGMA synchronous; PRAGMA synchronous = FULL; (2) PRAGMA synchronous = NORMAL; (1) PRAGMA synchronous = OFF; (0) 查询或更改"synchronous"标记的设定。第一种形式(查询)返回整数值。当synchronous设置为FULL (2), SQLite数据库引擎在紧急时刻会暂停以确定数据已经写入磁盘。这使系统崩溃或电源出问题时能确保数据库在重起后不会损坏。FULL synchronous很安全但很慢。当synchronous设置为NORMAL, SQLite数据库引擎在大部分紧急时刻会暂停,但不像FULL模式下那么频繁。NORMAL模式下有很小的几率(但不是不存在)发生电源故障导致数据库损坏的情况。但实际上,在这种情况下很可能你的硬盘已经不能使用,或者发生了其他的不可恢复的硬件错误。设置为synchronous OFF (0)时,SQLite在传递数据给系统以后直接继续而不暂停。若运行SQLite的应用程序崩溃,数据不会损伤,但在系统崩溃或写入数据时意外断电的情况下数据库可能会损坏。另一方面,在synchronous OFF时一些操作可能会快50倍甚至更多。 在SQLite 2中,缺省值为NORMAL.而在3中修改为FULL. 7 temp_store 使用2,内存模式。 PRAGMA temp_store; PRAGMA temp_store = DEFAULT; (0) PRAGMA temp_store = FILE; (1) PRAGMA temp_store = MEMORY; (2) 查询或更改"temp_store"参数的设置。当temp_store设置为DEFAULT (0),使用编译时的C预处理宏TEMP_STORE来定义储存临时表和临时索引的位置。当设置为MEMORY (2)临时表和索引存放于内存中。当设置为FILE (1)则存放于文件中。temp_store_directorypragma可用于指定存放该文件的目录。当改变temp_store设置,所有已存在的临时表,索引,触发器及视图将被立即删除。 经测试,在类BBS应用上,通过以上调整,效率可以提高2倍以上。 程序猿神奇的手,每时每刻,这双手都在改变着世界的交互方式! 本文转自当天真遇到现实博客园博客,原文链接:http://www.cnblogs.com/XYQ-208910/p/4825224.html,如需转载请自行联系原作者

优秀的个人博客,低调大师

IOS开发之property详解

之前很多网友对我翻译的教程中的Property的使用感到有些迷惑不解,搞不清楚什么时候要release,什么时候要self.xxx = nil;同时对于Objective-c的内存管理以及cocos2d的内存管理规则不够清楚。本文主要讲解objc里面@property,它是什么,它有什么用,atomic,nonatomic,readonly,readwrite,assign,retain,copy,getter,setter这些关键字有什么用,什么时候使用它们。至于Objc的内存管理和cocos2d的内存管理部分,接下来,我会翻译Ray的3篇教程,那里面再和大家详细讨论。今天我们的主要任务是搞定@property。 学过c/c++的朋友都知道,我们定义struct/class的时候,如果把访问限定符(public,protected,private)设置为public的话,那么我们是可以直接用.号来访问它内部的数据成员的。比如 //in Test.h class Test { public: int i; float f; }; 我在main函数里面是可以通过下面的方式来使用这个类的:(注意,如果在main函数里面使用此类,除了要包含头文件以外,最重要的是记得把main.m改成main.mm,否则会报一些奇怪的错误。所以,任何时候我们使用c++,如果报奇怪的错误,那就要提醒自己是不是把相应的源文件改成.mm后缀了。其它引用此类的文件有时候也要改成.mm文件) //in main.mm Test test; test.i =1; test.f =2.4f; NSLog(@"Test.i = %d, Test.f = %f",test.i, test.f); 但是,在objc里面,我们能不能这样做呢?请看下面的代码:(新建一个objc类,命名为BaseClass) //in BaseClass.h @interface BaseClass : NSObject{ @public NSString *_name; } 接下来,我们在main.mm里面: BaseClass *base= [[BaseClass alloc] init]; base.name =@"set base name"; NSLog(@"base class's name = %@", base.name); 不用等你编译,xcode4马上提示错误,请看截图: 请大家注意看出错提示“Property 'nam' not found on object of type BaseClass*",意思是,BaseClass这类没有一个名为name的属性。即使我们在头文件中声明了@public,我们仍然无法在使用BaseClass的时候用.号来直接访问其数据成员。而@public,@protected和@private只会影响继承它的类的访问权限,如果你使用@private声明数据成员,那么在子类中是无法直接使用父类的私有成员的,这和c++,java是一样的。 既然有错误,那么我们就来想法解决啦,编译器说没有@property,那好,我们就定义property,请看代码: //in BaseClass.h @interface BaseClass : NSObject{ @public NSString *_name; } @property(nonatomic,copy) NSString *name; //in BaseClass.m @synthesize name = _name; 现在,编译并运行,ok,很好。那你可能会问了@prperty是不是就是让”."号合法了呀?只要定义了@property就可以使用.号来访问类的数据成员了?先让我们来看下面的例子: @interface BaseClass : NSObject{ @public NSString *_name; } //@property(nonatomic,copy) NSString *name; -(NSString*) name; -(void) setName:(NSString*)newName; 我把@property的定义注释掉了,另外定义了两个函数,name和setName,下面请看实现文件: //@synthesize name = _name; -(NSString*) name{ return _name; } -(void) setName:(NSString *)name{ if (_name != name) { [_name release]; _name = [name copy]; } } 现在,你再编译运行,一样工作的很好。why?因为我刚刚做的工作和先前声明@property所做的工作完全一样。@prperty只不过是给编译器看的一种指令,它可以编译之后为你生成相应的getter和setter方法。而且,注意看到面property(nonatomic,copy)括号里面这copy参数了吗?它所做的事就是 _name = [name copy]; 如果你指定retain,或者assign,那么相应的代码分别是: //property(retain)NSString* name; _name = [name retain]; //property(assign)NSString* name; _name = name; 其它讲到这里,大家也可以看出来,@property并不只是可以生成getter和setter方法,它还可以做内存管理。不过这里我暂不讨论。现在,@property大概做了件什么事,想必大家已经知道了。但是,我们程序员都有一个坎,就是自己没有完全吃透的东西,心里用起来不踏实,特别是我自己。所以,接下来,我们要详细深挖@property的每一个细节。 首先,我们看atomic 与nonatomic的区别与用法,讲之前,我们先看下面这段代码: @property(nonatomic, retain) UITextField *userName; //1 @property(nonatomic, retain,readwrite) UITextField *userName; //2 @property(atomic, retain) UITextField *userName; //3 @property(retain) UITextField *userName; //4 @property(atomic,assign) int i; // 5 @property(atomic) int i; //6 @property int i; //7 请读者先停下来想一想,它们有什么区别呢? 上面的代码1和2是等价的,3和4是等价的,5,6,7是等价的。也就是说atomic是默认行为,assign是默认行为,readwrite是默认行为。但是,如果你写上@property(nontomic)NSString *name;那么将会报一个警告,如下图: 因为是非gc的对象,所以默认的assign修饰符是不行的。那么什么时候用assign、什么时候用retain和copy呢?推荐做法是NSString用copy,delegate用assign(且一定要用assign,不要问为什么,只管去用就是了,以后你会明白的),非objc数据类型,比如int,float等基本数据类型用assign(默认就是assign),而其它objc类型,比如NSArray,NSDate用retain。 在继续之前,我还想补充几个问题,就是如果我们自己定义某些变量的setter方法,但是想让编译器为我们生成getter方法,这样子可以吗?答案是当然可以。如果你自己在.m文件里面实现了setter/getter方法的话,那以翻译器就不会为你再生成相应的getter/setter了。请看下面代码: //代码一: @interface BaseClass : NSObject{ @public NSString *_name; } @property(nonatomic,copy,readonly) NSString *name; //这里使用的是readonly,所有会声明geter方法 -(void) setName:(NSString*)newName; //代码二: @interface BaseClass : NSObject{ @public NSString *_name; } @property(nonatomic,copy,readonly) NSString *name; //这里虽然声明了readonly,但是不会生成getter方法,因为你下面自己定义了getter方法。 -(NSString*) name; //getter方法是不是只能是name呢?不一定,你打开Foundation.framework,找到UIView.h,看看里面的property就明白了) -(void) setName:(NSString*)newName; //代码三: @interface BaseClass : NSObject{ @public NSString *_name; } @property(nonatomic,copy,readwrite) NSString *name; //这里编译器会我们生成了getter和setter //代码四: @interface BaseClass : NSObject{ @public NSString *_name; } @property(nonatomic,copy) NSString *name; //因为readwrite是默认行为,所以同代码三 上面四段代码是等价的,接下来,请看下面四段代码: //代码一: @synthesize name = _name; //这句话,编译器发现你没有定义任何getter和setter,所以会同时会你生成getter和setter //代码二: @synthesize name = _name; //因为你定义了name,也就是getter方法,所以编译器只会为生成setter方法,也就是setName方法。 -(NSString*) name{ NSLog(@"name"); return _name; } //代码三: @synthesize name = _name; //这里因为你定义了setter方法,所以编译器只会为你生成getter方法 -(void) setName:(NSString *)name{ NSLog(@"setName"); if (_name != name) { [_name release]; _name = [name copy]; } } //代码四: @synthesize name = _name; //这里你自己定义了getter和setter,这句话没用了,你可以注释掉。 -(NSString*) name{ NSLog(@"name"); return _name; } -(void) setName:(NSString *)name{ NSLog(@"setName"); if (_name != name) { [_name release]; _name = [name copy]; } } 上面这四段代码也是等价的。看到这里,大家对Property的作用相信会有更加进一步的理解了吧。但是,你必须小心,你如果使用了Property,而且你自己又重写了setter/getter的话,你需要清楚的明白,你究竟干了些什么事。别写出下面的代码,虽然是合法的,但是会误导别人: //BaseClass.h @interface BaseClass : NSObject{ @public NSArray *_names; } @property(nonatomic,assgin,readonly) NSArray *names; //注意这里是assign -(void) setNames:(NSArray*)names; //BaseClass.m @implementation BaseClass @synthesize names = _names; -(NSArray*) names{ NSLog(@"names"); return _names; } -(void) setNames:(NSArray*)names{ NSLog(@"setNames"); if (_name != name) { [_name release]; _name = [name retain]; //你retain,但是你不覆盖这个方法,那么编译器会生成setNames方法,里面肯定是用的assign } } 当别人使用@property来做内存管理的时候就会有问题了。总结一下,如果你自己实现了getter和setter的话,atomic/nonatomic/retain/assign/copy这些只是给编译的建议,编译会首先会到你的代码里面去找,如果你定义了相应的getter和setter的话,那么好,用你的。如果没有,编译器就会根据atomic/nonatomic/retain/assign/copy这其中你指定的某几个规则去生成相应的getter和setter。 好了,说了这么多,回到我们的正题吧。atomic和nonatomic的作用与区别: 如果你用@synthesize去让编译器生成代码,那么atomic和nonatomic生成的代码是不一样的。如果使用atomic,如其名,它会保证每次getter和setter的操作都会正确的执行完毕,而不用担心其它线程在你get的时候set,可以说保证了某种程度上的线程安全。但是,我上网查了资料,仅仅靠atomic来保证线程安全是很天真的。要写出线程安全的代码,还需要有同步和互斥机制。 而nonatomic就没有类似的“线程安全”(我这里加引号是指某种程度的线程安全)保证了。因此,很明显,nonatomic比atomic速度要快。这也是为什么,我们基本上所有用property的地方,都用的是nonatomic了。 还有一点,可能有读者经常看到,在我的教程的dealloc函数里面有这样的代码:self.xxx = nil;看到这里,现在你们明白这样写有什么用了吧?它等价于[xxx release]; xxx = [nil retain];(---如果你的property(nonatomic,retian)xxx,那么就会这样,如果不是,就对号入座吧)。 因为nil可以给它发送任何消息,而不会出错。为什么release掉了还要赋值为nil呢?大家用c的时候,都有这样的编码习惯吧。 int* arr = new int[10]; 然后不用的时候,delete arr; arr = NULL; 在objc里面可以用一句话self.arr = nil;搞定。 最新内容请见作者的GitHub页:http://qaseven.github.io/

优秀的个人博客,低调大师

iOS:UIButton按钮的详解

UIButton的详细介绍: 一、按钮具有的属性: @property(nonatomic,readonly)UIButtonType buttonType; //按钮形状类型 @property(nonatomic,readonly,retain)NSString*currentTitle; //按钮当前文字 @property(nonatomic,readonly,retain)UIColor*currentTitleColor; //按钮当前文字颜色 @property(nonatomic,readonly,retain)UIColor*currentTitleShadowColor; //按钮文字当前阴影颜色 @property(nonatomic,readonly,retain)UIImage*currentImage; //按钮当前前景图片 @property(nonatomic,readonly,retain)UIImage*currentBackgroundImage; //按钮当前背景图片 @property(nonatomic,readonly,retain)NSAttributedString*currentAttributedTitle //按钮文字当前属性 @property(nonatomic,readonly,retain)UILabel *titleLabel //按钮标签 @property(nonatomic,readonly,retain)UIImageView *imageView //按钮视图 @property(nonatomic)UIControlContentVerticalAlignment contentVerticalAlignment; //按钮垂直放置方式 @property(nonatomic)UIControlContentHorizontalAlignment contentHorizontalAlignment; //按钮水平放置方式 @property(nonatomic,readonly)UIControlState //按钮状态类型 二、设置按钮的属性值 - (void)setTitle:(NSString *)title forState:(UIControlState)state; //设置按钮文字内容 - (void)setTitleColor:(UIColor*)color forState:(UIControlState)state //设置按钮文字颜色 - (void)setTitleShadowColor:(UIColor*)color forState:(UIControlState)state //设置按钮文字阴影颜色 - (void)setImage:(UIImage*)image forState:(UIControlState)state; //设置按钮前景图片 - (void)setBackgroundImage:(UIImage*)image forState:(UIControlState)state //设置按钮背景图片 - (void)setAttributedTitle:(NSAttributedString*)title forState:(UIControlState)state //设置按钮文字属性 三、按钮的状态类型 按钮类型UIControlState: UIControlStateNormal //正常类型 UIControlStateHighlighted //高亮类型 UIControlStateDisabled //禁用类型 UIControlStateSelected //选中类型 UIControlStateApplication //当应用程序标识使用时 UIControlStateReserved //为框架预留的 四、设置按钮形状类型 self.loginBtn=[UIButtonbuttonWithType:UIButtonTypeRoundedRect]; buttonWithType:定义button按钮的外形 六种定义button类型:下面有图解 UIButtonTypeCustom=0,无类型 UIButtonTypeRoundedRect,四个角是圆弧型的 UIButtonTypeDetailDisclosure, UIButtonTypeInfoLight, UIButtonTypeInfoDark, UIButtonTypeContactAdd, 或者: [Btn.layer setMasksToBounds:YES]; [Btn.layer setCornerRadius:8.0]; //设置矩圆角半径 [Btn.layer setBorderWidth:1.0]; //边框宽度 CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceRGB(); CGColorRef colorref = CGColorCreate(colorSpace,(CGFloat[]){ 1, 0, 0, 1 }); [Btn.layer setBorderColor:colorref];//边框颜色 五、获取按钮的属性 - (NSString*)titleForState:(UIControlState)state; //获取按钮文字 - (UIColor*)titleColorForState:(UIControlState)state; //获取按钮文字颜色 - (UIColor*)titleShadowColorForState:(UIControlState)state; //获取按钮文字阴影颜色 - (UIImage*)imageForState:(UIControlState)state; //获取按钮前景图片 - (UIImage*)backgroundImageForState:(UIControlState)state; //获取按钮背景图片 - (NSAttributedString*)attributedTitleForState:(UIControlState)state; //获取按钮文字属性 六、按钮文字放置方式 垂直放置: UIControlContentVerticalAlignmentCenter //居中 UIControlContentVerticalAlignmentTop //置顶 UIControlContentVerticalAlignmentBottom //置底 UIControlContentVerticalAlignmentFill //填充 水平放置: UIControlContentHorizontalAlignmentCenter //居中 UIControlContentHorizontalAlignmentLeft //居左 UIControlContentHorizontalAlignmentRight //居右 UIControlContentHorizontalAlignmentFill //填充 说明: (1) 由于按钮有状态类型之分,所以,在给按钮添加文字时,使用button.TitleLabel.Text = @“按钮”这种赋值方式是无效的,在视图中不会显示出来,应该使用[buttonsetTitle:(NSString *)title forState:(UIControlState) state]这种方式才是有效地。同样设置文字的颜色也是如此: 设置UIButton上字体的颜色设置UIButton上字体的颜色,不是用: [btn.titleLabelsetTextColor:[UIColorblackColor]]; btn.titleLabel.textColor=[UIColorredColor]; 而是用: [btnsetTitleColor:[UIColorblackColor]forState:UIControlStateNormal]; (2)获取按钮的文字,应该使用[button currentTitle],如果使用button.titleLabel.Text,其结果并不是你设置的文字内容。同样获取文字的颜色也是如此.[button currentTitleColor] (3)设置按钮上的字体的大小 [buttonsetFont:[UIFontsystemFontSize:14.0]];//这种可以用来设置字体的大小,但是可能会在 将来的SDK版本中去除改方法 button.titleLabel.font = [UIFont fontWithName:(NSString*)fontName size:14.0]; //应该使用 或者 button.TitleLabel.font=[UIFontsystemFontOfSize:14.0]; //应该使用 (4)有些时候我们想让UIButton的title居左对齐 button.textLabel.textAlignment=UITextAlignmentLeft //是没有作用的,我们需要设置 button.contentHorizontalAlignment=UIControlContentHorizonAlignmentLeft; //显示居左 但是问题又出来,文字会紧贴到做边框,我们可以设置使文字距离左边框保持10个像素的距离。 button.contentEdgeInsets=UIEdgeInsetsMake(0,10,0,0); 程序猿神奇的手,每时每刻,这双手都在改变着世界的交互方式! 本文转自当天真遇到现实博客园博客,原文链接:http://www.cnblogs.com/XYQ-208910/p/4774082.html,如需转载请自行联系原作者

优秀的个人博客,低调大师

iOS:转载:UIControl的使用

主要功能: UIContol(控件是所有控件的基类 如:(UIButton)按钮主要用于与用户交互,通常情况下我们不会直接使用UIControl,而是子类化它。 常用属性: BOOL enabled 空间默认是启用的,要禁用控件,可以将enabled属性设置为NO,这样将导致控件会略任何触摸控件事件。被禁用后,控件还可以用不同的方式显示自己, 比如变成灰色不可用。由空间的子类完成的,这个属性却存在于UIControl中。 实例演示: UIButton *button = [[UIButton alloc] initWithFrame:CGRectMake(40, 60, 100, 60)]; button.backgroundColor = [UIColor orangeColor]; button.enabled = NO; [button addTarget:self action:@selector(onButton) forControlEvents:UIControlEventTouchUpInside]; [self.view addSubview:button]; - (void)onButton{ NSLog(@"button被点击"); }//不会有输出结果,因为button的事件被禁用。 BOOL selected; 当用户选中控件时,UIControl类会将其selected属性设置为YES。子类有时使用这个属性来让其选择自身,或者来表现不同的行为方式。 布局方式: UIControlContentVerticalAlignment:垂直对齐方式 1.UIControlContentVerticalAlignmentCenter //居中2.UIControlContentVerticalAlignmentTop //置顶3.UIControlContentVerticalAlignmentBottom //底部4.UIControlContentVerticalAlignmentFill //填充全部 UIControlContentHorizontalAlignment:水平对齐方式 1.UIControlContentHorizontalAlignmentCenter //居中2.UIControlContentHorizontalAlignmentLeft //居左3.UIControlContentHorizontalAlignmentRight //居右4.UIControlContentHorizontalAlignmentFill //填充全部 UIControl介绍(二) - (void)addTarget:(id)target action:(SEL)action forControlEvents:(UIControlEvents)controlEvents; UIControl类的提供的标准机制,来进行事件登记和接收。这可以指定控件在发生特定事件时,通知代理的一个方法。此方法用于注册一个事件,事件可以用逻辑OR合并在一起,因此可以在一次单独的addTarget调用中指定多个事件,下列事件为基类UIControl所支持,除非另有说明,也是用所有控件: UIControlEventTouchDown 单点触摸按下事件:用户点触屏幕,或者又有新手指落下的时候触发例如:[button addTarget:self action:@selector(onButton) forControlEvents:UIControlEventTouchDown]; UIControlEventTouchDownRepeat 多线触摸按下事件,点触计数大于1:用户按下两根手指以上时候触发 UIControlEventTouchDragInside 当一次触摸在控件窗口内拖动时 UIControlEventTouchDragUotside 当一次触摸在控件窗口之外拖动时 UIControlEventTouchDragEnter 当一次触摸从控件窗口之外拖动到内部时 UIControlEventTouchExit 当以一次触摸从控件窗口内部拖动到外部时 UIControlEventTouchUpInside 所有在控件之内触摸抬起事件 UIControlEventTouchOutside 所有在控件之外触摸抬起事件(点触必须开始与控件内部才会发送通知) UIControlEventTouchCancel 所有触摸取消事件,即依稀触摸因为放上了太多手指而被取消或者被上锁或者电话呼叫打断 UIControlEventTouchChanged 当控件的值发生改变时,发送通知。用于滑块,分段控件以及其他取值的控件 UIControlEventEditingDidBegin 当文本控件中开始编辑是发送通知 UIControlEventEditingChanged 当文本控件的文本被改变时发送通知 UIControlEventEditingDidEnd 当文本控件编辑结束时发送通知 UIControlEventEditingDidOnEit 当文本控件内通过按下回车键(或等价行为)结束编辑时,发送通知 UIControlEventEditingEvents 通知所有关于文本编辑的事件 UIControlEventAllEvents 通知所有事件 UIControl介绍(三) 常用方法 - (void)removeTarget:(id)target action:(SEL)action forControlEvents:(UIControlEvents)controlEvents; 删除一个或多个事件的响应动作,可以是使用UIControl类的removeTarget.使用nil值就可以将给定事件的目标所有动作删除: 注册事件的时候,方法签名有两种: -(void)onEventMethod:(UIControl *)sender; -(void)onEventMethod; 程序猿神奇的手,每时每刻,这双手都在改变着世界的交互方式! 本文转自当天真遇到现实博客园博客,原文链接:http://www.cnblogs.com/XYQ-208910/p/4764774.html,如需转载请自行联系原作者

优秀的个人博客,低调大师

iOS 遗留系统重构实践

在过去的几个月内,我主导着团队完成了一项工程浩大(累积八个人月的工作量)的重构工作——为我们的App替换数据库。之所以能够把这种伤筋动骨的事情称之为重构,是因为在这段时间内,我们每天向主干合并两到三次代码,期间App上线五次,用户没有感知到任何影响。在这篇文章中,我将讲述我们如何在不影响系统外部行为,也不影响正常交付的情况下,替换掉了数据库实现。 背景 在一个有着良好分层结构的系统中,每一层都有它自己的职责:显示层负责响应用户事件,调用业务层的逻辑,最后做数据呈现;业务逻辑层负责业务规则与数据处理;数据访问层封装底层数据库的操作,网络访问层与其并列,负责网络请求、json解析等等。无论是MVC、MVVM、VIPER,归根结底都是在”单一职责“、“关注点分离”、“高内聚低耦合”的原则下变化,只是表现形式和涵盖的层次各异。 而在我们的代码中,几乎所有的显示层对象,包括ViewController、ViewModel,甚至View里面都混杂了大量的CoreData API调用,直接进行数据库操作。 粗略统计了一下,系统中一共有25个类与NSManageContext紧紧耦合。形成了下图中混乱的局面: 面对这种情况,我们首先要做的就是解耦。 方案选型 我们最先排除掉的是重写这种简单粗暴的方式。表面上看来,我们可以通过重写得到一个干净利落的方案,层次结构清晰,职责分离;但与之相伴的是巨大的风险: 范围不可控——遗留系统的难点就在于牵一发而动全身,影响范围极广。稍不留神,重写的工作就会如野火燎原般蔓延开来,不可收拾。 长时间无法上线——在整个过程中,直到最后完成的那一刻之前,系统会处于一直不可用的状态。漫长的时间里,所有的新功能都被阻塞,不能交付。没有哪个产品团队能承担这样的结果。 第二个被排除掉的方案是特性分支。把重写的工作放到分支上完成,其他人继续在主干上开发新特性,直到重写结束再合并回主干——这种做法确实比直接重写要好上那么一点点,因为新特性还是可以不受影响的;但长期没有跟主干合并的分支,在经历上四五个月的重写之后,天知道到最后要花多长时间来处理合并冲突? 既想减小对系统的影响,又想不影响新功能上线,又不想处理大量的合并冲突,最后的方案就只剩下了一种,那就是抽象分支(Branch by Abstraction)+特性开关(Feature Toggle)。 抽象分支 抽象分支这个名字的缘起是针对版本库分支而言的,它允许开发者在一条“抽象”的分支上并行工作,无需创建一条实际的分支,从而避免无谓的合并开销。 Martin Fowler和Jez Humble都曾在多年前撰文介绍过这个重构方案 http://martinfowler.com/bliki/BranchByAbstraction.html http://continuousdelivery.com/2011/05/make-large-scale-changes-incrementally-with-branch-by-abstraction/ 它的工作原理很简单:当我们想要替换掉系统中的某个组件——名为X——时,首先为X组件创造一个抽象层,这一层里面可能会有大大小小若干接口或是协议,把系统中对X组件的访问都隔离在抽象层之下,系统只调用抽象的接口/协议,不会接触到具体的API实现。如下图所示。 这一步我们可以通过提取方法、提取类和接口等重构手法来完成;这以后系统就彻底跟X组件解耦了,它依赖的只是一组抽象接口,而非具体实现。这时候,我们就可以着手在这个抽象层下面,进行新组件的开发工作,让它也实现同一套接口即可。 这之后,我们再使用特性开关(其原理及实现见下节),让这个抽象层在生产环境下调用旧组件,测试环境下调用新组件,从而在完全不影响交付的情况下,完成对新组件的测试。测试结束后,就可以打开开关,让系统在线上使用新组件,等彻底稳定后,把开关代码和旧组件代码全部删掉,替换工作就完成了。 在上述整个开发过程中,任何一个阶段都可以做到细粒度的任务分解,然后小步提交,每次提交都自动触发单元测试和集成测试,保证不影响现有功能。在频繁提交的情况下,也不会出现大量的代码合并冲突,无论是做组件替换还是新特性开发,开发人员都可以基于同一套代码库工作。这就大大减少了对系统的冲击和交付风险。 特性开关 先看一段代码: 在这个例子中,我们要替换一个Storyboard的布局和相关ViewController的功能,耗时很久,如果直接在主干上修改,就会直接影响到现有的App,在功能完成之前都无法上线;如果拉一条分支出来做,未来就又会有大量的合并冲突。使用如上的特性开关就会避免上述问题。 当shouldDisplayNewSearchResultsScreen的值返回为真,就使用新的Storyboard,返回为假,就使用旧的Storyboard。这样一来,只要开关处于关闭状态,未完成的功能就是对用户不可见的,我们就既可以在开发环境下自测,也可以部署到测试环境下做验收测试,还可以针对开关为真的情况写对应的单元测试,让每次代码提交都有持续集成验证。这期间还可以继续发布新版本,用户完全感知不到影响,直到我们决定打开开关为止。 特性开关可以有多种实现方式。 预编译参数 在预编译参数中传值,让不同的xcconfig文件传入不同的值,然后在代码中做判断。 我们系统中绝大部分的特性开关都是用这种方式实现的。 NSUserDefaults 有些功能可能对App有破坏性的影响,即便是设成只对Internal Target可见,也会影响到QA的回归测试。我们给Internal Target做了个Developer Settings界面,让开发人员可以自己修改开关状态,把开关的值存放在NSUserDefaults里面,默认返回false,只有在界面上手工切换之后才会返回true。测试和开发互相不受影响。 我们向Realm迁移的特性开关使用的就是这种方式。 服务器取值 配置参数的值也可以通过服务器下发。这种做法的好处是比较灵活,在启用/禁用某项功能的时候不需要发布新版本,只需要后台配置,缺点是会增加集成和后台开发的工作量。 A/B测试 还有一个办法是使用第三方的A/B测试服务,如果缺少后台开发人员的话,这也是一个选择。但第三方的稳定性往往就会成为制约因素,Parse为推送通知提供过A/B测试服务,但是它到了17年就会被关闭了;我们用Amazon的A/B测试框架用了一段时间,然后Amazon也宣布今年8月份停用……目前我们还在寻找备选方案。 具体实现 在具体落实抽象分支和特性开关的时候,一共分成了如下几个阶段: 建立数据访问层 我们首先把跟数据请求有关的操作从ViewController中提取成一个方法,放到另一个对象中实现,以便日后替换。然后把所有的数据访问的方法都提取成一个协议,让数据层之上的对象都依赖于这个协议,而不是具体对象。这样一来,原先的ViewController就从下图中的样子: 变成了这样: 为数据对象提取协议 除了数据访问的代码以外,我们还把所有的数据对象上的公有属性和方法都提取了相应的协议,然后修改了整个App,让它使用协议,而不是具体的数据对象。这也是为以后的切换做准备。 使用Realm实现 前两步完成之后,我们就建立起了一个完整的抽象层。在这层之上,App里已经没有了对CoreData和数据对象的依赖,我们可以在这层抽象之下,提供一套全新的实现,用来替换CoreData。 在实现过程中,我们还是遇到了不少需要磨合的细节,比如Realm中的一对多关联是通过RLMArray实现的,并不是真正的NSArray,为了保证接口的兼容性,我们就只能把property定义为RLMArray,再提供一个NSArray的getter方法。种种问题不一而足。 切换开关状态 上篇文章说到,我们在迁移过程中的特性开关是用NSUserDefaults实现的,在界面上手工切换开关状态。这样的好处是开发过程不会影响在Hockey和TestFlight上内部发布。直到实现完成后,我们再把开关改成 + (BOOL)shouldUseRealm { return isInternalTarget; } 让测试人员可以在真机上测试。回归测试结束之后,再让开关直接返回true,就可以向App Store提交了。 数据迁移 这个无需多说,写个MigrationManager之类的类,用来把数据从CoreData中读出,写到Realm里面去。这个类大概要保留上三四个版本,等绝大部分用户都已经升级到新版本之后才会删掉。 后续清理 特性开关是不能一直存活下去的,否则代码中的分支判断会越来越多。我们一般都会在上线一两个星期之后,发现没有出现特别严重的crash,就把跟开关有关的代码全都删掉。 在第一步建立数据访问层的时候,我们创建出了一个特别庞大的PersistenceService,它里面含有所有的数据访问方法。这只是为了方便切换而已,切换完成后,我们还是要根据访问数据的不同,建立一个个小的Repository,然后让ViewModel对象访问Repository读写数据,把PersistenceService删掉。 最后形成的架构如图所示: 总结 首先,要勇敢面对遗留代码库,团队里一定要有人站出来跟大家说,我们不能让代码继续腐烂下去,我们要有清晰的目标和正确的策略,在重构中让优秀的设计渐渐涌现。这才是正途。 要有正确的方法 在遗留代码中工作,Long-Term Refactoring是不可或缺的。人们需要预见到在未来的产品规划中,哪些组件应当被替换,哪部分架构需要作出调整,把它们放到迭代计划里面来,当做日常工作的一部分。抽象分支和特性开关在Long-Term Refactoring可以发挥显著的效果,它们是持续交付的保障。 设计会过时,但设计原则不会 很多技术决策都不是非黑即白的,它们更像是在种种约束下做出的权衡。时光会褪色,框架会过时,脱离了具体场景,今天的优秀设计也会沦落成明天的遗留代码,但设计原则有着不动声色的力量。我们无法预见未来,只能根据当前的情况做出简单而灵活的设计。这样的设计应当服从这些设计原则:单一职责、关注点分离、不要和陌生人说话……让我们的代码尽可能保持高内聚低耦合,保证良好的可测试性。 ====================================分割线================================文章转载自 开源中国社区[http://www.oschina.net]

资源下载

更多资源
优质分享App

优质分享App

近一个月的开发和优化,本站点的第一个app全新上线。该app采用极致压缩,本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring

Spring框架(Spring Framework)是由Rod Johnson于2002年提出的开源Java企业级应用框架,旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念,提供核心容器、应用上下文、数据访问集成等模块,支持整合Hibernate、Struts等第三方框架,其适用范围不仅限于服务器端开发,绝大多数Java应用均可从中受益。

用户登录
用户注册
修改密码
忘记密码