NewAndNoteworthy_0.8.1.html

<!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>