blob: 1afdce4896ef49b430103c48a8df94ac0fdb5800 [file] [log] [blame]
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>ECF New and Noteworthy</title>
<link rel="stylesheet" href="http://www.eclipse.org/default_style.css" type="text/css">
</head>
<body bgcolor="#FFFFFF">
<table border=0 cellspacing=5 cellpadding=2 width="100%">
<tbody>
<tr>
<td width="69%" class="bannertext">
<font class="indextop style">eclipse communication framework</font>
<br><br>
<font class="indexsub">an eclipse technology subproject</font>
<br><br>
<font class="indextop style2">New and Noteworthy</font><br>0.8.1 Stable Release</font>
<br><br><br>
Return to <a href="downloads.php">ECF download page</a></br>
Return to <a href="comm_resources.php">ECF communication resources page</a>
<br><br>
<a href="NewAndNoteworthy_0.4.0.html">New and Noteworthy for 0.4.0</a><br>
<a href="NewAndNoteworthy_0.5.2.html">New and Noteworthy for 0.5.2</a><br>
<a href="NewAndNoteworthy_0.5.4.html">New and Noteworthy for 0.5.4</a><br>
<a href="NewAndNoteworthy_0.6.0.html">New and Noteworthy for 0.6.0</a><br>
<a href="NewAndNoteworthy_0.6.2.html">New and Noteworthy for 0.6.2</a><br>
<a href="NewAndNoteworthy_0.7.0.html">New and Noteworthy for 0.7.0</a><br>
<a href="NewAndNoteworthy_0.7.5.html">New and Noteworthy for 0.7.5</a><br>
<a href="NewAndNoteworthy_0.7.6.html">New and Noteworthy for 0.7.6</a><br>
<a href="NewAndNoteworthy_0.8.0.html">New and Noteworthy for 0.8.0</a>
</td>
<td width="31%">
<div align="center">
<img src="../images/Idea.jpg" width="120" height="86" hspace="50" align="middle">
</div>
</td>
</tr>
</tbody>
</table>
<table>
<TR> <!----------------------------------------------------->
<TD colSpan=2> <HR> </TD>
</TR>
<TR><TD colSpan=2><H2>ECF API Additions and Changes</H2></TD>
<TR>
<TD vAlign=top align=left width="30%">
<p><br></p>
<P align=left>
<B>Datashare API for Channel Lifecycle Events</B>
</P>
</TD>
<TD vAlign=top width="70%">
<p><br></p>
<P>IChannel lifecycle events are now delivered via: <a href="http://www.eclipse.org/ecf/org.eclipse.ecf.docs/api/org/eclipse/ecf/datashare/IChannelContainerListener.html">IChannelContainerListener</a>.
Methods <a href="http://www.eclipse.org/ecf/org.eclipse.ecf.docs/api/org/eclipse/ecf/datashare/IAbstractChannelContainer.html#addChannelContainerListener(org.eclipse.ecf.datashare.IChannelContainerListener)">IChannelContainer.addChannelContainerListener</a>
and <a href="http://www.eclipse.org/ecf/org.eclipse.ecf.docs/api/org/eclipse/ecf/datashare/IAbstractChannelContainer.html#removeChannelContainerListener(org.eclipse.ecf.datashare.IChannelContainerListener)">IChannelContainer.removeChannelContainerListener</a>
have been added to <b>IChannelContainer</b> allow the registration of listeners prior to the creation of <b>IChannels</b> within the <b>IChannelContainer</b>.
</p><p>Datashare provider implementations <b>must</b> deliver IChannelContainerListeners instances of the following events when IChannel instances are
created, either via local calls to IChannelContainer.createChannel, or via remote calls to create replica <b>IChannels</b>. In either the local or remote case,
the following events are to be
delivered to IChannelContainerListeners:</p>
<p></p>
<p><b>IChannelContainerChannelActivatedEvent</b> - delivered when an IChannel within this container is first activated</p>
<p><b>IChannelContainerChannelDeactivatedEvent</b> - delivered when an IChannel within this container is deactivated</p>
Instances of these events must be delivered synchronously to all <b>IChannelContainerListeners</b>. In the case of the <b>IChannelContainerChannelActivatedEvent</b>, the event should
be delivered to all <b>IChannelContainerListeners</b> before any other messages are delivered to the channel.</p>
<p>Note that the reception of the <b>IChannelContainerChannelActivatedEvent</b> can be responded to by (for example), setting the IChannelListener on
the channel to the desired channel message handler (for handling <b>IChannelMessageEvents</b>).
</p>
<p>See example test code in the <b>org.eclipse.ecf.test.datashare</b> plugin, in the <b>DatashareFixedChannelTest</b>, <b>DatashareDynamicChannelTest</b>, and <b>DatashareCustomChannelTest</b> test classes.</p>
</TD>
</TR>
</table>
</body>
</html>