Back to index
This interface encapsulates an arbitrary block to be used by the soap serialization or protocol. More...
|void||init (in nsISOAPAttachments aAttachments, in unsigned short aVersion)|
|Initialize the block for additional decoding information. |
|The namespace URI of the block. |
|The name of the block. |
|The encoding that was / will be applied to the block. |
|The schema type used to encode or decode the block. |
|The element which is the encoded value of this block. |
|The native value which is the decoded value of this block. |
This interface encapsulates an arbitrary block to be used by the soap serialization or protocol.
It presents the namespaceURI, name, encoding, schemaType, and value of the block. There are two different ways this may be used:
1. When created by a user for serialization, a value is set which is then used to encode the message. In this case, the user sets the value (or element in the case of a literal block) which is then encoded (unless it is the element) and incorporated into the document as it is encoded.
2. When requested by the user from a message that is to be decoded. In this case, an element is set on the block which is automatically decoded whenever the value attribute is accessed (possibly after the user sets the encoding or schemaType, or for literal blocks, the user just accesses the element and no decoding is performed. For SOAP which attachments, hidden attachments may also be associated from the message to the block so that later decoding which relies on the attachments is possible.
Initialize the block for additional decoding information.
|aAttachments||Attachments in case this refers to them.|
|aVersion||SOAP version for decoding special header attributes.|
The name of the block.
If the block is left unnamed, it will be encoded using the element types defined in the SOAP-ENC schema. For example,
<SOAP-ENC:int>45</SOAP-ENC:int> . If this is modified, element is set to null and all attributes computed from element revert to previous uncomputed values. If element is set, this becomes computed.
The native value which is the decoded value of this block.
If this is modified, element is set to null and all attributes computed from element revert to previous uncomputed values. If element is set, this becomes computed, relying on the value of encoding and schemaType each time it is computed.