com.ibm.retail.AEF.client
Interface AEFPropertyListenerProxy

All Superinterfaces:
java.rmi.Remote
All Known Implementing Classes:
AEFPropertyListenerProxyImpl

public interface AEFPropertyListenerProxy
extends java.rmi.Remote

The AEFPropertyListenerProxy interface defines a proxy interface for remote listeners to monitor the AEFPropertyChanges of its associated terminal session.

Remote proxy objects extend the appropriate RMI server classes which handle the RMI duties for the client (so the client does not need to deal with rmi server issues). The proxy objects also perform the role of event dispatching.

By default, the listener proxy object will perform event queuing on an AEF event thread. This relieves the client of any "thread swapping" responsibilities and insures that the AEF event dispatching performance is not affected by client processing. To override this default behavior, use the setDispatchQueue() method. The proxy utilizes the EventDispatcher for queueing event listener notification.

To use a proxy object, the client must implement the listener interface and get the POSDataProvider object from the AEFSession to monitor. The proxy object is then constructed passing a reference to the client and the data provider. The proxy object performs the listener registration and forwards all events from the data provider to the client.

See Also:
Sample Usage, EventDispatcher

Method Summary
 void addAEFPropertyChangeListener()
          Add a property change listener to listen to all data provider events.
 void addAEFPropertyChangeListener(java.lang.String category)
          Add a filtered property change listener to listen to data provider events for a specific category.
 void addAEFPropertyChangeListener(java.lang.String category, java.lang.String property)
          Add a filtered property change listener to listen to data provider events for a specific property.
 void removeAEFPropertyChangeListener()
          Remove a property change listener.
 void removeAEFPropertyChangeListener(java.lang.String category)
          Remove a filtered property change listener.
 void removeAEFPropertyChangeListener(java.lang.String category, java.lang.String property)
          Remove a filtered property change listener.
 

Method Detail

addAEFPropertyChangeListener

public void addAEFPropertyChangeListener()
                                  throws java.rmi.RemoteException
Add a property change listener to listen to all data provider events.

Throws:
java.rmi.RemoteException - if remote access fails

removeAEFPropertyChangeListener

public void removeAEFPropertyChangeListener()
                                     throws java.rmi.RemoteException
Remove a property change listener.

Throws:
java.rmi.RemoteException - if remote access fails

addAEFPropertyChangeListener

public void addAEFPropertyChangeListener(java.lang.String category)
                                  throws java.rmi.RemoteException
Add a filtered property change listener to listen to data provider events for a specific category.

Parameters:
category - identifies the category of data
Throws:
java.rmi.RemoteException - if remote access fails

removeAEFPropertyChangeListener

public void removeAEFPropertyChangeListener(java.lang.String category)
                                     throws java.rmi.RemoteException
Remove a filtered property change listener.

Parameters:
category - identifies the category of data
Throws:
java.rmi.RemoteException - if remote access fails

addAEFPropertyChangeListener

public void addAEFPropertyChangeListener(java.lang.String category,
                                         java.lang.String property)
                                  throws java.rmi.RemoteException
Add a filtered property change listener to listen to data provider events for a specific property.

Parameters:
category - identifies the category of data
property - identifies the property data
Throws:
java.rmi.RemoteException - if remote access fails

removeAEFPropertyChangeListener

public void removeAEFPropertyChangeListener(java.lang.String category,
                                            java.lang.String property)
                                     throws java.rmi.RemoteException
Remove a filtered property change listener.

Parameters:
category - identifies the category of data
property - identifies the property data
Throws:
java.rmi.RemoteException - if remote access fails


Copyright © 2004 IBM. All Rights Reserved.
Generated: July 19 2004