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

SEND_MAIL

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()
User	getRemoteUser() Deprecated. Please use getUser(). Deprecated since v4.3
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

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()

getUser

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

Returns the user who initiated this event.

Returns:

the user who initiated this event.

getRemoteUser

public User getRemoteUser()

Deprecated. Please use getUser(). Deprecated since v4.3

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