Dart Requires Chilkat v11.0.0+

URL Encoding Charset in POST Query Params

See more HTTP Examples

Demonstrates how to control the URL encoding charset in POST query params. 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.

  // We have the string "MÆRSK".
  final nameWin1252Encoded = 'M%E6RSK';

  final sb = CkStringBuilder();
  sb.decodeAndAppend(nameWin1252Encoded, 'url', 'windows-1252');

  final http = CkHttp();

  // We're setting the session log filename so we can see the exact request sent.
  http.sessionLogFilename = 'qa_output/sessionLog.txt';

  // First demonstrate a simple application/x-www-form-urlencoded POST

  final req = CkHttpRequest();

  // Set the Charset = "utf-8" to cause URL encoding to use utf-8.
  req.charset = 'utf-8';

  req.addParam('name', sb.getAsString());

  req.httpVerb = 'POST';
  req.contentType = 'application/x-www-form-urlencoded';

  final resp = CkHttpResponse();
  try {
    http.httpReq('https://www.chilkatsoft.com/something', req, resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // This is the request that is sent:
  // Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

  // 	POST /something HTTP/1.1
  // 	Host: www.chilkatsoft.com
  // 	Content-Type: application/x-www-form-urlencoded
  // 	Content-Length: 15
  // 
  // 	name=M%C3%A6RSK

  // ---------------------------------------------------------------
  // Switch to windows-1252

  req.charset = 'windows-1252';
  req.httpVerb = 'POST';
  req.contentType = 'application/x-www-form-urlencoded';

  try {
    http.httpReq('https://www.chilkatsoft.com/something', req, resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // This is the request that is sent:
  // Notice that windows-1252 is used in the query param (the letter 'Æ' is %E6)

  // 	POST /something HTTP/1.1
  // 	Host: www.chilkatsoft.com
  // 	Content-Type: application/x-www-form-urlencoded
  // 	Content-Length: 12
  // 
  // 	name=M%E6RSK

  // ---------------------------------------------------------------
  // Let's do the same with HttpSReq, switching back to utf-8

  req.path = '/something';
  req.httpVerb = 'POST';
  req.contentType = 'application/x-www-form-urlencoded';

  req.charset = 'utf-8';
  try {
    http.httpSReq('www.chilkatsoft.com', 443, true, req, resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // This is the request that is sent:
  // Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

  // 	POST /something HTTP/1.1
  // 	Host: www.chilkatsoft.com
  // 	Content-Type: application/x-www-form-urlencoded
  // 	Content-Length: 15
  // 
  // 	name=M%C3%A6RSK

  // ---------------------------------------------------------------
  // Let's do a POST with XML body where the query params are in the HTTP request start line, 
  // and the Content-Type is text/xml where the body of the request is XML.

  req.path = '/something';
  req.httpVerb = 'POST';
  req.contentType = 'text/xml';
  req.loadBodyFromString('<test>123</test>', 'utf-8');
  req.charset = 'utf-8';

  // Remember... our request object still contains the query param added in the above call to AddParam.
  try {
    http.httpSReq('www.chilkatsoft.com', 443, true, req, resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // This is the request that is sent:
  // Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

  // 	POST /something?name=M%C3%A6RSK HTTP/1.1
  // 	Host: www.chilkatsoft.com
  // 	Content-Type: text/xml
  // 	Content-Length: 16
  // 
  // 	<test>123</test>
}