#5.4.6

- Get Object Request 增加 versionID 支持 \-static_frameworks支持

Author: erichmzhang

CHANGELOG.md

@@ -1,32 +1,36 @@
+#5.4.6
+- Get Object Request 增加 versionID 支持
+-static_frameworks支持
+
 #5.4.5
 - 修复一些 Crash
-    
+
 # 5.4.4
 - QCloudCOSXMLService 中封装了一些常用接口
 - 修复了对于中文路径，并且路径中带/结尾时签名不正确的问题
 - 修复了多版本相关接口里的问题
 - 修复了分片上传 Resume 时，如果路径不在沙盒中会失败的问题
 - 修复了与 FCUUID 冲突的问题
-    
+
 #5.4.3
 - 修复Copy接口中，source为中文时会导致403的问题
-    
+
 # 5.4.2
 - 修复了返回数组类型的属性，如果数组内容只有一个时候会解析失败的问题。
-    
+
 # 5.4.1
 - 修复了 XML 中以 / 结尾的 Object 会403的的问题。
-    
+
 # 5.4.0
-- 修复了iOS8上面首次上传失败的问题 
+- 修复了iOS8上面首次上传失败的问题
 - 修复了反复多次调用分块复制接口会Crash的问题
-    
+
 # 5.3.4
 - 修复了 GetBucket 时，无法正确获得 Common Prefix 的 BUG。
-    
+
 # 5.3.2
 - 修复了签名时取到的某些头部可能会变更的问题
-    
+
 # 5.3.0
 - 增加了生成预签名 URL 的接口。
 - 增加列出指定前缀 Object 所有版本的接口。
@@ -37,25 +41,24 @@
 - 针对弱网络情况进行优化，大幅度提高弱网络情况下上传成功率。
 - 修复分块 Copy 大文件的问题。
 - 签名计算时支持自定义开始和结束时间。
-    
+
 # 5.2.0
 - 增加了精简版的SDK，只支持上传下载功能。
 - BucketName概念统一。
 - 支持查看Response中原始的HTTP Response内容。
 - 其它一些BUG修复与性能优化。
-    
+
 # 5.1.3
 - BucketName概念统一。
-    
+
 # 5.1.2    
 - 修复C++混编情况下的问题
-    
+
 # 5.1.1
 - 修复了一些问题
-    
+
 # 5.1.0
 - 增加了LifeCycle相关接口。
 - 增加了Copy Object的接口。
 - 分块上传初始化时，返回resumeData，方便异常情况中断后的续传。
 - 其它一些优化。
-    

QCloudCOSXML.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = "QCloudCOSXML"
-s.version              = "5.4.5"
+s.version              = "5.4.6"
   s.summary          = "QCloudCOSXML 腾讯云iOS-SDK组件"
 
   s.homepage         = "https://cloud.tencent.com/"
@@ -9,12 +9,12 @@ s.version              = "5.4.5"
   s.source           = { :git => "https://github.com/tencentyun/qcloud-sdk-ios.git", :tag => s.version.to_s }
   s.ios.deployment_target = '8.0'
   s.source_files = 'QCloudCOSXML/Classes/**/*'
-  s.dependency "QCloudCore",'5.4.5'
+  s.dependency "QCloudCore",'5.4.6'
   s.static_framework = true
 
   s.subspec 'Transfer' do |sbt|
     sbt.source_files = 'QCloudCOSXML/Classes/Transfer/*','QCloudCOSXML/Classes/Base/*'
-    sbt.dependency "QCloudCore",'5.4.5'
+    sbt.dependency "QCloudCore",'5.4.6'
  #   sbt.static_framework=true
   end
 end

QCloudCOSXML/Classes/Base/NSString+RegularExpressionCategory.h

@@ -0,0 +1,12 @@
+//
+//  NSString+RegularExpressionCategory.h
+//  QCloudCOSXML
+//
+//  Created by erichmzhang(张恒铭) on 29/06/2018.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface NSString (RegularExpressionCategory)
+- (BOOL) matchesRegularExpression:(NSString *)regularExpression;
+@end

QCloudCOSXML/Classes/Base/NSString+RegularExpressionCategory.m

@@ -0,0 +1,15 @@
+//
+//  NSString+RegularExpressionCategory.m
+//  QCloudCOSXML
+//
+//  Created by erichmzhang(张恒铭) on 29/06/2018.
+//
+
+#import "NSString+RegularExpressionCategory.h"
+
+@implementation NSString (RegularExpressionCategory)
+- (BOOL) matchesRegularExpression:(NSString *)regularExpression {
+    NSPredicate *predicate = [NSPredicate predicateWithFormat:@"SELF MATCHES %@",regularExpression];
+    return [predicate evaluateWithObject:self];
+}
+@end

QCloudCOSXML/Classes/Base/QCloudCOSXMLEndPoint.m

@@ -7,7 +7,7 @@
 //
 
 #import "QCloudCOSXMLEndPoint.h"
-
+#import "NSString+RegularExpressionCategory.h"
 @implementation QCloudCOSXMLEndPoint
 
 - (instancetype) init
