Subversion Repositories eFlore/Applications.del

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
709 gduche 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
	* Le web service image récupère toutes les données de la table del_obs_images
5
 * pour retourner une liste d'images associée à une observation
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 $
15
 * @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Images
16
 */
17
 
751 delphine 18
class ListeImages {
709 gduche 19
 
20
	private $imageIds = array();
719 gduche 21
	private $conteneur;
725 gduche 22
	private $navigation;
23
	private $masque;
24
	private $gestionBdd;
25
	private $bdd;
709 gduche 26
 
719 gduche 27
	public function __construct(Conteneur $conteneur = null) {
28
		$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
728 gduche 29
		$this->conteneur->chargerConfiguration('config_departements.ini');
725 gduche 30
		$this->navigation = $conteneur->getNavigation();
31
		$this->masque = $conteneur->getMasque();
32
		$this->gestionBdd = $conteneur->getGestionBdd();
33
		$this->bdd = $this->gestionBdd->getBdd();
719 gduche 34
	}
35
 
709 gduche 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();
711 gduche 47
		$this->verifierConfiguration();
709 gduche 48
 
49
		// Lancement du service
50
		$liaisons = $this->chargerLiaisons();
719 gduche 51
		$total = $this->compterImages();
725 gduche 52
		$this->navigation->setTotal($total);
709 gduche 53
		$images = $this->chargerImage($liaisons);
54
		$images = $this->chargerVotes($images);
55
 
56
		// Mettre en forme le résultat et l'envoyer pour affichage
57
		$resultat = new ResultatService();
719 gduche 58
		$resultat->corps = array('entete' => $this->conteneur->getEntete(), 'resultats' => $images);
709 gduche 59
		return $resultat;
60
	}
61
 
62
	/*-------------------------------------------------------------------------------
63
	 							CONFIGURATION DU SERVICE
64
	 --------------------------------------------------------------------------------*/
65
	/**
66
	 * Configuration du service en fonction du fichier de config config_del.ini
67
	 * */
68
	public function configurer() {
719 gduche 69
		$this->mappingFiltre = $this->conteneur->getParametre('mapping_masque');
70
		$this->mappingObservation = $this->conteneur->getParametre('mapping_observation');
709 gduche 71
	}
72
 
73
	/**
710 gduche 74
	 * Vérifier que le service est bien configuré
75
	 * */
76
	public function verifierConfiguration() {
728 gduche 77
 
710 gduche 78
		$erreurs = array();
728 gduche 79
		$tableauImages = $this->conteneur->getParametre('images');
80
		if (empty($tableauImages)) {
710 gduche 81
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [images] ou celui-ci est vide ;';
82
		} else {
728 gduche 83
			if ($this->conteneur->getParametre('url_service') == null) {
710 gduche 84
				$erreurs[] = '- paramètre "url_service" manquant ;';
85
			}
86
 
728 gduche 87
			if ($this->conteneur->getParametre('url_images') == null) {
710 gduche 88
				$erreurs[] = '- paramètre "url_images" manquant ;';
89
			}
90
 
91
		}
92
 
93
		if (empty($this->mappingObservation)) {
94
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_observation] ou celui-ci est vide ;';
95
		} else {
96
			$champsMappingObs = array('id_observation', 'date_observation', 'date_transmission', 'famille', 'nom_sel', 'nom_sel_nn', 'nt',
97
								'ce_zone_geo', 'lieudit', 'station', 'milieu', 'ce_utilisateur', 'nom', 'prenom');
98
			foreach ($champsMappingObs as $champ) {
99
				if (!isset($this->mappingObservation[$champ])) {
100
					$erreurs[] = '- le mapping du champ "'.$champ.'" pour l\'observation est manquant ;';
101
				}
102
			}
103
		}
104
 
105
		if (empty($this->mappingFiltre)) {
106
			$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_masque] ou celui-ci est vide ;';
107
		} else {
108
			$champsMappingFiltre = array('famille', 'ns', 'nn', 'date', 'tag', 'commune');
109
			foreach ($champsMappingFiltre as $champ) {
110
				if (!isset($this->mappingFiltre[$champ])) {
111
					$erreurs[] = '- le mapping du champ "'.$champ.'" pour l\'observation est manquant ;';
112
				}
113
			}
114
		}
115
 
116
		if (!empty($erreurs)) {
117
			$e = 'Erreur lors de la configuration : '."\n";
118
			$e .= implode("\n", $erreurs);
711 gduche 119
			throw new Exception($e, RestServeur::HTTP_CODE_ERREUR);
728 gduche 120
		}
710 gduche 121
	}
122
 
709 gduche 123
 
124
 
125
	/**
126
	 * Obtenir une chaine de caractère concaténant nom et prénom séparé par une virgule
127
	 * @param String $auteurId l'identifiant de l'auteur
128
	 * @return String la chaine de concaténation
129
	 * */
130
	private function getChaineNomPrenom($auteurId) {
131
		$nomPrenom = explode(' ', $auteurId);
719 gduche 132
		$nomPrenom = $this->proteger($nomPrenom);
709 gduche 133
		$chaineNomPrenom = implode(', ', $nomPrenom);
134
		return $chaineNomPrenom;
135
	}
136
 
137
	/**
138
	* Charger la clause WHERE en fonction des paramètres de masque
139
	* */
140
	private function chargerClauseWhere() {
141
		$where = array();
725 gduche 142
		$tableauMasque = $this->masque->getMasque();
728 gduche 143
		// FIXME : Les communes avec une apostrophe (ex: saint michel d'euzet) arrivent dans les paramètres sans l'apostrophe
725 gduche 144
		if (!empty($tableauMasque)) {
145
			foreach($tableauMasque as $idMasque => $valeurMasque) {
146
 
147
				$idMasque = str_replace('masque.', '', $idMasque);
148
				switch ($idMasque) {
149
					// nom du masque => nom BDD
150
					case 'auteur' :
151
						$auteurId = $this->masque->getMasque('auteur');
152
						if (is_numeric($auteurId)) {
153
							$where[] = ' ce_utilisateur = '.$auteurId;
154
						} else {
155
							if (strpos($auteurId, '@') === false) {
156
								$chaineNomPrenom = $this->getChaineNomPrenom($auteurId);
157
								$where[] = '((nom IN ('.$chaineNomPrenom.')) OR (prenom IN ('.$chaineNomPrenom.')))';
158
							} else {
159
								$where[] = " courriel LIKE ".$this->proteger($this->masque->getMasque('auteur').'%')." ";
160
							}
161
						}
162
						break;
719 gduche 163
 
725 gduche 164
						//TODO : gérer le format de la date ?
165
						// rechercher sur LIKE DATE % ?
166
						// TODO : recherche sur JOUR MOIS ou ANNEE
167
					case 'departement' :
168
						$dept = $valeurMasque;
169
						if (is_numeric($dept)) {
170
							$where[] = " ce_zone_geo LIKE ".$this->proteger('INSEE-C:'.$dept.'%');
709 gduche 171
						} else {
728 gduche 172
 
173
							//FIXME : et les apostrophes dans les départements ?
174
 
175
							$deptId = $this->conteneur->getParametre($dept);
176
							if ($deptId != null) {
177
								$where[] = " ce_zone_geo LIKE ".$this->proteger('INSEE-C:'.$deptId.'%');
178
							}
709 gduche 179
						}
725 gduche 180
						break;
181
					case 'genre' :
719 gduche 182
						$where[] = ' '.$this->mappingFiltre['ns'].' LIKE '.$this->proteger($valeurMasque.' %');
725 gduche 183
						break;
184
					case 'tag' :
185
						$where[] = " di.mots_cles_texte LIKE ".$this->proteger($valeurMasque);
186
						break;
187
					default:
188
						$where[] = ' '.$this->mappingFiltre[$idMasque].' = '.$this->proteger($valeurMasque);
189
					break;
190
				}
191
			}
709 gduche 192
		}
193
 
194
		if (!empty($where)) {
195
			return ' WHERE '.implode('AND', $where);
196
		} else {
197
			return;
198
		}
199
	}
200
 
201
	/*-------------------------------------------------------------------------------
202
								CHARGEMENT DES IMAGES
203
	--------------------------------------------------------------------------------*/
204
	/**
205
	* Chargement depuis la bdd de toutes les liaisons entre images et observations
206
	* */
207
	private function chargerLiaisons() {
208
 
209
		$requeteLiaisons = 'SELECT SQL_CALC_FOUND_ROWS * '.
725 gduche 210
						   'FROM '.$this->gestionBdd->formaterTable('del_obs_images', 'doi').
709 gduche 211
						   'INNER JOIN del_image di '.
736 gduche 212
						   'ON doi.id_image = di.id_image '.
709 gduche 213
						   'INNER JOIN del_observation dob '.
736 gduche 214
						   'ON doi.id_observation = dob.id_observation '.
709 gduche 215
						   'INNER JOIN del_utilisateur du '.
736 gduche 216
						   'ON du.id_utilisateur = doi.id_utilisateur';
709 gduche 217
		$requeteLiaisons .= $this->chargerClauseWhere();
736 gduche 218
		$requeteLiaisons .= ' ORDER BY date_transmission DESC';
725 gduche 219
		$requeteLiaisons .= $this->gestionBdd->getLimitSql();
736 gduche 220
 
719 gduche 221
		return $this->bdd->recupererTous($requeteLiaisons);
709 gduche 222
	}
