|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.util.EventObject javax.tv.service.SIChangeEvent
SIChangeEvent
objects are sent to
SIChangeListener
instances to signal detected changes
in the SI database.
Note that while the SI database may detect changes, notification of
which specific SIElement
has changed is not guaranteed.
The entity reported by the method getSIElement()
will
be either:
null
, if the specific changed element is unknown.
SIChangeEvent
instances also report the kind of change
that occurred to the SI element, via the method
getChangeType()
:
SIChangeType
of ADD
indicates that
the reported SI element is new in the database.
SIChangeType
of REMOVE
indicates
that the reported SI element is defunct and no longer cached by the
database. The results of subsequent method invocations on the
removed SIElement are undefined.
SIChangeType
of MODIFY
indicates
that the data encapsulated by the reported SI element has changed.
null
), the
SIChangeType
will be MODIFY
.
Individual SI element changes are reported only once, i.e.,
a change to an SI element is not also reported as a change
to any containing (or "parent") SI elements.
getSIElement()
,
getChangeType()
,
Serialized FormField Summary |
Fields inherited from class java.util.EventObject |
source |
Constructor Summary | |
SIChangeEvent(java.lang.Object source,
SIChangeType type,
SIElement e)
Constructs an SIChangeEvent object. |
Method Summary | |
SIChangeType |
getChangeType()
Indicates the type of change that occurred. |
SIElement |
getSIElement()
Reports the SIElement that changed. |
Methods inherited from class java.util.EventObject |
getSource, toString |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public SIChangeEvent(java.lang.Object source, SIChangeType type, SIElement e)
SIChangeEvent
object.
source
- The entity in which the change occurred.type
- The type of change that occurred.e
- The SIElement
that changed, or
null
if this is unknown.Method Detail |
public SIElement getSIElement()
SIElement
that changed.
This method may return null
, since it is not
guaranteed that the SI database can or will determine which
element in a particular table changed.
SIElement
that changed, or
null
if this is unknown.public SIChangeType getChangeType()
|
JSR-927 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |