|
Eclipse Platform Release 3.3 |
|||||||||||
| 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 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 |
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 unregistered
public 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
public 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.3 |
|||||||||||
| 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, 2007. All rights reserved.