ETF's proposal for issue 78: RPC structs and Encoding root attribute

 Hello all. 8-)
 The issue 78 states that it is unclear which of the child 
element information items inside the SOAP Body is the RPC 
request/response struct, it also calls for clarification of the 
SOAP Encoding "root" attribute.

 The Encoding part:
 The section 3.7 - root Attribute information item [2] 
effectively says:
 True serialization rules don't have the attribute, its value 
being implied as true. Elements that are not true roots can be 
labeled as such with root="true". Elements can explicitly be 
labeled as not being serialization roots with root="false".

 We propose that we rephrase the long paragraph into:
 >>The root attribute item is used to distinguish between element
information items that are true roots of a serialised graph and
element information items that may appear to be roots of a graph
but are not.  Element information items that are true roots MAY
be labelled with a root attribute information item with a logical
value of "true". Element information items that are not roots MAY
be labelled with a root attribute information item with a logical
value of "false". This element information item has no default 
value.<<

 This rewrite makes clear what the attribute's value means. The
rewritten section 3.7 would effectively provide means to 
disambiguate true serialization roots from other (formerly 
"independent") elements at the same level in the resulting XML.
 
 For the RPC part: 
 Section 4.1 - RPC and SOAP Body [1] says that "the invocation is
viewed as a single struct" and "the response is viewed as a
single struct". To disambiguate the RPC struct from other 
elements in the Body, we have to add the following rule:
 >>The invocation and response structs are the true serialization
roots. Other element information items in the Body MUST be
explicitly marked as non-roots with enc:root="false".<<
 We've decided that marking the non-roots is more efficient than 
marking the root which will allways be there. 

 Best regards,


                   Jacek Kopecky

                   Senior Architect, Systinet (formerly Idoox)
                   http://www.systinet.com/

[1] http://www.w3.org/2000/xp/Group/1/10/11/soap12-part2.html#b1b2b6b8c20
[2] http://www.w3.org/2000/xp/Group/1/10/11/soap12-part2.html#b1b2b6b6c28

Received on Wednesday, 20 February 2002 08:49:08 UTC