Name
connectiondatasource (LzConnectionDatasource) (as2) — The connection datasource to receive and send messages through the persistent connection.
Synopsis
- LZX: connectiondatasource
- JavaScript: LzConnectionDatasource
- Type: Class
- Access: public
- Runtimes: as2
- Topic: LFC.Data
- Declared in: WEB-INF/lps/lfc/data/platform/swf/LzConnectionDatasource.lzs
Description
Use the connectiondatasource tag to declare the
datasets that handle will handle the incoming data from a
connection. Unlike the
connection tag, the
connectiondatasource tag can be declared in
libraries.
You can use the connection datasource to send messages and receive the list of connected users.
Example 5. Sending and receiving asynchronous messages
<canvas debug="true" height="200" width="400">
<debug y="60"/>
<connection authenticator="anonymous">
<handler name="onconnect">
Debug.write("persistent connection established");
</handler>
<handler name="ondisconnect">
Debug.write("persistent connection closed");
</handler>
</connection>
<connectiondatasource name="mycd">
<dataset name="dsetMessage" />
<dataset name="dsetXML" />
</connectiondatasource>
<!-- Datapointer to listen for persistent connection messages -->
<datapointer xpath="mycd:dsetMessage:/*[1]">
<handler name="ondata">
var from = this.xpathQuery('/from[0]/@name');
var mesg = this.xpathQuery('/text()');
Debug.write("got message (from " + from + "): '"+ mesg + "'");
</handler>
</datapointer>
<!-- Datapointer to listen for persistent connection XML messages -->
<datapointer xpath="mycd:dsetXML:/*[1]">
<handler name="ondata">
var mesg = this.xpathQuery('/myxml/text()');
Debug.write("got xml mesg: '" + mesg + "'");
</handler>
</datapointer>
<!-- Datapointer to listen for result of sendMessage call. -->
<datapointer xpath="mycd:sendMessageDset:/*[1]">
<handler name="ondata" args="d">
Debug.write("d", d);
</handler>
<handler name="onerror" args="dset">
Debug.write("error sending message: " + dset.errorstring);
</handler>
</datapointer>
<!-- Datapointer to listen for result of sendXML call. -->
<datapointer xpath="mycd:sendXMLDset:/*[1]">
<handler name="ondata" args="d">
Debug.write("d", d);
</handler>
<handler name="onerror" args="dset">
Debug.write("error sending XML: " + dset.errorstring);
</handler>
</datapointer>
<view x="10" y="10" layout="class: simplelayout; axis: x; spacing: 10">
<button onclick="connection.connect()" text="connect" />
<button onclick="connection.disconnect()" text="disconnect" />
<button>send hello
<handler name="onclick">
mycd.sendMessage("*", "hello, world", "dsetMessage");
</handler>
</button>
<button>send XML
<handler name="onclick">
<![CDATA[
mycd.sendXML("*", "<myxml>hello, xml</myxml>", "dsetXML");
]]>
</handler>
</button>
</view>
</canvas>
See The Persistent Connection document for more information on the connection datasource and the persistent connection.
Sample-Apps
Sample applications that use the <connectiondatasource> tag are: