01: /**
02: * Copyright (c) 2003-2007, David A. Czarnecki
03: * All rights reserved.
04: *
05: * Redistribution and use in source and binary forms, with or without
06: * modification, are permitted provided that the following conditions are met:
07: *
08: * Redistributions of source code must retain the above copyright notice, this list of conditions and the
09: * following disclaimer.
10: * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
11: * following disclaimer in the documentation and/or other materials provided with the distribution.
12: * Neither the name of "David A. Czarnecki" and "blojsom" nor the names of its contributors may be used to
13: * endorse or promote products derived from this software without specific prior written permission.
14: * Products derived from this software may not be called "blojsom", nor may "blojsom" appear in their name,
15: * without prior written permission of David A. Czarnecki.
16: *
17: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
18: * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
19: * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
20: * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
21: * EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
22: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24: * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25: * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
26: * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
27: * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
29: * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30: */package org.blojsom.event;
31:
32: /**
33: * EventBroadcaster
34: *
35: * @author David Czarnecki
36: * @since blojsom 3.0
37: * @version $Id: EventBroadcaster.java,v 1.2 2007/01/17 02:35:17 czarneckid Exp $
38: */
39: public interface EventBroadcaster {
40:
41: /**
42: * Add a event to this event broadcaster
43: *
44: * @param listener {@link Listener}
45: */
46: public void addListener(Listener listener);
47:
48: /**
49: * Add a event to this event broadcaster. Events are filtered using the {@link Filter} instance
50: * passed to this method.
51: *
52: * @param listener {@link Listener}
53: * @param filter {@link Filter} used to filter events
54: */
55: public void addListener(Listener listener, Filter filter);
56:
57: /**
58: * Remove a event from this event broadcaster
59: *
60: * @param listener {@link Listener}
61: */
62: public void removeListener(Listener listener);
63:
64: /**
65: * Broadcast an event to all listeners
66: *
67: * @param event {@link org.blojsom.event.Event} to be broadcast to all listeners
68: */
69: public void broadcastEvent(Event event);
70:
71: /**
72: * Process an event with all listeners
73: *
74: * @param event {@link Event} to be processed by all listeners
75: */
76: public void processEvent(Event event);
77: }
|