Java 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. Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Http;
import com.chilkatsoft.chilkat2.HttpRequest;
import com.chilkatsoft.chilkat2.HttpResponse;
import com.chilkatsoft.chilkat2.StringBuilder;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

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

        StringBuilder sb = new StringBuilder();
        sb.decodeAndAppend(nameWin1252Encoded, "url", "windows-1252");

        Http http = new Http();

        // We're setting the session log filename so we can see the exact request sent.
        http.setSessionLogFilename("qa_output/sessionLog.txt");

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

        HttpRequest req = new HttpRequest();

        // Set the Charset = "utf-8" to cause URL encoding to use utf-8.
        req.setCharset("utf-8");

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

        req.setHttpVerb("POST");
        req.setContentType("application/x-www-form-urlencoded");

        HttpResponse resp = new HttpResponse();
        try {
            http.httpReq("https://www.chilkatsoft.com/something", req, resp);

            // 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.setCharset("windows-1252");
            req.setHttpVerb("POST");
            req.setContentType("application/x-www-form-urlencoded");

            http.httpReq("https://www.chilkatsoft.com/something", req, resp);

            // 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.setPath("/something");
            req.setHttpVerb("POST");
            req.setContentType("application/x-www-form-urlencoded");

            req.setCharset("utf-8");
            http.httpSReq("www.chilkatsoft.com", 443, true, req, resp);

            // 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.setPath("/something");
            req.setHttpVerb("POST");
            req.setContentType("text/xml");
            req.loadBodyFromString("<test>123</test>", "utf-8");
            req.setCharset("utf-8");

            // Remember... our request object still contains the query param added in the above call to AddParam.
            http.httpSReq("www.chilkatsoft.com", 443, true, req, resp);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            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>
    }
}