one.world.core
Class SymbolicHandler

java.lang.Object
  |
  +--one.world.core.SymbolicHandler

All Implemented Interfaces:

EventHandler, Serializable

Direct Known Subclasses:

DiscoveredResource, LocalizedResource, NullHandler

public abstract class SymbolicHandler

extends Object

implements EventHandler, Serializable

The superclass of all symbolic event handlers. Unlike regular event handlers, symbolic event handlers do not directly provide any functionality. Rather, they carry some symbolic information that represents an actual event handler. As a result, symbolic event handlers are not wrapped when crossing concurrency domain or protection domain boundaries.

Version:

$Revision: 1.3 $

See Also:

Wrapper, Serialized Form

Constructor Summary

SymbolicHandler()
Create a new symbolic event handler.

Method Summary

void	handle(Event e) Handle an event.

Methods inherited from class java.lang.Object

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

Constructor Detail

SymbolicHandler

public SymbolicHandler()

Create a new symbolic event handler.

Method Detail

handle

public final void handle(Event e)

Handle an event. This handler sends an exceptional event that wraps an unsupported operation exception to the source of the specified event, unless the specified event is an exceptional event, in which case the event is simply logged.

Specified by:

handle in interface EventHandler

Throws:

UnsupportedOperationException - Signals that symbolic event handlers do not actually handle events.