Zig

Send SOAP multipart/related with XML Body and Zip Attachment

See more REST Misc Examples

Demonstrates how to construct and send a multipart/related POST containing a SOAP XML body and a binary zip attachment. Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

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

    // This example constructs and sends the following HTTP request.
    // (The boundary strings will be different and auto-generated by Chilkat)

    // Accept-Encoding: gzip,deflate
    // SOAPAction: invio
    // Content-Type: Multipart/Related; boundary="MIME_boundary"; type="text/xml"; start="mailto:rootpart@soapui.org"
    // MIME-Version: 1.0
    //
    // --MIME_boundary
    // Content-Type: text/xml; charset=UTF-8
    // Content-Transfer-Encoding: 8bit
    // Content-ID: <rootpart@soapui.org>
    //
    // <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:attachment.ws.it">
    // <soapenv:Header/>
    // <soapenv:Body>
    //   <urn:inputBean>
    //    <nomeFileAllegato>myfile.zip</nomeFileAllegato>
    //   </urn:inputBean>
    // </soapenv:Body>
    // </soapenv:Envelope>
    //
    // --MIME_boundary
    // Content-Type: application/zip
    // Content-Transfer-Encoding: binary
    // Content-ID: <myfile.zip>
    // Content-Disposition: attachment; name="myfile.zip"; filename="myfile.zip"
    //
    // ... binary zip data goes here ...
    // --MIME_boundary--
    //

    const rest = try chilkat.Rest.init();
    defer rest.deinit();

    rest.addHeader("Accept-Encoding", "gzip,deflate") catch {};
    rest.addHeader("SOAPAction", "invio") catch {};
    rest.addHeader("Content-Type", "Multipart/Related; boundary=\"MIME_boundary\"; type=\"text/xml\"; start=\"mailto:rootpart@soapui.org\"") catch {};
    rest.addHeader("MIME-Version", "1.0") catch {};

    // Build the SOAP XML:
    // Use this online tool to generate the code from sample XML:
    // Generate Code to Create XML

    const xml = try chilkat.Xml.init();
    defer xml.deinit();
    xml.setTag("soapenv:Envelope");
    xml.addAttribute("xmlns:soapenv", "http://schemas.xmlsoap.org/soap/envelope/") catch {};
    xml.addAttribute("xmlns:urn", "urn:attachment.ws.it") catch {};
    xml.updateChildContent("soapenv:Header", "");
    xml.updateChildContent("soapenv:Body|urn:inputBean|nomeFileAllegato", "myfile.zip");

    // Build the SOAP XML sub-part
    rest.setPartSelector("1");
    rest.addHeader("Content-Type", "text/xml; charset=UTF-8") catch {};
    rest.addHeader("Content-Transfer-Encoding", "8bit") catch {};
    rest.addHeader("Content-ID", "<rootpart@soapui.org>") catch {};
    try rest.setMultipartBodyString(try xml.getXml(alloc));

    // Build the sub-part containing the .zip
    rest.setPartSelector("2");
    rest.addHeader("Content-Type", "application/zip") catch {};
    rest.addHeader("Content-Transfer-Encoding", "binary") catch {};
    rest.addHeader("Content-ID", "<myfile.zip>") catch {};
    rest.addHeader("Content-Disposition", "attachment; name=\"myfile.zip\"; filename=\"myfile.zip\"") catch {};

    // Add a zip file to the 2nd sub-part body.
    // This example will load the .zip file into memory, but it is also possible to stream directly from the file as the request is sent
    // by calling SetMultipartBodyStream.
    const bd = try chilkat.BinData.init();
    defer bd.deinit();
    try bd.loadFile("qa_data/zips/helloWorld.zip");
    try rest.setMultipartBodyBd(bd);

    // To be safe, always revert the PartSelector back to 0..
    rest.setPartSelector("0");

    // Send the request by connecting to the web server and then sending..
    // Connect using TLS.
    const b_auto_reconnect = true;
    rest.connect("www.chilkatsoft.com", 443, true, b_auto_reconnect) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // In this example, we're setting DebugMode.
    // When debug mode is turned on, no request is actually sent.
    // Instead, the request that would be sent is recorded to memory
    // and we can retrieve it afterwards..
    rest.setDebugMode(true);

    _ = rest.fullRequestMultipart(alloc, "POST", "/someTargetPath") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // Retrieve the request that would've been sent and save it to a file.
    // We can then examine the file to see if the request was structured as we desired.
    // (Note: The zip bytes will be binary data and will appear as garbled garbage in a text editor..)
    const bd_request = try chilkat.BinData.init();
    defer bd_request.deinit();
    rest.getLastDebugRequest(bd_request) catch {};
    try bd_request.writeFile("qa_output/multipartRelatedRequest.bin");

    std.debug.print("OK, examine the output file..\n", .{});
}