Dart

Add Data to multipart/form-data Request

See more HTTP Examples

Demonstrates how to add content (such as a JPG, PDF, XML, etc.) to multipart/form-data requests. 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.

  final req = CkHttpRequest();
  req.httpVerb = 'POST';
  req.contentType = 'multipart/form-data';
  req.path = '/xyz/something';

  req.addParam('param1', 'value1');
  req.addParam('param2', 'value2');

  // Add some small files to the request. (Small so we can see what the full request looks like without too much data..)
  final bd = CkBinData();
  bd.loadFile('qa_data/jpg/starfish20.jpg');
  req.addBdForUpload('starfish20', 'starfish20.jpg', bd, 'image/jpeg');

  bd.loadFile('qa_data/pdf/helloWorld.pdf');
  req.addBdForUpload('helloWorld', 'helloWorld.pdf', bd, 'application/pdf');

  bd.loadFile('qa_data/xml/tinyA.xml');
  req.addBdForUpload('tinyA', 'tinyA.xml', bd, 'text/xml');

  // This HTTP request contains binary data, so we cannot call GenerateRequestText
  // to examine it as a string.  We can instead call GenerateRequestFile
  // to write the request to a file and then examine using a hex editor,
  // or an editor that is capable of handling null bytes and non-printable chars (perhaps by displaying "?" chars instead).
  req.generateRequestFile('qa_output/multipartFormDataRequest.bin');

  print('OK.');

  // This is the HTTP multipart/form-data request built by the above code:

  // POST /xyz/something HTTP/1.1
  // Host: domain
  // Content-Type: multipart/form-data; boundary=------------090708030009010000030901
  // Content-Length: 2220
  // 
  // --------------090708030009010000030901
  // Content-Disposition: form-data; name="param1"
  // 
  // value1
  // --------------090708030009010000030901
  // Content-Disposition: form-data; name="param2"
  // 
  // value2
  // --------------090708030009010000030901
  // Content-Disposition: form-data; name="starfish20"; filename="starfish20.jpg"
  // Content-Type: image/jpeg
  // 
  // JPEG DATA HERE...
  // --------------090708030009010000030901
  // Content-Disposition: form-data; name="helloWorld"; filename="helloWorld.pdf"
  // Content-Type: application/pdf
  // 
  // PDF DATA HERE...
  // --------------090708030009010000030901
  // Content-Disposition: form-data; name="tinyA"; filename="tinyA.xml"
  // Content-Type: text/xml
  // 
  // XML DATA HERE...
  // --------------090708030009010000030901--
  // 
}