83
|
1 /*
|
|
2 * $Header: /cvshome/build/org.osgi.framework/src/org/osgi/framework/FrameworkEvent.java,v 1.15 2007/02/20 00:14:12 hargrave Exp $
|
|
3 *
|
|
4 * Copyright (c) OSGi Alliance (2004, 2007). All Rights Reserved.
|
|
5 *
|
|
6 * Licensed under the Apache License, Version 2.0 (the "License");
|
|
7 * you may not use this file except in compliance with the License.
|
|
8 * You may obtain a copy of the License at
|
|
9 *
|
|
10 * http://www.apache.org/licenses/LICENSE-2.0
|
|
11 *
|
|
12 * Unless required by applicable law or agreed to in writing, software
|
|
13 * distributed under the License is distributed on an "AS IS" BASIS,
|
|
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
15 * See the License for the specific language governing permissions and
|
|
16 * limitations under the License.
|
|
17 */
|
|
18
|
|
19 module org.osgi.framework.FrameworkEvent;
|
|
20 import org.osgi.framework.Bundle;
|
|
21
|
|
22 import java.lang.all;
|
|
23 import java.util.EventObject;
|
|
24
|
|
25 /**
|
|
26 * A general event from the Framework.
|
|
27 *
|
|
28 * <p>
|
|
29 * <code>FrameworkEvent</code> objects are delivered to
|
|
30 * <code>FrameworkListener</code>s when a general event occurs within the
|
|
31 * OSGi environment. A type code is used to identify the event type for future
|
|
32 * extendability.
|
|
33 *
|
|
34 * <p>
|
|
35 * OSGi Alliance reserves the right to extend the set of event types.
|
|
36 *
|
|
37 * @Immutable
|
|
38 * @see FrameworkListener
|
|
39 * @version $Revision: 1.15 $
|
|
40 */
|
|
41
|
|
42 public class FrameworkEvent : EventObject {
|
|
43 static final long serialVersionUID = 207051004521261705L;
|
|
44 /**
|
|
45 * Bundle related to the event.
|
|
46 */
|
|
47 private final Bundle bundle;
|
|
48
|
|
49 /**
|
|
50 * Exception related to the event.
|
|
51 */
|
|
52 private final Throwable throwable;
|
|
53
|
|
54 /**
|
|
55 * Type of event.
|
|
56 */
|
|
57 private final int type;
|
|
58
|
|
59 /**
|
|
60 * The Framework has started.
|
|
61 *
|
|
62 * <p>
|
|
63 * This event is fired when the Framework has started after all installed
|
|
64 * bundles that are marked to be started have been started and the Framework
|
|
65 * has reached the intitial start level.
|
|
66 *
|
|
67 * <p>
|
|
68 * The value of <code>STARTED</code> is 0x00000001.
|
|
69 *
|
|
70 * @see "<code>StartLevel</code>"
|
|
71 */
|
|
72 public final static int STARTED = 0x00000001;
|
|
73
|
|
74 /**
|
|
75 * An error has occurred.
|
|
76 *
|
|
77 * <p>
|
|
78 * There was an error associated with a bundle.
|
|
79 *
|
|
80 * <p>
|
|
81 * The value of <code>ERROR</code> is 0x00000002.
|
|
82 */
|
|
83 public final static int ERROR = 0x00000002;
|
|
84
|
|
85 /**
|
|
86 * A PackageAdmin.refreshPackage operation has completed.
|
|
87 *
|
|
88 * <p>
|
|
89 * This event is fired when the Framework has completed the refresh packages
|
|
90 * operation initiated by a call to the PackageAdmin.refreshPackages method.
|
|
91 *
|
|
92 * <p>
|
|
93 * The value of <code>PACKAGES_REFRESHED</code> is 0x00000004.
|
|
94 *
|
|
95 * @since 1.2
|
|
96 * @see "<code>PackageAdmin.refreshPackages</code>"
|
|
97 */
|
|
98 public final static int PACKAGES_REFRESHED = 0x00000004;
|
|
99
|
|
100 /**
|
|
101 * A StartLevel.setStartLevel operation has completed.
|
|
102 *
|
|
103 * <p>
|
|
104 * This event is fired when the Framework has completed changing the active
|
|
105 * start level initiated by a call to the StartLevel.setStartLevel method.
|
|
106 *
|
|
107 * <p>
|
|
108 * The value of <code>STARTLEVEL_CHANGED</code> is 0x00000008.
|
|
109 *
|
|
110 * @since 1.2
|
|
111 * @see "<code>StartLevel</code>"
|
|
112 */
|
|
113 public final static int STARTLEVEL_CHANGED = 0x00000008;
|
|
114
|
|
115 /**
|
|
116 * A warning has occurred.
|
|
117 *
|
|
118 * <p>
|
|
119 * There was a warning associated with a bundle.
|
|
120 *
|
|
121 * <p>
|
|
122 * The value of <code>WARNING</code> is 0x00000010.
|
|
123 *
|
|
124 * @since 1.3
|
|
125 */
|
|
126 public final static int WARNING = 0x00000010;
|
|
127
|
|
128 /**
|
|
129 * An informational event has occurred.
|
|
130 *
|
|
131 * <p>
|
|
132 * There was an informational event associated with a bundle.
|
|
133 *
|
|
134 * <p>
|
|
135 * The value of <code>INFO</code> is 0x00000020.
|
|
136 *
|
|
137 * @since 1.3
|
|
138 */
|
|
139 public final static int INFO = 0x00000020;
|
|
140
|
|
141 /**
|
|
142 * Creates a Framework event.
|
|
143 *
|
|
144 * @param type The event type.
|
|
145 * @param source The event source object. This may not be <code>null</code>.
|
|
146 * @deprecated As of 1.2. This constructor is deprecated in favor of using
|
|
147 * the other constructor with the System Bundle as the event
|
|
148 * source.
|
|
149 */
|
|
150 public this(int type, Object source) {
|
|
151 super(source);
|
|
152 this.type = type;
|
|
153 this.bundle = null;
|
|
154 this.throwable = null;
|
|
155 }
|
|
156
|
|
157 /**
|
|
158 * Creates a Framework event regarding the specified bundle.
|
|
159 *
|
|
160 * @param type The event type.
|
|
161 * @param bundle The event source.
|
|
162 * @param throwable The related exception. This argument may be
|
|
163 * <code>null</code> if there is no related exception.
|
|
164 */
|
|
165 public this(int type, Bundle bundle, Throwable throwable) {
|
|
166 super(cast(Object)bundle);
|
|
167 this.type = type;
|
|
168 this.bundle = bundle;
|
|
169 this.throwable = throwable;
|
|
170 }
|
|
171
|
|
172 /**
|
|
173 * Returns the exception related to this event.
|
|
174 *
|
|
175 * @return The related exception or <code>null</code> if none.
|
|
176 */
|
|
177 public Throwable getThrowable() {
|
|
178 return throwable;
|
|
179 }
|
|
180
|
|
181 /**
|
|
182 * Returns the bundle associated with the event. This bundle is also the
|
|
183 * source of the event.
|
|
184 *
|
|
185 * @return The bundle associated with the event.
|
|
186 */
|
|
187 public Bundle getBundle() {
|
|
188 return bundle;
|
|
189 }
|
|
190
|
|
191 /**
|
|
192 * Returns the type of framework event.
|
|
193 * <p>
|
|
194 * The type values are:
|
|
195 * <ul>
|
|
196 * <li>{@link #STARTED}
|
|
197 * <li>{@link #ERROR}
|
|
198 * <li>{@link #WARNING}
|
|
199 * <li>{@link #INFO}
|
|
200 * <li>{@link #PACKAGES_REFRESHED}
|
|
201 * <li>{@link #STARTLEVEL_CHANGED}
|
|
202 * </ul>
|
|
203 *
|
|
204 * @return The type of state change.
|
|
205 */
|
|
206
|
|
207 public int getType() {
|
|
208 return type;
|
|
209 }
|
|
210 }
|