Dart

Download File from Dropbox into a String Variable

See more Dropbox Examples

Demonstrates how to download a file from Dropbox directly into a string variable. Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // 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.

  final rest = CkRest();

  // Connect to Dropbox
  try {
    rest.connect('content.dropboxapi.com', 443, true, true);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Add request headers.
  rest.addHeader('Authorization', 'Bearer DROPBOX_ACCESS_TOKEN');

  // The download "parameters" are contained in JSON passed in an HTTP request header.
  // This is the JSON indicating the file to be downloaded:
  // { 
  //    "path": "/jack.txt",
  // }

  final json = CkJsonObject();
  json.appendString('path', '/jack.txt');
  rest.addHeader('Dropbox-API-Arg', json.emit());

  // The content of the file on Dropbox is returned.
  final String fileContent;
  try {
    fileContent = rest.fullRequestNoBody('POST', '/2/files/download');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

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

  // Show the file content that was downloaded:
  print(fileContent);
  print('----');

  // Information about the downloaded file is also available as JSON in a response header.
  // The "dropbox-api-result" response header contains the information.  For example:
  final apiResult = rest.responseHdrByName('dropbox-api-result');
  print(apiResult);

  // In this case, the pretty-formatted dropbox-api-result JSON looks like this:
  // { 
  //   "name": "jack.txt",
  //   "path_lower": "/jack.txt",
  //   "path_display": "/jack.txt",
  //   "id": "id:yqx4-tE_NKAAAAAAAAAAAQ",
  //   "client_modified": "2016-06-02T20:42:11Z",
  //   "server_modified": "2016-06-02T20:42:11Z",
  //   "rev": "8482db15f",
  //   "size": 42
  // }

  // Load the JSON, pretty-print it, and demonstrate how to get some values...
  final jsonResult = CkJsonObject();
  jsonResult.emitCompact = false;
  jsonResult.load(apiResult);
  // Show the JSON pretty-printed...
  print(jsonResult.emit());

  // Sample code to get data from the JSON response:
  final size = jsonResult.intOf('size');
  print('size = $size');

  final rev = jsonResult.stringOf('rev');
  print('rev = $rev');

  final clientModified = jsonResult.stringOf('client_modified');
  final ckdt = CkDateTime();
  ckdt.setFromTimestamp(clientModified);
  final bLocalTime = true;
  final dt = CkDtObj();
  ckdt.toDtObj(bLocalTime, dt);

  print('${dt.day}/${dt.month}/${dt.year} ${dt.hour}:${dt.minute}');
}