284
EXTENDING FIREWORKS
Cross-Product Extensions
Las
t
up
d
a
ted
12/8/2009
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.
Parameters
Parameters are simply data nodes with an
order
attribute. The
order
attribute identifies the order in which the
parameters should be processed for the server. In this way, the RPC client can use any XML client library to build
parameters in any order, and the RPC server retains the correct parameter order. The first parameter should have the
order
attribute set to 0; the second, to 1; and so on, as in this example:
<string order="1" value="bob" />
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.
Содержание 65011817 - Fireworks CS4 - Mac
Страница 1: ...Extending ADOBE FIREWORKS CS4...