WebSVN – eFlore/Archives.cel-v2 – Diff – /trunk/src/org/tela_botanica/client/vues/ArbreMotsClesVue.java


package org.tela_botanica.client.vues;
 
 
import org.tela_botanica.client.image.ImageMediateur;
import org.tela_botanica.client.interfaces.Rafraichissable;
import com.google.gwt.user.client.Window;
import com.gwtext.client.core.EventObject;
import com.gwtext.client.data.Node;
import com.gwtext.client.data.NodeTraversalCallback;
import com.gwtext.client.data.Tree;
import com.gwtext.client.widgets.Button;
import com.gwtext.client.widgets.Panel;
import com.gwtext.client.widgets.event.ButtonListenerAdapter;
import com.gwtext.client.widgets.form.TextField;
import com.gwtext.client.widgets.layout.RowLayout;
import com.gwtext.client.widgets.layout.RowLayoutData;
import com.gwtext.client.widgets.tree.TreeEditor;
import com.gwtext.client.widgets.tree.TreeNode;
import com.gwtext.client.widgets.tree.TreePanel;
import com.gwtext.client.widgets.tree.event.TreePanelListenerAdapter;
 
/**
 * Arbre des mots clés, qui est une vue rafraichissable,
 * qui contient des mots clés cochables et réorganisables à volonté
 * @author aurelien
 *
 */
public class ArbreMotsClesVue extends Panel implements Rafraichissable {
 
	/**
	 * Le médiateur associé à la vue
	 */
	private ImageMediateur iMediateur = null ;
	
	/**
	 * Le treepanel qui affiche l'arbre
	 */
	private TreePanel arbreMotsCles = null ;
	/**
	 * L'éditeur qui permet de modifier les mots clés dans l'arbre
	 */
	private TreeEditor te = null ;
	/**
	 * Le textfield associé à l'éditeur
	 */
	private TextField tfEdit = null ;
	/**
	 * Bouton de validation
	 */
	private Button valider = null ;
	/**
	 * Une string permettant connaitre les mots clés cochés en cours séparés par des virgules
	 */
	private String motsClesEnCours = "" ;
	/**
	 * Tableau contenant les mots clés qui n'ont pas encore été jaouté à l'arbre 
	 * (sert au lazy rendering quand on reçoit des mots clés avant que le rendu du conteneur n'ai été effectué)
	 */
	private String[] motsClesEnAttente ; 
	/**
	 * Booléen d'évènement qui sert à savoir si on est en train d'ajouter un noeud
	 */
	private boolean ajoutNoeud = false ;
	/**
	 * Booléen d'évènement qui sert à savoir si on est en train de modifier un noeud
	 */
	private boolean modifNoeud = false ;
	/**
	 * Booléen d'instanciation du conteneur
	 */
	private boolean estInstancie = false ;
	/**
	 * Booléen d'évènement qui sert à savoir si les mots clés ont bien été reçu
	 */
	private boolean motsCleInitialises ;
	
	/**
	 * Constructeur sans paramètre (privé car interdit d'utilisation)
	 */
	private ArbreMotsClesVue()
	{
		super() ;
	}
	
	/**
	 * Constructeur avec paramètre
	 * @param im le médiateur à associer
	 */
	public ArbreMotsClesVue(ImageMediateur im)
	{
		// on crée le panel
		super("Mots clés") ;
		this.setLayout(new RowLayout());
		iMediateur = im ;
		
		// on crée le conteneur de l'arbre
		arbreMotsCles = new TreePanel() ;
		// on permet le drag and drop dans l'arbre
		arbreMotsCles.setEnableDD(true) ;
		
		// on crée une racine pour l'arbre
		TreeNode root = new TreeNode("Tags") ;
		root.setId("racine") ;
		String[] usObject = {"Mots clés" , "racine" } ;
		root.setUserObject(usObject) ;
		
		arbreMotsCles.setRootNode(root) ;
		arbreMotsCles.setRootVisible(false) ;
		arbreMotsCles.getRootNode().setIcon("tela.png") ;
		arbreMotsCles.setBorder(false) ;
		
		// on crée l'éditeur pour l'arbre
		tfEdit = new TextField() ;
		te = new TreeEditor(arbreMotsCles,tfEdit) ;
		valider = new Button("Appliquer") ;
		arbreMotsCles.add(te) ;
		
		// on met en forme le layout
		this.add(arbreMotsCles,new RowLayoutData("90%")) ;
		this.add(valider,new RowLayoutData("10%")) ;
		
		this.setBorder(false) ;
		
		// on ajoute les listeners
		ajouterListeners() ;
		
	}
	
	/**
	 * Acesseur pour le médiateur
	 * @return le médiateur associé à la vue
	 */
	private ImageMediateur GetIMediateur() {
		
		return iMediateur ;
		
	}
	
