{"id":132,"date":"2006-07-25T15:48:58","date_gmt":"2006-07-25T22:48:58","guid":{"rendered":"http:\/\/kennyw.com\/indigo\/132"},"modified":"2006-07-25T15:48:58","modified_gmt":"2006-07-25T22:48:58","slug":"washing-the-soap-from-messages","status":"publish","type":"post","link":"https:\/\/kennyw.com\/?p=132","title":{"rendered":"Washing the SOAP from Messages"},"content":{"rendered":"

Now that the July CTP is public, I can divulge the details of a feature that I added to WCF in April<\/a>.<\/p>\n

In PDC ’05 we showed how you can use WCF extensibility to send “POX” (Plain Old Xml) Messages via our runtime. However, it took some magical incantations to enable. These including setting HttpMappingMode<\/a><\/code> on the HttpTransportBindingElement<\/code>, and writing a custom encoder that only writes out the body of the Message.<\/p>\n

In July CTP, you now get 1st class support for POX-style Messages. To accomplish this, we added new Addressing and Envelope Versions (AddressingVersion<\/code>.None<\/code> and EnvelopeVersion<\/code>.None<\/code>). I’m also happy to report the obsolescence and removal of HttpMappingMode<\/code> (nee MapAddressingHeadersToHttpHeaders<\/code> for those former Beta 1 users who have been following along).<\/p>\n

AddressingVersion<\/code>.None<\/code> means that your addressing information (To, Action, etc) is transmitted out of band from the Envelope. One example of this type of addressing is BasicHttpBinding — the <To><\/code> is sent as the HTTP Request-Uri, and the <Action><\/code> is sent out as either the SOAP-Action (in SOAP 1.1), or as a parameter to the content-type (in SOAP 1.2). If a particular binding requires WS-Addressing, then they can throw on Send()<\/code> for Messages with AddressingVersion<\/code>.None<\/code><\/p>\n

EnvelopeVersion<\/code> applies to the basic structure of the Message. This is where SOAP can come in to play. By default, the EnvelopeVersion of a Message is EnvelopeVersion<\/code>.Soap12<\/code>. SOAP 1.2 includes (among other things), support for Headers, and an outer <Envelope><\/code> tag. To “wash off” the SOAP from the Message (thanks Don<\/a>), you should create a Message with EnvelopeVersion<\/code>.None<\/code>. When using such Messages, you cannot add any Headers other than <To><\/code> and <Action><\/code>. <To><\/code> and <Action><\/code> are “special” since they are intrinsics used by the runtime system. <To><\/code> is used by default for addressing dispatch, and <Action><\/code> is used by default for Operation dispatch. Some transports (such as our HTTP Transport) will strip these header values out and lift them into their “framing layer” (i.e. the goo we put around a Message to conform to the HTTP protocol).<\/p>\n

For our programming model, AddressingVersion<\/code> and EnvelopeVersion<\/code> are packaged together into a single MessageVersion<\/code> that is assigned to a Message<\/code> or a Binding<\/code>. Enabling simple POX messaging is now simply a matter of setting up an HTTP binding on your service with a TextEncoder that uses MessageVersion<\/code>.None<\/code> (or messageVersion=”none” in config-speak). Viola! No SOAP!<\/p>\n

NOTE: see here<\/a> for more information about the breaking changes between Beta 2 and the June CTP.<\/p>\n","protected":false},"excerpt":{"rendered":"

Now that the July CTP is public, I can divulge the details of a feature that I added to WCF in April. In PDC ’05 we showed how you can use WCF extensibility to send “POX” (Plain Old Xml) Messages via our runtime. However, it took some magical incantations to enable. These including setting HttpMappingMode […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[],"class_list":["post-132","post","type-post","status-publish","format-standard","hentry","category-indigo"],"_links":{"self":[{"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/posts\/132","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/kennyw.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=132"}],"version-history":[{"count":0,"href":"https:\/\/kennyw.com\/index.php?rest_route=\/wp\/v2\/posts\/132\/revisions"}],"wp:attachment":[{"href":"https:\/\/kennyw.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=132"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kennyw.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=132"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kennyw.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=132"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}