WebSVN – eFlore/Applications.cel – Diff – /branches/v1.6-croc/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.VerticalLayout;
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 = "";
	
	private String[] tableauMotsClesEnCours = new String[0];
	/**
	 * 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 = new String[0];
	/**
	 * 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 arbreCharge = 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)
	 */
	@SuppressWarnings("unused")
	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 VerticalLayout());
		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);
		arbreMotsCles.setId("x-view-tree-keyword");
 
		// 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(true);
		arbreMotsCles.setBorder(false);
		arbreMotsCles.setWidth(500);
 
		// on crée l'éditeur pour l'arbre
		tfEdit = new TextField();
		tfEdit.setAutoWidth(true);
		te = new TreeEditor(arbreMotsCles, tfEdit);
		valider = new Button("Appliquer");
		arbreMotsCles.add(te);
 
		// on met en forme le layout
		this.add(arbreMotsCles);
		this.add(valider);
 
		this.setBorder(false);
		this.setCollapsible(true);
		this.setTitleCollapse(true);
		
		// 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() {
 
			@Override
			public void onExpandNode(TreeNode node) {		
				cocherMotsCles(tableauMotsClesEnCours);
			}
			
			// gestion du clic sur un noeud
			@Override
			public void onClick(TreeNode node, EventObject e) {
 
				e.stopEvent();
				gererClicNoeud(node);
			}
 
			// gestion du clic droit sur un noeud
			@Override
			public void onContextMenu(TreeNode node, EventObject e) {
 
				e.stopEvent();
				getIMediateur().montrerContextMenuArbre(node, e, getTe());
 
			}
 
			// gestion du double clic sur un noeud
			@Override
			public void onDblClick(TreeNode node, EventObject e) {
 
				modifNoeud = true;
				if (!node.getId().equals("racine")) {
					te.startEdit(node);
				}
			}
 
			// gestion de la modification du texte d'un noeud
			@Override
			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 considère l'ajout achevé
					ajoutNoeud = false;
					// et on notifie le médiateur de l'ajout et on lui passe
					// l'arbre
					getIMediateur().ajouterMotCleDansArbre(nd,
							getArbreMotsCles().getTree());
				}
				// si c'est noeud déjà existant
				else {
					// et on considère la modification achevée
					modifNoeud = false;
					// on notifie le médiateur de la modification et on lui
					// passe l'arbre
					getIMediateur().modifierMotCleDansArbre(nd,
							getArbreMotsCles().getTree());
				}
 
			}
 
			// gestion du déplacement d'un noeud
			@Override
			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 de la validation
		valider.addListener(new ButtonListenerAdapter() {
 
			// lors du clic
			@Override
			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
							@Override
							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.setCls("x-view-treenode-keyword");
		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] = "";
		usObject[1] = genererIdMotCle(nd);
		nd.setId(usObject[1]);
		nd.setUserObject(usObject);
		// l'identifiant d'un noeud c'est son hashcode
		// l'objet associé au noeud contient aussi son identifiant
 
		// 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
						@Override
						public boolean execute(Node node) {
 
							getArbreMotsCles().getNodeById(node.getId())
							.getUI().toggleCheck(false);
							
							// 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];
 
								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
	 */
	@Override
	public void rafraichir(Object nouvelleDonnees,
			boolean repandreRafraichissement) {
		
		if(nouvelleDonnees instanceof Tree) {
 
			Tree nouvelArbre = (Tree)nouvelleDonnees ;
 
			// on prend sa racine et on l'attache à l'arbre des mots clés
			Node[] rootChild = getArbreMotsCles().getRootNode().getChildNodes();
			for (int i = 0; i < rootChild.length; i++) {
				
				rootChild[i].remove();
			}
			
			copierFilsNoeud(nouvelArbre.getRootNode(),getArbreMotsCles().getRootNode());
 
			// si l'arbre n'était pas encore considéré comme instancié
			if (!arbreCharge) {
				// on signale que oui
				arbreCharge = true;
			}
		}
 
		// Si on reçoit un tableau de String (cas ou l'on séléectionne une
		// nouvelle image)
		if (nouvelleDonnees instanceof String[]) {
 
				// 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
				tableauMotsClesEnCours = (String[]) nouvelleDonnees;
				cocherMotsCles(tableauMotsClesEnCours);
		}
	}
 
	private String genererIdMotCle(TreeNode nd) {
		return "" + (nd.hashCode() + (Math.random() * 10000));
	}
	
	/**
	 * Fonction récursive qui prend deux noeuds d'arbre en paramètre et crée un
	 * copie du sous arbre du premier noeud, qu'elle concatène au deuxième
	 * 
	 * @param ndPereOriginal
	 *            le père des noeuds de l'arbre original
	 * @param ndPereCopie
	 *            le père qui va recevoir les copies
	 */
	private void copierFilsNoeud(Node ndPereOriginal, TreeNode ndPereCopie) {
		if (ndPereCopie != null && ndPereOriginal != null) {
			Node[] ndNodeFils = ndPereOriginal.getChildNodes();
			
			for (int i = 0; i < ndNodeFils.length; i++) {
 
				String[] usObj = (String[]) ndNodeFils[i].getUserObject();
				TreeNode child = new TreeNode(usObj[0]);
				child.setId(usObj[1]);
				child.setChecked(false);
				child.setUserObject(usObj);
				ndPereCopie.appendChild(child);
 
				if (!ndNodeFils[i].isLeaf()) {
					copierFilsNoeud(ndNodeFils[i], child);
				}
 
			}
		}
	}
}

Subversion Repositories eFlore/Applications.cel

(root)/branches/v1.6-croc/src/org/tela_botanica/client/vues/ArbreMotsClesVue.java @ 3220 – Rev 1009 → 1291

Rev 1009		Rev 1291
1	`package org.tela_botanica.client.vues;`	1	`package org.tela_botanica.client.vues;`
2		2
3	`import org.tela_botanica.client.image.ImageMediateur;`	3	`import org.tela_botanica.client.image.ImageMediateur;`
4	`import org.tela_botanica.client.interfaces.Rafraichissable;`	4	`import org.tela_botanica.client.interfaces.Rafraichissable;`
5		5
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.VerticalLayout;`	15	`import com.gwtext.client.widgets.layout.VerticalLayout;`
16	`import com.gwtext.client.widgets.tree.TreeEditor;`	16	`import com.gwtext.client.widgets.tree.TreeEditor;`
17	`import com.gwtext.client.widgets.tree.TreeNode;`	17	`import com.gwtext.client.widgets.tree.TreeNode;`
18	`import com.gwtext.client.widgets.tree.TreePanel;`	18	`import com.gwtext.client.widgets.tree.TreePanel;`
19	`import com.gwtext.client.widgets.tree.event.TreePanelListenerAdapter;`	19	`import com.gwtext.client.widgets.tree.event.TreePanelListenerAdapter;`
20		20
21	`/**`	21	`/**`
22	`* Arbre des mots clés, qui est une vue rafraichissable, qui contient des mots`	22	`* Arbre des mots clés, qui est une vue rafraichissable, qui contient des mots`
23	`* clés cochables et réorganisables à volonté`	23	`* clés cochables et réorganisables à volonté`
24	`*`	24	`*`
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`