Swift
REST Stream Multipart Body from File

Demonstrates how to send a multipart/form-data HTTP request, where one of the parts contains data streamed directly from a file. This is good for cases where the file to be uploaded is very large.
Chilkat Swift Downloads

Download Chilkat for Swift
Swift

func chilkatTest() {
    var success: Bool = false

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

    let rest = CkoRest()!

    // Connect to the destination web server.
    var bTls: Bool = true
    var port: Int = 443
    var bAutoReconnect: Bool = true
    success = rest.connect(hostname: "www.somewebserver.com", port: port, tls: bTls, autoReconnect: bAutoReconnect)

    // This example will send the following multipart/form-data request.
    // The Content-Length is automatically computed and added by Chilkat.

    // 	POST /some_path HTTP/1.1
    // 	Content-Type: multipart/form-data; boundary=---------------------------735323031399963166993862150
    // 	Content-Length: 834
    // 
    // 	-----------------------------735323031399963166993862150
    // 	Content-Disposition: form-data; name="text1"
    // 
    // 	text 123 abc
    // 	-----------------------------735323031399963166993862150
    // 	Content-Disposition: form-data; name="text2"
    // 
    // 	xyz
    // 	-----------------------------735323031399963166993862150
    // 	Content-Disposition: form-data; name="file1"; filename="a.txt"
    // 	Content-Type: text/plain
    // 
    // 	Content of a.txt.
    // 
    // 	-----------------------------735323031399963166993862150
    // 	Content-Disposition: form-data; name="file2"; filename="a.html"
    // 	Content-Type: text/html
    // 
    // 	<!DOCTYPE html><title>Content of a.html.</title>
    // 
    // 	-----------------------------735323031399963166993862150
    // 	Content-Disposition: form-data; name="file3"; filename="starfish.jpg"
    // 	Content-Type: image/jpeg
    // 
    // 	binary data goes here
    // 	-----------------------------735323031399963166993862150--

    // Set the Content-Type for the topmost MIME part.
    rest.addHeader(name: "Content-Type", value: "multipart/form-data")

    // Specify each part of the request.
    rest.partSelector = "1"
    rest.addHeader(name: "Content-Disposition", value: "form-data; name=\"text1\"")
    rest.setMultipartBodyString(bodyText: "text 123 abc")

    rest.partSelector = "2"
    rest.addHeader(name: "Content-Disposition", value: "form-data; name=\"text2\"")
    rest.setMultipartBodyString(bodyText: "xyz")

    rest.partSelector = "3"
    rest.addHeader(name: "Content-Disposition", value: "form-data; name=\"file1\"; filename=\"a.txt\"")
    rest.addHeader(name: "Content-Type", value: "text/plain")
    rest.setMultipartBodyString(bodyText: "Content of a.txt.")

    rest.partSelector = "4"
    rest.addHeader(name: "Content-Disposition", value: "form-data; name=\"file2\"; filename=\"a.html\"")
    rest.addHeader(name: "Content-Type", value: "text/html")
    let sbHtml = CkoStringBuilder()!
    sbHtml.loadFile(path: "qa_data/html/a.html", charset: "utf-8")
    rest.setMultipartBodySb(bodySb: sbHtml)

    rest.partSelector = "5"
    rest.addHeader(name: "Content-Disposition", value: "form-data; name=\"file3\"; filename=\"starfish.jpg\"")
    rest.addHeader(name: "Content-Type", value: "image/jpeg")

    // When the request is sent, stream this part directly from the file.
    // This avoids having to load the entire file into memory.
    let fileStream = CkoStream()!
    fileStream.sourceFile = "qa_data/jpg/starfish.jpg"
    rest.setMultipartBodyStream(stream: fileStream)

    var responseBody: String? = rest.fullRequestMultipart(httpVerb: "POST", uriPath: "/some_path")
    if rest.lastMethodSuccess != true {
        print("\(rest.lastErrorText!)")
        return
    }

    // ...
    // ...

    // Clear the REST object for any subsequent requests..
    rest.clearAllHeaders()
    rest.clearAllParts()
    rest.partSelector = ""

}