Data node

The data node is the most important type of XML node in RPC. Methods called through the func operation need to act on actual data or references to server objects identified in data nodes. The data nodes are used as parameters and parts of replies. There are several types of data nodes, as described in the following table.

Data type Node name Example Description

array

array

<array><string value="stuff" /><int value="50" /></array>

An array data type. It is simply a container node for the other data nodes. There are no restrictions on how many subelements it can contain or which types it can contain. The contained data nodes may be of the same type or of different types. No additional attributes have to be added to the contained nodes.

Boolean

bool

<bool value="true" />

The Boolean data type. It can contain either true or false and nothing else. Note that the values are case sensitive.

dictionary

dict

<dict><double key="foo" value="5.0" /><string key="bar" value="fred" /></dict>

A dictionary data type. Like the array data type, it is simply a container for other data nodes. Each direct child node of a dictionary node must contain an additional key attribute. The key attribute is a string and must be unique for the given dictionary node. The key string must start with a letter or an underscore (_) and may followed by numbers, letters, or underscores. Dictionary nodes can be used to pass objects by value.

float

double

<double value="1.2345" />

The floating-point data type. It can contain any floating-point (real) number within the range 1.7e +/- 308.

integer

int

<int value="50" />

The integer data type. It can contain any signed integer in the range -2,147,483,648 through 2,147,483,647.

null

null

<null />

The null type has only one value: null. The null type automatically coerces into the string type, array type, dictionary type, and the server object type. The null type cannot have any attributes or sub-elements.

server object

obj

<obj value="fw" class="Fireworks" />

The server object data type. The value attribute is set to the object ID. The class attribute is optional. The server always specifies the object class when sending replies to the client. The client, however, is not required to specify the class when sending server object nodes to the server. The class attribute tells the client what properties and methods are available on an object.

string

string

<string value="foo" />

A string data type. It can contain a

UTF-8-encoded string. If you include special characters, you must "escape" them (indicate that they are part of the string) according to the method described in the XML Data Model (from http://www.w3.org/XML/Datamodel.html). Most XML writing packages automatically do this.

void

void

<void />

No value; no type. Cannot have any attributes or subelements.


 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/fireworks/8/fwextending/fw_03_c6.htm