Subversion Repositories eFlore/Applications.del

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
720 gduche 1
<?php
2
// declare(encoding='UTF-8');
3
/**
737 gduche 4
	* Le web service observations récupère toutes les observations et, pour chacune d'elle, les
5
	* images qui lui sont associées.
720 gduche 6
 *
7
 * @category	php 5.2
8
 * @package	del
9
 * @subpackage images
10
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
11
 * @copyright	Copyright (c) 2012, Tela Botanica (accueil@tela-botanica.org)
12
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
13
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
14
 * @version	$Id: Bdd.php 403 2012-02-22 14:35:20Z gduche $
737 gduche 15
 * @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Observations
720 gduche 16
 */
17
 
755 gduche 18
class ListeObservations {
720 gduche 19
 
755 gduche 20
 
720 gduche 21
	private $conteneur;
726 gduche 22
	private $navigation;
23
	private $masque;
737 gduche 24
	private $gestionBdd;
25
	private $bdd;
720 gduche 26
 
27
	public function __construct(Conteneur $conteneur = null) {
28
		$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
737 gduche 29
		$this->conteneur->chargerConfiguration('config_departements.ini');
726 gduche 30
		$this->navigation = $conteneur->getNavigation();
31
		$this->masque = $conteneur->getMasque();
737 gduche 32
		$this->gestionBdd = $conteneur->getGestionBdd();
33
		$this->bdd = $this->gestionBdd->getBdd();
720 gduche 34
	}
35
 
36
	/**
37
	 * Méthode principale de la classe.
38
	 * Lance la récupération des images dans la base et les place dans un objet ResultatService
39
	 * pour l'afficher.
40
	 * @param array $ressources les ressources situées après l'url de base (ex : http://url/ressource1/ressource2)
41
	 * @param array $parametres les paramètres situés après le ? dans l'url
42
	 * */
43
	public function consulter($ressources, $parametres) {
44
 
45
		// Gestion des configuration du script
46
		$this->configurer();
47
		$this->verifierConfiguration();
48
 
49
		// Lancement du service
50
		$liaisons = $this->chargerLiaisons();
737 gduche 51
		$total = $this->compterObservations();
726 gduche 52
		$this->navigation->setTotal($total);
755 gduche 53
		$observations = $this->chargerObservations($liaisons);
54
		$observations = $this->chargerImages($observations);
55
		$observations = $this->chargerDeterminations($observations);
56
		$observations = $this->chargerNombreCommentaire($observations);
720 gduche 57
 
58
		// Mettre en forme le résultat et l'envoyer pour affichage
59
		$resultat = new ResultatService();
755 gduche 60
		$resultat->corps = array('entete' => $this->conteneur->getEntete(), 'resultats' => $observations);
720 gduche 61
		return $resultat;
62
	}
63
 
64
	/*-------------------------------------------------------------------------------
65
	 							CONFIGURATION DU SERVICE
66
	 --------------------------------------------------------------------------------*/
67
	/**
68
	 * Configuration du service en fonction du fichier de config config_del.ini
69
	 * */
755 gduche 70
	private function configurer() {
720 gduche 71
		$this->mappingFiltre = $this->conteneur->getParametre('mapping_masque');
72
		$this->mappingObservation = $this->conteneur->getParametre('mapping_observation');
73
	}
74
 
75
	/**
76
	 * Vérifier que le service est bien configuré
77
	 * */
755 gduche 78
	private function verifierConfiguration() {
737 gduche 79
 
720 gduche 80
		$erreurs = array();
755 gduche 81
		$tableauObservations = $this->conteneur->getParametre('observations');
82
		if (empty($tableauObservations)) {
720 gduche 83
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [images] ou celui-ci est vide ;';
84
		} else {
737 gduche 85
			if ($this->conteneur->getParametre('url_service') == null) {
720 gduche 86
				$erreurs[] = '- paramètre "url_service" manquant ;';
87
			}
88
 
737 gduche 89
			if ($this->conteneur->getParametre('url_images') == null) {
720 gduche 90
				$erreurs[] = '- paramètre "url_images" manquant ;';
91
			}
92
 
93
		}
94
 
95
		if (empty($this->mappingObservation)) {
96
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_observation] ou celui-ci est vide ;';
97
		} else {
98
			$champsMappingObs = array('id_observation', 'date_observation', 'date_transmission', 'famille', 'nom_sel', 'nom_sel_nn', 'nt',
737 gduche 99
								'ce_zone_geo', 'zone_geo', 'lieudit', 'station', 'courriel', 'ce_utilisateur', 'nom', 'prenom');
100
 
720 gduche 101
			foreach ($champsMappingObs as $champ) {
102
				if (!isset($this->mappingObservation[$champ])) {
103
					$erreurs[] = '- le mapping du champ "'.$champ.'" pour l\'observation est manquant ;';
104
				}
105
			}
106
		}
107
 
108
		if (empty($this->mappingFiltre)) {
109
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_masque] ou celui-ci est vide ;';
110
		} else {
111
			$champsMappingFiltre = array('famille', 'ns', 'nn', 'date', 'tag', 'commune');
112
			foreach ($champsMappingFiltre as $champ) {
113
				if (!isset($this->mappingFiltre[$champ])) {
114
					$erreurs[] = '- le mapping du champ "'.$champ.'" pour l\'observation est manquant ;';
115
				}
116
			}
117
		}
