(PowerBuilder) How to Access Parts of a multipart/related HTTP Response

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

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

integer li_rc
oleobject loo_Http
oleobject loo_SoapXml
string ls_XmlBody
oleobject loo_Req
integer li_UseTls
oleobject loo_Resp
oleobject loo_Mime
oleobject loo_Part0
string ls_SubPartXmlBody

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

loo_Http = create oleobject
// Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")
if li_rc < 0 then
    destroy loo_Http
    MessageBox("Error","Connecting to COM object failed")
    return
end if

loo_SoapXml = create oleobject
// Use "Chilkat_9_5_0.Xml" for versions of Chilkat < 10.0.0
li_rc = loo_SoapXml.ConnectToNewObject("Chilkat.Xml")

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

loo_SoapXml.Tag = "soap:Envelope"
loo_SoapXml.AddAttribute("xmlns:soap","http://schemas.xmlsoap.org/soap/envelope/")
loo_SoapXml.UpdateAttrAt("soap:Body|Detail",1,"xmlns","http://example.org/mtom/data")
loo_SoapXml.UpdateAttrAt("soap:Body|Detail|image|xop:Include",1,"xmlns:xop","http://www.w3.org/2004/08/xop/include")
loo_SoapXml.UpdateAttrAt("soap:Body|Detail|image|xop:Include",1,"href","cid:5aeaa450-17f0-4484-b845-a8480c363444@example.org")

loo_SoapXml.EmitXmlDecl = 0
ls_XmlBody = loo_SoapXml.GetXml()
Write-Debug ls_XmlBody

loo_Req = create oleobject
// Use "Chilkat_9_5_0.HttpRequest" for versions of Chilkat < 10.0.0
li_rc = loo_Req.ConnectToNewObject("Chilkat.HttpRequest")

loo_Req.HttpVerb = "POST"
loo_Req.Path = "/something/someTarget"

loo_Req.ContentType = "multipart/related; start-info=~"text/xml~"; type=~"application/xop+xml~""
loo_Req.AddHeader("SOAPAction","some-SOAP-action")

li_Success = loo_Req.AddStringForUpload2("","",ls_XmlBody,"utf-8","application/xop+xml; type=~"text/xml~"; charset=utf-8")

// The bytes will be sent as binary (not base64 encoded).
li_Success = loo_Req.AddFileForUpload2("","qa_data/jpg/starfish.jpg","image/jpeg")

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

loo_Http.FollowRedirects = 1

li_UseTls = 1
loo_Resp = loo_Http.SynchronousRequest("www.example.org",443,li_UseTls,loo_Req)
if loo_Http.LastMethodSuccess <> 1 then
    Write-Debug loo_Http.LastErrorText
    destroy loo_Http
    destroy loo_SoapXml
    destroy loo_Req
    return
end if

// 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.
loo_Mime = create oleobject
// Use "Chilkat_9_5_0.Mime" for versions of Chilkat < 10.0.0
li_rc = loo_Mime.ConnectToNewObject("Chilkat.Mime")

loo_Mime.LoadMime(loo_Resp.FullMime)

// Your code might verify that the Content-Type is indeed multipart/related.
Write-Debug loo_Mime.ContentType
Write-Debug "num parts = " + string(loo_Mime.NumParts)

// Assuming it is, and the number of sub-parts is > 0
if loo_Mime.NumParts > 0 then
    loo_Part0 = loo_Mime.GetPart(0)
    // The Content-Type (in this ficticious example) should be "application/xop+xml"
    Write-Debug "sub-part Content-Type: " + loo_Part0.ContentType
    // Now get the XML 
    ls_SubPartXmlBody = loo_Part0.GetBodyDecoded()
    Write-Debug ls_SubPartXmlBody
    destroy loo_Part0
end if

destroy loo_Resp


destroy loo_Http
destroy loo_SoapXml
destroy loo_Req
destroy loo_Mime