Java

REST Upload Bandwidth Throttle

See more REST Examples

Demonstrates how to use upload bandwidth throttling with the REST API. This example will upload a file to Drobox using a file stream, with a limit on the bandwidth that can be used for the transfer. Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.DateTime;
import com.chilkatsoft.chilkat2.DtObj;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.Rest;
import com.chilkatsoft.chilkat2.Socket;
import com.chilkatsoft.chilkat2.Stream;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        // A Dropbox access token should have been previously obtained.
        // Dropbox access tokens do not expire.
        // See Dropbox Access Token.

        // To use bandwidth throttling, the connection should be made using the socket API.
        // This provides numerous properties to customize the connection, such as
        // BandwidthThrottleDown, BandwidthThrottleUp, ClientIpAddress, ClintPort, Http Proxy,
        // KeepAlive, PreferIpv6, RequireSslCertVerify, SoRcvBuf, SoSndBuf, SoReuseAddr,
        // SOCKS proxy, TcpNoSDelay, TlsPinSet, TlsCipherSuite, SslAllowedCiphers, etc.

        Socket socket = new Socket();
        int maxWaitMs = 5000;
        try {
            socket.connect("content.dropboxapi.com", 443, true, maxWaitMs);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            System.out.println("Connect Fail Reason: " + socket.getConnectFailReason());
            return;
        }

        // Set the upload bandwidth throttle rate to 50000 bytes per second.
        socket.setBandwidthThrottleUp(50000);

        Rest rest = new Rest();

        // Tell the REST object to use the connected socket.
        rest.useConnection(socket, true);

        // The remainder of this example is identical to the example at:
        // Dropbox File Stream Upload.

        // Add request headers.
        rest.addHeader("Content-Type", "application/octet-stream");
        rest.addHeader("Authorization", "Bearer DROPBOX_ACCESS_TOKEN");

        // The upload "parameters" contained in JSON passed in an HTTP request header.
        // This is the JSON to be added in this example:
        // {
        //    "path": "/Homework/lit/hamlet.xml",
        //    "mode": "add",
        //    "autorename": true,
        //    "mute": false
        // }

        JsonObject json = new JsonObject();
        json.appendString("path", "/Homework/lit/hamlet.xml");
        json.appendString("mode", "add");
        json.appendBool("autorename", true);
        json.appendBool("mute", false);
        rest.addHeader("Dropbox-API-Arg", json.emit());

        // Almost ready to go...
        // Let's setup a file stream to point to a file.
        Stream fileStream = new Stream();
        fileStream.setSourceFile("qa_data/xml/hamlet.xml");

        // Do the upload.  The URL is https://content.dropboxapi.com/2/files/upload.
        // We already connected to content.dropboxapi.com using TLS (i.e. HTTPS),
        // so now we only need to specify the path "/2/files/upload".

        // Note: The file is streamed directly from disk.  (The entire
        // file will not be loaded into memory.)
        String responseStr;
        try {
            responseStr = rest.fullRequestStream("POST", "/2/files/upload", fileStream);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // When successful, Dropbox responds with a 200 response code.
        if (rest.getResponseStatusCode() != 200) {
            // 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): " + responseStr);
            System.out.println("---");
            System.out.println("LastRequestStartLine: " + rest.getLastRequestStartLine());
            System.out.println("LastRequestHeader: " + rest.getLastRequestHeader());
            return;
        }

        // The response is JSON.
        JsonObject jsonResp = new JsonObject();
        jsonResp.setEmitCompact(false);
        jsonResp.load(responseStr);

        // Show the JSON response.
        System.out.println(jsonResp.emit());

        // Returns JSON that looks like this:
        // {
        //   "name": "hamlet.xml",
        //   "path_lower": "/homework/lit/hamlet.xml",
        //   "path_display": "/Homework/lit/hamlet.xml",
        //   "id": "id:74FkdeNuyKAAAAAAAAAAAQ",
        //   "client_modified": "2016-06-02T23:19:00Z",
        //   "server_modified": "2016-06-02T23:19:00Z",
        //   "rev": "9482db15f",
        //   "size": 279658
        // }

        // Sample code to get data from the JSON response:
        int size = jsonResp.intOf("size");
        System.out.println("size = " + size);

        String rev = jsonResp.stringOf("rev");
        System.out.println("rev = " + rev);

        String clientModified = jsonResp.stringOf("client_modified");
        DateTime ckdt = new DateTime();
        ckdt.setFromTimestamp(clientModified);
        boolean bLocalTime = true;
        DtObj dt = new DtObj();
        ckdt.toDtObj(bLocalTime, dt);

        System.out.println(dt.getDay() + "/" + dt.getMonth() + "/" + dt.getYear() + " " + dt.getHour() + ":" + dt.getMinute());
    }
}