| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697 |
- //
- // GetBucket.h
- // GetBucket
- //
- // Created by tencent
- // Copyright (c) 2015年 tencent. All rights reserved.
- //
- // ██████╗ ██████╗██╗ ██████╗ ██╗ ██╗██████╗ ████████╗███████╗██████╗ ███╗ ███╗██╗███╗ ██╗ █████╗ ██╗ ██╗ █████╗ ██████╗
- // ██╔═══██╗██╔════╝██║ ██╔═══██╗██║ ██║██╔══██╗ ╚══██╔══╝██╔════╝██╔══██╗████╗ ████║██║████╗ ██║██╔══██╗██║ ██║ ██╔══██╗██╔══██╗
- // ██║ ██║██║ ██║ ██║ ██║██║ ██║██║ ██║ ██║ █████╗ ██████╔╝██╔████╔██║██║██╔██╗ ██║███████║██║ ██║ ███████║██████╔╝
- // ██║▄▄ ██║██║ ██║ ██║ ██║██║ ██║██║ ██║ ██║ ██╔══╝ ██╔══██╗██║╚██╔╝██║██║██║╚██╗██║██╔══██║██║ ██║ ██╔══██║██╔══██╗
- // ╚██████╔╝╚██████╗███████╗╚██████╔╝╚██████╔╝██████╔╝ ██║ ███████╗██║ ██║██║ ╚═╝ ██║██║██║ ╚████║██║ ██║███████╗ ███████╗██║ ██║██████╔╝
- // ╚══▀▀═╝ ╚═════╝╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝╚═╝ ╚═╝╚══════╝ ╚══════╝╚═╝ ╚═╝╚═════╝
- //
- //
- // _ __ _ _
- // (_) / _| | | | |
- // ___ ___ _ ____ ___ ___ ___ | |_ ___ _ __ __| | _____ _____| | ___ _ __ ___ _ __ ___
- // / __|/ _ \ '__\ \ / / |/ __/ _ \ | _/ _ \| '__| / _` |/ _ \ \ / / _ \ |/ _ \| '_ \ / _ \ '__/ __|
- // \__ \ __/ | \ V /| | (_| __/ | || (_) | | | (_| | __/\ V / __/ | (_) | |_) | __/ | \__
- // |___/\___|_| \_/ |_|\___\___| |_| \___/|_| \__,_|\___| \_/ \___|_|\___/| .__/ \___|_| |___/
- // ______ ______ ______ ______ ______ ______ ______ ______ | |
- // |______|______|______|______|______|______|______|______| |_|
- //
- #import <Foundation/Foundation.h>
- #import <QCloudCore/QCloudCore.h>
- #import "QCloudListBucketResult.h"
- NS_ASSUME_NONNULL_BEGIN
- /**
- 查询存储桶（Bucket) 下的部分或者全部对象的方法.
- COS 支持列出指定 Bucket 下的部分或者全部对象.
- 每次默认返回的最大条目数为 1000 条.
- 如果无法一次返回所有的对象，则返回结果中的 IsTruncated 为 true，同时会附加一个 NextMarker 字段，提示下 一个条目的起点.
- 若一次请求，已经返回了全部对象，则不会有 NextMarker 这个字段，同时 IsTruncated 为 false.
- 若把 prefix 设置为某个文件夹的全路径名，则可以列出以此 prefix 为开头的文件，即该文件 夹下递归的所有文件和子文件夹.
- 如果再设置 delimiter 定界符为 “/”，则只列出该文件夹下的文件，子文件夹下递归的文件和文件夹名 将不被列出.而子文件夹名将会以 CommonPrefix 的形式给出.
- 关于查询Bucket 下的部分或者全部对象接口的具体描述，请查看https://cloud.tencent.com/document/product/436/7734.
- cos iOS SDK 中查询 Bucket 下的部分或者全部对象的方法具体步骤如下：
- 1. 实例化 QCloudGetBucketRequest，填入需要的参数。
- 2. 调用 QCloudCOSXMLService 对象中的 GetBucket 方法发出请求。
- 3. 从回调的 finishBlock 中的 QCloudListBucketResult 获取具体内容。
- 示例：
- @code
- QCloudGetBucketRequest* request = [QCloudGetBucketRequest new];
- request.bucket = @“testBucket-123456789”; //存储桶名称(cos v5 的 bucket格式为：xxx-appid, 如 test-1253960454)
- request.maxKeys = 1000;
- [request setFinishBlock:^(QCloudListBucketResult * result, NSError* error) {
- //additional actions after finishing
- }];
- [[QCloudCOSXMLService defaultCOSXML] GetBucket:request];
- @endcode
- */
- @interface QCloudGetBucketRequest : QCloudBizHTTPRequest
- /**
- 存储桶名
- */
- @property (strong, nonatomic) NSString *bucket;
- /**
- 前缀匹配，用来规定返回的文件前缀地址
- */
- @property (strong, nonatomic) NSString *prefix;
- /**
- 定界符为一个符号，如果有 Prefix，则将 Prefix 到 delimiter 之间的相同路径归为一类，定义为 Common Prefix，然后列出所有 Common Prefix。如果没有 Prefix，则从路径起点开始
- */
- @property (strong, nonatomic) NSString *delimiter;
- /**
- 规定返回值的编码方式，可选值:url
- */
- @property (strong, nonatomic) NSString *encodingType;
- /**
- 默认以UTF-8二进制顺序列出条目，所有列出条目从marker开始
- */
- @property (strong, nonatomic) NSString *marker;
- /**
- 单次返回的最大条目数量，默认1000
- */
- @property (assign, nonatomic) int maxKeys;
- - (void) setFinishBlock:(void (^)(QCloudListBucketResult* result, NSError * error))QCloudRequestFinishBlock;
- @end
- NS_ASSUME_NONNULL_END
|
