Subversion Repositories eFlore/Applications.del

Rev

Rev 1794 | Rev 1837 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 1794 Rev 1795
Line 1... Line 1...
1 
<?php
 1 
<?php
2 
// declare(encoding='UTF-8');
 2 
// declare(encoding='UTF-8');
3 
/**
 3 
/**
4 
	* Le web service image récupère toutes les données de la table del_obs_images
 4 
 * Retourne le contenu d'un commentaire pour un identifiant donné.
5 
 * pour retourner une liste d'images associée à une observation
 5 
 * http://localhost/service:del:0.1/commentaires/#id => retourne le contenu d'un commentaire d'id #id
6 
 *
 6 
 *
7 
 * @category	php 5.2
 7 
 * @category   DEL
8 
 * @package	del
 8 
 * @package    Services
9 
 * @subpackage images
 9 
 * @subpackage Commentaires
- 
 
 10 
 * @version    0.1
10 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 11 
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
11 
 * @copyright	Copyright (c) 2012, Tela Botanica (accueil@tela-botanica.org)
 12 
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
12 
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 13 
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
13 
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 14 
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
14 
 * @version	$Id: Bdd.php 403 2012-02-22 14:35:20Z gduche $
 15 
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
15 
 * @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Images
 16 
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
16 
 */
 17 
 */
Line 17... Line 18...
17 
 
 18 
 
Line 18... Line 19...
18 
class ConsulterCommentaire {
 19 
class ConsulterCommentaire {
19 
 
 20 
 
20 
	private $conteneur;
 - 
 
21 
	private $navigation;
 21 
	private $conteneur;
22 
	private $masque;
 - 
 
23 
	private $bdd;
 - 
 
24 
	private $parametres = array();
 22 
	private $navigation;
Line -... Line 23...
- 
 
 23 
	private $bdd;
- 
 
 24 
	private $idCommentaire;
- 
 
 25 
 
25 
	private $ressources = array();
 26 
	private $mapping = array();
26 
	private $idCommentaire;
 27 
	private $mappingInverse = array();
27 
 
