001/*
002 * GWTEventService
003 * Copyright (c) 2011 and beyond, strawbill UG (haftungsbeschr?nkt)
004 *
005 * This is free software; you can redistribute it and/or modify it
006 * under the terms of the GNU Lesser General Public License as
007 * published by the Free Software Foundation; either version 3 of
008 * the License, or (at your option) any later version.
009 * Other licensing for GWTEventService may also be possible on request.
010 * Please view the license.txt of the project for more information.
011 *
012 * This software is distributed in the hope that it will be useful,
013 * but WITHOUT ANY WARRANTY; without even the implied warranty of
014 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
015 * Lesser General Public License for more details.
016 *
017 * You should have received a copy of the GNU Lesser General Public
018 * License along with this software; if not, write to the Free
019 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
021 */
022package de.novanic.eventservice.client.event.listener;
023
024import de.novanic.eventservice.client.event.Event;
025
026/**
027 * A RemoteEventListener should be used to process events on client side. The apply method ({@link RemoteEventListener#apply(de.novanic.eventservice.client.event.Event)})
028 * should check the incoming event and call another method of the extending interface of RemoteEventListener.
029 * For example the extending interface of RemoteEventListener is "UserListListener" and The incoming event "UserAddEvent".
030 * The apply method should call a method like "userAdded" and the implementation of the listener can handle the userAdded call.
031 *
032 * @author sstrohschein
033 * <br>Date: 06.06.2008
034 * <br>Time: 18:57:30
035 */
036public interface RemoteEventListener
037{
038    /**
039     * The apply method should recognize the incoming events and dispatch to a similar method of the extending interface.
040     * For example the extending interface of RemoteEventListener is "UserListListener" and The incoming event "UserAddEvent".
041     * The apply method should call a method like "userAdded" and the implementation of the listener can handle the userAdded call.
042     * @param anEvent event to process
043     */
044    void apply(Event anEvent);
045}