add cmake options to disable a special feature.

Author: huiguangjun

README.md

@@ -116,6 +116,29 @@ cmake .. -DBUILD_TESTS=ON
 cmake .. -DENABLE_RTTI=OFF
 ```
 
+#### OSS_DISABLE_BUCKET
+(Default OFF) If turned ON, the SDK is built without the bucket's API.
+```
+cmake .. -DOSS_DISABLE_BUCKET=ON
+```
+#### OSS_DISABLE_LIVECHANNEL
+(Default OFF) If turned ON, the SDK is built without the livechannel's API.
+```
+cmake .. -DOSS_DISABLE_LIVECHANNEL=ON
+```
+
+#### OSS_DISABLE_RESUAMABLE
+(Default OFF) If turned ON, the SDK is built without the resumable operation feature.
+```
+cmake .. -DOSS_DISABLE_RESUAMABLE=ON
+```
+
+#### OSS_DISABLE_ENCRYPTION
+(Default OFF) If turned ON, the SDK is built without the client-side encryption feature.
+```
+cmake .. -DOSS_DISABLE_ENCRYPTION=ON
+```
+
 ## Use the C++ SDK
 
 The following code shows how to list buckets owned by the requester. 

README_zh.md

@@ -116,6 +116,29 @@ cmake .. -DBUILD_TESTS=ON
 cmake .. -DENABLE_RTTI=OFF
 ```
 
+#### OSS_DISABLE_BUCKET
+(默认为关，即OFF) 如果打开, 构建的库不会包含和 bucket 有关的接口.
+```
+cmake .. -DOSS_DISABLE_BUCKET=ON
+```
+#### OSS_DISABLE_LIVECHANNEL
+(默认为关，即OFF) 如果打开, 构建的库不会包含和 livechannel 有关的接口.
+```
+cmake .. -DOSS_DISABLE_LIVECHANNEL=ON
+```
+
+#### OSS_DISABLE_RESUAMABLE
+(默认为关，即OFF) 如果打开, 构建的库不会包含断点续传功能.
+```
+cmake .. -DOSS_DISABLE_RESUAMABLE=ON
+```
+
+#### OSS_DISABLE_ENCRYPTION
+(默认为关，即OFF) 如果打开, 构建的库不会包含客户端加密功能.
+```
+cmake .. -DOSS_DISABLE_ENCRYPTION=ON
+```
+
 ## 如何使用 C++ SDK
 
 以下代码展示了如何获取请求者拥有的Bucket。

sample/CMakeLists.txt

@@ -16,13 +16,22 @@
 project(cpp-sdk-sample VERSION ${version})
 
 file(GLOB sample_src "src/*")
+
+if (NOT OSS_DISABLE_BUCKET)
 file(GLOB sample_service_src "src/service/*")
 file(GLOB sample_bucket_src "src/bucket/*")
+endif()
+
 file(GLOB sample_object_src "src/object/*")
 file(GLOB sample_presignedurl_src "src/presignedurl/*")
+
+if (NOT OSS_DISABLE_LIVECHANNEL)
 file(GLOB sample_livechannel_src "src/LiveChannel/*")
-file(GLOB sample_encryption_src "src/encryption/*")
+endif()
 