 - 
 
28 
	public function __construct(Conteneur $conteneur = null) {
 - 
 
29 
		$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
 28 
 
30 
		$this->conteneur->chargerConfiguration('config_commentaires.ini');
 - 
 
31 
		$this->conteneur->chargerConfiguration('config_mapping_commentaires.ini');
 29 
	public function __construct(Conteneur $conteneur = null) {
- 
 
 30 
		$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
- 
 
 31 
		$this->navigation = $conteneur->getNavigation();
- 
 
 32 
		$this->bdd = $this->conteneur->getBdd();
32 
		$this->navigation = $conteneur->getNavigation();
 33 
 
Line 33... Line -...
33 
		$this->masque = $conteneur->getMasque();
 - 
 
34 
		$this->bdd = $this->conteneur->getBdd();
 - 
 
35 
	}
 - 
 
36 
 
 - 
 
37 
	/**
 - 
 
38 
	 * Méthode principale de la classe.
 - 
 
39 
	 * Lance la récupération des images dans la base et les place dans un objet ResultatService
 - 
 
40 
	 * pour l'afficher.
 34 
		$this->mapping = $this->conteneur->getParametreTableau('commentaires.mapping');
41 
	 * @param array $ressources les ressources situées après l'url de base (ex : http://url/ressource1/ressource2)
 - 
 
42 
	 * @param array $parametres les paramètres situés après le ? dans l'url
 - 
 
43 
	 * */
 - 
 
44 
	public function consulter($ressources, $parametres) {
 - 
 
45 
		$this->initialiserRessourcesEtParametres($ressources, $parametres);
 35 
		$this->mappingInverse = array_flip($this->mapping);
Line 46... Line 36...
46 
 
 36 
	}
47 
		// Gestion des configuration du script
 37 
 
48 
		$this->configurer();
 38 
	public function consulter($ressources) {
49 
		$this->verifierConfiguration();
 - 
 
50 
 
 39 
		$this->idCommentaire = $ressources[0];
51 
		// Lancement du service
 - 
 
52 
		$commentaires = $this->chargerCommentaires();
 - 
 
Line 53... Line 40...
53 
		$commentaires = $this->formaterCommentaires($commentaires);
 40 
 
54 
		$total = $this->compterCommentaires();
 41 
		// Lancement du service
- 
 
 42 
		$commentaire = $this->chargerCommentaire();
Line 55... Line -...
55 
		$this->navigation->setTotal($total);
 - 
 
56 
		/*$images = $this->chargerImage($liaisons);
 43 
		$commentaire = $this->formaterCommentaires($commentaire);
57 
		$images = $this->chargerVotes($images);
 44 
		$this->navigation->setTotal(count($commentaire));
Line 58... Line -...
58 
 
 - 
 
59 
		// Mettre en forme le résultat et l'envoyer pour affichage*/
 - 
 
60 
		$resultat = new ResultatService();
 - 
 
61 
 
 - 
 
62 
		$resultat->corps = array('entete' => $this->navigation->getEntete(), 'resultats' => $commentaires);
 - 
 
63 
		return $resultat;
 - 
 
64 
	}
 - 
 
65 
 
 - 
 
66 
	private function initialiserRessourcesEtParametres($ressources, $parametres) {
 - 
 
67 
		$this->ressources = $ressources;
 - 
 
68 
 
 - 
 
69 
		if (sizeof($this->ressources) == 1 && (is_numeric($this->ressources[0]))) {
 - 
 
70 
			$this->idCommentaire = $ressources[0];
 - 
 
71 
		} else {
 - 
 
72 
			$e = 'L\identifiant d\un commentaire est numérique';
 - 
 
73 
			throw new Exception($e, RestServeur::HTTP_CODE_ERREUR);
 - 
 
74 
		}
 - 
 
75 
 
 - 
 
76 
		$this->parametres = $parametres;
 - 
 
77 
 
 - 
 
78 
	}
 - 
 
79 
 
 - 
 
80 
	/*-------------------------------------------------------------------------------
 - 
 
81 
	 							CONFIGURATION DU SERVICE
 - 
 
82 
	 --------------------------------------------------------------------------------*/
 - 
 
83 
	/**
 - 
 
84 
	 * Configuration du service en fonction du fichier de config config_del.ini
 - 
 
85 
	 * */
 - 
 
86 
	public function configurer() {
 45 
 
87 
		$this->mappingFiltre = $this->conteneur->getParametre('mapping_masque');
 46 
		// Mettre en forme le résultat et l'envoyer pour affichage*/
88 
		$this->mappingCommentaire = $this->conteneur->getParametre('mapping_commentaire');
 - 
 
89 
	}
 47 
		$resultat = new ResultatService();
90 
 
 - 
 
91 
	/**
 - 
 
92 
	 * Vérifier que le service est bien configuré
 - 
 
93 
	 * */
 - 
 
94 
	public function verifierConfiguration() {
 - 
 
95 
		$erreurs = array();
 - 
 
96 
		$tableauCommentaires = $this->conteneur->getParametre('commentaires');
 - 
 
97 
		if (empty($tableauCommentaires)) {
 48 
		$resultat->corps = array('entete' => $this->navigation->getEntete(), 'resultats' => $commentaire);
98 
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [commentaires] ou celui-ci est vide ;';
 - 
 
99 
		} else {
 - 
 
100 
			if ($this->conteneur->getParametre('url_service') == null) {
 - 
 
101 
				$erreurs[] = '- paramètre "url_service" manquant ;';
 - 
 
102 
			}
 - 
 
103 
		}
 49 
 
104 
 
 - 
 
105 
		if (empty($this->mappingCommentaire)) {
 - 
 
106 
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_commentaire] ou celui-ci est vide ;';
 - 
 
107 
		} else {
 - 
 
108 
			$champsMappingCom = array('id_commentaire', 'texte', 'ce_utilisateur', 'utilisateur_nom', 'utilisateur_prenom', 'utilisateur_courriel', 'date');
 50 
		return $resultat;
109 
			foreach ($champsMappingCom as $champ) {
 - 
 
110 
				if (!isset($this->mappingCommentaire[$champ])) {
 - 
 
111 
					$erreurs[] = '- le mapping du champ "'.$champ.'" pour le commentaire est manquant ;';
 - 
 
112 
				}
 - 
 
113 
			}
 51 
	}
114 
		}
 - 
 
115 
 
 - 
 
116 
		if (empty($this->mappingFiltre)) {
 - 
 
117 
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_masque] ou celui-ci est vide ;';
 - 
 
118 
		} else {
 - 
 
119 
			$champsMappingFiltre = array('observation');
 52 
 
120 
			foreach ($champsMappingFiltre as $champ) {
 53 
	private function chargerCommentaire() {
121 
				if (!isset($this->mappingFiltre[$champ])) {
 - 
 
122 
					$erreurs[] = '- le mapping du champ "'.$champ.'" pour l\'observation est manquant ;';
 54 
		$requete = 'SELECT * '.
123 
				}
 - 
 
124 
			}
 - 
 
125 
		}
 - 
 
126 
 
 - 
 
127 
		if (!empty($erreurs)) {
 - 
 
128 
			$e = 'Erreur lors de la configuration : '."\n";
 - 
 
129 
			$e .= implode("\n", $erreurs);
 - 
 
130 
			throw new Exception($e, RestServeur::HTTP_CODE_ERREUR);
 - 
 
131 
		}
 - 
 
132 
	}
 - 
 
133 
 
