// 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 OBSSetObjectACLModel_h
#define OBSSetObjectACLModel_h
#import "OBSBaseModel.h"
#import "OBSBaseNetworking.h"
#import "OBSClient.h"
#import "OBSServiceBaseModel.h"
#import "OBSServiceCommonEntities.h"


#pragma mark - request

/**
 设置对象访问策略
 */
@protocol OBSSetObjectACLProtocol
@required

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

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

/**
 多版本ID
 */
@property (nonatomic, strong, nonnull) NSString *versionID;

/**
 访问策略
 */
//@property (nonatomic, strong, nonnull) OBSAccessControlPolicy *accessControlPolicy;
@end


/**
 设置对象访问策略request
 */
@interface OBSSetObjectACLRequest: OBSBaseRequest<OBSSetObjectACLProtocol>

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

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

/**
 对象多版本ID
 */
@property (nonatomic, strong, nonnull) NSString *versionID;

/**
 访问权限控制
 */
@property (nonatomic, strong, nonnull) OBSAccessControlPolicy *accessControlPolicy;

/**
 初始化设置对象访问策略 request

 @param bucketName 桶名
 @param objectKey 对象key
 @param accessControlPolicy 访问权限控制
 @return 设置对象访问策略 request
 */
-(instancetype)initWithBucketName:(NSString*) bucketName objectKey:(NSString*) objectKey accessControlPolicy:(OBSAccessControlPolicy*) accessControlPolicy;
@end

/**
 预定义头域设置桶访问策略       //**添加了以头域方式对已存在对象设置ACL的方式
 */
@interface OBSSetObjectACLWithCannedACLRequest: OBSBaseRequest<OBSSetObjectACLProtocol>

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

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

/**
 对象多版本ID
 */
@property (nonatomic, strong, nonnull) NSString *versionID;

/**
 ACL种类
 
 OBSACLPolicyPrivate 桶或对象的所有者拥有完全控制的权限，其他任何人都没有访问权限,
 OBSACLPolicyPublicRead 桶或对象的所有者拥有完全控制的权限，其他所有用户包括匿名用户拥有读的权限,
 OBSACLPolicyPublicReadWrite 桶或对象的所有者拥有完全控制的权限，其他所有用户包括匿名用户拥有读和写的权限,
 OBSACLPolicyAuthenticatedRead 桶或对象的所有者拥有完全控制的权限，其他OBS授权用户拥有读权限,
 OBSACLPolicyBucketOwnerRead 对象的所有者拥有完全控制的权限，桶的所有者拥有只读的权限,
 OBSACLPolicyBucketOwnerFullControl 对象的所有者拥有完全控制的权限，桶的所有者拥有完全控制的权限,
 OBSACLPolicyLogDeliveryWrite 日志投递用户组拥有对桶的写权限以及读 ACP的权限,
 */
@property (nonatomic, assign) OBSACLPolicy cannedACL;

/**
 初始化预定义设置桶访问策略 request
 
 @param bucketName 桶名
 @param cannedACL 预定义策略对象
 @return 预定义设置桶策略 request
 
 */
-(instancetype)initWithBucketName:(NSString*) bucketName objectKey:(NSString*) objectKey cannedACL:(OBSACLPolicy) cannedACL;
@end

#pragma mark - networking request
@interface OBSSetObjectACLRequestNetworking : OBSServiceNetworkingCommandRequest
@end

    //response
#pragma mark - response

/**
 设置对象访问策略response
 */
@interface OBSSetObjectACLResponse: OBSServiceResponse

/**
 版本ID
 */
@property (nonatomic, strong, nonnull) NSString *versionID;
@end


#pragma mark - client method
@interface OBSClient(setObjectACL)

/**
 设置对象的ACL

 @param request 设置对象访问策略 request
 @param completionHandler 设置对象访问策略回调
 @return OBSBFTask
 */
- (OBSBFTask*)setObjectACL:(__kindof OBSBaseRequest<OBSSetObjectACLProtocol>*)request
                 completionHandler:(void (^)(OBSSetObjectACLResponse  * response, NSError * error))completionHandler;
@end


#endif  /* OBSSetObjectACLModel_h */