sofya.ed.semantic
Interface ChainedEventListenerFactory

public interface ChainedEventListenerFactory

Interface which indicates that an object is capable of acting as a factory for producing event listeners which are aware of an association with a filtered event stream produced by an EventFilter.

Classes which implement this factory interface are intended to be used with event filters which split a single event stream into multiple event streams based on some correlation of events with particular program entities, such as threads or object instances. Such filters may need to be able to create new listeners on demand, since it is often the case that it is not possible to know a priori how many entities will be created by the program.

Version:

06/10/2005

Author:

Alex Kinneer

Method Summary

ChainedEventListener

createEventListener(ChainedEventListener parent, long streamId, java.lang.String streamName) Creates a new event listener to be associated with a particular program entity.

Method Detail

createEventListener

ChainedEventListener createEventListener(ChainedEventListener parent,
                                         long streamId,
                                         java.lang.String streamName)
                                         throws FactoryException

Creates a new event listener to be associated with a particular program entity.

Parameters:

parent - Event listener from which the newly created chained listener will receive events. It is left to implementors' discretion whether to permit the passing of null, though it is generally not recommended.

streamId - Unique identifier associated with the program entity, or in the more generic sense, the event stream, to which this listener will be attached.

streamName - Name of the entity or entity type associated with the stream.

Throws:

FactoryException