(Swift 3,4,5...) URL Encoding Charset in POST Query Params

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

Chilkat Downloads for the Swift Programming Language MAC OS X (Cocoa) Objective-C/Swift Libs iOS Objective-C/Swift Libs

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

    // We have the string "MÆRSK".
    var nameWin1252Encoded: String? = "M%E6RSK"

    // Note: The DecodeAndAppend method is newly added in Chilkat v9.5.0.87
    let sb = CkoStringBuilder()!
    var success: Bool = sb.decodeAndAppend(nameWin1252Encoded, encoding: "url", charset: "windows-1252")

    let http = CkoHttp()!

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

    let req = CkoHttpRequest()!

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

    req.addParam("name", value: sb.getAsString())

    var resp: CkoHttpResponse? = http.postUrlEncoded("https://www.chilkatsoft.com/something", req: req)
    if http.lastMethodSuccess == false {
        print("\(http.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

    resp = nil

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

    req.charset = "windows-1252"

    resp = http.postUrlEncoded("https://www.chilkatsoft.com/something", req: req)
    if http.lastMethodSuccess == false {
        print("\(http.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

    resp = nil

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

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

    req.charset = "utf-8"

    resp = http.synchronousRequest("www.chilkatsoft.com", port: 443, ssl: true, req: req)
    if http.lastMethodSuccess == false {
        print("\(http.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

    resp = nil

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

    req.path = "/something"
    req.httpVerb = "POST"
    req.contentType = "text/xml"
    success = req.loadBody(from: "<test>123</test>", charset: "utf-8")
    req.charset = "utf-8"

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

    resp = http.synchronousRequest("www.chilkatsoft.com", port: 443, ssl: true, req: req)
    if http.lastMethodSuccess == false {
        print("\(http.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>

    resp = nil

}