sofya.ed.semantic
Interface ChainedEventListener

All Superinterfaces:

EventListener

All Known Implementing Classes:

AutomataController, ObjectFilter, ThreadFilter, TraceFileTarget

public interface ChainedEventListener
extends EventListener

Interface which indicates than an event listener can be made aware that it is associated with a subset of the stream of events being produced by the system under observation.

This interface facilitates the chaining of filters and targets (listeners which are terminal points in the event processing stream). In particular, it enables a listener to query recursively for information about filters which precede it in the processing chain so that it can report the nature of the filter chain in some meaningful way.

Version:

02/07/2005

Author:

Alex Kinneer

Nested Class Summary

Nested classes/interfaces inherited from interface sofya.ed.semantic.EventListener

EventListener.Arguments, EventListener.CallData, EventListener.ExceptionData, EventListener.FieldData, EventListener.MethodData, EventListener.MonitorData, EventListener.NewAllocationData, EventListener.ObjectData, EventListener.ThreadData, EventListener.ThreadStatus

Method Summary

ChainedEventListener	getParent() Gets the parent of this listener in the listener chain.
long	getStreamID() Gets the unique identifier associated with this event stream.
java.lang.String	getStreamName() Gets an informational name associated with this event stream.

Methods inherited from interface sofya.ed.semantic.EventListener

callReturnEvent, classPrepareEvent, constructorCallEvent, constructorEnterEvent, constructorExitEvent, exceptionCatchEvent, exceptionThrowEvent, executionStarted, instanceFieldAccessEvent, instanceFieldWriteEvent, interfaceCallEvent, monitorAcquireEvent, monitorContendEvent, monitorPreReleaseEvent, monitorReleaseEvent, newAllocationEvent, staticCallEvent, staticFieldAccessEvent, staticFieldWriteEvent, staticInitializerEnterEvent, staticMethodEnterEvent, staticMethodExitEvent, systemExited, systemStarted, threadDeathEvent, threadStartEvent, virtualCallEvent, virtualMethodEnterEvent, virtualMethodExitEvent

Method Detail

getParent

ChainedEventListener getParent()

Gets the parent of this listener in the listener chain.

Returns:

The event listener from which this listener receives events.

getStreamID

long getStreamID()

Gets the unique identifier associated with this event stream.

Returns:

An value which should uniquely identify this event stream, typically derived from some characteristic of the filtering criteria being applied by the parent listener.

getStreamName

java.lang.String getStreamName()

Gets an informational name associated with this event stream.

Returns:

A string which provides some description of the nature of the events handled by this string.