001/*
002 * Copyright (c) 2006-2011 Nuxeo SA (http://nuxeo.com/) and others.
003 *
004 * All rights reserved. This program and the accompanying materials
005 * are made available under the terms of the Eclipse Public License v1.0
006 * which accompanies this distribution, and is available at
007 * http://www.eclipse.org/legal/epl-v10.html
008 *
009 * Contributors:
010 *     bstefanescu
011 */
012package org.nuxeo.ecm.core.event;
013
014
015/**
016 * An event listener receives notifications from core components.
017 * <p>
018 * Notifications are expressed as Event objects. This type of listeners are always invoked synchronously immediately
019 * after the event is raised.
020 *
021 * @see PostCommitEventListener for asynchronous listeners or post commit listeners
022 * @author <a href="mailto:bs@nuxeo.com">Bogdan Stefanescu</a>
023 */
024public interface EventListener {
025
026    /**
027     * Handle the given event. The listener can cancel the event by calling {@link Event#cancel()}
028     *
029     * @param event the event
030     */
031    void handleEvent(Event event);
032
033}