	/**
	 * Acesseur pour l'arbre des mots clés
	 * @return le panel contenant l'arbre
	 */
	public TreePanel getArbreMotsCles() {
		return arbreMotsCles;
	}
 
	/**
	 * Accesseur pour l'éditeur
	 * @return l'éditeur associé à l'arbre
	 */
	public TreeEditor getTe() {
		return te;
	}
 
	/**
	 * Acesseur pour le TextField associé à l'éditeur
	 * @return le champ texte associé à l'éditeur
	 */
	public TextField getTfEdit() {
		return tfEdit;
	}
	
	/**
	 * Ajoute les listeners nécessaires pour la gestion des évènements
	 */
	private void ajouterListeners()
	{
		arbreMotsCles.addListener(new TreePanelListenerAdapter() {
			
			// gestion du clic sur un noeud
			public void onClick(TreeNode node, EventObject e) {
				
				e.stopEvent() ;
				gererClicNoeud(node);
			}
 
			// gestion du clic droit sur un noeud
			public void onContextMenu(TreeNode node, EventObject e) {
				
					e.stopEvent() ;
					GetIMediateur().montrerContextMenuArbre(node, e , getTe()) ;
				
			}
		
			// gestion du double clic sur un noeud
			public void onDblClick(TreeNode node, EventObject e) {
				
				modifNoeud = true ;
				te.startEdit(node);
			}
			
			// gestion de la modification du texte d'un noeud 
			public void onTextChange(TreeNode node, String text, String oldText) {
 
				// on récupère les informations associées au noeud
				TreeNode nd = node ;
				String[] usObject = new String[2] ;
				usObject[0] = text ;
				usObject[1] = ((String[])nd.getUserObject())[1] ;
				nd.setUserObject(usObject) ;
				
				// si c'est un nouveau noeud
				if(ajoutNoeud)
				{
					// on notifie le médiateur de l'ajout et on lui passe l'arbre
					GetIMediateur().ajouterMotCleDansArbre(nd,getArbreMotsCles().getTree()) ;
					// et considière l'ajout achevé
					ajoutNoeud = false ;
				}
				// si c'est noeud déjà existant
				else
				{
					// on notifie le médiateur de la modification et on lui passe l'arbre
					GetIMediateur().modifierMotCleDansArbre(nd,getArbreMotsCles().getTree()) ;
					// et on considère la modification achevée
					modifNoeud = false ;
				}
				
			}
			
			// gestion du déplacement d'un noeud
			public void onMoveNode(Tree tree, TreeNode node, TreeNode oldParent, TreeNode newParent,int index)
			{
				// on notifie le médiateur et on lui passe l'arbre
				GetIMediateur().deplacerMotCleDansArbre(node, getArbreMotsCles().getTree()) ;
			}
 
			// gestion du changement de valeur dans la checkbox 
			public void onCheckChange(TreeNode node, boolean checked) {
				
				// si on a coché un noeud
				if(checked)
				{
					// on remonte pour cocher tous les parents du noeud
					node.bubble(new NodeTraversalCallback() {
						
						public boolean execute(Node node)
						{
							TreeNode tn = getArbreMotsCles().getNodeById(node.getId()) ;
							tn.getUI().toggleCheck(true) ;
							
							return true ;
						}
					}) ;
				}
			}
			
		}) ;
		
		// gestion de la validation
		valider.addListener(new ButtonListenerAdapter() {
			
			// lors du clic
			public void onClick(Button button, EventObject e) {
				
				// on vide les mots clés en cours
				motsClesEnCours = "" ;
				// pour chaque noeud à partir de la racine
				getArbreMotsCles().getRootNode().cascade(new NodeTraversalCallback() {
					
					// on éxécute une fonction
					public boolean execute(Node node) {
					
							// on récupère le mot clé associé au noeud et ses infos
							TreeNode tn = getArbreMotsCles().getNodeById(node.getId()) ;
 
								String[] usObject =  (String[])tn.getUserObject() ;
								GetIMediateur().mettreAjourMotsClesId(usObject[0],usObject[1]) ;
									
									if(tn.getUI().isChecked())
									{
										// et les concatène à la string des mots clés en cours
										motsClesEnCours += usObject[1]+"," ;
									}
							
							return true ;
					}
					
				});
				
				// enfin on notifie le médiateur et on lui passe l'arbre et la liste des mots clés ainsi obtenue
				GetIMediateur().mettreAjourMotsCles(motsClesEnCours,arbreMotsCles.getTree()) ;
			}
		}) ;
		
	}
	
	/**
	 * Envoie une demande au médiateur pour obtenir l'arbre des mots clés
	 */
	public void obtenirArbreMotsCles() {
		
		GetIMediateur().obtenirArbreMotsCles(this) ;
		
	}
 
	/**
	 * Supprime un noeud de l'arbre
	 * @param n le noeud à supprimer
	 */
	public void supprimerNoeud(TreeNode n)
	{
		// si ça n'est pas la racine (qu'on ne peut pas supprimer)
		if(!n.getId().equals(getArbreMotsCles().getRootNode().getId()))
		{
			// on détache le noeud et on le détruit
			n.getParentNode().removeChild(n);
			n.destroy() ;
			// puis on en notifie le médiateur en lui passant le noeud supprimé et l'arbre
			GetIMediateur().supprimerMotCleDansArbre(n, arbreMotsCles.getTree()) ;
		}
		else
		{
			// si l'utilisateur tente de supprimer la racine, on l'avertit de son erreur
			Window.alert("Impossible de supprimer la racine de l'arbre") ;
		}
	}
	
	/**
	 * Ajoute un noeud dans l'arbre au parent donné
	 * @param parent le futur parent du noeud à ajouter
	 */
	public void ajouterNoeud(TreeNode parent)
	{
		// on met l'ajout du noeud à vrai
		ajoutNoeud = true ;
		// on crée un nouveau noeud vide
		TreeNode nd = new TreeNode("");
		nd.setIcon("tela.png") ;
		nd.setChecked(true);
		// on associe un objet au noeud qui contient des infos
		String[] usObject = new String[2] ;
		// l'objet contient le nom du noeud
		usObject[0] = "" ;
		// l'identifiant d'un noeud c'est son hashcode
		usObject[1] = Integer.toString(nd.hashCode()) ;
		// l'objet associé au noeud contient aussi son identifiant
		nd.setId(usObject[1]) ;
		nd.setUserObject(usObject) ;
		
		// on le concatène au parent et on étend ses enfants
		parent.appendChild(nd);
		parent.expand();
		// enfin on place le curseur et on fait apparaitre le champ d'édition pour que l'utilisateur nomme son mot clé
		te.startEdit(nd);
	}
	
	/**
	 * Coche le noeud s'il est décoché, le décoche sinon
	 * @param node
	 */
	public void gererClicNoeud(TreeNode node)
	{
		if(node.getUI().isChecked())
		{
			node.getUI().toggleCheck(false) ;
		}
		else
		{
			node.getUI().toggleCheck(true) ;
		}
	}
	
	/**
	 * Parcourt l'arbre et coche les noeud qui font partie de la liste des mots clés à cocher 
	 * @param motsClesIds un tableau contenant les identifiants des mots clés à cocher
	 */
	public void cocherMotsCles(final String[] motsClesIds)
	{
		if(getArbreMotsCles() != null && getArbreMotsCles().getRootNode() != null)
		{
			// à partir de la racine
			getArbreMotsCles().getRootNode().cascade(new NodeTraversalCallback() {
	
				// pour chaque noeud
				public boolean execute(Node node) {
					
						// on parcourt le tableau des mots clés
						for(int i = 0 ; i < motsClesIds.length ; i++)
						{
							// si le mot clé fait partie des id à cocher on le coche
							String usObject[] = (String[])node.getUserObject() ;
							String nodeId = usObject[1] ;
							
							getArbreMotsCles().getNodeById(node.getId()).getUI().toggleCheck(false) ;
										
							if(nodeId.equals(motsClesIds[i]))
							{
								getArbreMotsCles().getNodeById(nodeId).getUI().toggleCheck(true) ;
								return true ;
							}
						}
						// et on passe au suivant
						return true;
				}
				
			}) ;
		}
	}
	
	/**
	 * Méthode héritée de l'interface rafraichissable
	 * @param nouvelleDonnees les nouvelles données pour l'objet
	 * @param repandreRafraichissement booleen qui dit si on doit répandre l'évenement
	 */
	public void rafraichir(Object nouvelleDonnees,
			boolean repandreRafraichissement) {
		
		// si on a reçu un arbre
		if(nouvelleDonnees instanceof Tree)
		{
				Tree nouvelArbre = (Tree)nouvelleDonnees ;
					
					// on prend sa racine et on l'attache à l'arbre des mots clés
					getArbreMotsCles().getRootNode().appendChild(nouvelArbre.getRootNode()) ;
					getArbreMotsCles().expandAll() ;
					
					// si l'arbre n'était pas encore considéré comme instancié
					if(!estInstancie)
					{
						// on signale que oui
						estInstancie = true ;
					}
					
					// s'il y a des mots clés en attente (lors du premier rendering)
					if(motsCleInitialises == false && motsClesEnAttente != null)
					{
						// on les coche
						// TODO: corriger le bug qui fait que ça ne marche pas la premiere fois !!!!
						cocherMotsCles(motsClesEnAttente) ;
						motsCleInitialises = true ; 
					}
		}
		
		
		// Si on reçoit un tableau de String (cas ou l'on séléectionne une nouvelle image)
		if(nouvelleDonnees instanceof String[])
		{
			// et que l'arbre est instancié
			if(estInstancie && nouvelleDonnees != null)
			{
				// le tableau de String contient les id des mots clés associés à l'image
				// on coche les mots clés contenu dans le tableau
				String[] motsClesIds = (String[])nouvelleDonnees ;		
				cocherMotsCles(motsClesIds) ;		
			}
			// si l'arbre n'est pas encore instancié on met les mots clés en attente
			else
			{
				motsClesEnAttente = (String[])nouvelleDonnees ;
			}
		}
		
	}
 
}

