精华区文章阅读

发信人: yahooboy (复活鸟), 信区: POPsoft
标题: XML对象
发信站: 听涛站 (Sun Oct 8 18:20:57 2000), 转信

ML对象
使用方法来完成XML对象道具的载入、解析、发送、建立和操作XML文档树。
在你调用任何方法之前，你必须使用new XML()构造函数来建立XML对象的实体。然后，
在你调用任何操作XML文档元素或文本节点的方法之前，你必须调用createElement或cr
eateTextnode方法。使用XML接口对象来建立和管理接口连接，以便用来发送XML文档到
远程服务器上。
Flash5或以后版本的播放器将支持XML对象。
XML对象的方法摘要：
----------------------------------------------------------------------------
------
方法描述
----------------------------------------------------------------------------
------
appendChild(); 给指定对象的子树的末端增加一节点。
cloneNode(); 复制指定节点，并循环复制所有的子集。
createElement(); 给指定的XML对象建立新的XML元素。
createTextNode(); 给指定的XML对象建立新的XML文本节点。
hasChildNodes(); 如果指定的节点存在子集，返回真值；否则返回假值。
insertBefore(); 在指定的节点子树之内，在现有的节点之前插入一节点。
load(); 从指定的URL载入文档（通过XML对象指定）。
onLoad(); 针对load和sendAndLoad函数的复查函数。
parseXML(); 到指定的XML对象树中解析XML文档。
removeNode(); 从它的父集移除指定节点。
send(); 发送指定的XML对象到一个URL。
sendAndLoad(); 发送指定的XML对象到一个URL，并给服务器加载另一个XML对象。
toString(); 将指定的节点和其子树转变参展XML文本。
----------------------------------------------------------------------------
------
XML对象属性摘要：
----------------------------------------------------------------------------
------
方法描述
----------------------------------------------------------------------------
------
docTypeDecl 设置并返回关于XML文档的文件类型声明的信息。
firstChild(); 在指定节点的列表内，访问第一个子集。
lastChild(); 在指定节点的列表内，访问最后一个子集。
loaded(); 核对是否将指定XML对象载入。
nextSibling(); 在父集子树上，访问下一个兄弟集。
nodeName(); 返回XML元素的标志名。
nodeType(); 返回指定节点的类型（XML元素或文本节点）。
nodeValue(); 当指定节点为文本节点时，返回指定节点的文本。
parentNode(); 访问指定节点的父集。
previousSibling(); 在父集子树上，访问下一个兄弟集。
staus 返回数字的状态代码表示XML文档解析操作成功还是失败。
xmlDecl 设置并返回关于XML文档的文档声明的信息。
----------------------------------------------------------------------------
-------
XML对象类集摘要：
----------------------------------------------------------------------------
-------
方法描述
----------------------------------------------------------------------------
-------
attributes(); 返回联合数组，包含了指定节点的所有属性。
childNodes(); 返回数组，包含指定节点下所有可访问的子集。
----------------------------------------------------------------------------
-------
XML对象的构造函数new XML
语法:
new XML();
new XML(source);
参数：
source： XML文档，被解析后建立了新的XML对象。
描述：
构造函数，建立新的XML对象。你必须在调用任何XML对象方法之前使用用构造函数方法
建立新的XML对象实体。接着，你必须在调用任一存取或管理XML文档树结构的方法之前
，使用createElement或createTextnode方法。
第一条语句构造了一个新的空的XML对象。
第二条语句通过source参数指定并解析XML文档，构造新的XML对象，并将XML文档树结果
移入新建的XML对象中。
注意：createElement和createTextnode方法是用来在XML文档树中创建元素和文本节点
的构造函数方法。在你调用任一存取或管理节点的方法前，你必须调用其一。
播放器：
Flash 5 或以后版本。
范例：
下面的例子是建立新的空的XML对象。
myXML = new XML();
XML.appendChild
语法：
myXML .appendChild(childNode );
参数：
childNode：给指定XML对象子树列表增加的子集。
描述：
方法，增加指定节点到XML对象子树列中。这个增加的子集的位置与它现有的父集树结构
无关。要使用这方法，首先你必须使用createElement或createTextNode创建一个元素或
文本节点。
播放器：
Flash 5 或以后版本。
范例：
XML.attributes
语法：
myXML .attributes();
参数：
无
描述：
类集（可读写），返回联合数组，包含了指定XML对象的所有属性。要使用这方法，首先
你必须使用createElement或createTextNode创建一个元素或文本节点。
播放器：
Flash 5 或以后版本。
范例：
XML.childNodes
语法：
myXML .childNodes();
参数：
无
描述：
类集（只读），返回指定XML对象子集的数组。给与你所有可见的XML文档树，包括所有
节点、所有元素和所有子集。在每个数组元素是对XML对象子节点描绘的介绍。这是只读
属性，并不能用来管理子节点。只能使用appendChild,insertBefor和removeNode这些方
法来管理子节点。要使用这方法，首先你必须使用createElement或createTextNode创建
一个元素或文本节点。
这个类集未给文本节点（节点类型值为3）定义。
播放器：
Flash 5 或以后版本。
范例：
XML.cloneNode
语法：
myXML .cloneNode(deep );
参数：
deep：布尔值指定是否要将指定的XML对象的子集循环复制。
描述：
方法，创建并返回一个新的同指定XML对象一样相同类型、名称、数值和属性的XML节点
。如果deep设为真值，所有子节点将循环复制，结果是原样复制原始对象文档树。要使
用这方法，首先你必须使用createElement或createTextNode创建一个元素或文本节点。

