ej.microui.event

Class EventGenerator

java.lang.Object

ej.microui.event.EventGenerator

Direct Known Subclasses:

Buttons, Command, GenericEventGenerator, Keyboard, States

public abstract class EventGenerator
extends java.lang.Object

Event generators generate int-based events (see Event). They are responsible for holding data that cannot be sent within the event. Event generators are state machines that convert serialized (mostly external) integers to MicroUI events.

There is a system pool that holds generators. A generator in the system pool has an ID between 0 and 254, otherwise ID is 0xFF. The advantage of putting a generator in the system pool is that it can then be looked-up using get(int) and get(Class, int).

See Also:

Event

Constructor Summary

Constructors

Constructor and Description
EventGenerator() Creates a new event generator.

Method Summary

Modifier and Type	Method and Description
int	addToSystemPool() Adds the generator in the system pool.
static <E extends EventGenerator> EventGenerator[]	get(java.lang.Class<E> clazz) Gets all generators of the given type from the system pool in an array.
static <E extends EventGenerator> E	get(java.lang.Class<E> clazz, int fromIndex) Gets a generator whose class is clazz from the system pool starting the search from fromIndex.
static EventGenerator	get(int id) Gets a generator from its id.
EventHandler	getEventHandler() Gets the generator's event handler.
abstract int	getEventType() Gets the event type associated with the event generator
int	getID() Gets the generator's unique id.
static <E extends EventGenerator> java.util.List<E>	getList(java.lang.Class<E> clazz) Gets all generators of the given type from the system pool in a list.
void	removeFromSystemPool() Removes the generator from the system generators pool.
protected void	sendEvent(int event) Sends the given event to the current EventHandler.
void	setEventHandler(EventHandler eventHandler) Sets an event handler to this event generator.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventGenerator

public EventGenerator()

Creates a new event generator. As soon as a new event generator is added to the system pool it has a valid id.

Method Detail

addToSystemPool

public int addToSystemPool()

Adds the generator in the system pool. The generator can only be added once as a system generator. When added, its id is set.

Returns:

the event generator's id in the system pool.

Throws:

java.lang.RuntimeException - if the maximum number of event generators added to the system pool has been reached

removeFromSystemPool

public void removeFromSystemPool()

Removes the generator from the system generators pool. If the generator is not in the pool, nothing is done.

setEventHandler

public void setEventHandler(EventHandler eventHandler)
                     throws java.lang.SecurityException

Sets an event handler to this event generator. It will receive the generated events.

It replaces the old one and can be null.

Parameters:

eventHandler - the event handler to add.

Throws:

java.lang.SecurityException - if a security manager exists and does not allow the caller to handle events from this event generator.

Since:

2.0

get

public static EventGenerator get(int id)

Gets a generator from its id.

Parameters:

id - the generator's id.

Returns:

the associated event generator.

Throws:

java.lang.IndexOutOfBoundsException - if the generator does not exist.

get

public static <E extends EventGenerator> E get(java.lang.Class<E> clazz,
                                               int fromIndex)

Gets a generator whose class is clazz from the system pool starting the search from fromIndex. If class clazz is not an EventGenerator or if nothing is found, returns null.

Parameters:

clazz - the EventGenerator's class to return

fromIndex - index from which starting to search

Returns:

the EventGenerator or null.

Throws:

java.lang.NullPointerException - if the given class is null.

get

public static <E extends EventGenerator> EventGenerator[] get(java.lang.Class<E> clazz)

Gets all generators of the given type from the system pool in an array.

Parameters:

clazz - the type of the event generators to return.

Returns:

the arrays of event generators.

getList

public static <E extends EventGenerator> java.util.List<E> getList(java.lang.Class<E> clazz)

Gets all generators of the given type from the system pool in a list.

Parameters:

clazz - the type of the event generators to return.

Returns:

the list of event generators.

Since:

2.0

getID

public int getID()

Gets the generator's unique id. Up to 254 EventGenerators can be installed as MicroUI system event generator.

Returns:

the generator's id as an int.

getEventHandler

public EventHandler getEventHandler()

Gets the generator's event handler.

Returns:

the generator's event handler.

Since:

2.0

getEventType

public abstract int getEventType()

Gets the event type associated with the event generator

Returns:

the event type

sendEvent

protected void sendEvent(int event)

Sends the given event to the current EventHandler. Does nothing if there is no event handler set to this event generator.

Parameters:

event - the event to send