echopoint
Class ExternalEventMonitor

java.lang.Object
  nextapp.echo.Component
      echopoint.ExternalEventMonitor

All Implemented Interfaces:

java.io.Serializable

public class ExternalEventMonitor

extends nextapp.echo.Component

A ExternalEventMonitor can be used to monitor external events that come in via web request URIs.

ExternalEventMonitor will inform all attached ExternalEventListeners about those web request events.

ExternalEventMonitor looks for web application requests with the special marker "E_id=ExternalEvent". This allows other web pages (especially non Echo based ones) to link to the Echo web application via an URI, say something like :

 /servletcontext/servlet?E_id=ExternalEvent&p1=v1&p2=v2..
 

The parameters of the web request are packaged into a Map and placed within the ExternalEvent object.

ExternalEventMonitor is a non visual component.

See Also:

ExternalEvent, ExternalEventListener, Serialized Form

Field Summary

Fields inherited from class nextapp.echo.Component

BACKGROUND_CHANGED_PROPERTY, CHILDREN_CHANGED_PROPERTY, ENABLED_CHANGED_PROPERTY, FONT_CHANGED_PROPERTY, FOREGROUND_CHANGED_PROPERTY, IDENTIFIER_CHANGED_PROPERTY, LOCALE_CHANGED_PROPERTY, MODEL_CHANGED_PROPERTY, STYLE_BACKGROUND, STYLE_FONT, STYLE_FOREGROUND, UPDATE_PROPERTY, VISIBLE_CHANGED_PROPERTY

Constructor Summary

ExternalEventMonitor()
Constructs an ExternalEventMonitor

Method Summary

void	addExternalEventListener(ExternalEventListener l) Adds an ExternalEventListener to the ExternalEventMonitor
void	fireExternalEvent(ExternalEvent externalEvent) This is called by the support code to inform all ExternalEventListeners that an external event has ocurred.
void	removeExternalEventListener(ExternalEventListener l) Removes an ExternalEventListener from the ExternalEventMonitor

Methods inherited from class nextapp.echo.Component

add, add, addHierarchyListener, addPropertyChangeListener, applyStyle, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getComponent, getComponentCount, getComponents, getEchoInstance, getFont, getForeground, getIdentifier, getLocale, getParent, indexOf, init, isAncestorOf, isEnabled, isRegistered, isShowing, isVisible, remove, remove, removeAll, removeHierarchyListener, removePropertyChangeListener, setBackground, setEnabled, setFont, setForeground, setIdentifier, setLocale, setVisible, update, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

ExternalEventMonitor

public ExternalEventMonitor()

Constructs an ExternalEventMonitor

Method Detail

addExternalEventListener

public void addExternalEventListener(ExternalEventListener l)

Adds an ExternalEventListener to the ExternalEventMonitor

Parameters:

l - the ExternalEventListener to add

removeExternalEventListener

public void removeExternalEventListener(ExternalEventListener l)

Removes an ExternalEventListener from the ExternalEventMonitor

Parameters:

l - the ExternalEventListener to remove

fireExternalEvent

public void fireExternalEvent(ExternalEvent externalEvent)

This is called by the support code to inform all ExternalEventListeners that an external event has ocurred. This is method not designed to be called by Echo applications.

Parameters:

externalEvent - - the new ExternalEvent