(Lianja) URL Encoding Charset in POST Query Params

Demonstrates how to control the URL encoding charset in POST query params.

Chilkat Lianja Extension Download Chilkat Lianja Extension

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

// We have the string "MÆRSK".
lcNameWin1252Encoded = "M%E6RSK"

// Note: The DecodeAndAppend method is newly added in Chilkat v9.5.0.87
loSb = createobject("CkStringBuilder")
llSuccess = loSb.DecodeAndAppend(lcNameWin1252Encoded,"url","windows-1252")

loHttp = createobject("CkHttp")

// We're setting the session log filename so we can see the exact request sent.
loHttp.SessionLogFilename = "qa_output/sessionLog.txt"

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

loReq = createobject("CkHttpRequest")

// Set the Charset = "utf-8" to cause URL encoding to use utf-8.
loReq.Charset = "utf-8"

loReq.AddParam("name",loSb.GetAsString())

loResp = loHttp.PostUrlEncoded("https://www.chilkatsoft.com/something",loReq)
if (loHttp.LastMethodSuccess = .F.) then
    ? loHttp.LastErrorText
    release loSb
    release loHttp
    release loReq
    return
endif

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

release loResp

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

loReq.Charset = "windows-1252"

loResp = loHttp.PostUrlEncoded("https://www.chilkatsoft.com/something",loReq)
if (loHttp.LastMethodSuccess = .F.) then
    ? loHttp.LastErrorText
    release loSb
    release loHttp
    release loReq
    return
endif

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

release loResp

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

loReq.Path = "/something"
loReq.HttpVerb = "POST"
loReq.ContentType = "application/x-www-form-urlencoded"

loReq.Charset = "utf-8"

loResp = loHttp.SynchronousRequest("www.chilkatsoft.com",443,.T.,loReq)
if (loHttp.LastMethodSuccess = .F.) then
    ? loHttp.LastErrorText
    release loSb
    release loHttp
    release loReq
    return
endif

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

release loResp

// ---------------------------------------------------------------
// Let's do a PostXml 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.

loReq.Path = "/something"
loReq.HttpVerb = "POST"
loReq.ContentType = "text/xml"
llSuccess = loReq.LoadBodyFromString("<test>123</test>","utf-8")
loReq.Charset = "utf-8"

// Remember... our request object still contains the query param added in the above call to AddParam.

loResp = loHttp.SynchronousRequest("www.chilkatsoft.com",443,.T.,loReq)
if (loHttp.LastMethodSuccess = .F.) then
    ? loHttp.LastErrorText
    release loSb
    release loHttp
    release loReq
    return
endif

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

release loResp


release loSb
release loHttp
release loReq