|
Eclipse Platform Release 3.2 |
|||||||||
| 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 can be used without OSGi running.
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)
Return 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. |
void |
unregisterObject(IExtension extension,
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,
Object object,
int referenceType)
REF_STRONG, REF_SOFT, REF_WEAK.
extension - the extensionobject - the object to associate with the extensionreferenceType - one of REF_STRONG, REF_SOFT, REF_WEAKREF_STRONG,
REF_SOFT,
REF_WEAK
void unregisterObject(IExtension extension,
Object object)
extension - the extension under which the object has been registeredobject - the object to unregisterObject[] unregisterObject(IExtension extension)
extension - the extension for which the objects are removed
Object[] getObjects(IExtension extension)
extension - the extension for which the object must be returned
void close()
|
Eclipse Platform Release 3.2 |
|||||||||
| 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, 2006. All rights reserved.