|
Eclipse Platform Release 3.1 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
public interface IExtensionTracker
An extension tracker keeps associations between extensions and their derived objects on an extension basis. All extensions being added in a tracker will automatically be removed when the extension is uninstalled from the registry. Users interested in extension removal can register a handler that will let them know when an object is being removed.
This interface is not intended to be implemented by clients.
| Field Summary | |
|---|---|
static int |
REF_SOFT
Constant for soft reference holding. |
static int |
REF_STRONG
Constant for strong (normal) reference holding. |
static int |
REF_WEAK
Constant for weak reference holding. |
| Method Summary | |
|---|---|
void |
close()
Close the tracker. |
java.lang.Object[] |
getObjects(IExtension extension)
Get all the objects that have been associated with the given extension. |
void |
registerHandler(IExtensionChangeHandler handler,
IFilter filter)
Register an extension change handler with this tracker using the given filter |
void |
registerObject(IExtension extension,
java.lang.Object object,
int referenceType)
Create an association between the given extension and the given object. |
void |
unregisterHandler(IExtensionChangeHandler handler)
Unregister the given extension change handler previously registered with this tracker |
java.lang.Object[] |
unregisterObject(IExtension extension)
Remove all the objects associated with the given extension and return them. |
void |
unregisterObject(IExtension extension,
java.lang.Object object)
Remove an association between the given extension and the given object. |
| Field Detail |
|---|
static final int REF_STRONG
1.
static final int REF_SOFT
2.
static final int REF_WEAK
3.
| Method Detail |
|---|
void registerHandler(IExtensionChangeHandler handler,
IFilter filter)
handler - the handler to be registeredfilter - the filter to use to choose interesting changesvoid unregisterHandler(IExtensionChangeHandler handler)
handler - the handler to be unregistered
void registerObject(IExtension extension,
java.lang.Object object,
int referenceType)
extension - : an extensionobject - : the object to associate with the extensionreferenceType - : one of REF_STRONG, REF_SOFT, REF_WEAK
void unregisterObject(IExtension extension,
java.lang.Object object)
extension - : the extension under which the object has been registeredobject - : the object to unregisterjava.lang.Object[] unregisterObject(IExtension extension)
extension - : the extension for which the objects are removed
java.lang.Object[] getObjects(IExtension extension)
extension - the extension for which the object must be returned
void close()
|
Eclipse Platform Release 3.1 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.