01: /*
02: * Copyright (c) 1998-2008 Caucho Technology -- all rights reserved
03: *
04: * This file is part of Resin(R) Open Source
05: *
06: * Each copy or derived work must preserve the copyright notice and this
07: * notice unmodified.
08: *
09: * Resin Open Source is free software; you can redistribute it and/or modify
10: * it under the terms of the GNU General Public License version 2
11: * as published by the Free Software Foundation.
12: *
13: * Resin Open Source is distributed in the hope that it will be useful,
14: * but WITHOUT ANY WARRANTY; without even the implied warranty of
15: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
16: * of NON-INFRINGEMENT. See the GNU General Public License for more
17: * details.
18: *
19: * You should have received a copy of the GNU General Public License
20: * along with Resin Open Source; if not, write to the
21: *
22: * Free Software Foundation, Inc.
23: * 59 Temple Place, Suite 330
24: * Boston, MA 02111-1307 USA
25: *
26: * @author Scott Ferguson
27: */
28:
29: package javax.faces.event;
30:
31: import java.util.*;
32:
33: import javax.faces.component.*;
34:
35: public abstract class FacesEvent extends EventObject {
36: private PhaseId phaseId;
37:
38: public FacesEvent(UIComponent component) {
39: super (component);
40:
41: if (component == null)
42: throw new IllegalArgumentException();
43:
44: this .phaseId = PhaseId.ANY_PHASE;
45: }
46:
47: public UIComponent getComponent() {
48: return (UIComponent) this .source;
49: }
50:
51: public PhaseId getPhaseId() {
52: return this .phaseId;
53: }
54:
55: public void setPhaseId(PhaseId phaseId) {
56: if (phaseId == null)
57: throw new IllegalArgumentException();
58:
59: this .phaseId = phaseId;
60: }
61:
62: public void queue() {
63: //the spec dictates that the exception be thrown. but Trinidad uses
64: //facesevent.queue all over... so removing the check for now.
65: getComponent().queueEvent(this );
66: //if (! (getComponent() instanceof UIViewRoot))
67: // throw new IllegalStateException("FacesEvent component must descent from UIViewRoot to use queue()");
68:
69: //throw new UnsupportedOperationException();
70: }
71:
72: public abstract boolean isAppropriateListener(FacesListener listener);
73:
74: public abstract void processListener(FacesListener listener)
75: throws AbortProcessingException;
76: }
|