rocks.xmpp.core.stanza

Class IQEvent

java.lang.Object

java.util.EventObject

rocks.xmpp.core.stanza.IQEvent

All Implemented Interfaces:

java.io.Serializable

public final class IQEvent
extends java.util.EventObject

An IQ event is fired whenever an IQ stanza is received or sent.

This class is immutable.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IQEvent(java.lang.Object source, IQ iq, boolean inbound) Constructs an IQ event.

Method Summary

Modifier and Type	Method and Description
void	consume() Marks this event as consumed.
IQ	getIQ() Gets the IQ stanza.
boolean	isConsumed() Indicates, whether this event has been consumed.
boolean	isInbound() Indicates, whether the stanza has been received (inbound) or is about to being sent (outbound).
java.lang.String	toString()

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

IQEvent

public IQEvent(java.lang.Object source,
               IQ iq,
               boolean inbound)

Constructs an IQ event.

Parameters:

source - The object on which the event initially occurred.

iq - The IQ stanza.

inbound - True, if the stanza is inbound.

Throws:

java.lang.IllegalArgumentException - if source is null.

Method Detail

getIQ

public final IQ getIQ()

Gets the IQ stanza.

Returns:

The IQ stanza.

isInbound

public final boolean isInbound()

Indicates, whether the stanza has been received (inbound) or is about to being sent (outbound).

Returns:

True, if the stanza is inbound; false if it is outbound.

consume

public final void consume()

Marks this event as consumed. For outbound stanzas, consuming this event cancels sending the stanza.

See Also:

isConsumed()

isConsumed

public final boolean isConsumed()

Indicates, whether this event has been consumed.

Returns:

True, if this event has been consumed.

See Also:

consume()

toString

public final java.lang.String toString()

Overrides:

toString in class java.util.EventObject