MBDataStore.h

浏览该文件的文档.

//
//  MBDatastore.h
//  iNaviCore
//
//  Created by renzc on 2017/8/25.
//  Copyright © 2017年 Mapbar. All rights reserved.
//

#import "MBObject.h"

@class MBDatastoreItem, MBDataUpdateTask, MBDatastore;

typedef NS_ENUM(NSInteger, MBDatastoreErrCode) {
    MBDatastoreErrCode_downloadFailed,
    MBDatastoreErrCode_createDirFailed,
    MBDatastoreErrCode_notEnoughDiskSpace,
    MBDatastoreErrCode_installFailed,
    MBDatastoreErrCode_replaceFailed
};

@protocol MBDatastoreDelegate <NSObject>
 @optional
- (void)datastoreRefreshed:(MBDatastore *)ds;
- (void)datastoreRefreshCanceled:(MBDatastore *)ds;
- (void)datastoreRefreshFailed:(MBDatastore *)ds;

- (void)datastoreDataItemQueryFileListSucceeded:(MBDatastore *)ds itemId:(NSString *)itemId andTask:(MBDataUpdateTask *)task;
- (void)datastoreDataItemQueryFileListFailed:(MBDatastore *)ds itemId:(NSString *)itemId andErrCode:(MBDatastoreErrCode)code;

- (void)datastoreDownloadingDataItemBegan:(MBDatastore *)ds itemId:(NSString *)itemId;
- (void)datastoreDownloadingDataItemProgressUpdated:(MBDatastore *)ds itemId:(NSString *)itemId withPercent:(CGFloat)percent;
- (void)datastoreDownloadingDataItemCompleted:(MBDatastore *)ds itemId:(NSString *)itemId;
- (void)datastoreDownloadingDataItemFailed:(MBDatastore *) ds itemId:(NSString *)itemId withErrCode:(MBDatastoreErrCode)code;

- (void)datastoreInstallDataItemBegan:(MBDatastore *)ds itemId:(NSString *)itemId;
//  增量更新时的安装进度
- (void)datastoreInstallDataItemProgressUpdated:(MBDatastore *) ds itemId:(NSString *)itemId withPercent:(CGFloat)percent;
- (void)datastoreInstallDataItemFinished:(MBDatastore *)ds itemId:(NSString *)itemId;
- (void)datastoreInstallDataItemFailed:(MBDatastore *)ds itemId:(NSString *)itemId withErrCode:(MBDatastoreErrCode)code;

- (void)dataItemStateChanged:(MBDatastore *)ds itemId:(NSString *)itemId;

@end

@interface MBDatastore : MBObject

@property (nonatomic, readonly, copy) NSString *serverUrl;
@property (nonatomic, readonly, copy) NSString *localDataPath;
@property (nonatomic, readonly, strong) MBDatastoreItem *root;
@property (nonatomic, readwrite, weak) id<MBDatastoreDelegate> delegate;

- (instancetype)initWithUrl:(NSString*)url localPath:(NSString*)path;
- (instancetype)initWithUrl:(NSString*)url;
- (void)setNeedsRefresh;
- (void)cancelRefreshing;
- (NSInteger)currentVersion;
- (NSInteger)latestVersion;
- (void)setDataVersion:(NSInteger) version;
// save datastore local_data.json
- (void)saveLocalDataToJson;
- (MBDataUpdateTask *)dataUpdateTaskWithId:(NSString *)itemId;
- (MBDatastoreItem *)itemWithId:(NSString *)itemId;
- (BOOL)createUpdateTaskForItem:(NSString *)itemId;
- (BOOL)resumeDataItem:(NSString *)itemId;
- (BOOL)pauseDataItem:(NSString *)itemId;
//  取消下载的临时文件夹中对应itemId的数据项，并删除
- (BOOL)cancelDataItem:(NSString *)itemId;
//  删除本地文件夹和临时文件夹对应itemId的数据项
- (void)deleteDataItem:(NSString *)itemId;
- (void)retryDataItem:(NSString *)itemId;

@end