com.atlassian.jira.event.issue
Class IssueEvent

java.lang.Object
  com.atlassian.jira.event.AbstractEvent
      com.atlassian.jira.event.issue.IssueEvent

All Implemented Interfaces:

JiraEvent

public final class IssueEvent
extends AbstractEvent

Basic representation of something that happens to an Issue, such as a modification or comment. Event listeners register to receive these.

The IssueEvent object thrown as a result of an edit operation, may now return null from a getChangeLog() call. This can occur when a user chooses to edit an issue but only leaves a comment and makes no other changes to the issue.

Prior to 3.5.2 no event was fired in this case and this was identified as a bug (JRA-9415) and has since been fixed. Check any calls to getChangeLog() for null.

See Also:

IssueEvent

Field Summary

static String	BASE_URL_PARAM_NAME Key of event parameter holding the application's base URL.
static String	CUSTOM_FIELDS_PARAM_NAME In case of issue delete events, a param with this key may store the custom field values of the deleted issue.
static String	SEND_MAIL
static String	WATCHERS_PARAM_NAME In case of issue delete events, a param with this key may store list of this issue's watchers as a list of User objects.

Fields inherited from class com.atlassian.jira.event.AbstractEvent

params, time

Constructor Summary

IssueEvent(Issue issue, Map params, com.atlassian.crowd.embedded.api.User user, Long eventTypeId)
Create a new IssueEvent with a given list of parameters.

IssueEvent(Issue issue, Map params, com.atlassian.crowd.embedded.api.User user, Long eventTypeId, boolean sendMail)
Allows configuration of whether the mail notification should be sent

IssueEvent(Issue issue, com.atlassian.crowd.embedded.api.User user, Comment comment, Worklog worklog, org.ofbiz.core.entity.GenericValue changeGroup, Map params, Long eventTypeId)
Create a new IssueEvent with a given list of parameters.

IssueEvent(Issue issue, com.atlassian.crowd.embedded.api.User user, Comment comment, Worklog worklog, org.ofbiz.core.entity.GenericValue changeGroup, Map params, Long eventTypeId, boolean sendMail)
Create a new IssueEvent with a given list of parameters.

IssueEvent(Issue issue, com.atlassian.crowd.embedded.api.User user, Comment comment, Worklog worklog, org.ofbiz.core.entity.GenericValue changeGroup, Map params, Long eventTypeId, boolean sendMail, boolean subtasksUpdated)

Method Summary

boolean	equals(Object o) Note: this will not compare the time stamps of two events - only everything else.
org.ofbiz.core.entity.GenericValue	getChangeLog()
Comment	getComment()
Long	getEventTypeId()
Issue	getIssue()
Project	getProject()
com.atlassian.crowd.embedded.api.User	getUser() Returns the user who initiated this event.
Worklog	getWorklog()
int	hashCode()
boolean	isSendMail()
boolean	isSubtasksUpdated()
void	setWorklog(Worklog worklog)
String	toString()

Methods inherited from class com.atlassian.jira.event.AbstractEvent

getParams, getTime

Methods inherited from class java.lang.Object

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

Field Detail

SEND_MAIL

public static final String SEND_MAIL

See Also:

Constant Field Values

BASE_URL_PARAM_NAME

public static final String BASE_URL_PARAM_NAME

Key of event parameter holding the application's base URL.

CUSTOM_FIELDS_PARAM_NAME

public static final String CUSTOM_FIELDS_PARAM_NAME

In case of issue delete events, a param with this key may store the custom field values of the deleted issue.

NOTE: this parameter is not guaranteed to exist so explicit check in the event parameters map must be performed by the clients. If not found, the custom field values may be retrieved by means of field manager from the issue object associated with the event.

WATCHERS_PARAM_NAME

public static final String WATCHERS_PARAM_NAME

In case of issue delete events, a param with this key may store list of this issue's watchers as a list of User objects.

NOTE: this parameter is not guaranteed to exist so explicit check in the event parameters map must be performed by the clients. If not found, the value may be retrieved via IssueManager.getWatchers(com.atlassian.jira.issue.Issue).

Constructor Detail

IssueEvent

public IssueEvent(Issue issue,
                  Map params,
                  com.atlassian.crowd.embedded.api.User user,
                  Long eventTypeId)

Create a new IssueEvent with a given list of parameters.

Parameters:

issue - the issue this event refers to

params - parameters that can be retrieved by the Listener

user - the user who has initiated this event

eventTypeId - the type ID of this event

IssueEvent

public IssueEvent(Issue issue,
                  Map params,
                  com.atlassian.crowd.embedded.api.User user,
                  Long eventTypeId,
                  boolean sendMail)

Allows configuration of whether the mail notification should be sent

Parameters:

issue - the issue this event refers to

params - parameters that can be retrieved by the Listener

user - the user who has initiated this event

eventTypeId - the type ID of this event

sendMail - configure whether mail notifications should be sent

IssueEvent

public IssueEvent(Issue issue,
                  com.atlassian.crowd.embedded.api.User user,
                  Comment comment,
                  Worklog worklog,
                  org.ofbiz.core.entity.GenericValue changeGroup,
                  Map params,
                  Long eventTypeId)

Create a new IssueEvent with a given list of parameters.

This event also has an attached changeGroup, comment and worklog (any of which may be null).

Parameters:

issue - The issue this event refers to

user - the user who has initiated this event

comment - A comment for this event

worklog - A worklog for this event

changeGroup - An attached changeGroup for this event

params - Parameters that can be retrieved by the Listener

eventTypeId - the type ID of this event

IssueEvent

public IssueEvent(Issue issue,
                  com.atlassian.crowd.embedded.api.User user,
                  Comment comment,
                  Worklog worklog,
                  org.ofbiz.core.entity.GenericValue changeGroup,
                  Map params,
                  Long eventTypeId,
                  boolean sendMail)

Create a new IssueEvent with a given list of parameters.

This event also has an attached changeGroup, comment and worklog (any of which may be null).

Parameters:

issue - the issue this event refers to

user - the user who has initiated this event

comment - comment for this event

worklog - A worklog for this event

changeGroup - an attached changeGroup for this event

params - parameters that can be retrieved by the Listener

eventTypeId - the type ID of this event

sendMail - configure whether mail notifications should be sent

IssueEvent

public IssueEvent(Issue issue,
                  com.atlassian.crowd.embedded.api.User user,
                  Comment comment,
                  Worklog worklog,
                  org.ofbiz.core.entity.GenericValue changeGroup,
                  Map params,
                  Long eventTypeId,
                  boolean sendMail,
                  boolean subtasksUpdated)

Method Detail

getIssue

public Issue getIssue()

getProject

public Project getProject()

getUser

public com.atlassian.crowd.embedded.api.User getUser()

Returns the user who initiated this event.

Returns:

the user who initiated this event.

getChangeLog

public org.ofbiz.core.entity.GenericValue getChangeLog()

getComment

public Comment getComment()

getWorklog

public Worklog getWorklog()

setWorklog

public void setWorklog(Worklog worklog)

getEventTypeId

public Long getEventTypeId()

isSendMail

public boolean isSendMail()

isSubtasksUpdated

public boolean isSubtasksUpdated()

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Note: this will not compare the time stamps of two events - only everything else.

Overrides:

equals in class AbstractEvent

hashCode

public int hashCode()

Overrides:

hashCode in class AbstractEvent