播放器：
Flash 5 或以后版本。
范例：
XML.createElement
语法：
myXML .createElement(name );
参数：
name：将被建立的XML元素的名称。
描述：
方法，用参数指定元素名创建一个新的XML元素。新的元素刚开始没有父集和子集。这方
法和createTextNode构造函数方法，必须在使用其它XML对象方法之前调用。
播放器：
Flash 5 或以后版本。
范例：
XML.createTextNode
语法：
myXML .createTextNode(text );
参数：
text：这是用来建立新的文本节点。
描述：
方法，指定文本创建一个新的XML文本节点。新的节点刚开始没有父集，并且文本节点不
能有子集。这方法返回访问XML对象新文本节点的说明。这方法和XML.createElement构
造函数方法，必须在使用其它XML对象方法之前调用。
播放器：
Flash 5 或以后版本。
范例：
XML.docTypeDecl
语法：
myXML.XMLdocTypeDecl();
参数：
无
描述：
属性，设定并返回关于XML文档的文件类型声明的信息。当在XML文本被解析入XML对象之
后，XML对象的XML.docTypeDecl属性设定了XML文档的文件类型声明的文本。举例，<!D
OCTYPE greeting SYSTEM "hello.dtd">。这属性用一行类型声明来设定，不是一个XML
节点对象。动作角本的XML解析不只是一个确认解析。文件类型声明通过解析可读，并存
入docTypeDecl属性，但没执行文件类型定义确认。
如果在解析过程中没有文件类型声明，XML.docTypeDecl设置就没有定义。在XML声明存
入XML.xmlDecl之后，在任何其它文本在XML对象之前，XML.toString直接输出XML.docT
ypeDecl的内容。如果XML.docTypeDecl没有定义，将没有文件类型声明输出。
播放器：
Flash 5 或以后版本。
范例：
下面的例子是使用XML.docTypeDecl来设定文件类型声明给XML对象：
myXML ="<!DOCTYPE greeting SYSTEM \"hello.dtd \">";
参考：
XML.toString
XML.xmlDecl
XML.firstChild
语法：
myXML .firstChild();
参数：
无
描述：
属性（只读），访问指定XML对象父节点子树列的第一个子节点，当节点不存在子树列时
，这方法返回一空值。XML对象必须存在一个元素或文本节点。这是只读属性，不能用来
操作子节点。只有appendChild , insertBefore , 和 removeNode 这些方法才能操作子
节点。要使用这方法，首先你必须使用createElement或createTextNode创建一个元素或
文本节点。
播放器：
Flash 5 或以后版本。
参考：
XML.appendChild,insertBefor,removeNode
XML.haschildNodes
语法：
myXML .hasChildNodes();
参数：
无
描述：
方法，如果指定XML对象存在子节点，返回真值；否则返回假值。要使用这方法，首先你
必须使用createElement或createTextNode创建一个元素或文本节点。
播放器：
Flash 5 或以后版本。
范例：
XML.insertBefore
语法：
myXML .insertBefore(childNode,beforeNode );
参数：
childNode：此节点将加入。
beforeNode：此节点在childNode之前。
描述：
方法，在beforeNode之前，插入新的子节点到XML对象的子树列中，连接现有节点的父节
点。要使用这方法，首先你必须使用createElement或createTextNode创建一个元素或文
本节点。
播放器：
Flash 5 或以后版本。
范例：
XML.lastChild
语法：
myXML .lastChild();
参数：
无
描述：
属性（只读），在指定节点的列表内，访问最后一个子集。如果这节点不存在子节点，
这方法返回一个空值。要使用这方法，首先你必须使用createElement或createTextNod
e创建一个元素或文本节点。这是一个只读属性，不能用来操作子节点；只有appendChi
ld , insertBefore , 和 removeNode 这些方法才能操作子节点。
播放器：
Flash 5 或以后版本。
参考：
XML.appendChild,insertBefore,removeNode
XML.load
语法：
myXML .load(url );
参数：
url：根据URL载入指定的XML文档。这个URL必须同电影的当前位置一样有着相同的子域
。
描述：
方法，从指定的URL载入XML文档，并用下载的XML数据替换指定XML对象的内容。这载入
进程是不同步的；在load方法执行之后，它还没结束，XML对象属性loaded设为真值，而
且onLoad方法被呼叫。在完全下载之前，XML数据是不会被解析的。如果XML对象包含任
何XML树列，它们被丢弃。在onLoad方法进行之时，你能指定你特有的复查函数。
播放器：
Flash 5 或以后版本。
范例：
XML.loaded
语法：
myXML .loaded();
参数：
无
描述：
属性（只读），load调用完成，确定文档载入进行是否初始化。如果进行成功，方法返
回真值；反之，返回假值。
播放器：
Flash 5 或以后版本。
范例：
XML.nextSibling
语法：
myXML .nextSibling();
参数：
无
描述：
属性（只读），在父集子树上，访问下一个兄弟集。要使用这方法，首先你必须使用cr
eateElement或createTextNode创建一个元素或文本节点。这是一个只读属性，不能用来
操作子节点；只有appendChild , insertBefore , 和 removeNode 这些方法才能操作子
节点。
播放器：
Flash 5 或以后版本。
参考：
XML.appendChild,insertBefore,removeNode
XML.nodeName
语法：
myXML .nodeName();
参数：
无
描述：
属性，取得或返回XML对象的节点名。如果XML对象是一个XML元素（==1），节点名就是
在XML文件中描述节名的标记名。例如，, TITLE是HTML文档TITLE标记的节点名。如果X
ML对象是一个文本节点（==3），这节点名为空。要使用这方法，首先你必须使用creat
eElement或createTextNode创建一个元素或文本节点。
播放器：
Flash 5 或以后版本。
参考：
XML.nodeType
XML.nodeType
语法：
myXML .nodeType();
参数：
无
描述：
属性（只读），取得或返回节点类型数值，为1时是XML元素，为3时为文本节点。要使用
这方法，首先你必须使用createElement或createTextNode创建一个元素或文本节点。
播放器：
Flash 5 或以后版本。
参考：
XML.nodeValue
XML.nodeValue
语法：
myXML .nodeValue(x );(read)
myXML .nodeValue ="x ";(write)
参数：
x ：节点中的文本，假设这段文本是一个文本节点。
描述：
属性，返回XML对象的节点类型nodeType和节点数值nodeValue。如果XML对象是文本节点
，nodeType为3，并且nodeValue包含了节点中的文本。如果XML对象是XML元素，则是空
值和只读属性。要使用这方法，首先你必须使用createElement或createTextNode创建一
个元素或文本节点。
播放器：
Flash 5 或以后版本。
参考：
XML.nodeType
XML.onLoad
语法：
myXML .onLoad(function );
参数：
function：调用动作，这参数是可随项。
描述：
方法：如果function参数被指定，当XML对象从WEB服务器载入成荔，function被执行指
定动作。如果没有参数被指定，没有动作执行。详细信息请见load和sendAndLoad方法。

播放器：
Flash 5 或以后版本。
参考：
XML.load,sendAndLoad
XML.parentNode
语法：
myXML .parentNode();
参数：
无
描述：
属性（只读），访问指定XML对象的父节点。如果这节点没有父节点，则返回空值。要使
用这方法，首先你必须使用createElement或createTextNode创建一个元素或文本节点。
这是一个只读属性，不能用来操作子节点；只有appendChild , insertBefore , 和 re
moveNode 这些方法才能操作子节点。
播放器：
Flash 5 或以后版本。
范例：
XML.parseXML
语法：
myXML .parseXML(source );
参数：
source：经过解析通过成为指定XML对象的XML文档。
object.
描述：
方法：通过指定source参数解析XML文档，并且使用返回的结果--XML树组装成指定XML对
象。一切XML对象现有的树被丢弃。
播放器：
Flash 5 或以后版本。
范例：
XML.previousSibling
语法：
myXML .previousSibling();
参数：
描述：
属性（只读），访问指定子节点在父节点的子树列上的前一个兄弟节点。如果这个节点
没有前一个兄弟，则返回一个空值。要使用这方法，首先你必须使用createElement或c
reateTextNode创建一个元素或文本节点。这是一个只读属性，不能用来操作子节点；只
有appendChild , insertBefore , 和 removeNode 这些方法才能操作子节点。
播放器：
Flash 5 或以后版本。
范例：
XML.removeNode
语法：
myXML .removeNode();
参数：
无
描述：
方法；其父节点下，删除指定XML对象。要使用这方法，首先你必须使用createElement
或createTextNode创建一个元素或文本节点。
播放器：
Flash 5 或以后版本。
范例：
XML.send
语法：
myXML .send(url );
myXML .send(url,window );
参数：
url：指定成为XML对象的目标文件。
window：通过服务器将返回数据交给浏览器窗口显示：
_self 在当前窗口的当前框架内。
_blank 指定新的窗口。
_parent 指定当前框架的父窗口。
_top 指定当前窗口最高层的框架。
描述：
属性；将指定的XML对象编码转入XML文档，并使用POST方法给指定URL提交数据。
播放器：
Flash 5 或以后版本。
范例：
XML.sendAndLoad
语法：
myXML .sendAndLoad(url,targetXMLobject );
参数：
url：指定成为XML对象的目标文件。这个URL必须与当前动画档所在的URL在同一个子域
。
targetXMLobject：一个用构造函数方法建立的XML对象 An XML object created with
the constructor method.
描述：
方法：将指定的XML对象编码转入XML文档，并使用POST方法给指定URL提交数据，下传服
务器回应，然后通过指定参数载入到targetXML对象中。服务务回应也是通过load的方法
以同样的方式被载入。
播放器：
Flash 5 或以后版本。
范例：
XML.status
语法：
myXML .status();
参数：
无
描述：
属性，自动设置并返回数值，显示将XML文档解析为XML对象是成功或是失败。接着是每
个数字状态代码的列表：
0 没有错误：解析完全成功。
2 CDATA部分没有完全结束。
3 XML声明没有完全结束。
4 DOCTYPE声明没有完全结束。
5 注束没有完全结束。
6 XML元素畸形。
7 内存溢出。
8 属性数值没有完全结束。
9 起始标签与终止标签不相配。
10 只有终止标签而没有起始标签。
播放器：
Flash 5 或以后版本。
范例：
XML.toString
语法：
myXML .toString();
参数：
无
描述：
方法；针对XML对象的目标节点（使用createElement或createTextNode创建一个元素或
文本节点。）XML.toString求出指定XML对象的值，返回结果为字符串（XML的架构，包
括节点与子节点）。
针对最高层的XML对象（那些是用构造函数创建的）。XML.toString输出文档的XML声明
（存储在XML.xmlDecl），紧接的是文档的DOCTYPE声明（存储在XML.docTypeDel)，紧接
着是在对象中的所有节点的文字表现。如果XML.xmlDecl没定义，XML声明不输出。如果
XML.docTypeDecl没定义，DOCTYPE声明汪输出。
播放器：
Flash 5 或以后版本。
范例：
接来的范例，使用XML.toString来访问XML对象的节点：
node =new XML("<h1>test</h1>");
trace(node.toString());
//发送<H1>test</H1>在output窗口
参考：
XML.xmlDecl
XML.docTypeDecl
XML.xmlDecl
语法：
myXML .xmlDecl();
参数：
无
描述：
属性：设置并返回关于XML文档文件声明的信息。在XML文档解析为XML对象之后，这属性
是XML文档声明的文本来设定的。这属性是用XML文档声明的字符串，而不是XML节点对象
。如果在解析过程中没有XML声明，本属性没有定度。XML.toString输出XML.xmlDecl的
内容在XML对象的其它文本之前。如果XML.xmlDecl包含"undefined"类型，没有XML声明
输出。
XMLSocket对象
XMLSocket对象允许你控制接口连接，因此你能转移XML文档给XML兼容服务器，也可从X
ML兼容服务器转移出文档，加强客户端与服务器端交互性。要使用XMLSocket对象，你必
须先使用构造函数来建立新的XMLSocket对象。
播放器：
Flash 5 或以后版本。
范例：
接着是使用XML.xmlDecl给XML对象设定XML文档声明的例子：
myXML ="<?xml version=\"1.0 \"?>";
参见：
XML.toString
XML.docTypeDecl
XMLSocket对象方法概要：
----------------------------------------------------------------------------
-----------------------
方法描述：
----------------------------------------------------------------------------
-----------------------
close(); 结束公共接口连接。
connect(); 指定服务器建立连接。
onConnect(); 复查函数，当XML接口尝试连接时被调用。
onXML(); 复查函数，当来自服务器的XML对象来到达时被调用。
send(); 发送XML对象到服务器
----------------------------------------------------------------------------
-----------------------
XMLSocket对象的构造函数
new XMLSocket
语法：
new XMLSocket();
参数：
无。
描述：
构造函数，创建一个新的XMLSocket对象。
播放器：
Flash 5 或以后版本。
范例：
myXMLSocket = new XMLSocket();
XMLSocket.close
语法：
myXMLSocket .close();
参数：
无
描述：
方法；关闭指定XMLSocket对象的连接。
播放器：
Flash 5 或以后版本。
范例：
XMLSocket.connect
语法：
myXMLSocket .connect(host,port );
参数：
host：完全有效的DNS域名，或IP地址(aaa.bbb.ccc.ddd)。
port：在host上的端口号，用来建立连接。这端口号必须大于等于1024。
描述：
方法：指定因特网网址，指定TCP端口（必须大于等于1024）来建立连接。如果你不知道
你因特网网址机器的端口号，联系你的网络管理员。接口连接只能与同电影档URL相同子
域的网址相连接。
注意：如果FLASH插件或ActiveX控件开已使用，网址的指定必须与SWF文件播放的起源地
是相同子域。
播放器：
Flash 5 或以后版本。
范例：
XMLSocket.onClose
语法：
myXMLSocket .onClose();
参数：
无
描述：
方法；缺省值下，这方法没有任何作用，只有当服务器公共端口要关闭时才被呼叫。你
能重载这方法来执行你自身的动作。
播放器：
Flash 5 或以后版本。
范例：
XMLSocket.onConnect
语法：
myXMLSocket .onConnect(success );
参数：
success：不管接口连接是否成功，显示一个布尔值。（成功为真值，反之为假值）
描述：
方法；缺省值下，这方法没有作用，只有这方法被呼叫时。如果接口连接成功返回真值
，反之返回假值，你能重载这方法来执行你自身的动作。
播放器：
Flash 5 或以后版本。
See also
XMLSocket.connect
XMLSocket.onXML
语法：
myXMLSocket .onXML(data );
Argument
data：XML对象实体。
描述：
方法；缺省值下，这方法没有任何作用，只有当XML对象转移从服务器到FLASH通过公共
XMLSocket连接时才被呼叫。你能使用通过XML对象的返回值，重载无作用设置，并执行
用户定义的动作。
播放器：
Flash 5 或以后版本。
XMLSocket.send
语法：
myXMLSocket .send(data );
参数：
data：XML对象。
描述：
方法；通过指定XMLSocket连接发送XML对象到服务器。
播放器：
Flash 5 或以后版本。

--
※ 来源:．听涛站 cces.net．[FROM: 匿名天使的家]

computer 版 (精华区)