(Delphi DLL) Add Data to multipart/form-data Request

Demonstrates how to add content (such as a JPG, PDF, XML, etc.) to multipart/form-data requests.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, BinData, HttpRequest;

...

procedure TForm1.Button1Click(Sender: TObject);
var
req: HCkHttpRequest;
bd: HCkBinData;
success: Boolean;

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

req := CkHttpRequest_Create();
CkHttpRequest_putHttpVerb(req,'POST');
CkHttpRequest_putContentType(req,'multipart/form-data');
CkHttpRequest_putPath(req,'/xyz/something');

CkHttpRequest_AddParam(req,'param1','value1');
CkHttpRequest_AddParam(req,'param2','value2');

// Add some small files to the request. (Small so we can see what the full request looks like without too much data..)
bd := CkBinData_Create();
success := CkBinData_LoadFile(bd,'qa_data/jpg/starfish20.jpg');
CkHttpRequest_AddBdForUpload(req,'starfish20','starfish20.jpg',bd,'image/jpeg');

success := CkBinData_LoadFile(bd,'qa_data/pdf/helloWorld.pdf');
CkHttpRequest_AddBdForUpload(req,'helloWorld','helloWorld.pdf',bd,'application/pdf');

success := CkBinData_LoadFile(bd,'qa_data/xml/tinyA.xml');
CkHttpRequest_AddBdForUpload(req,'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).
CkHttpRequest_GenerateRequestFile(req,'qa_output/multipartFormDataRequest.bin');

Memo1.Lines.Add('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--
// 

CkHttpRequest_Dispose(req);
CkBinData_Dispose(bd);

end;