118
 
119
		if (!empty($erreurs)) {
120
			$e = 'Erreur lors de la configuration : '."\n";
121
			$e .= implode("\n", $erreurs);
122
			throw new Exception($e, RestServeur::HTTP_CODE_ERREUR);
737 gduche 123
		}
720 gduche 124
	}
125
 
126
 
127
 
128
	/**
129
	 * Obtenir une chaine de caractère concaténant nom et prénom séparé par une virgule
130
	 * @param String $auteurId l'identifiant de l'auteur
131
	 * @return String la chaine de concaténation
132
	 * */
133
	private function getChaineNomPrenom($auteurId) {
134
		$nomPrenom = explode(' ', $auteurId);
135
		$nomPrenom = $this->proteger($nomPrenom);
136
		$chaineNomPrenom = implode(', ', $nomPrenom);
137
		return $chaineNomPrenom;
138
	}
139
 
140
	/**
141
	* Charger la clause WHERE en fonction des paramètres de masque
142
	* */
143
	private function chargerClauseWhere() {
144
		$where = array();
737 gduche 145
		$tableauMasque = $this->masque->getMasque();
146
		// FIXME : Les communes avec une apostrophe (ex: saint michel d'euzet) arrivent dans les paramètres sans l'apostrophe
147
		if (!empty($tableauMasque)) {
148
			foreach($tableauMasque as $idMasque => $valeurMasque) {
149
 
150
				$idMasque = str_replace('masque.', '', $idMasque);
151
				switch ($idMasque) {
152
					// nom du masque => nom BDD
153
					case 'auteur' :
154
						$auteurId = $this->masque->getMasque('auteur');
155
						if (is_numeric($auteurId)) {
156
							$where[] = ' ce_utilisateur = '.$auteurId;
157
						} else {
158
							if (strpos($auteurId, '@') === false) {
159
								$chaineNomPrenom = $this->getChaineNomPrenom($auteurId);
160
								$where[] = '((nom IN ('.$chaineNomPrenom.')) OR (prenom IN ('.$chaineNomPrenom.')))';
161
							} else {
162
								$where[] = " courriel LIKE ".$this->proteger($this->masque->getMasque('auteur').'%')." ";
163
							}
164
						}
165
						break;
720 gduche 166
 
737 gduche 167
						//TODO : gérer le format de la date ?
168
						// rechercher sur LIKE DATE % ?
169
						// TODO : recherche sur JOUR MOIS ou ANNEE
170
					case 'departement' :
171
						$dept = $valeurMasque;
172
						if (is_numeric($dept)) {
744 gduche 173
							$dept = sprintf('%02s', $dept);
174
							$dept = sprintf("%-'_5s", $dept);
175
							$where[] = " ce_zone_geo LIKE ".$this->proteger('INSEE-C:'.$dept);
720 gduche 176
						} else {
737 gduche 177
 
178
							//FIXME : et les apostrophes dans les départements ?
179
 
180
							$deptId = $this->conteneur->getParametre($dept);
181
							if ($deptId != null) {
182
								$where[] = " ce_zone_geo LIKE ".$this->proteger('INSEE-C:'.$deptId.'%');
183
							}
720 gduche 184
						}
737 gduche 185
						break;
186
					case 'genre' :
744 gduche 187
						$where[] = ' '.$this->mappingFiltre['ns'].' LIKE '.$this->proteger('%'.$valeurMasque.'% %');
737 gduche 188
						break;
189
					case 'tag' :
744 gduche 190
						$where[] = " mots_cles_texte LIKE ".$this->proteger($valeurMasque);
737 gduche 191
						break;
744 gduche 192
					case 'nn' :
193
						$where[] = ' '.$this->mappingFiltre['nn'].'  = '.$this->proteger($valeurMasque);
740 gduche 194
						break;
737 gduche 195
					default:
744 gduche 196
						$where[] = ' '.$this->mappingFiltre[$idMasque].' LIKE '.$this->proteger('%'.$valeurMasque.'%');
737 gduche 197
				}
198
			}
720 gduche 199
		}
200
 
201
		if (!empty($where)) {
202
			return ' WHERE '.implode('AND', $where);
203
		} else {
204
			return;
205
		}
206
	}
207
 
208
	/*-------------------------------------------------------------------------------
745 gduche 209
								CHARGEMENT DES OBSERVATIONS
720 gduche 210
	--------------------------------------------------------------------------------*/
211
	/**
212
	* Chargement depuis la bdd de toutes les liaisons entre images et observations
213
	* */
214
	private function chargerLiaisons() {
215
 
216
		$requeteLiaisons = 'SELECT SQL_CALC_FOUND_ROWS * '.
737 gduche 217
						   'FROM '.$this->gestionBdd->formaterTable('del_observation', 'dob').
766 aurelien 218
						   'INNER JOIN '.$this->gestionBdd->formaterTable('del_obs_image', 'doi').
737 gduche 219
						   'ON doi.id_observation = dob.id_observation '.
720 gduche 220
						   'INNER JOIN del_utilisateur du '.
737 gduche 221
						   'ON du.id_utilisateur = doi.id_utilisateur ';
720 gduche 222
		$requeteLiaisons .= $this->chargerClauseWhere();
737 gduche 223
		$requeteLiaisons .=  ' GROUP BY doi.id_observation';
224
		$requeteLiaisons .= ' ORDER BY date_transmission DESC ';
225
		$requeteLiaisons .= $this->gestionBdd->getLimitSql();
226
 
720 gduche 227
		return $this->bdd->recupererTous($requeteLiaisons);
228
	}
229
 
230
	/**
231
	* Compter le nombre total d'images dans la base pour affichage dans entete.
232
	* */
737 gduche 233
	private function compterObservations() {
720 gduche 234
		$requete = 'SELECT FOUND_ROWS() AS nbre ';
235
		$resultats = $this->bdd->recuperer($requete);
766 aurelien 236
		return (int) $resultats['nbre'];
720 gduche 237
	}
238
 
239
	/**
240
	* Retourner un tableau d'images formaté en fonction des liaisons trouvées
241
	* @param $liaisons les liaisons de la table del_obs_images
242
	* */
737 gduche 243
	private function chargerObservations($liaisons) {
720 gduche 244
 
737 gduche 245
		$observations = array();
720 gduche 246
		foreach ($liaisons as $liaison) {
737 gduche 247
			$idObs = $liaison[$this->mappingObservation['id_observation']];
720 gduche 248
 
745 gduche 249
			$observation = $this->formaterObservation($liaison);
737 gduche 250
			$observations[$idObs] = $observation;
720 gduche 251
		}
737 gduche 252
		return $observations;
720 gduche 253
	}
254
 
255
	/**
737 gduche 256
	 * Sélectionner toutes les images de chaque observation
257
	 * @param array $observations la liste des observations
258
	 * */
755 gduche 259
	private function chargerImages($observations) {
720 gduche 260
 
737 gduche 261
		foreach ($observations as $id => $observation) {
720 gduche 262
 
766 aurelien 263
			$requeteImages = 'SELECT * FROM '. $this->gestionBdd->formaterTable('del_obs_image', 'doi').
737 gduche 264
							 'INNER JOIN '.$this->gestionBdd->formaterTable('del_image', 'di').
265
							 'ON doi.id_image = di.id_image '.
266
							 'WHERE doi.id_observation = '.$observation['id_observation'];
720 gduche 267
 
737 gduche 268
			$images = $this->bdd->recupererTous($requeteImages);
269
			$images = $this->formaterImages($images);
270
			$observations[$id]['images'] = $images;
720 gduche 271
		}
272
 
737 gduche 273
		return $observations;
720 gduche 274
	}
275
 
755 gduche 276
	/**
277
	* Récupérer toutes les déterminations et le nombre de commentaire au total
278
	* @param array $observations la liste des observations à mettre à jour
279
	* */
280
	private function chargerDeterminations($observations) {
281
		foreach ($observations as $id => $observation) {
282
			$requetePropositions = 'SELECT * FROM '.$this->gestionBdd->formaterTable('del_commentaire', 'dc').
283
									   'WHERE dc.nom_sel IS NOT NULL AND ce_observation = '.$observation['id_observation'];
284
			$propositions = $this->bdd->recupererTous($requetePropositions);
285
			$observations[$id]['propositions'] = $propositions;
286
		}
287
		return $observations;
288
	}
737 gduche 289
 
755 gduche 290
	/**
291
	 * Charger le nombre de commentaires (sans détermination) associé à l'observation
292
	 * @param Array $observations le tableau des observatins à mettre à jour
293
	 * */
294
	private function chargerNombreCommentaire($observations) {
295
		foreach ($observations as $id => $observation) {
296
			$requeteNbCommentaires = 'SELECT COUNT('.$this->proteger('id_commentaire').') as nb '.
297
		                         'FROM '.$this->gestionBdd->formaterTable('del_commentaire').
298
		                         'WHERE ce_observation = '.$observation['id_observation'].' '.
299
								 'AND nom_sel IS NULL';
300
			$nbCommentaires = $this->bdd->recuperer($requeteNbCommentaires);
301
			$observations[$id]['commentaires'] = (int) $nbCommentaires['nb'];
302
		}
303
		return $observations;
304
 
305
 
306
 
307
	}
737 gduche 308
 
720 gduche 309
	/*-------------------------------------------------------------------------------
310
								FORMATER ET METTRE EN FORME
311
	--------------------------------------------------------------------------------*/
312
 
313
	/**
737 gduche 314
	 * Formater les images d'une observation
315
	 * @param array $images les images de l'observation
316
	 * */
317
	private function formaterImages($images) {
318
		$imagesRetour = array();
319
		foreach ($images as $image) {
320
			$imageCourante = array();
321
			$imageCourante['id_image'] = $image['id_image'];
322
			$imageCourante['date'] = $image['date_prise_de_vue'];
323
			$imageCourante['binaire.href'] = $this->formaterLienImage($image['id_image']);
324
			$imageCourante['hauteur'] = $image['hauteur'];
325
			$imageRetour['largeur'] = $image['largeur'];
326
 
327
			$imagesRetour[] = $imageCourante;
328
		}
329
 
330
		return $imagesRetour;
331
	}
332
 
333
	/**
720 gduche 334
	*  Formater une observation depuis une ligne liaison
335
	*  @param $liaison liaison issue de la recherche
336
	*  @return $observation l'observation mise en forme
337
	* */
338
	private function formaterObservation($liaison) {
339
		$observation = array();
340
 
341
		foreach ($this->mappingObservation as $nomOriginal => $nomFinal) {
342
			$observation[$nomFinal] = $liaison[$nomOriginal];
343
		}
745 gduche 344
 
345
		$observation['images'] = array();
720 gduche 346
 
347
		return $observation;
348
	}
349
 
350
 
351
	/**
352
	 * Formater le lien de l'image en fonction du fichier de config et de l'identifiant de l'image
353
	 * */
354
	private function formaterLienImage($idImage) {
355
		$idImage = sprintf('%09s', $idImage);
356
		$url = $this->conteneur->getParametre('url_images');
357
		$urlImage = str_replace('%s', $idImage, $url);
358
		return $urlImage;
359
	}
360
 
361
	private function proteger($valeur) {
362
		if (is_array($valeur)) {
363
			return $this->bdd->protegerTableau($valeur);
364
		} else {
365
			return $this->bdd->proteger($valeur);
366
		}
367
	}
368
}
369
?>