@@ -56,12 +56,33 @@ - (NSURL*) serverURLWithBucket:(NSString *)bucket appID:(NSString *)appID
     if (!self.useHTTPS) {
         scheme = @"http";
     }
+    static NSString *regularExpression = @"[a-zA-Z0-9.-]*";
+    BOOL isLegal = [bucket matchesRegularExpression:regularExpression];
+    NSAssert(isLegal, @"bucket name contains illegal character! It can only contains a-z, A-Z, 0-9, '.' and '-' ");
+    if (!isLegal) {
+        QCloudLogDebug(@"bucket %@ contains illeagal character, building service url pregress  returns immediately", bucket);
+        return  nil;
+    }
+
     NSString* formattedRegionName = [self formattedRegionName:self.regionName];
     NSString* formattedBucketName = [self formattedBucket:bucket withAPPID:appID];
     NSURL* serverURL = [NSURL URLWithString:[NSString stringWithFormat:@"%@://%@-%@.%@.%@",scheme,formattedBucketName,appID,formattedRegionName,self.serviceName]];
     return serverURL;
 }
 
+- (void)setRegionName:(QCloudRegion)regionName {
+    //Region 仅允许由 a-z, A-Z, 0-9, 英文句号. 和 - 构成。
+    NSParameterAssert(regionName);
+    static NSString *regularExpression = @"[a-zA-Z0-9.-]*";
+    BOOL isLegal = [regionName matchesRegularExpression:regularExpression];
+    NSAssert(isLegal, @"Region name contains illegal character! It can only contains a-z, A-Z, 0-9, '.' and '-' ");
+    if (!isLegal) {
+        QCloudLogDebug(@"Region %@ contains illeagal character, setter returns immediately", regionName);
+        return ;
+    }
+    _regionName = regionName;
+}
+
 - (id)copyWithZone:(NSZone *)zone {
     QCloudCOSXMLEndPoint* endpoint = [super copyWithZone:nil];
     endpoint.regionName = self.regionName;

QCloudCOSXML/Classes/Manager/QCloudGetObjectACLRequest.h

@@ -64,6 +64,10 @@ request.object = @"objectName";
  对象名
 */
 @property (strong, nonatomic) NSString *object;
+/**
+  指定多版本中的 Version ID
+*/
+@property (strong, nonatomic) NSString *versionID;
 
 
 - (void) setFinishBlock:(void (^)(QCloudACLPolicy* result, NSError * error))QCloudRequestFinishBlock;

QCloudCOSXML/Classes/Manager/QCloudGetObjectACLRequest.m

@@ -93,6 +93,9 @@ - (BOOL) buildRequestData:(NSError *__autoreleasing *)error
             return NO;
         }
     }
+    if (self.versionID) {
+        [self.requestData setValue:self.versionID forHTTPHeaderField:@"x-cos-version-id"];
+    }
     self.requestData.URIMethod = @"acl";
     NSMutableArray* __pathComponents = [NSMutableArray arrayWithArray:self.requestData.URIComponents];
     if(self.object) [__pathComponents addObject:self.object];

QCloudCOSXML/Classes/QCloudCOSXMLVersion.h

@@ -6,15 +6,15 @@
 
 #ifndef QCloudCOSXMLModuleVersion_h
 #define QCloudCOSXMLModuleVersion_h
-#define QCloudCOSXMLModuleVersionNumber 504005
+#define QCloudCOSXMLModuleVersionNumber 504006
 
 //dependency
-#if QCloudCoreModuleVersionNumber != 504005
-    #error "库QCloudCOSXML依赖QCloudCore最小版本号为5.4.5，当前引入的QCloudCore版本号过低，请及时升级后使用" 
+#if QCloudCoreModuleVersionNumber != 504006 
+    #error "库QCloudCOSXML依赖QCloudCore最小版本号为5.4.6，当前引入的QCloudCore版本号过低，请及时升级后使用" 
 #endif
 
 //
 FOUNDATION_EXTERN NSString * const QCloudCOSXMLModuleVersion;
 FOUNDATION_EXTERN NSString * const QCloudCOSXMLModuleName;
 
-#endif
+#endif

QCloudCOSXML/Classes/QCloudCOSXMLVersion.m

@@ -1,5 +1,5 @@
 #import "QCloudCOSXMLVersion.h"
-NSString * const QCloudCOSXMLModuleVersion = @"5.4.5";
+NSString * const QCloudCOSXMLModuleVersion = @"5.4.6";
 NSString * const QCloudCOSXMLModuleName = @"QCloudCOSXML";
 @interface QCloudQCloudCOSXMLLoad : NSObject
 @end
@@ -26,4 +26,4 @@ + (void) load
 #pragma clang diagnostic pop
     }
 }
-@end
+@end

QCloudCOSXML/Classes/Transfer/QCloudGetObjectRequest.h

@@ -102,6 +102,10 @@ RFC 2616 中定义的指定文件下载范围，以字节（bytes）为单位
 */
 @property (strong, nonatomic) NSString *ifNoneMatch;
 /**
+指定 Object 的 VersionID (在开启多版本的情况下)
+*/
+@property (strong, nonatomic) NSString *versionID;
+/**
 对象名
 */
 @property (strong, nonatomic) NSString *object;