Subversion Repositories eFlore/Archives.cel-v2

(root)/trunk/src/org/tela_botanica/client/vues/ArbreMotsClesVue.java – Rev 36 → 38

Rev 36		Rev 38
1	`package org.tela_botanica.client.vues;`	1	`package org.tela_botanica.client.vues;`
2		2
3		3
4	`import org.tela_botanica.client.image.ImageMediateur;`	4	`import org.tela_botanica.client.image.ImageMediateur;`
5	`import org.tela_botanica.client.interfaces.Rafraichissable;`	5	`import org.tela_botanica.client.interfaces.Rafraichissable;`
6	`import com.google.gwt.user.client.Window;`	6	`import com.google.gwt.user.client.Window;`
7	`import com.gwtext.client.core.EventObject;`	7	`import com.gwtext.client.core.EventObject;`
8	`import com.gwtext.client.data.Node;`	8	`import com.gwtext.client.data.Node;`
9	`import com.gwtext.client.data.NodeTraversalCallback;`	9	`import com.gwtext.client.data.NodeTraversalCallback;`
10	`import com.gwtext.client.data.Tree;`	10	`import com.gwtext.client.data.Tree;`
11	`import com.gwtext.client.widgets.Button;`	11	`import com.gwtext.client.widgets.Button;`
12	`import com.gwtext.client.widgets.Panel;`	12	`import com.gwtext.client.widgets.Panel;`
13	`import com.gwtext.client.widgets.event.ButtonListenerAdapter;`	13	`import com.gwtext.client.widgets.event.ButtonListenerAdapter;`
14	`import com.gwtext.client.widgets.form.TextField;`	14	`import com.gwtext.client.widgets.form.TextField;`
15	`import com.gwtext.client.widgets.layout.RowLayout;`	15	`import com.gwtext.client.widgets.layout.RowLayout;`
16	`import com.gwtext.client.widgets.layout.RowLayoutData;`	16	`import com.gwtext.client.widgets.layout.RowLayoutData;`
17	`import com.gwtext.client.widgets.tree.TreeEditor;`	17	`import com.gwtext.client.widgets.tree.TreeEditor;`
18	`import com.gwtext.client.widgets.tree.TreeNode;`	18	`import com.gwtext.client.widgets.tree.TreeNode;`
19	`import com.gwtext.client.widgets.tree.TreePanel;`	19	`import com.gwtext.client.widgets.tree.TreePanel;`
20	`import com.gwtext.client.widgets.tree.event.TreePanelListenerAdapter;`	20	`import com.gwtext.client.widgets.tree.event.TreePanelListenerAdapter;`
21		21
22	`/**`	22	`/**`
23	`* Arbre des mots clés, qui est une vue rafraichissable,`	23	`* Arbre des mots clés, qui est une vue rafraichissable,`
24	`* qui contient des mots clés cochables et réorganisables à volonté`	24	`* qui contient des mots clés cochables et réorganisables à volonté`
25	`* @author aurelien`	25	`* @author aurelien`
26	`*`	26	`*`
27	`*/`	27	`*/`
28	`public class ArbreMotsClesVue extends Panel implements Rafraichissable {`	28	`public class ArbreMotsClesVue extends Panel implements Rafraichissable {`
29		29
30	`/**`	30	`/**`
31	`* Le médiateur associé à la vue`	31	`* Le médiateur associé à la vue`
32	`*/`	32	`*/`
33	`private ImageMediateur iMediateur = null ;`	33	`private ImageMediateur iMediateur = null ;`
34		34
35	`/**`	35	`/**`
36	`* Le treepanel qui affiche l'arbre`	36	`* Le treepanel qui affiche l'arbre`
37	`*/`	37	`*/`
38	`private TreePanel arbreMotsCles = null ;`	38	`private TreePanel arbreMotsCles = null ;`
39	`/**`	39	`/**`
40	`* L'éditeur qui permet de modifier les mots clés dans l'arbre`	40	`* L'éditeur qui permet de modifier les mots clés dans l'arbre`