Java

Upload using Azure Storage Account Shared Access Signature (SAS) Authorization

See more Azure Cloud Storage Examples

Sample code to upload binary bytes to a block blob in Azure Cloud Storage using an Azure Storage Account Shared Access Signature (SAS) Authorization. This creates a block blob, or replaces an existing block blob.

Note: The maximum size of a block blob created by uploading in a single step is 64MB. For larger files, the upload must be broken up into blocks. There is another Chilkat example for that..

Note: This example requires Chilkat v9.5.0.65 or later.

Chilkat2 Java

import com.chilkatsoft.chilkat2.BinData;
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Rest;
import com.chilkatsoft.chilkat2.StringBuilder;

public class ChilkatExample {

    public static void main(String[] args) {
        // Note: This example requires Chilkat v9.5.0.65 or greater.

        // Azure Blob Service Example: Upload binary bytes to a block blob.
        // This uses a Shared Access Signature (SAS) for Authorization.
        // This creates a new block blob or replaces an existing one in its entirety.
        // See also: https://msdn.microsoft.com/en-us/library/azure/dd179451.aspx

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

        Rest rest = new Rest();

        // Connect to the Azure Storage Blob Service
        boolean bTls = true;
        int port = 443;
        boolean bAutoReconnect = true;
        // In this example, the storage account name is "chilkat".
        try {
            rest.connect("chilkat.blob.core.windows.net", port, bTls, bAutoReconnect);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // ----------------------------------------------------------------------------------------------
        // The code above this comment could be placed inside a function/subroutine within the application
        // because the connection does not need to be made for every request.  Once the connection is made
        // the app may send many requests..
        // ----------------------------------------------------------------------------------------------

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

        // Let's load a previously computed Azure Storage Account SAS token and use it.
        // See How to Create an Azure Storage Account Shared Access Signature
        StringBuilder sbToken = new StringBuilder();
        try {
            sbToken.loadFile("qa_data/tokens/azureStorageAccountSas.txt", "utf-8");
        } catch (ChilkatException e) {
            System.out.println("Failed to load SAS token.");
            return;
        }

        // Add the Shared Access Signature query params for authorization.
        rest.addQueryParams(sbToken.getAsString());

        // IMPORTANT: Make sure to set the x-ms-blob-type header:
        rest.addHeader("x-ms-blob-type", "BlockBlob");

        // IMPORTANT: Make sure to add the x-ms-date header.
        // When the header name is "x-ms-date", Chilkat will recognize the keyword "NOW"
        // and will substitute the current system date/time formatted as required by Microsoft.
        rest.addHeader("x-ms-date", "NOW");

        // For this example, we'll just load a JPG file into memory..
        BinData binData = new BinData();
        try {
            binData.loadFile("qa_data/jpg/starfish.jpg");
        } catch (ChilkatException e) {
            System.out.println("Failed to load JPG file.");
            return;
        }

        // Note: The maximum size of a block blob created by uploading in a single step is 64MB.
        // For larger files, the upload must be broken up into blocks.  There is another Chilkat example for that..
        StringBuilder sbResponse = new StringBuilder();
        try {
            rest.fullRequestBd("PUT", "/mycontainer/starfish.jpg", binData, sbResponse);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // When successful, the Azure Storage service will respond with a 201 response status code,
        // with no response body.
        if (rest.getResponseStatusCode() != 201) {
            // Examine the request/response to see what happened.
            System.out.println("response status code = " + rest.getResponseStatusCode());
            System.out.println("response status text = " + rest.getResponseStatusText());
            System.out.println("response header: " + rest.getResponseHeader());
            System.out.println("response body (if any): " + sbResponse.getAsString());
            System.out.println("---");
            System.out.println("LastRequestStartLine: " + rest.getLastRequestStartLine());
            System.out.println("LastRequestHeader: " + rest.getLastRequestHeader());
            System.out.println("Failed.");
            return;
        }

        System.out.println("Success.");
    }
}