equip.data
Class DataCallbackPost

java.lang.Object
  equip.runtime.Object
      equip.runtime.ValueBase
          equip.data.DataCallback
              equip.data.DataCallbackPost

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

DataCallbackPostImpl

public abstract class DataCallbackPost

extends DataCallback

post-event callback interface, alternative to DataCallback, and normally more intuitive.

Use in place of a DataCallback object if you wish to receive a notification immediately AFTER an event has been enacted, e.g. after an add event has added its item to the environment.

Constructor Summary

DataCallbackPost()
Default no-arg constructor

Method Summary

boolean	_equals_helper(DataCallbackPost c) Internal IDL-generated equality test helper
boolean	_matches_helper(DataCallbackPost c) Internal IDL-generated match test helper
boolean	equals(java.lang.Object c) Standard IDL-generated equality test.
java.lang.String	getModuleName() IDL-generated helper routine to get module name (currently unimplemented).
boolean	matches(java.lang.Object c) Standard IDL-generated template match test.
abstract void	notifyPost(Event event, EventPattern pattern, boolean patternDeleted, DataSession session, DataProxy dataspace, ItemData oldValue, ItemBinding oldBinding, ValueBase closure) notification of a matched event or pseudo event.
void	readObject(ObjectInputStream in) Internal IDL-generated serialisation helper.
void	writeObject(ObjectOutputStream out) Internal IDL-generated serialisation helper.

Methods inherited from class equip.data.DataCallback

_equals_helper, _matches_helper, notify

Methods inherited from class equip.runtime.ValueBase

_equals_helper, _matches_helper, clone

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DataCallbackPost

public DataCallbackPost()

Default no-arg constructor

Method Detail

notifyPost

public abstract void notifyPost(Event event,
                                EventPattern pattern,
                                boolean patternDeleted,
                                DataSession session,
                                DataProxy dataspace,
                                ItemData oldValue,
                                ItemBinding oldBinding,
                                ValueBase closure)

notification of a matched event or pseudo event. As with DataCallback, you pass your own DataCallbackPost subclass as an argument to DataProxy.createSession(equip.data.DataCallback, equip.runtime.ValueBase) when creating a new DataSession. Note that post callbacks may be received AFTER a session or pattern has been deleted (if and only if this is done in a notify callback on the same event). NOTE: this class is not currently (2003-10-16) supported in the C++ version.

Parameters:

event - The matched event being enacted by the dataspace.

pattern - The pattern that was matched.

patternDeleted - Whether the pattern has been deleted as a result of the event, e.g. matched.

session - The DataSession generating this callback.

dataspace - The local dataspace generating this callback.

oldValue - (for update and delete only) the old value of the data item (before this event was enacted)

oldBinding - (for update and delete only) the old value of the item binding (before this event was enacted)

closure - As provided when the DataSession was created.

getModuleName

public java.lang.String getModuleName()

IDL-generated helper routine to get module name (currently unimplemented).

Overrides:

getModuleName in class DataCallback

Returns:

name of this class's module

equals

public boolean equals(java.lang.Object c)

Standard IDL-generated equality test.

Overrides:

equals in class DataCallback

Parameters:

c - The object to be compared against this.

Returns:

true if this is equal to c

_equals_helper

public boolean _equals_helper(DataCallbackPost c)

Internal IDL-generated equality test helper

matches

public boolean matches(java.lang.Object c)

Standard IDL-generated template match test.

Overrides:

matches in class DataCallback

Parameters:

c - The object to be checked against this template.

Returns:

true if this (as a template) matches the argument

_matches_helper

public boolean _matches_helper(DataCallbackPost c)

Internal IDL-generated match test helper

writeObject

public void writeObject(ObjectOutputStream out)
                 throws java.io.IOException

Internal IDL-generated serialisation helper. Used by ObjectInputStream and ObjectOutputStream only.

Overrides:

writeObject in class DataCallback

Throws:

java.io.IOException

readObject

public void readObject(ObjectInputStream in)
                throws java.io.IOException,
                       java.lang.ClassNotFoundException,
                       java.lang.InstantiationException

Internal IDL-generated serialisation helper. Used by ObjectInputStream and ObjectOutputStream only.

Overrides:

readObject in class DataCallback

Throws:

java.io.IOException

java.lang.ClassNotFoundException

java.lang.InstantiationException