|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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. |
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,
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 |
Object[] |
unregisterObject(IExtension extension)
Remove all the objects associated with the given extension and return them. |
void |
unregisterObject(IExtension extension,
Object object)
Remove an association between the given extension and the given object. |
Field Detail |
public static final int REF_STRONG
1
.
public static final int REF_SOFT
2
.
public static final int REF_WEAK
3
.
Method Detail |
public void registerHandler(IExtensionChangeHandler handler, IFilter filter)
handler
- the handler to be registeredfilter
- the filter to use to choose interesting changespublic void unregisterHandler(IExtensionChangeHandler handler)
handler
- the handler to be unregisteredpublic void registerObject(IExtension extension, Object object, int referenceType)
extension
- : an extensionobject
- : the object to associate with the extensionreferenceType
- : one of REF_STRONG, REF_SOFT, REF_WEAKpublic void unregisterObject(IExtension extension, Object object)
extension
- : the extension under which the object has been registeredobject
- : the object to unregisterpublic Object[] unregisterObject(IExtension extension)
extension
- : the extension for which the objects are removed
public Object[] getObjects(IExtension extension)
extension
- the extension for which the object must be returned
public 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.