Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(Unicode C) Wasabi File Streaming UploadSee more Wasabi ExamplesDemonstrates how to do a streaming upload from a file to the Wasabi storage service. The AWS authorization presents some difficulties when the REST request body is to be streamed from a file (or from some other source). The issue is that the SHA-256 hash of the file data must be calculated. There are only two possible ways to do this: (1) stream the file into memory in its entirety and calculate the SHA-256 hash prior to uploading, or (2) pre-calculate the SHA-256 in a streaming fashion, and then provide it to the AWS authentication object. If the application does NOT pre-compute the SHA-256, then Chilkat (internally) is forced to stream into memory, calculate the SHA-256, and then upload from the in-memory copy of the file.
#include <C_CkCrypt2W.h> #include <C_CkRestW.h> #include <C_CkAuthAwsW.h> #include <C_CkStreamW.h> void ChilkatSample(void) { HCkCrypt2W crypt; const wchar_t *fileToUploadPath; const wchar_t *hashStr; HCkRestW rest; BOOL bTls; int port; BOOL bAutoReconnect; BOOL success; HCkAuthAwsW authAws; HCkStreamW fileStream; const wchar_t *responseStr; // This example requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. // This first part is optional. AWS authentication requires // the SHA-256 hash of the request body (i.e. the contents of the file // to be uploaded). We can choose to pre-calculate the SHA-256 in a streaming fashion // and then provide it to the authenticator object. This way, if the file is // extremely large, it never needs to completely reside in memory. crypt = CkCrypt2W_Create(); // ---------------------------------------------------- // Important: Wasabi requires a lowercase hex format. // ---------------------------------------------------- CkCrypt2W_putEncodingMode(crypt,L"hex-lower"); CkCrypt2W_putHashAlgorithm(crypt,L"sha-256"); fileToUploadPath = L"qa_data/xml/hamlet.xml"; hashStr = CkCrypt2W_hashFileENC(crypt,fileToUploadPath); rest = CkRestW_Create(); // Connect to the Amazon AWS REST server. bTls = TRUE; port = 443; bAutoReconnect = TRUE; // This example will demonstrate uploading to a bucket in the eu-west-2 region success = CkRestW_Connect(rest,L"s3.eu-west-2.wasabisys.com",port,bTls,bAutoReconnect); // Provide AWS credentials for the REST call. authAws = CkAuthAwsW_Create(); CkAuthAwsW_putAccessKey(authAws,L"access-key"); CkAuthAwsW_putSecretKey(authAws,L"secret-key"); CkAuthAwsW_putServiceName(authAws,L"s3"); // Provide the pre-computed SHA-256 here: CkAuthAwsW_putPrecomputedSha256(authAws,hashStr); success = CkRestW_SetAuthAws(rest,authAws); CkRestW_AddHeader(rest,L"Expect",L"100-continue"); CkRestW_AddHeader(rest,L"Content-Type",L"application/xml"); // Set the bucket name via the HOST header. // In this case, the bucket name is "chilkat100". CkRestW_putHost(rest,L"chilkat100.s3.eu-west-2.wasabisys.com"); fileStream = CkStreamW_Create(); CkStreamW_putSourceFile(fileStream,fileToUploadPath); // Upload to the Wasabi Storage service. // If the application provided the SHA-256 hash of the file contents (as shown above) // then file is streamed and never has to completely reside in memory. // If the application did NOT provide the SHA-256, then Chilkat will (internally) // load the entire file into memory, calculate the SHA-256, and then upload. responseStr = CkRestW_fullRequestStream(rest,L"PUT",L"/hamlet.xml",fileStream); if (CkRestW_getLastMethodSuccess(rest) != TRUE) { wprintf(L"%s\n",CkRestW_lastErrorText(rest)); CkCrypt2W_Dispose(crypt); CkRestW_Dispose(rest); CkAuthAwsW_Dispose(authAws); CkStreamW_Dispose(fileStream); return; } // When successful, the Wasabi Storage service will respond with a 200 response code, // with an XML body. if (CkRestW_getResponseStatusCode(rest) == 200) { wprintf(L"%s\n",responseStr); wprintf(L"File uploaded.\n"); } else { // Examine the request/response to see what happened. wprintf(L"response status code = %d\n",CkRestW_getResponseStatusCode(rest)); wprintf(L"response status text = %s\n",CkRestW_responseStatusText(rest)); wprintf(L"response header: %s\n",CkRestW_responseHeader(rest)); wprintf(L"response body: %s\n",responseStr); wprintf(L"---\n"); wprintf(L"LastRequestStartLine: %s\n",CkRestW_lastRequestStartLine(rest)); wprintf(L"LastRequestHeader: %s\n",CkRestW_lastRequestHeader(rest)); } CkCrypt2W_Dispose(crypt); CkRestW_Dispose(rest); CkAuthAwsW_Dispose(authAws); CkStreamW_Dispose(fileStream); } |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.