Adaptateurs
Identificateur :
org.eclipse.core.runtime.adapters
Depuis :
3.0
Description :
Le point
d'extension d'adaptateurs permet aux plug-ins d'enregistrer des
fabriques d'adaptateurs de façon déclarée. Grâce à ces informations,
le langage d'expression XML détermine l'existence d'adaptateurs sans
charger de plug-ins.
L'enregistrement de fabriques d'adaptateurs via
le point d'extension rend inutile leur enregistrement manuel au
démarrage d'un plug-in.
Marques de configuration :
<!ELEMENT extension (factory+)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT factory (adapter+)>
<!ATTLIST factory
adaptableType CDATA #REQUIRED
class CDATA #REQUIRED>
- adaptableType - nom qualifié complet d'une classe
(implémentant généralement IAdaptable) pour laquelle cette fabrique
fournit des adaptateurs.
- class - nom qualifié complet de la classe de fabrique
d'adaptateur. Doit implémenter org.eclipse.core.runtime.IAdapterFactory.
<!ELEMENT adapter EMPTY>
<!ATTLIST adapter
type CDATA #REQUIRED>
- type - nom qualifié complet d'une classe ou interface Java
à laquelle cette fabrique peut s'adapter.
Exemples :
L'exemple
ci-dessous illustre une déclaration d'adaptateur. Cet exemple déclare que ce plug-in fournira une fabrique d'adaptateur
pour adapter les objets de type IFile à ceux de type MyFile.
<extension point=
"org.eclipse.core.runtime.adapters"
>
<factory
class=
"com.xyz.MyFileAdapterFactory"
adaptableType=
"org.eclipse.core.resources.IFile"
>
<adapter type=
"com.xyz.MyFile"
/>
</factory>
</extension>
Informations d'API :
Les
fabriques d'adaptateurs enregistrées à l'aide de ce point
d'extension peuvent être interrogées avec la méthode
IAdapterManager.hasAdapter
ou extraites avec l'une des
méthodes getAdapter de IAdapterFactory.
Une fabrique d'adaptateur enregistrée avec ce point d'extension ne
doit pas l'être aussi au moment de l'exécution avec IAdapterFactory.registerAdapters.
Implémentation fournie :
Plusieurs
plug-ins dans la plateforme fournissent des adaptateurs pour
divers objets IAdaptable.
Copyright (c) 2004, 2005 IBM Corporation and others.
All rights reserved. Ce programme et les produits associés sont
distribués sous licence publique Eclipse v1.0 et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/epl-v10.html