Go

REST Asynchronous Streaming Upload File

See more REST Examples

Demonstrates how to asynchronous streaming upload a file to cloud storage. This particular example demonstrates an upload to the Azure Cloud Storage service. The same concepts apply to S3, Google Cloud, and Google Drive. Go

    success := false

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    rest := chilkat.NewRest()

    // Connect to the Azure Storage Blob Service
    bTls := true
    port := 443
    bAutoReconnect := true
    // In this example, the storage account name is "chilkat".
    success = rest.Connect("chilkat.blob.core.windows.net",port,bTls,bAutoReconnect)
    if success != true {
        fmt.Println(rest.LastErrorText())
        rest.DisposeRest()
        return
    }

    // Provide Azure Cloud credentials for the REST call.
    azAuth := chilkat.NewAuthAzureStorage()
    azAuth.SetAccessKey("AZURE_ACCESS_KEY")
    // The account name used here should match the 1st part of the domain passed in the call to Connect (above).
    azAuth.SetAccount("chilkat")
    azAuth.SetScheme("SharedKey")
    azAuth.SetService("Blob")
    // This causes the "x-ms-version: 2021-08-06" header to be automatically added.
    azAuth.SetXMsVersion("2021-08-06")
    success = rest.SetAuthAzureStorage(azAuth)

    // Set some request headers.
    success = rest.AddHeader("x-ms-blob-content-disposition","attachment; filename=\"thisIsATest.txt\"")
    success = rest.AddHeader("x-ms-blob-type","BlockBlob")
    success = rest.AddHeader("x-ms-meta-m1","v1")
    success = rest.AddHeader("x-ms-meta-m2","v2")

    // Note: The application does not need to explicitly set the following
    // headers: x-ms-date, Authorization, and Content-Length.  These headers
    // are automatically set by Chilkat.

    sendStream := chilkat.NewStream()

    // Define the source data for the stream to be a file.
    sendStream.SetSourceFile("qa_data/hamlet.xml")

    // Create a background thread task to upload from the stream
    // The name of the Azure storage container is "test".
    c := make(chan *chilkat.Task)
    go rest.FullRequestStreamAsync("PUT","/test/thisIsATest.txt",sendStream,c)
    task := <-c

    // Start the task. 

    // In this example, we'll simply sleep and periodically
    // check to see if the REST upload if finished.
    curPctDone := 0
    for task.Finished() != true {
        task.SleepMs(100)
    }

    // Check to see if the call to FullRequestStream in the background thread pool succeeded.
    if task.TaskSuccess() != true {
        // Show what would've been the LastErrorText had FullRequestStream been called synchronously
        fmt.Println(task.ResultErrorText())
        task.DisposeTask()
        rest.DisposeRest()
        azAuth.DisposeAuthAzureStorage()
        sendStream.DisposeStream()
        task.DisposeTask()
        return
    }

    responseStatusCode := rest.ResponseStatusCode()

    // When successful, the Azure Storage service will respond with a 201 response code,
    // with an empty body.  Therefore, in the success condition, the responseStr is empty.
    if responseStatusCode == 201 {
        fmt.Println("File uploaded.")
    } else {
        // It failed, so examine the response body, if one was returned:
        // Given that FullRequestStream returns a string, the return value is obtained via GetResultString.
        responseBodyStr := task.GetResultString()
        fmt.Println("response body (if any): ", *responseBodyStr)

        // Examine the request/response to see what happened.
        fmt.Println("response status code = ", rest.ResponseStatusCode())
        fmt.Println("response status text = ", rest.ResponseStatusText())
        fmt.Println("response header: ", rest.ResponseHeader())
        fmt.Println("---")
        fmt.Println("LastRequestStartLine: ", rest.LastRequestStartLine())
        fmt.Println("LastRequestHeader: ", rest.LastRequestHeader())
    }

    task.DisposeTask()

    rest.DisposeRest()
    azAuth.DisposeAuthAzureStorage()
    sendStream.DisposeStream()
    task.DisposeTask()