public class

JebEventSource

extends Object
implements IEventSource
java.lang.Object
   ↳ com.pnfsoftware.jeb.core.events.JebEventSource
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

The standard engines implementation of an IEventSource. Designed to emit JebEvents. After deserialization, the listeners list is empty, and the parent set to null (it is neither serialized nor automatically restored).

Summary

Fields
public static final AtomicInteger onEventCallCount
Public Constructors
JebEventSource()
Create an event with a null parent source.
JebEventSource(IEventSource parentSource)
Create an event source and hook it to a parent source.
Public Methods
void addListener(IEventListener listener)
Register a listener.
int countListeners()
Get the numbers of objects listening to this event source.
List<IEventListener> getListeners()
Get a copy of the list of listeners.
IEventSource getParentSource()
Get the parent source.
void insertListener(int index, IEventListener listener)
Register a listener.
void notifyListeners(JebEvent e, boolean notifyParent)
void notifyListeners(IEvent e)
Notify listeners that an event has occurred.
void notifyListeners(JebEvent e)
void removeListener(IEventListener listener)
Unregister a listener.
void setParentSource(IEventSource parentSource)
Set a parent source.
[Expand]
Inherited Methods
From class java.lang.Object
From interface com.pnfsoftware.jeb.util.events.IEventSource

Fields

public static final AtomicInteger onEventCallCount

Public Constructors

public JebEventSource ()

Create an event with a null parent source.

public JebEventSource (IEventSource parentSource)

Create an event source and hook it to a parent source. When this source notifies its observers of an event, the "parent source" will also be notified (regardless of the "parent source" being a listener of that observable).

Parameters
parentSource source that generated the event

Public Methods

public void addListener (IEventListener listener)

Register a listener. The listener is appended to the existing list of listeners. The implementor may allow duplicates.

Parameters
listener a listener of events generated by this source

public int countListeners ()

Get the numbers of objects listening to this event source.

Returns
  • the number of listeners

public List<IEventListener> getListeners ()

Get a copy of the list of listeners.

public IEventSource getParentSource ()

Get the parent source.

Returns
  • the parent source, or null if none

public void insertListener (int index, IEventListener listener)

Register a listener. The implementor may allow duplicates.

Parameters
index insertion point
listener a listener of events generated by this source

public void notifyListeners (JebEvent e, boolean notifyParent)

public void notifyListeners (IEvent e)

Notify listeners that an event has occurred.

Parameters
e the event to be propagated

public void notifyListeners (JebEvent e)

public void removeListener (IEventListener listener)

Unregister a listener. If the implementor allows duplicates in addListener(), it should deal with those consistently.

Parameters
listener the listener to be removed

public void setParentSource (IEventSource parentSource)

Set a parent source.

Parameters
parentSource the optional parent source