iphone开发我的新浪微博客户端-用户登录准备篇(1.1)
首先说一下我这个的实现思路，登录支持多个账号，也就是说可以保存多个微博账号登录的时候选择其中一个登录。多个账号信息保存在sqlite的数据库中，每一个账号信息就是一条记录, 当用户启动微博客户端的时候去取保存在sqlite数据库中的账号记录信息，然后把这些在界面中以列表的形式展示出来，用户可以点击其中的一个账号进入微博，如果如果启动微博客户端的时候检查到sqlite数据库中一个账号都没有的时候，程序自动显示用户授权认证页面，本客户端是基于oauth认证实现的，所以使用新微博账号前需要进行授权认证，一个账号只需要第一次做一下授权认证然后会把user_id、Access Token和Access Secret以及用户名称和头像小图标一起保存到sqlite的数据库中，下次登录的时候可以不在需要输入账号和密码，直接在界面中点击已经选择的用户小图标进入微博。关于Access Token和Access Secret这个我就不解释了，不懂的可以google一下oauth的知识，其实我前面做android版本的微博客户端的时候写过一篇比较详细的介绍过关于oauth的随笔可以翻出来参考一下。
从上面的思路来看用户登录有两种可能性，第一种数据库中尚无任何账号信息；第二种数据库中已经包含了一个或以上的账号信息。这两种情况显示不同的用户界面，两种情况的实现过程看下面的描述。
第一种情况实现过程：1.查询sqlite数据库 -->2.无账号记录显示需要进行授权认证的提示信息界面（上图6） -->3.在上一步界面中点击开始按钮进入用户授权界面-->4.用户输入自己的微博账号和密码点击确定然后关闭用户授权界面（上图7）-->5.程序根据用户的授权获取这个账号的信息保存到sqlite库-->6.显示用户登录选择界面默认账号就是用户刚刚授权的账号
第二种情况实现过程：1.查询sqlite数据库 -->2.已有账号记录获取所有账号信息并且显示用户登录选择界面 -->3.读取上一次登录的账号作为界面的默认选择用户显示（如上图2）-->4.点击添加按钮显示账号添加界面（如上图4）-->5.点击切换按钮显示账号选择列表界面（如下图3）-->6.点击删除按钮显示账号删除确认界面（如下图5）
从上面的实现过程看涉及到的主要知识点：1.sqlite数据库操作(创建数据库、创建数据表、插入数据记录、读取数据记录)；2、oauth授权认证（已经由sdk实现了调用相关方法即可）；3、NSUserDefaults存取（用来记录上一次的登录账号）
现在正式开始动手做一一些准备工作：
一、到 http://code.google.com/p/minblog4sina/（关于这个可以参看：iphone开发我的新浪微博客户端-开篇）把我的这个sdk项目源代码checkout到本地，然后用xcode打开这个工程，在这个sdk工程的基础上开发微博客户端应用。
二、设计sqlite数据库用来保存用户账号信息，我是用firefox的一个名为SQLite Manager的插件来创建sqlite数据库，这个使用非常简单就不介绍了自己装起来就知道怎么使用，我用它创建了一个名为weibo.sqlite的数据库，然后这这个数据库中创建了一个名为loginUser的表用来保存账号信息，loginUser表的，这个表包含5个字段分别用来保存user_id、账号昵称、Access Token、Access Secret、账号小图标，具体如下图：
三、用xcode打开工程，然后把上一步完成的weibo.sqlite文件添加到工程的Resources文件夹中.
四、在工程中添加类型为Objective-C class名为Sqlite的类用来负责sqlite库的创建、记录的读取、记录的添加等操作，同时在Xcode的左边树Frameworks右键添加名为libsqlite3.dylib的Framework，这个类库封装了sqlite库的操作。
五、打开Sqlite.h添加如下代码，在这个文件中首先import了sqlite3.h，这个就是Frameworks中的libsqlite3.dylib类库，然后又import了User.h，这个是MinBlog4Sina的sdk中的用户账号对象类。又声明的4个方法分别是数据库初始化、获取用户记录列表、添加用户记录、删除用户记录。
#import <Foundation/Foundation.h>
#import <sqlite3.h>
#import "User.h"
@interface Sqlite : NSObject {
sqlite3 *database;
}
-(Sqlite *)init;
-(NSMutableArray *)getUserList;
-(BOOL)addUser:(User *)user;
-(BOOL)delUser:(NSString *)name;
@end
六、打开Sqlite.m添加如下代码,这个文件里实现了上述的几个方法，所谓的数据库创建其实就是把上面第三个步骤中添加到工程的weibo.sqlite文件拷贝到本软件的目录中，在下面的-(Sqlite *)init方法中进行了拷贝操作。还有就是用户记录读取和添加中关于BLOB类型的数据处理，这里存储的是图片数据了，在添加的时候把图片转换成bytes类型，读取的时候把bytes类型转换成图片。
#import "Sqlite.h"
@interface Sqlite(private)
-(void)createDatabaseIfNeeded:(NSString *)filename;
-(NSString *)dataFilePath;
-(BOOL)openDatabase;
-(void)closeDatabase;
@end
@implementation Sqlite
//初始化数据库
-(Sqlite *)init
{
if (self= [super init]) {
[self createDatabaseIfNeeded:@"weibo.sqlite"];
}
return self;
}
-(BOOL)delUser:(NSString *)name
{
BOOL sucess=[self openDatabase];
if (sucess) {
NSString *sql=[[NSString alloc] initWithFormat:@"delete from loginUser where screen_name='%@'",name];
char *errorMsg;
if (sqlite3_exec(database, [sql UTF8String], NULL, NULL, &errorMsg)!=SQLITE_OK) {
NSLog(@"del User error:%s",errorMsg);
sqlite3_free(errorMsg);
}else {
}
[sql release];
}
[self closeDatabase];
return sucess;
}
//添加用户记录
-(BOOL)addUser:(User *)user
{
BOOL sucess=[self openDatabase];
if (sucess) {
NSString *sql=[[NSString alloc] initWithFormat:@"insert into loginUser(user_id,screen_name,key,secret,icon)values(?,?,?,?,?)"];
sqlite3_stmt *statement;
if (sqlite3_prepare_v2(database, [sql UTF8String], -1, &statement, nil)==SQLITE_OK)
{
NSString *uid=[NSString stringWithFormat:@"%@",user.userId];
const char *user_idChar=[uid UTF8String];
sqlite3_bind_text(statement, 1, user_idChar, strlen(user_idChar), NULL);
const char *screen_nameChar=[user.screen_name UTF8String];
sqlite3_bind_text(statement, 2, screen_nameChar, strlen(screen_nameChar), NULL);
const char *keyChar=[user.key UTF8String];
sqlite3_bind_text(statement, 3, keyChar, strlen(keyChar), NULL);
const char *secretChar=[user.secret UTF8String];
sqlite3_bind_text(statement, 4, secretChar, strlen(secretChar), NULL);
NSData *imageData = [[NSData alloc] initWithContentsOfURL:[NSURL URLWithString:user.profile_image_url]];
sqlite3_bind_blob(statement, 5, [imageData bytes], [imageData length], NULL);
if(sqlite3_step(statement)==SQLITE_DONE)
{
NSLog(@"done");
}else {
NSLog(@"error");
}
sqlite3_finalize(statement);
}
[sql release];
}
[self closeDatabase];
return sucess;
}
//获取用户记录列表
-(NSMutableArray *)getUserList
{
NSMutableArray *list;
BOOL sucess=[self openDatabase];
if (sucess) {
NSString *query=@"select * from loginUser";
sqlite3_stmt *statement;
if (sqlite3_prepare_v2(database, [query UTF8String], -1, &statement, nil)==SQLITE_OK)
{
list=[[[NSMutableArray alloc] init]autorelease];
while (sqlite3_step(statement)==SQLITE_ROW) {
char *user_idChar=(char *)sqlite3_column_text(statement, 0);
char *screen_nameChar=(char *)sqlite3_column_text(statement, 1);
char *keyChar=(char *)sqlite3_column_text(statement, 2);
char *secretChar=(char *)sqlite3_column_text(statement, 3);
int bytes = sqlite3_column_bytes(statement, 4);
const void *value = sqlite3_column_blob(statement, 4);
NSString *user_id=[[NSString alloc] initWithUTF8String:user_idChar];
NSString *screen_name=[[NSString alloc] initWithUTF8String:screen_nameChar];
NSString *key=[[NSString alloc] initWithUTF8String:keyChar];
NSString *secret=[[NSString alloc] initWithUTF8String:secretChar];
UIImage *icon;
if( value != NULL && bytes != 0 ){
NSData *data = [NSData dataWithBytes:value length:bytes];
icon=[UIImage imageWithData:data];
}
User *user=[[User alloc] init];
user.userId=user_id;
user.name=screen_name;
user.key=key;
user.secret=secret;
if (icon) {
user.icon=icon;
}
[list addObject:user];
[user release];
[user_id release];
[screen_name release];
[key release];
[secret release];
}
sqlite3_finalize(statement);
}
}
[self closeDatabase];
return list;
}
//根据是否已经存在数据库决定是否要创建数据库
-(void)createDatabaseIfNeeded:(NSString *)filename
{
NSAutoreleasePool *pool=[[NSAutoreleasePool alloc] init];
NSFileManager *filemanage=[NSFileManager defaultManager];
NSArray *paths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsDirectory=[paths objectAtIndex:0];
NSString *writableDBPath=[documentsDirectory stringByAppendingPathComponent:filename];
BOOL sucess=[filemanage fileExistsAtPath:writableDBPath];
if (sucess) {
return;
}
NSString *defaultDBPath=[[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:filename];
NSError *error;
sucess=[filemanage copyItemAtPath:defaultDBPath toPath:writableDBPath error:&error];
if (!sucess) {
NSLog(@"create Database rror:%@",[error localizedDescription]);
}
[pool release];
}
//获取数据库文件路径
-(NSString *)dataFilePath
{
NSArray *paths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentPath=[[paths objectAtIndex:0] stringByAppendingPathComponent:@"weibo.sqlite"];
return documentPath;
}
//打开数据库
-(BOOL)openDatabase
{
int returnValue=sqlite3_open([[self dataFilePath] UTF8String], &database);
if (returnValue!=SQLITE_OK) {
sqlite3_close(database);
NSLog(@"open Database error:%@",sqlite3_errmsg(database));
return NO;
}else {
return YES;
}
}
//关闭数据库
-(void)closeDatabase
{
if (sqlite3_close(database)!=SQLITE_OK) {
NSLog(@"close Database error:%@",sqlite3_errmsg(database));
}
}
@end
七、在工程中添加类型为Objective-C class名为Global的类用来提供一些非常常用的公用方法。
八、打开Global.h添加如下代码，声明了2个方法，一个是获取png的图片资源、另外一个是进行时间格式化输出的方法，这2个方法都是被声明成+类型，这样方便使用,这2个方法在后面篇章中经常会用到。
#import <Foundation/Foundation.h>
@interface Global : NSObject
+(UIImage *) pngWithPath:(NSString *)path;
+(NSString *) dateInFormat: (time_t)dateTime format:(NSString*) stringFormat;
@end
九、打开Global.m添加如下代码
#import "Global.h"
@implementation Global
+(UIImage *) pngWithPath:(NSString *)path
{
NSString *fileLocation = [[NSBundle mainBundle] pathForResource:path ofType:@"png"];
NSData *imageData = [NSData dataWithContentsOfFile:fileLocation];
UIImage *img=[UIImage imageWithData:imageData];
return img;
}
+(NSString *) dateInFormat: (time_t)dateTime format:(NSString*) stringFormat
{
char buffer[80];
const char *format = [stringFormat UTF8String];
struct tm * timeinfo;
timeinfo = localtime(&dateTime);
strftime(buffer, 80, format, timeinfo);
return [NSString stringWithCString:buffer encoding:NSUTF8StringEncoding];
}
@end
到处准备篇的工作就已经算是完成了，主要的编码工作就是sqlite的数据库操作了，在下一篇中我们会在这个基础上开始用户功能的开发。
