Rust Requires Chilkat v11.0.0+

How to Access Parts of a multipart/related HTTP Response

See more HTTP Examples

Demonstrates how to access the parts of a multipart/related response. This example sends a ficticious multipart/related request, and handles a ficticious multipart/related response.

We send the following multipart/related request:

Content-Type: multipart/related; start-info="text/xml"; type="application/xop+xml"; boundary="----=_Part_0_1744155.1118953559416"
Content-Length: 3453
SOAPAction: "some-SOAP-action"

------=_Part_1_4558657.1118953559446
Content-Type: application/xop+xml; type="text/xml"; charset=utf-8

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Detail xmlns="http://example.org/mtom/data">
      <image>
        <xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" href="cid:5aeaa450-17f0-4484-b845-a8480c363444@example.org" />
      </image>
    </Detail>
  </soap:Body>
</soap:Envelope>

------=_Part_1_4558657.1118953559446
Content-Type: image/jpeg
Content-ID: <5aeaa450-17f0-4484-b845-a8480c363444@example.org>


... binary data ...

Rust

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

let http = chilkat::Http::new();

let soap_xml = chilkat::Xml::new();

// Build the following SOAP XML

// <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
//   <soap:Body>
//     <Detail xmlns="http://example.org/mtom/data">
//       <image>
//         <xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" href="cid:5aeaa450-17f0-4484-b845-a8480c363444@example.org" />
//       </image>
//     </Detail>
//   </soap:Body>
// </soap:Envelope>

soap_xml.set_tag("soap:Envelope");
let _ = soap_xml.add_attribute("xmlns:soap", "http://schemas.xmlsoap.org/soap/envelope/");
let _ = soap_xml.update_attr_at("soap:Body|Detail", true, "xmlns", "http://example.org/mtom/data");
let _ = soap_xml.update_attr_at("soap:Body|Detail|image|xop:Include", true, "xmlns:xop", "http://www.w3.org/2004/08/xop/include");
let _ = soap_xml.update_attr_at("soap:Body|Detail|image|xop:Include", true, "href", "cid:5aeaa450-17f0-4484-b845-a8480c363444@example.org");

soap_xml.set_emit_xml_decl(false);
let xml_body = soap_xml.get_xml().unwrap_or_default();
println!("{}", xml_body);

let req = chilkat::HttpRequest::new();
req.set_http_verb("POST");
req.set_path("/something/someTarget");

req.set_content_type("multipart/related; start-info=\"text/xml\"; type=\"application/xop+xml\"");
req.add_header("SOAPAction", "some-SOAP-action");

let _ = req.add_string_for_upload2("", "", &xml_body, "utf-8", "application/xop+xml; type=\"text/xml\"; charset=utf-8").is_ok();

// The bytes will be sent as binary (not base64 encoded).
let _ = req.add_file_for_upload2("", "qa_data/jpg/starfish.jpg", "image/jpeg").is_ok();

// The JPEG data is the 2nd sub-part, and therefore is at index 1 (the first sub-part is at index 0)
let _ = req.add_sub_header(1, "Content-ID", "<5aeaa450-17f0-4484-b845-a8480c363444@example.org>").is_ok();

http.set_follow_redirects(true);

let use_tls = true;
let resp = chilkat::HttpResponse::new();
if http.http_s_req("www.example.org", 443, use_tls, &req, &resp).is_err() {
    println!("{}", http.last_error_text());
    return;
}

// Imagine the HTTP response is multipart related and is something like this:

// HTTP/1.1 200 OK
// Cache-Control: no-cache, no-store
// Pragma: no-cache
// Transfer-Encoding: chunked
// Content-Type: multipart/related; boundary=------------080001080500020607080905
// Expires: -1
// Server: Microsoft-IIS/10.0
// X-AspNet-Version: 4.0.30319
// X-Powered-By: ASP.NET
// Date: Wed, 19 Feb 2020 15:27:06 GMT
// 
// --------------080001080500020607080905
// Content-Type: application/xop+xml; charset=iso-8859-1
// Content-Id: RootPart
// Content-Transfer-Encoding: binary
// 
// <?xml version="1.0" encoding="iso-8859-1"?>
// <soapenv:Envelope xmlns:xcpt="...">
//   <soapenv:Header />
//   <soapenv:Body>
//     <xres:Transport profile="http://something.example.com/..." version="1.4">
//       <xres:TransportHeader>
// 	...
// 	...
//       </xres:TransportHeader>
//       <xres:TransportBody />
//     </xres:Transport>
//   </soapenv:Body>
// </soapenv:Envelope>
// --------------080001080500020607080905--

// To get the XML, load the full MIME of the response into a Chilkat MIME object.  Then get the body of the 1st sub-part.
let mime = chilkat::Mime::new();
let _ = mime.load_mime(&resp.full_mime());

// Your code might verify that the Content-Type is indeed multipart/related.
println!("{}", mime.content_type());
println!("num parts = {}", mime.num_parts());

// Assuming it is, and the number of sub-parts is > 0
if mime.num_parts() > 0 {

    let part0 = chilkat::Mime::new();
    let _ = mime.part_at(0, &part0);

    // The Content-Type (in this ficticious example) should be "application/xop+xml"
    println!("sub-part Content-Type: {}", part0.content_type());
    // Now get the XML 
    let sub_part_xml_body = part0.get_body_decoded().unwrap_or_default();
    println!("{}", sub_part_xml_body);
}