io.divide.otto

Class EventHandler

java.lang.Object

io.divide.otto.EventHandler

public class EventHandler
extends java.lang.Object

Wraps a single-argument 'handler' method on a specific object.

This class only verifies the suitability of the method and event type if something fails. Callers are expected t verify their uses of this class.

Two EventHandlers are equivalent when they refer to the same method on the same object (not class). This property is used to ensure that no handler method is registered more than once.

Constructor Summary

Constructors

Constructor and Description
EventHandler(java.lang.Object target, java.lang.reflect.Method method)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
void	handleEvent(java.lang.Object event) Invokes the wrapped handler method to handle event.
int	hashCode()
void	invalidate() If invalidated, will subsequently refuse to handle events.
boolean	isValid()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

EventHandler

public EventHandler(java.lang.Object target,
            java.lang.reflect.Method method)

Method Detail

isValid

public boolean isValid()

invalidate

public void invalidate()

If invalidated, will subsequently refuse to handle events. Should be called when the wrapped object is unregistered from the Bus.

handleEvent

public void handleEvent(java.lang.Object event)
                 throws java.lang.reflect.InvocationTargetException

Invokes the wrapped handler method to handle event.

Parameters:

event - event to handle

Throws:

java.lang.IllegalStateException - if previously invalidated.

java.lang.reflect.InvocationTargetException - if the wrapped method throws any Throwable that is not an Error (Errors are propagated as-is).

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object