annotate org.eclipse.osgi/osgi/src/org/osgi/framework/BundleListener.d @ 105:bbe49769ec18

...
author Frank Benoit <benoit@tionex.de>
date Sun, 08 Nov 2009 12:42:30 +0100
parents 12b890a6392a
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
86
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
1 /*
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
2 * $Header: /cvshome/build/org.osgi.framework/src/org/osgi/framework/BundleListener.java,v 1.13 2007/02/21 16:49:05 hargrave Exp $
105
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
3 *
86
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
4 * Copyright (c) OSGi Alliance (2000, 2007). All Rights Reserved.
105
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
5 *
86
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
6 * Licensed under the Apache License, Version 2.0 (the "License");
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
7 * you may not use this file except in compliance with the License.
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
8 * You may obtain a copy of the License at
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
9 *
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
10 * http://www.apache.org/licenses/LICENSE-2.0
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
11 *
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
12 * Unless required by applicable law or agreed to in writing, software
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
13 * distributed under the License is distributed on an "AS IS" BASIS,
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
15 * See the License for the specific language governing permissions and
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
16 * limitations under the License.
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
17 */
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
18
105
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
19 // Port to the D programming language:
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
20 // Frank Benoit <benoit@tionex.de>
86
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
21 module org.osgi.framework.BundleListener;
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
22
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
23 import java.lang.all;
105
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
24
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
25 import org.osgi.framework.BundleEvent; // packageimport
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
26
86
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
27 import java.util.EventListener;
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
28
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
29 /**
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
30 * A <code>BundleEvent</code> listener. <code>BundleListener</code> is a
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
31 * listener interface that may be implemented by a bundle developer. When a
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
32 * <code>BundleEvent</code> is fired, it is asynchronously delivered to a
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
33 * <code>BundleListener</code>. The Framework delivers
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
34 * <code>BundleEvent</code> objects to a <code>BundleListener</code> in
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
35 * order and must not concurrently call a <code>BundleListener</code>.
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
36 * <p>
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
37 * A <code>BundleListener</code> object is registered with the Framework using
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
38 * the {@link BundleContext#addBundleListener} method.
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
39 * <code>BundleListener</code>s are called with a <code>BundleEvent</code>
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
40 * object when a bundle has been installed, resolved, started, stopped, updated,
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
41 * unresolved, or uninstalled.
105
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
42 *
86
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
43 * @see BundleEvent
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
44 * @NotThreadSafe
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
45 * @version $Revision: 1.13 $
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
46 */
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
47
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
48 public interface BundleListener : EventListener {
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
49 /**
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
50 * Receives notification that a bundle has had a lifecycle change.
105
Frank Benoit <benoit@tionex.de>
parents: 86
diff changeset
51 *
86
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
52 * @param event The <code>BundleEvent</code>.
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
53 */
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
54 public void bundleChanged(BundleEvent event);
12b890a6392a Work on databinding
Frank Benoit <benoit@tionex.de>
parents:
diff changeset
55 }