com.atlassian.jira.event
Interface JiraListener

All Superinterfaces:

java.util.EventListener

All Known Subinterfaces:

IssueEventListener, UserEventListener

All Known Implementing Classes:

DebugListener, IssueCacheListener, IssueIndexListener, MailListener

public interface JiraListener

extends java.util.EventListener

The basic interface that all Listeners must implement.

All Listeners must also have an empty constructor to that the ListenerFactory can create it.

See Also:

IssueEventListener, UserEventListener

Method Summary

java.lang.String[]	getAcceptedParams() Get a list of the parameters for this listener.
java.lang.String	getDescription() A textual description of the listener.
void	init(java.util.Map params) Initialise the listener.
boolean	isInternal() Indicates whether administrators can delete this listener from within the web interface.
boolean	isUnique() Whether this listener class should be unique.

Method Detail

init

public void init(java.util.Map params)

Initialise the listener.

For custom listeners, the list of parameters is always empty.

getAcceptedParams

public java.lang.String[] getAcceptedParams()

Get a list of the parameters for this listener.

isInternal

public boolean isInternal()

Indicates whether administrators can delete this listener from within the web interface.

Basically only Atlassian listeners should return true from this.

isUnique

public boolean isUnique()

Whether this listener class should be unique. Some listeners are fine to have multiples, and some are not.

Having multiple mail listeners could be fine - if you wanted multiple mails sent out.

With other listeners, such as the cache listeners, it makes no sense to have multiple listeners of the one class.

Returns:

Whether this listener class should be unique.

getDescription

public java.lang.String getDescription()

A textual description of the listener. You can include HTML if required, but do not use tables, or DHTML, as the description may be displayed inside tables / frames.

A good description will describe what this listener does, and then explains the parameters required for configuring the listener.

If no description is appropriate, return null.

Returns:

A HTML description of the listener