React Native

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. React Native

import { CkDateTime, DtObj, JsonObject, Rest, Socket, Stream } from '@chilkat/react-native'

async function chilkatExample() {
  // 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.

  const socket = new Socket();
  const maxWaitMs = 5000;
  try {
    await socket.connectAsync('content.dropboxapi.com', 443, true, maxWaitMs);
  } catch {
    console.log(socket.lastErrorText);
    console.log(`Connect Fail Reason: ${socket.connectFailReason}`);
    return;
  }

  // Set the upload bandwidth throttle rate to 50000 bytes per second.
  socket.bandwidthThrottleUp = 50000;

  const 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
  // }

  const 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.
  const fileStream = new Stream();
  fileStream.sourceFile = '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.)
  let responseStr: string;
  try {
    responseStr = await rest.fullRequestStreamAsync('POST', '/2/files/upload', fileStream);
  } catch {
    console.log(rest.lastErrorText);
    return;
  }

  // When successful, Dropbox responds with a 200 response code.
  if (rest.responseStatusCode !== 200) {
    // Examine the request/response to see what happened.
    console.log(`response status code = ${rest.responseStatusCode}`);
    console.log(`response status text = ${rest.responseStatusText}`);
    console.log(`response header: ${rest.responseHeader}`);
    console.log(`response body (if any): ${responseStr}`);
    console.log('---');
    console.log(`LastRequestStartLine: ${rest.lastRequestStartLine}`);
    console.log(`LastRequestHeader: ${rest.lastRequestHeader}`);
    return;
  }

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

  // Show the JSON response.
  console.log(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:
  const size = jsonResp.intOf('size');
  console.log(`size = ${size}`);

  const rev = jsonResp.stringOf('rev');
  console.log(`rev = ${rev}`);

  const clientModified = jsonResp.stringOf('client_modified');
  const ckdt = new CkDateTime();
  ckdt.setFromTimestamp(clientModified);
  const bLocalTime = true;
  const dt = new DtObj();
  ckdt.toDtObj(bLocalTime, dt);

  console.log(`${dt.day}/${dt.month}/${dt.year} ${dt.hour}:${dt.minute}`);
}