Définition de propriétés et d`événements pour un composant

634.1/PROGRAMMATION
Définitiondepropriétésetd’événementspouruncomposant
PeterDAEHNEVersion3.11–13.05.2015
LeprotocoleJavaBeansspécifiecommentdéfinirdespropriétésetdesévénementspouruncomposant,propriétésetévénementsquiserontreconnuspar
l’IDEetintégrésautomatiquementàsoninterfaceutilisateur.
Ceprotocoleestdéfiniàdeuxniveaux:
 unniveaulightbasésurdesconventionsdenommageetd’héritage;
 unniveaucompletbasésurladéfinitiondedifférentsclassesdupackagejava.beans.
Cedocumentdécritleprotocolelight.
Constructeur
Lecomposantdoitdisposeraumoinsduconstructeursansparamètre.
Propriétés
UnepropriétépropdetypeTexisteetestaffichéedansl’IDEsilesaccesseurssuivantsexistent:
publicvoidsetProp(Tval){...}/*Pasprésentesilapropriétéestenlectureseule*/
publicTgetProp(){...}oupublicbooleanisProp(){...}/*Possiblepourunepropriétéboolean*/
Engénéral,maiscen’estpasobligatoire,lapropriétéestimplantéeaumoyend’unevariableprivatechargéed’enmémoriserlavaleur.
Événements
1. Créerlamémoiredel’événement;ils’agitd’uneclassequidérivedejava.awt.AWTEvent.
/*Mémoiredel'événement*/
publicclassXXEventextendsjava.awt.AWTEvent{
/*Attributsetaccesseursd’informationsspécifiquesdel’événementainsiqueconstructeursadaptés.*/
publicXXEvent(Objectsource,intid){
super(source,id);
}//Constructeur
}//XXEvent

PeterDAEHNEVersion3.11–13.05.2015
2. CréerleListenerquidéfinitlesnouveauxévénements(ildoitétendrel’interfacejava.util.EventListener).Sesméthodesserontlesnouveaux
événementsauxquelslecomposantseracapablederéagir.
/*Interfacedéfinissantlelistenerspécifique*/
publicinterfaceXXListenerextendsjava.util.EventListener{
voidevenement1(XXEvente);
/*...*/
voidevenementk(XXEvente);
}//XXListener
Lesévénementsevenement1,…,evenementkapparaîtrontdanslalistedesévénementsproposésparl’IDE.
SileListenerproposeplusieursévénements,créerleXXAdaptercorrespondant(cen’estpasobligatoire;ils’agitd’unebonnepratique).
3. Créerdanslecomposantlui‐mêmelesystèmed’abonnementetdedéclenchementdesévénementsnouvellementdéfinis.
/*Listedeslistenersabonnés*/
privatejava.util.ArrayList<XXListener>XXListenerList=newjava.util.ArrayList<XXListener>();
/*Enregistrementd'unlistenerdanslalistedesabonnés.*/
publicsynchronizedvoidaddXXListener(XXListenerlistener){
XXListenerList.add(listener);
}//addXXListener
/*Retraitd'unlistenerdelalistedesabonnés.*/
publicsynchronizedvoidremoveXXListener(XXListenerlistener){
XXListenerList.remove(listener);
}//removeXXListener
/*Notificationdesévénementsàtouslesabonnés.*/
@SuppressWarnings("unchecked")
privatevoidfireXXListenerEvenement1(XXEventevent){
java.util.ArrayList<XXListener>list=(java.util.ArrayList<XXListener>)XXListenerList.clone();
for(inti=0;i<list.size();i++){
list.get(i).evenement1(event);
}
}//fireXXListenerEvenement1

PeterDAEHNEVersion3.11–13.05.2015
/*...*/
@SuppressWarnings("unchecked")
privatevoidfireXXListenerEvenementk(XXEventevent){
java.util.ArrayList<XXListener>list=(java.util.ArrayList<XXListener>)XXListenerList.clone();
for(inti=0;i<list.size();i++){
list.get(i).evenementk(event);
}
}//fireXXListenerEvenementk
4. Danslecomposant,déclencherl’événementlorsqu’ilseproduit.Ils’agitengénéraldelatransformationd’unévénementoud’ungrouped’événements
existantspourlescontrôlesgraphiquesconstituantlecomposant.
XXEventevent=newXXEvent(this,java.awt.AWTEvent.RESERVED_ID_MAX+n);/*Ouautreconstructeur*/
fireXXListenerEvenementn(event);
Remarques
LescomposantsainsicrééspeuventêtreintégrésàlapalettedeNetBeans(oudetoutIDEquireconnaîtleprotocoleJavaBeans).
L’icôneassociéeaucomposantestl’icônepardéfaut: 
Lespropriétéspeuventêtreéditéesdepuisl’interfacedel’IDE.Ilyauncertainnombred’éditeursdéfinispourlestypessimples(textes,nombres,…)etles
typesdejava.awt(Color,Font,…).
LeprotocoleJavaBeanscompletpermetdedéfinirl’icônequ’onveutassocieraucomposantainsiquedemettreàdispositiondeséditeurspourdestypes
exotiques(c’est‐à‐direducodequiseraexécutéparl’IDEetnonparl’application).