|
Eclipse Platform Release 3.2 |
|||||||||||
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 unregisteredpublic 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.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.