OBSUploadPartModel.h 6.34 KB
// Copyright 2019 Huawei Technologies Co.,Ltd.
// Licensed under the Apache License, Version 2.0 (the "License"); you may not use
// this file except in compliance with the License.  You may obtain a copy of the
// License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software distributed
// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
// CONDITIONS OF ANY KIND, either express or implied.  See the License for the
// specific language governing permissions and limitations under the License.

#ifndef OBSUploadPartModel_h
#define OBSUploadPartModel_h
#import "OBSBaseNetworking.h"
#import "OBSClient.h"
#import "OBSServiceBaseModel.h"
#import "OBSServiceConstDefinition.h"

@class OBSAbstractEncryption;
    //request
#pragma mark - request

/**
 多段数据上传
 */
@protocol OBSUploadPartProtocol<NSObject>
@required

/**
 桶名
 */
@property (nonatomic, strong, nonnull) NSString *bucketName;

/**
 对象名
 */
@property (nonatomic, strong, nonnull) NSString *objectKey;

/**
 分段号
 */
@property (nonatomic, strong, nonnull) NSNumber *partNumber; // 1 to 10000

/**
 多段上传任务ID
 */
@property (nonatomic, strong, nonnull) NSString *uploadID;

/**
 加密方式
 */
@property (nonatomic, strong, nonnull) __kindof OBSAbstractEncryption *encryption;

/**
 上传进度
 */
@property (nonatomic, copy, nonnull) OBSNetworkingUploadProgressBlock uploadProgressBlock;
@end


/**
 多段上传父类
 */
@interface OBSAbstractUploadPartRequest : OBSBaseRequest<OBSUploadPartProtocol>

/**
 桶名
 */
@property (nonatomic, strong, nonnull) NSString *bucketName;

/**
 对象名
 */
@property (nonatomic, strong, nonnull) NSString *objectKey;

/**
 分段号
 */
@property (nonatomic, strong, nonnull) NSNumber *partNumber; // 1 to 10000

/**
 多段上传任务ID
 */
@property (nonatomic, strong, nonnull) NSString *uploadID;

/**
 加密方式
 */
@property (nonatomic, strong, nonnull) __kindof OBSAbstractEncryption *encryption;

/**
 上传进度
 */
@property (nonatomic, copy, nonnull) OBSNetworkingUploadProgressBlock uploadProgressBlock;

/**
 Content-MD5
 */
@property (nonatomic, strong, nonnull) NSString *contentMD5;
@end


/**
 多段数据上传request
 */
@interface OBSUploadPartWithDataRequest: OBSAbstractUploadPartRequest

/**
 上传的数据
 */
@property (nonatomic, strong, nonnull) NSData *uploadData;

- (void) freeUploadData;
/**
 初始化多段数据上传request

 @param bucketName 桶名
 @param objectkey 对象KEY
 @param partNumber 上传段的段号
 @param uploadID 多段上传任务ID
 @param data 上传的数据
 @return 多段数据上传request
 */
-(instancetype)initWithBucketName:(NSString*) bucketName
                        objectkey:(NSString*) objectkey
                       partNumber:(NSNumber*) partNumber
                         uploadID:(NSString*) uploadID
                       uploadData:(NSData*) data;

/**
 初始化多段数据上传request
 
 @param bucketName 桶名
 @param objectkey 对象KEY
 @param partNumber 上传段的段号
 @param uploadID 多段上传任务ID
 @param data 上传的数据URL
 @return 多段数据上传request
 */
-(instancetype)initWithBucketName:(NSString*) bucketName
                        objectkey:(NSString*) objectkey
                       partNumber:(NSNumber*) partNumber
                         uploadID:(NSString*) uploadID
                    uploadDataURL:(NSURL*) dataURL;
@end


/**
 多段文件上传request
 */
@interface OBSUploadPartWithFileRequest: OBSAbstractUploadPartRequest
/**
 上传数据
 */
@property (nonatomic, weak) __weak NSData *uploadAllData; 
@property (nonatomic, weak) __weak NSFileHandle *fileHandle;

/**
 文件路径
 */
@property (nonatomic, strong, nonnull) NSString *uploadFilePath;

/**
 开始的位置
 */
@property (nonatomic, strong, nonnull) NSNumber *bytesStart;

/**
 数据大小
 */
@property (nonatomic, strong, nonnull) NSNumber *bytesLength;

/**
 是否后台上传
 */
@property (nonatomic, assign) BOOL background;

@property (nonatomic, strong) OBSUploadPartWithDataRequest * dataRequest;


@property (nonatomic, strong) OBSBaseNetworkingRequest * dataRequest1;


/**
 初始化多段文件上传request

 @param bucketName 桶名
 @param objectkey 对象KEY
 @param partNumber 上传段的段号
 @param uploadID 多段上传任务ID
 @param uploadFilePath 文件路径
 @return 多段文件上传request
 */
-(instancetype)initWithBucketName:(NSString*) bucketName
                        objectkey:(NSString*) objectkey
                       partNumber:(NSNumber*) partNumber
                         uploadID:(NSString*) uploadID
                   uploadFilePath:(NSString*) uploadFilePath;

/**
 初始化多段文件上传request

 @param bucketName 桶名
 @param objectkey 对象KEY
 @param partNumber 上传段的段号
 @param uploadID 多段上传任务ID
 @param uploadFilePath 文件路径
 @param bytestStart 开始位置
 @param bytestLength 文件大小
 @return 多段文件上传request
 */
-(instancetype)initWithBucketName:(NSString*) bucketName
                        objectkey:(NSString*) objectkey
                       partNumber:(NSNumber*) partNumber
                         uploadID:(NSString*) uploadID
                   uploadFilePath:(NSString*) uploadFilePath
                       bytesStart:(NSNumber*) bytestStart // long
                      bytesLength:(NSNumber*) bytestLength; //long
@end

#pragma mark - networking request
@interface OBSNetworkingUploadPartWithDataRequest : OBSServiceNetworkingUploadDataRequest
@end

@interface OBSNetworkingUploadPartWithFileRequest : OBSServiceNetworkingUploadFileRequest
@end

    //response
#pragma mark - response

/**
 多段上传response
 */
@interface OBSUploadPartResponse: OBSServiceResponse

/**
 加密方式
 */
@property (nonatomic, strong, nonnull) __kindof OBSAbstractEncryption *encryption;

/**
 上传段的etag
 */
@property (nonatomic, strong, nonnull) NSString *etag;
@end

    //client method
#pragma mark - client method
@interface OBSClient(uploadPart)

/**
 多段上传

 @param request 多段上传request
 @param completionHandler 多段上传回调
 @return OBSBFTask
 */
- (OBSBFTask*)uploadPart:(__kindof OBSBaseRequest<OBSUploadPartProtocol>*)request
      completionHandler:(void (^)(OBSUploadPartResponse  * response, NSError * error))completionHandler;
@end

#endif /* OBSUploadPartModel_h */