using System; using System.Collections; using BCG.Utilities; using System.IO; namespace BCG { /// /// Some basic event handling functionality factorred out of any Stream whose behaviour /// is driven by some interface passed on by the user /// public abstract class MethodDrivenStream : ViewStream { protected ViewStream myStream; protected DataPacket myLastArrivedPacket; protected DataPacket myLastFiredPacket; protected bool myFireSwitch = true; public MethodDrivenStream(ViewStream vs) {myStream = vs;} /// /// Calls the base class's "change handlers". Sets the fireSwitch to true, so if /// the base class does not want to fire the packet, it should set the switch to false /// /// internal void myChangeHandler (object o) { myFireSwitch = true; myLastArrivedPacket = (DataPacket)o; if (myLastFiredPacket == null) { myHandleFirstCall (); myFireEvent (myLastFiredPacket.Clone ()); return; } if (myLastArrivedPacket.newRows.Count == 0) myOnTableClear (); else { myHandleIncrementalDelete (); myHandleIncrementalAdd (); } if (myFireSwitch) myFireEvent (myLastFiredPacket.Clone()); } /// /// Used for Unit Testing since handler is interal /// /// /// public void myChangeHandlerTest(object o) { myChangeHandler(o); } /// /// To handle the first call, the LastFiredPacket is supposed to be initialized and filled /// with data. /// protected abstract void myHandleFirstCall (); /// /// Handle incremenetal adds, and myLastFiredPacket filled with the resulting data /// protected abstract void myHandleIncrementalAdd(); /// /// Handle incremenetal deletes, and myLastFiredPacket filled with the resulting data /// protected abstract void myHandleIncrementalDelete(); protected virtual void myInit () { myLastFiredPacket = null; myLastArrivedPacket = null; } protected abstract void myOnTableClear (); protected override void myOnFirstSubscriber() { myStream.onChange += new DataStream.ChangeDelegate (myChangeHandler); } protected override void myOnLastSubscriber () { myStream.onChange -= new DataStream.ChangeDelegate (myChangeHandler); } } }