+if (NOT OSS_DISABLE_ENCRYPTION)
+file(GLOB sample_encryption_src "src/encryption/*")
+endif()
 
 add_executable(${PROJECT_NAME} 
 	${sample_src} 

sample/src/LiveChannel/LiveChannelSample.cc

@@ -23,23 +23,14 @@ static void waitTimeinSec(int time)
 LiveChannelSample::LiveChannelSample(const std::string& bucket, const std::string& channelName):bucket_(bucket),channelName_(channelName),
     timeStart_(0),timeEnd_(0),isSuccess_(false)
 {
-    
     ClientConfiguration conf;
     client = new OssClient(Config::Endpoint, Config::AccessKeyId, Config::AccessKeySecret, conf);
-    CreateBucketRequest request(bucket_);
-    client->CreateBucket(request);
+    //CreateBucketRequest request(bucket_);
+    //client->CreateBucket(request);
 }
 
 LiveChannelSample::~LiveChannelSample()
 {
-    DeleteBucketRequest request(bucket_);
-    auto deleteOutcome = client->DeleteBucket(request);
-
-    if(!deleteOutcome.isSuccess())
-    {
-        std::cerr<<"delete bucket "+bucket_+" fail";
-    }
-
     if(nullptr != client)
     {
         delete client;

sample/src/Program.cc

@@ -1,13 +1,22 @@
 #include <alibabacloud/oss/OssClient.h>
 #include <iostream>
 #include "Config.h"
+
+#if !defined(OSS_DISABLE_BUCKET)
 #include "service/ServiceSample.h"
 #include "bucket/BucketSample.h"
+#endif
+
 #include "object/ObjectSample.h"
 #include "presignedurl/PresignedUrlSample.h"
+
+#if !defined(OSS_DISABLE_LIVECHANNEL)
 #include "LiveChannel/LiveChannelSample.h"
-#include "encryption/EncryptionSample.h"
+#endif
 
+#if !defined(OSS_DISABLE_ENCRYPTION)
+#include "encryption/EncryptionSample.h"
+#endif
 
 using namespace AlibabaCloud::OSS;
 
@@ -29,6 +38,7 @@ int main(void)
     SetLogLevel(LogLevel::LogDebug);
     SetLogCallback(LogCallbackFunc);
 
+#if !defined(OSS_DISABLE_BUCKET)
     ServiceSample serviceSample;
     serviceSample.ListBuckets();
     serviceSample.ListBucketsWithMarker();
@@ -50,11 +60,6 @@ int main(void)
     bucketSample.DeleteBucketLifecycle();
     bucketSample.DeleteBucketCors();
 
-
-    bucketSample.ListObjects();
-    bucketSample.ListObjectWithMarker();
-    bucketSample.ListObjectWithEncodeType();
-
     bucketSample.GetBucketAcl();
     bucketSample.GetBucketLocation();
     bucketSample.GetBucketLogging();
@@ -63,12 +68,9 @@ int main(void)
     bucketSample.GetBucketStat();
     bucketSample.GetBucketLifecycle();
     //bucketSample.DeleteBucketsByPrefix();
-
+#endif
 
     ObjectSample objectSample(bucketName);
-    objectSample.UploadObjectProgress();
-    objectSample.MultiCopyObjectProcess();
-    objectSample.DownloadObjectProcess();
     objectSample.PutObjectFromBuffer();
     objectSample.PutObjectFromFile();
     objectSample.GetObjectToBuffer();
@@ -85,13 +87,25 @@ int main(void)
     objectSample.CopyObject();
     //objectSample.RestoreArchiveObject("your-archive", "oss_archive_object.PNG", 1);
 
+    objectSample.ListObjects();
+    objectSample.ListObjectWithMarker();
+    objectSample.ListObjectWithEncodeType();
+
+#if !defined(OSS_DISABLE_RESUAMABLE)
+    objectSample.UploadObjectProgress();
+    objectSample.MultiCopyObjectProcess();
+    objectSample.DownloadObjectProcess();
+#endif
+
     PresignedUrlSample signedUrlSample(bucketName);
     signedUrlSample.GenGetPresignedUrl();
     signedUrlSample.PutObjectByUrlFromBuffer();
     signedUrlSample.PutObjectByUrlFromFile();
     signedUrlSample.GetObjectByUrlToBuffer();
     signedUrlSample.GetObjectByUrlToFile();
 
+
+#if !defined(OSS_DISABLE_LIVECHANNEL)
     // LiveChannel
     LiveChannelSample liveChannelSample(bucketName, "test_channel");
     liveChannelSample.PutLiveChannel();
@@ -103,16 +117,21 @@ int main(void)
     liveChannelSample.GetVodPlayList();
     liveChannelSample.PutLiveChannelStatus();
     liveChannelSample.DeleteLiveChannel();
+#endif
 
+#if !defined(OSS_DISABLE_ENCRYPTION)
     // Encryption
     EncryptionSample encryptionSample(bucketName);
     encryptionSample.PutObjectFromBuffer();
     encryptionSample.PutObjectFromFile();
     encryptionSample.GetObjectToBuffer();
     encryptionSample.GetObjectToFile();
+#if !defined(DISABLE_RESUAMABLE)
     encryptionSample.UploadObjectProgress();
     encryptionSample.DownloadObjectProcess();
     encryptionSample.MultipartUploadObject();
+#endif
+#endif
 
     ShutdownSdk();
     return 0;

sample/src/bucket/BucketSample.cc

@@ -258,75 +258,6 @@ void BucketSample::DeleteBucketCors()
     }
 }
 
-void BucketSample::ListObjects()
-{
-    ListObjectsRequest request(bucket_);
-    auto outcome = client->ListObjects(request);
-    if (outcome.isSuccess()) {
-        std::cout << __FUNCTION__ << " success " << 
-            "and object count is " << outcome.result().ObjectSummarys().size() << std::endl;
-    }
-    else {
-        PrintError(__FUNCTION__, outcome.error());
-    }
-}
-
-void BucketSample::ListObjectWithMarker()
-{
-    ListObjectsRequest request(bucket_);
-    request.setMaxKeys(1);
-    bool IsTruncated = false;
-    size_t total = 0;
-    do {
-        auto outcome = client->ListObjects(request);
-
-        if (outcome.isSuccess()) {
-            std::cout << __FUNCTION__ << " success, " <<
-                "and object count is " << outcome.result().ObjectSummarys().size() <<
-                "next marker is " << outcome.result().NextMarker() << std::endl;
-            total += outcome.result().ObjectSummarys().size();
-        }
-        else {
-            PrintError(__FUNCTION__, outcome.error());
-            break;
-        }
-
-        request.setMarker(outcome.result().NextMarker());
-        IsTruncated = outcome.result().IsTruncated();
-    } while (IsTruncated);
-
-    std::cout << __FUNCTION__ << " done, and total is " << total << std::endl;
-}
-
-void BucketSample::ListObjectWithEncodeType()
-{
-    ListObjectsRequest request(bucket_);
-    request.setEncodingType("url");
-    bool IsTruncated = false;
-    size_t total = 0;
-    request.setMaxKeys(1);
-    ListObjectOutcome outcome;
-    do {
-        outcome = client->ListObjects(request);
-
-        if (outcome.isSuccess()) {
-            std::cout << __FUNCTION__ << " success, " <<
-                "and object count is " << outcome.result().ObjectSummarys().size() <<
-                "next marker is " << outcome.result().NextMarker() << std::endl;
-            total += outcome.result().ObjectSummarys().size();
-        }
-        else {
-            PrintError(__FUNCTION__, outcome.error());
-            break;
-        }
-
-        request.setMarker(outcome.result().NextMarker());
-        IsTruncated = outcome.result().IsTruncated();
-    } while (IsTruncated);
-
-    std::cout << __FUNCTION__ << " done, and total is " << total << std::endl;
-}
-
 void BucketSample::GetBucketAcl()
 {
     GetBucketAclRequest request(bucket_);

sample/src/bucket/BucketSample.h

@@ -22,10 +22,6 @@ class BucketSample
     void DeleteBucketLifecycle();
     void DeleteBucketCors();
 
-    void ListObjects();
-    void ListObjectWithMarker();
-    void ListObjectWithEncodeType();
-
     void GetBucketAcl();
     void GetBucketLocation();
     void GetBucketLogging();

sample/src/encryption/EncryptionSample.cc

@@ -36,7 +36,7 @@ EncryptionSample::EncryptionSample(const std::string &bucket) :
     auto materials = std::make_shared<SimpleRSAEncryptionMaterials>(publicKey, privateKey);
     client = new OssEncryptionClient(Config::Endpoint, Config::AccessKeyId, Config::AccessKeySecret, 
         conf, materials, cryptoConf);
-    CreateBucketRequest request(bucket_);
+    //CreateBucketRequest request(bucket_);
 }
 
 EncryptionSample::~EncryptionSample() {
@@ -109,6 +109,7 @@ static void ProgressCallback(size_t increment, int64_t transfered, int64_t total
                  increment <<" ," << transfered << "," << total << std::endl;
 }
 
+#if !defined(DISABLE_RESUAMABLE)
 void EncryptionSample::UploadObjectProgress()
 {
     //case 1: checkpoint dir is not enabled
@@ -204,6 +205,7 @@ void EncryptionSample::DownloadObjectProcess()
         }
     }
 }
+#endif
 
 void EncryptionSample::MultipartUploadObject()
 {

sample/src/encryption/EncryptionSample.h

@@ -10,9 +10,12 @@ class EncryptionSample
     void PutObjectFromFile();
     void GetObjectToBuffer();
     void GetObjectToFile();
+    void MultipartUploadObject();
+
+#if !defined(OSS_DISABLE_RESUAMABLE)
     void UploadObjectProgress();
     void DownloadObjectProcess();
-    void MultipartUploadObject();
+#endif
 
 private:
     void PrintError(const std::string &funcName, const AlibabaCloud::OSS::OssError &error);