 - 
 
134 
	/**
 - 
 
135 
	* Charger la clause WHERE en fonction des paramètres de masque
 - 
 
136 
	* */
 - 
 
137 
	private function chargerClauseWhere() {
 - 
 
138 
		$where = array();
 - 
 
139 
		if (isset($this->idCommentaire)) {
 - 
 
140 
			$where[] = 'id_commentaire = '.$this->idCommentaire;
 - 
 
141 
		}
 - 
 
142 
 
 - 
 
143 
		$tableauMasque = $this->masque->getMasque();
 - 
 
144 
		if (!empty($tableauMasque)) {
 - 
 
145 
			foreach($tableauMasque as $idMasque => $valeurMasque) {
 - 
 
146 
				//TODO: scinder ceci en fonctions réutilisables ?
 - 
 
147 
				// voir si c'est interessant par rapport à la recherche générale
 - 
 
148 
				$idMasque = str_replace('masque.', '', $idMasque);
 - 
 
149 
				switch ($idMasque) {
 - 
 
150 
					default:
 - 
 
151 
						$where[] = ' '.$this->mappingFiltre[$idMasque].' = '.$this->proteger($valeurMasque);
 - 
 
152 
					break;
 - 
 
153 
				}
 55 
			'FROM del_commentaire '.
154 
			}
 - 
 
155 
		}
 - 
 
156 
 
 - 
 
157 
		if (!empty($where)) {
 - 
 
158 
			return ' WHERE '.implode('AND', $where);
 - 
 
159 
		} else {
 - 
 
160 
			return;
 - 
 
161 
		}
 - 
 
162 
	}
 - 
 
163 
 
 - 
 
164 
	/*-------------------------------------------------------------------------------
 - 
 
165 
							   CHARGEMENT DES COMMENTAIRES
 - 
 
166 
	--------------------------------------------------------------------------------*/
 - 
 
167 
	/**
 - 
 
168 
	* Chargement depuis la bdd de tous les commentaires
 - 
 
169 
	* */
 - 
 
170 
	private function chargerCommentaires() {
 - 
 
171 
		$requeteLiaisons = 'SELECT DISTINCT SQL_CALC_FOUND_ROWS * FROM del_commentaire '.
 - 
 
172 
			$this->chargerClauseWhere().
 - 
 
173 
			' LIMIT '.$this->navigation->getDepart().', '.$this->navigation->getLimite();
 - 
 
174 
		return $this->bdd->recupererTous($requeteLiaisons);
 - 
 
175 
	}
 56 
			'WHERE id_commentaire = '.$this->idCommentaire.' '.
176 
 
 57 
			'LIMIT '.$this->navigation->getDepart().', '.$this->navigation->getLimite().' '.
177 
	/**
 - 
 
178 
	* Compter le nombre total de commentaires dans la base pour affichage dans entete.
 - 
 
179 
	* */
 - 
 
180 
	private function compterCommentaires() {
 - 
 
181 
		$requete = 'SELECT FOUND_ROWS() AS nbre ';
 58 
			' -- '.__FILE__.' : '.__LINE__;
182 
		$resultats = $this->bdd->recuperer($requete);
 - 
 
183 
		return (int) $resultats['nbre'];
 - 
 
184 
	}
 - 
 
185 
 
 - 
 
186 
	/*-------------------------------------------------------------------------------
 - 
 
187 
								FORMATER ET METTRE EN FORME
 59 
		$resultat = $this->bdd->recuperer($requete);
188 
	--------------------------------------------------------------------------------*/
 60 
		if ($resultat === false) {
189 
 
 - 
 
190 
	/**
 61 
			$message = "Aucune information ne correspond au commentaire # «{$this->idCommentaire}».";
191 
	*  Formater les commentaires
 62 
			throw new Exception($message, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
192 
	*  @param $commentaires les commentaires à mettre à jour
 63 
		}
193 
	*  @return $commentaires les commentaires mis à jour
 - 
 
194 
	* */
 - 
 
195 
	private function formaterCommentaires($commentaires) {
 - 
 
196 
		$retourCommentaires = array();
 - 
 
197 
 
 - 
 
198 
		foreach ($commentaires as $id => $commentaire) {
 - 
 
199 
			foreach ($this->mappingCommentaire as $nomOriginal => $nomFinal) {
 - 
 
200 
				$retourCommentaires[$nomFinal] = $commentaire[$nomOriginal];
 - 
 
201 
			}
 - 
 
202 
		}
 - 
 
203 
 
 - 
 
204 
		return $retourCommentaires;
 64 
		return is_array($resultat) ? $resultat : array();
- 
 
 65 
	}
205 
	}
 66 
 
206 
 
 - 
 
207 
	private function proteger($valeur) {
 - 
 
208 
		if (is_array($valeur)) {
 67 
	private function formaterCommentaires($infos) {
- 
 
 68 
		$retour = array();
209 
			return $this->bdd->protegerTableau($valeur);
 69 
		$idCommentaire = $infos['id_commentaire'];