home *** CD-ROM | disk | FTP | other *** search
/ Symantec Visual Cafe for Java 2.5 / symantec-visual-cafe-2.5-database-dev-edition.iso / VCafe / prosrc.bin / DataBusEventListener.java < prev    next >
Encoding:
Java Source  |  1998-03-18  |  1.2 KB  |  28 lines
  1. /*
  2.  * @(#DataBusEventListener.java
  3.  *
  4.  * Copyright (c) 1997 Symantec Corporation. All Rights Reserved.
  5.  *
  6.  */
  7.  
  8. package symantec.itools.db.beans.binding.databus;
  9. public interface DataBusEventListener
  10. {
  11.  
  12.  //This method is called in order to inform an IB component of the coming or going of data items. The
  13.  //data item name is passed as a hint, and may be used in a subsequent requestDataItem() call. Note that
  14.  //it is possible (but unusual) that a subsequent call to requestDataItem() may fail even though the listener
  15.  //has "just" been informed of the new data item.
  16. public void handleDataBusEvent(DataBusEvent e);
  17.  
  18.  
  19.  //DataBusEventListeners are called by this method to see if they can fulfill a request for a data item. Note
  20.  //that solicitations for new data may arrive at any time. A source may respond to requests for data items
  21.  //which it did not announce (for example, a spreadsheet may respond to a request for item named
  22.  //"A1..B10", even though it may never have announced the availability of such an item).
  23.  
  24.  //Components that are not acting in the role of data source may ignore these events by implementing an
  25.  //empty requestDataItem() method.
  26. public  void requestDataItem(DataBusEvent e);
  27.  
  28. }