com.jivesoftware.base.event
Class GroupEvent

java.lang.Object
  
      com.jivesoftware.base.event.GroupEvent

public class GroupEvent
extends 

A class for group events. This class will be passed to GroupListeners whenever a group event is fired and contains all the pertinent information to the event.

Certain event types will populate the params Map with additional objects as outlined below:

Event Type

Extra Params

CREATED

None

GDELETED

None

USER_ADDED

A param named 'User' with a 'User' object as a payload

USER_DELETED

A param named 'User' with a 'User' object as a payload

ADMINISTRATOR_ADDED

A param named 'Administrator' with a 'User' object as a payload

ADMINISTRATOR_DELETED

A param named 'Administrator' with a 'User' object as a payload

MODIFIED

Reason	Name	Value
Name was modified	Type	nameModify
Name was modified	originalValue	The name before it was modified
Description was modified	Type	descriptionModify
Description was modified	originalValue	The description before it was modified
Property was modified	Type	propertyModify
Property was modified	PropertyKey	The name of the property
Property was modified	originalValue	The property value before it was modified
Property was added	Type	propertyAdd
Property was added	PropertyKey	The name of the new property
Property was deleted	Type	propertyDelete
Property was deleted	PropertyKey	The name of the property that is going to be deleted

Nested Class Summary

static class

GroupEvent.Type

Constructor Summary

GroupEvent()

GroupEvent(GroupEvent.Type eventType, Group group, Map<String,?> params)

Method Summary

boolean	equals(Object o)
Exception	getFailureException() Returns the exception that indicates why a listener failed to handle an event.
int	hashCode()
void	setFailureException(Exception e) Sets the exception that indicates why a listener failed to handle an event.

Methods inherited from class java.lang.Object

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

Constructor Detail

GroupEvent

public GroupEvent()

GroupEvent

public GroupEvent(GroupEvent.Type eventType,
                  Group group,
                  Map<String,?> params)

Method Detail

getFailureException

public Exception getFailureException()

Returns the exception that indicates why a listener failed to handle an event. This will return null if no exception occurred.

Sometimes the class triggering the event needs to know if any listeners for the event were unsuccessful for any reason. This is used internally by Jive classes and should be ignored by listener authors.

Returns:

the failure exception.

setFailureException

public void setFailureException(Exception e)

Sets the exception that indicates why a listener failed to handle an event.

Sometimes the class triggering the event needs to know if any listeners for the event were unsuccessful for any reason. Listeners can call this method to indicate that the event was not handled successfully in all cases. This is used internally by Jive classes ashould be ignored by listener authors.

Parameters:

e - the exception.

equals

public boolean equals(Object o)

hashCode

public int hashCode()