Annotation Based Event Listener Example


Confluence 3.3 and later

This page gives the example code for an annotation-based event listener, as described in the page about event listener plugins.

The methods must be annotated with the com.atlassian.event.api.EventListener annotation and only take a single parameter of the type of event this method is to service.

The event listener must also register itself with the EventPublisher which can be injected into the constructor. The event listener will need to implement the DisposableBean interface to unregister itself when the plugin is disabled or uninstalled.

package com.atlassian.confluence.plugin.example.listener;

import com.atlassian.event.api.EventListener;
import com.atlassian.event.api.EventPublisher;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.DisposableBean;

public class AnnotatedListener implements DisposableBean{
    private static final Logger log = LoggerFactory.getLogger(AnnotatedListener.class);

    protected EventPublisher eventPublisher;

    public AnnotatedListener(EventPublisher eventPublisher) {
        this.eventPublisher = eventPublisher;

    public void loginEvent(LoginEvent event) {
        log.error("Login Event: " + event);

    public void logoutEvent(LogoutEvent event) {
        log.error("Logout Event: " + event);

    // Unregister the listener if the plugin is uninstalled or disabled.
    public void destroy() throws Exception

INFO: An annotation-based event listener does not need to implement the com.atlassian.event.EventListener class.

Was this page helpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport