home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 November / Chip_1998-11_cd.bin / tema / Cafe / prosrc.bin / DataBusEvent.java < prev    next >
Text File  |  1998-03-18  |  2KB  |  84 lines
  1. /*
  2.  * @(#DataBusEvent.java
  3.  *
  4.  * Copyright (c) 1997 Symantec Corporation. All Rights Reserved.
  5.  *
  6.  */
  7.  
  8. //This class specifies an IB event for a DataItem. The IB event's parameters include
  9. //   the data item name, which should be descriptive enough to allow a data consumer to decide whether to obtain
  10. //   the data item.
  11.  
  12. //  the event type, which is one of DATA_AVAILABLE, DATA_REVOKED, or DATA_REQUEST.
  13.  
  14. //  the object that created the event.
  15. //  the data item referred to by the event
  16.  
  17. package symantec.itools.db.beans.binding.databus;
  18.  
  19. public  class DataBusEvent extends java.util.EventObject
  20. {
  21.      //DATA_AVAILABLE
  22.      //Event type sent by a source to announce the availability of the named DataItem.
  23. public static final int DATA_AVAILABLE =0;
  24.  
  25.      //DATA_REVOKED
  26.      //Event type sent by a source to indicate that an existing DataItem is no longer available.
  27. public static final int DATA_REVOKED =1;
  28.  
  29.      //DATA_REQUEST
  30.      //Event type sent by a consumer to request the DataItem matching a specified dataItemName,
  31.      //from the sources on the bus.
  32. public static final int DATA_REQUEST =2;
  33.  
  34. private int ty;
  35. private String itNa;
  36. private DataItem di;
  37.  
  38. public DataBusEvent(int type, String itemName, Object source)  throws InvalidType
  39. {
  40.     super(source);
  41.     if ((type < DATA_AVAILABLE) || ( type > DATA_REQUEST))
  42.             throw new InvalidType();
  43.     else
  44.             ty=type;
  45.     itNa=itemName;
  46. }
  47.  
  48. public DataBusEvent(int type, String itemName, Object source, DataItem d)throws InvalidType
  49. {
  50.     super(source);
  51.     if ((type < DATA_AVAILABLE) || ( type > DATA_REQUEST))
  52.             throw new InvalidType();
  53.     else
  54.             ty=type;
  55.     itNa=itemName;
  56.     di=d;
  57. }
  58.      //These methods construct an IB event object for a data item. The first constructor leaves the item data
  59.      //to be filled in later, when requested, while the second one supplies it.
  60.  
  61. public  DataItem getDataItem()
  62. {
  63.     return di;
  64. }
  65.  
  66. public  void setDataItem(DataItem d)
  67.      //These methods are for the source and consumer of the data to set and get the data item associated
  68.      //with the event.
  69.      {
  70.         di=d;
  71.      }
  72.  
  73. public  int getEventType()
  74. {
  75.     return ty;
  76. }
  77.  
  78. public  String getDataItemName()
  79.      //These methods allow the data consumer to look at the event type and data item name to find out what
  80.      //kind of data the data item holds.
  81.      {
  82.         return itNa;
  83.      }
  84. }