01: package org.tanukisoftware.wrapper.event;
02:
03: /*
04: * Copyright (c) 1999, 2006 Tanuki Software Inc.
05: *
06: * Permission is hereby granted, free of charge, to any person
07: * obtaining a copy of the Java Service Wrapper and associated
08: * documentation files (the "Software"), to deal in the Software
09: * without restriction, including without limitation the rights
10: * to use, copy, modify, merge, publish, distribute, sub-license,
11: * and/or sell copies of the Software, and to permit persons to
12: * whom the Software is furnished to do so, subject to the
13: * following conditions:
14: *
15: * The above copyright notice and this permission notice shall be
16: * included in all copies or substantial portions of the Software.
17: *
18: * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19: * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
20: * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
21: * NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
22: * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
23: * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24: * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
25: * OTHER DEALINGS IN THE SOFTWARE.
26: */
27:
28: import java.util.EventObject;
29:
30: import org.tanukisoftware.wrapper.WrapperManager;
31:
32: /**
33: * WrapperEvents are used to notify WrapperEventListeners of various wrapper
34: * related events.
35: * <p>
36: * For performance reasons, some event instances may be reused by the code
37: * which fires them off. For this reason, references to the event should
38: * never be referenced outside the scope of the WrapperListener.processEvent
39: * method.
40: *
41: * @author Leif Mortenson <leif@tanukisoftware.com>
42: */
43: public abstract class WrapperEvent extends EventObject {
44: /*---------------------------------------------------------------
45: * Constructors
46: *-------------------------------------------------------------*/
47: /**
48: * Creates a new WrapperEvent.
49: */
50: protected WrapperEvent() {
51: super (WrapperManager.class);
52: }
53:
54: /*---------------------------------------------------------------
55: * Methods
56: *-------------------------------------------------------------*/
57: /**
58: * Returns a set of event flags for which the event should be fired.
59: * This value is compared with the mask supplied when when a
60: * WrapperEventListener is registered to decide which listeners should
61: * receive the event.
62: * <p>
63: * If a subclassed, the return value of the super class should usually
64: * be ORed with any additional flags.
65: *
66: * @return a set of event flags.
67: */
68: public long getFlags() {
69: return 0;
70: }
71: }
|