VdiskSDK-iOS

请先前往 微盘开发者中心 注册为微盘开发者, 并创建应用.

RESTful API文档: http://vdisk.weibo.com/developers/index.php?module=api&action=apidoc

关于微盘OPENAPI、SDK使用以及技术问题请联系: @一个开发者 @Littlebox222

QQ群: 134719337、162285095

邮箱: [email protected]

---

Usage

包含头文件: #import "VdiskSDK.h"

---

• 登录认证相关

---

• 实例化VdiskSession

VdiskSession *session = [[VdiskSession alloc] initWithAppKey:@"你的微盘AppKey" 
                                                   appSecret:@"你的微盘AppSecret" 
                                                     appRoot:@"sandbox"];
session.delegate = self;
[session setRedirectURI:@"http://OAuth2回调地址"];
[VdiskSession setSharedSession:[session autorelease]];

• 判断是否已登录, 如果没有, 则授权并登录

if (![[VdiskSession sharedSession] isLinked]) {

    [[VdiskSession sharedSession] link];
}

• 实现VdiskSessionDelegate

#pragma mark -
#pragma mark VdiskSessionDelegate methods

/* When you use the VdiskSession's request methods,
 you may receive the following 7 callbacks. */

//发现已经登录了，不必再次登录
- (void)sessionAlreadyLinked:(VdiskSession *)session {

    NSLog(@"sessionAlreadyLinked");
}

// Log in successfully.
- (void)sessionLinkedSuccess:(VdiskSession *)session {

    NSLog(@"sessionLinkedSuccess: %@", session.userID);
  
}

//log fail
- (void)session:(VdiskSession *)session didFailToLinkWithError:(NSError *)error {

    NSLog(@"didFailToLinkWithError:%@", error);
}

// Log out successfully.
- (void)sessionUnlinkedSuccess:(VdiskSession *)session {

    NSLog(@"sessionUnlinkedSuccess");
}

//调用接口的时候，发现没有登录，会调用此方法
- (void)sessionNotLink:(VdiskSession *)session {

    NSLog(@"sessionNotLink");
}

// access_token超过有效期会调用此方法
- (void)sessionExpired:(VdiskSession *)session {
    
    NSLog(@"sessionExpired");
   // [session refreshLink];
}

---

• 接口调用 ==========

• 上传文件

---

• 实例化VdiskRestClient

_vdiskRestClient = [[VdiskRestClient alloc] initWithSession:[VdiskSession sharedSession]];
_vdiskRestClient.delegate = self;

• 调用上传方法

[_vdiskRestClient uploadFile:@"要保存的文件名" 
                      toPath:@"目标路径(不含文件名)" 
               withParentRev:nil 
                    fromPath:@"本地文件全路径"];

• 实现上传相关的VdiskRestClientDelegate

#pragma mark - VdiskRestClientDelegate

//处理上传成功后的工作
- (void)restClient:(VdiskRestClient *)client uploadedFile:(NSString *)destPath from:(NSString *)srcPath metadata:(VdiskMetadata *)metadata {

    UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"Upload success!" message:@"Please look at the metadata object" delegate:nil cancelButtonTitle:@"Okay" otherButtonTitles:nil];
    
    [alertView show];
    [alertView release];
    
    [_uploadButton setEnabled:YES];
    [_uploadButton setTitle:@"Select a photo to upload" forState:UIControlStateNormal];
    
    //delete tmp file, 如果有必要的话
    [[NSFileManager defaultManager] removeItemAtPath:srcPath error:nil];
}

//更新进度
- (void)restClient:(VdiskRestClient *)client uploadProgress:(CGFloat)progress forFile:(NSString *)destPath from:(NSString *)srcPath {

    [_progressLabel setHidden:NO];
    [_progressView setHidden:NO];
    
    [_progressView setProgress:progress];
    _progressLabel.text = [NSString stringWithFormat:@"%.1f%%", progress*100.0f];
}

//处理上传失败后的工作
- (void)restClient:(VdiskRestClient *)client uploadFileFailedWithError:(NSError *)error {
    
    UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"ERROR!!" 
                                                        message:[NSString stringWithFormat:@"Error!\nerrno:%d\n%@\%@\n", 
                                                                                           error.code, 
                                                                                           error.localizedDescription, 
                                                                                           [error userInfo]] 
                                                       delegate:nil 
                                              cancelButtonTitle:@"Okay" 
                                              otherButtonTitles:nil];
    
    [alertView show];
    [alertView release];
    
    [_uploadButton setEnabled:YES];
    [_uploadButton setTitle:@"Select a photo to upload" forState:UIControlStateNormal];
       
    //delete tmp file, 如果有必要的话
    [[NSFileManager defaultManager] removeItemAtPath:[error.userInfo objectForKey:@"sourcePath"] error:nil];
}

• 获得文件信息、文件列表

---

• • [VdiskRestClient loadMetadata:(NSString *)path]

[_restClient loadMetadata:@"/path/to/folder"]; //获得目录信息
[_restClient loadMetadata:@"/path/to/file"];   //获得文件信息

• 实现VdiskRestClientDelegate

#pragma mark - VdiskRestClientDelegate

- (void)restClient:(VdiskRestClient *)client loadedMetadata:(VdiskMetadata *)metadata {
    
    NSLog(@"path:%@", metadata.path);
    NSLog(@"filename:%@", metadata.filename);

    if ([metadata isDirectory]) {

        self.listData = metadata.contents;
        [self.tableView reloadData];
        
    } else {
    
        NSLog(@"humanReadableSize:%@", metadata.humanReadableSize);
        NSLog(@"totalBytes:%@", metadata.totalBytes);
    }  
}

- (void)restClient:(VdiskRestClient *)client metadataUnchangedAtPath:(NSString *)path {
    
    [self.tableView reloadData];
}

- (void)restClient:(VdiskRestClient *)client loadMetadataFailedWithError:(NSError *)error {
    
    NSLog(@"%@", error);
}