223
 
224
	/**
225
	* Compter le nombre total d'images dans la base pour affichage dans entete.
226
	* */
227
	private function compterImages() {
228
		$requete = 'SELECT FOUND_ROWS() AS nbre ';
719 gduche 229
		$resultats = $this->bdd->recuperer($requete);
709 gduche 230
		return (int) $resultats['nbre'];
231
	}
232
 
233
	/**
234
	* Retourner un tableau d'images formaté en fonction des liaisons trouvées
235
	* @param $liaisons les liaisons de la table del_obs_images
236
	* */
237
	private function chargerImage($liaisons) {
238
 
239
		$images = array();
240
		foreach ($liaisons as $liaison) {
736 gduche 241
			$idImage = $liaison['id_image'];
709 gduche 242
 
243
			// On enregistre l'ID de l'image pour n'effectuer qu'une seule requête par la suite
244
			$this->imageIds[] = $idImage;
245
			$images[$idImage] = array('id_image' => $idImage, 'date' => $liaison['date_prise_de_vue'], 'binaire.href' => $this->formaterLienImage($idImage),
246
						'hauteur' => $liaison['hauteur'], 'largeur' => $liaison['largeur'], 'votes' => array(), 'observation' => $this->formaterObservation($liaison));
247
		}
248
		return $images;
249
	}
250
 
251
	/**
252
	* Charger les votes pour chaque image
253
	* */
254
	private function chargerVotes($images) {
255
 
256
		if (sizeof($this->imageIds) > 0) {
257
			$chaineImageIds = implode(',', $this->imageIds);
258
 
259
			$requeteVotes = 'SELECT * FROM '.
736 gduche 260
			                $this->gestionBdd->formaterTable('del_image_vote').
709 gduche 261
			                'WHERE ce_image IN ('.$chaineImageIds.')';
719 gduche 262
			$resultatsVotes = $this->bdd->recupererTous($requeteVotes);
709 gduche 263
 
264
 
265
			//TODO : faire une méthode formater vote
266
			$votes = $this->formaterVotes($resultatsVotes);
267
 
268
			foreach ($images as $id => $image) {
269
				if (isset($votes[$image['id_image']])) {
270
					$images[$id]['votes'] = $votes[$image['id_image']];
271
				}
272
			}
273
		}
274
 
275
		return $images;
276
	}
277
 
278
	/*-------------------------------------------------------------------------------
279
								FORMATER ET METTRE EN FORME
280
	--------------------------------------------------------------------------------*/
281
 
282
	/**
283
	*  Formater une observation depuis une ligne liaison
284
	*  @param $liaison liaison issue de la recherche
285
	*  @return $observation l'observation mise en forme
286
	* */
287
	private function formaterObservation($liaison) {
288
		$observation = array();
289
 
290
		foreach ($this->mappingObservation as $nomOriginal => $nomFinal) {
291
			$observation[$nomFinal] = $liaison[$nomOriginal];
292
		}
293
 
294
		return $observation;
295
	}
296
 
297
	/**
298
	*  Formater une observation depuis une ligne liaison
299
	*  @param $liaison liaison issue de la recherche
300
	*  @return $observation l'observation mise en forme
301
	* */
302
	private function formaterVotes($votes) {
303
		$retour = array();
304
		foreach ($votes as $vote) {
305
			$idImage = $vote['ce_image'];
306
			$id = $vote['id_vote_image'];
307
			$id_protocole = $vote['ce_protocole'];
308
			$auteur_id = $vote['ce_utilisateur'];
309
			$valeur = $vote['valeur_vote'];
310
			$date = $vote['date_vote_image'];
311
 
312
			$retour[$idImage]['valeur'] = $valeur;
313
			$retour[$idImage]['protocole'] = $id_protocole;
314
			$retour[$idImage]['auteur_id'] = $auteur_id;
315
			$retour[$idImage]['date'] = $auteur_id;
316
		}
317
 
318
		return $retour;
319
	}
320
 
321
	/**
322
	 * Formater le lien de l'image en fonction du fichier de config et de l'identifiant de l'image
323
	 * */
324
	private function formaterLienImage($idImage) {
325
		$idImage = sprintf('%09s', $idImage);
719 gduche 326
		$url = $this->conteneur->getParametre('url_images');
709 gduche 327
		$urlImage = str_replace('%s', $idImage, $url);
328
		return $urlImage;
329
	}
719 gduche 330
 
331
	private function proteger($valeur) {
332
		if (is_array($valeur)) {
333
			return $this->bdd->protegerTableau($valeur);
334
		} else {
335
			return $this->bdd->proteger($valeur);
709 gduche 336
		}
337
	}
338
}
339
?>