Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 499 | Rev 517 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
452 mathilde 1
<?php
2
 
3
/**
4
* Classe InformationsBaseflor.php permet de faire des requetes de baseflor en fonction d'un référentiel
499 jpm 5
*( BDTFX, BDAFX, BDBFX ) et d'un numéro nomenclatural ( différent de 0 ).
452 mathilde 6
*  fin d'url possibles :
7
*  /informations/#bdnt.nn:#num_nomen --> retourne tous les champs pour un BDNT et un num_nomen
8
*  /informations/#bdnt.nn:#num_nomen?champs=description --> retourne champs description pour un BDNT et un num_nomen
9
*  /informations/#bdnt.nn:#num_nomen?champs=ecologie --> retourne champs ecologiques pour un BDNT et un num_nomen
10
*  /informations --> retourne les 10 premiers résultats
11
*  /informations?navigation.limite=..&navigation.depart=.. --> retourne les 10 premiers résultats avec limites
12
*
13
* Encodage en entrée : utf8
14
* Encodage en sortie : utf8
15
* @package eflore-projets
16
* @author Mathilde SALTHUN-LASSALLE <mathilde@tela-botanica.org>
17
* @author Delphine CAUQUIL <delphine@tela-botanica.org>
18
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
19
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
20
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
21
* @version 1.0
22
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
23
*/
24
 
25
class InformationsBaseflor extends Commun{
499 jpm 26
 
452 mathilde 27
	protected $table = "";
28
	private $requete_condition = "";
29
	private $format_reponse = 'informations';
30
	private $total_resultat;
31
	private $retour_format = 'max';
32
	protected $limite_requete = array( 'depart' => 0, 'limite' => 10);
33
	private $champs_recherches = '*';
34
	private $champs_ontologiques = array();
35
	protected $serviceNom = 'informations';
499 jpm 36
 
452 mathilde 37
	public function consulter($ressources, $parametres) {
38
		$this->ressources = $ressources;
39
		$this->parametres = $parametres;
40
		$this->traiterParametres();
41
		$this->traiterVersionProjet();
42
		$resultats = null;
499 jpm 43
		foreach ($this->table_version as $version) {
44
			$this->table = $version;
45
			$this->recupererNomChamp($this->table);
46
			$this->traiterRessources();
47
			$requete = $this->assemblerLaRequete();
452 mathilde 48
			$resultat = $this->getBdd()->recupererTous($requete);
49
			$versionResultat = $this->traiterResultat($resultat, $version, $requete);
50
			if (count($this->table_version) > 1) {
51
				$resultats[$version] = $versionResultat;
52
			} else {
53
				$resultats = $versionResultat;
54
			}
55
		}
499 jpm 56
		return $resultats;
452 mathilde 57
	}
499 jpm 58
 
452 mathilde 59
	public function traiterResultat($resultat, $version, $requete) {
60
		$versionResultat = null;
61
		if ($resultat == '') {
62
			$message = 'La requête SQL formée comporte une erreur!';
63
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
64
			throw new Exception($message, $code);
65
		} elseif ($resultat) {
66
			$versionResultat = $this->retournerResultatFormate($resultat, $version);
499 jpm 67
		}
452 mathilde 68
		return $versionResultat;
69
	}
499 jpm 70
 
71
//+--------------------------traitement ressources ou paramètres  -------------------------------------------+
452 mathilde 72
	public function traiterParametres() {
73
		if (isset($this->parametres) && !empty($this->parametres)) {
74
			foreach ($this->parametres as $param => $valeur) {
75
				switch ($param) {
499 jpm 76
					case 'navigation.depart'  :
452 mathilde 77
						 $this->limite_requete['depart'] = $valeur;	 break;
78
					case 'navigation.limite'  :  $this->limite_requete['limite'] = $valeur;	  break;
516 mathilde 79
					case 'categorie'  :
452 mathilde 80
						if ($valeur == "description") {
81
							$this->champs_recherches = "num_nomen, BDNT, chorologie, inflorescence,"
499 jpm 82
								." sexualite, ordre_maturation, "
83
								."pollinisation, fruit, dissemination, couleur_fleur, macule, floraison, type_bio, "
84
						 		."form_vegetale ";
85
							$this->requete_condition[] = "( chorologie != '' OR inflorescence != '' ".
86
								"OR  sexualite != '' OR ordre_maturation != '' OR pollinisation != '' ".
87
								"OR fruit != '' OR dissemination != '' OR couleur_fleur != '' OR macule != '' ".
88
								"OR floraison != '' OR type_bio != '' OR form_vegetale != '' )";
89
						}elseif ($valeur == "ecologie") {
466 mathilde 90
							$this->champs_recherches = " num_nomen, BDNT, ve_lumiere , ve_temperature,"
499 jpm 91
								." ve_continentalite, ve_humidite_atmos, ve_humidite_edaph, ve_reaction_sol,"
92
								." ve_nutriments_sol, ve_salinite, ve_texture_sol, ve_mat_org_sol ";
466 mathilde 93
							$this->requete_condition[] = "( ve_lumiere  != '' OR ve_temperature != '' ".
94
								"OR ve_continentalite != '' OR ve_humidite_atmos != '' ".
95
								"OR ve_humidite_edaph != '' OR ve_reaction_sol != '' ".
96
								"OR ve_nutriments_sol != '' OR ve_salinite != '' ".
499 jpm 97
								"OR ve_texture_sol != '' OR ve_mat_org_sol != '' )";
98
						} else {
99
							$e = "Valeur de paramètre inconnue  pour 'test'.";
452 mathilde 100
							$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
101
						}
102
						break;
103
					case 'retour.format'  :
104
						$this->retour_format = $valeur;
105
						break;
106
					default :
107
						$e = 'Erreur dans les parametres de votre requête : </br> Le paramètre " '
108
							.$param.' " n\'existe pas.';
109
						$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);	break;
110
				}
111
			}
112
		}
113
	}
114
 
115
	public function traiterRessources() {
116
		if (isset($this->ressources) && !empty($this->ressources[0])) {
117
			if(preg_match('/^(.+)\.nn:([0-9]+)$/', $this->ressources[0], $retour)==1){
118
				switch ($retour[1]) {
119
					case 'bdtfx' :
120
						$this->requete_condition[] = "num_nomen = ".$retour[2]." AND BDNT = 'BDTFX' ";
121
						break;
122
					case  'bdafx' :
499 jpm 123
						$this->requete_condition[] = "num_nomen = ".$retour[2]." AND BDNT = 'BDAFX' ";
452 mathilde 124
						break;
125
					case  'bdbfx' :
499 jpm 126
						$this->requete_condition[] = "num_nomen = ".$retour[2]." AND BDNT = 'BDBFX' ";
452 mathilde 127
						break;
128
					default :
516 mathilde 129
						$e = 'Erreur dans l\'url de votre requête : </br> Le référentiel " '
452 mathilde 130
							.$retour[1].' " n\'existe pas.';
499 jpm 131
						$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
452 mathilde 132
						break;
499 jpm 133
				}
134
 
516 mathilde 135
			} else {
136
				$e = 'Erreur dans l\'url de votre requête : </br> La ressource demandée n\'existe pas.';
137
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
138
				break;
452 mathilde 139
			}
140
		} else {
141
			$this->champs_recherches=" cle, catminat_code, BDNT, num_taxon, num_nomen ";
142
		}
143
	}
499 jpm 144
 
452 mathilde 145
//+--------------------------formatages de resultats  -------------------------------------------+
146
	public function retournerResultatFormate($resultat) {
147
		if ((count($this->ressources)) == 0) {
148
			$table_retour_json['resultat'] = $this->formaterResultatsInformations($resultat);
149
		} else {
150
			$table_retour_json = $this->formaterResultatsInformationsBDNTnn($resultat);
151
		}
152
		return $table_retour_json;
153
	}
499 jpm 154
 
452 mathilde 155
	public function formaterResultatsInformationsBDNTnn($resultat){
499 jpm 156
		$resultat_json = $resultat[0];
157
		if ($this->retour_format == 'max'){
516 mathilde 158
			if (!isset($this->parametres['categorie']) ) {
499 jpm 159
				$resultat_json = $this->formaterResultatsTousChamps($resultat_json);
516 mathilde 160
			} elseif ($this->parametres['categorie'] == 'ecologie') {
499 jpm 161
				$resultat_json = $this->formaterResultatsChampsEcologie($resultat_json);
516 mathilde 162
			} elseif ($this->parametres['categorie'] == 'description') {
499 jpm 163
				$resultat_json = $this->formaterResultatsChampsDescription($resultat_json);
164
			}
452 mathilde 165
		}
499 jpm 166
		return $resultat_json;
452 mathilde 167
	}
499 jpm 168
 
169
 
452 mathilde 170
	public function formaterResultatsTousChamps($resultat) {
171
		$resultat_json = $resultat;
499 jpm 172
 
452 mathilde 173
		if ($resultat_json['type_bio'] != ""){
174
			$tab_ontologie = $this->recupererOntologiePrTypeBio($resultat_json['type_bio']);
175
			unset($resultat_json['type_bio']);
176
			$resultat_json= array_merge($resultat_json,$tab_ontologie);
177
		}
178
		$this->champs_ontologiques = $this->recupererTableauConfig('champs_ontologiques');
499 jpm 179
 
452 mathilde 180
		foreach ($this->champs_ontologiques as $cle => $valeur){
181
			if ($resultat_json[$cle] != ""){
182
				$tab_ontologie = $this->recupererOntologies($resultat_json[$cle], $cle);
183
				unset($resultat_json[$cle]);
184
				$resultat_json = array_merge($resultat_json,$tab_ontologie);
185
			}
186
		}
499 jpm 187
		$resultat_json['graphique_climat']['libelle'] = 'climat';
188
		$resultat_json['graphique_climat']['href'] = $this->ajouterHref('graphiques/climat', strtolower($resultat_json['BDNT']).'.nn:'.$resultat_json['num_nomen']);
189
		$resultat_json['graphique_sol']['libelle'] = 'sol';
190
		$resultat_json['graphique_sol']['href'] = $this->ajouterHref('graphiques/sol', strtolower($resultat_json['BDNT']).'.nn:'.$resultat_json['num_nomen']);
191
 
452 mathilde 192
		return $resultat_json ;
193
	}
499 jpm 194
 
452 mathilde 195
	public function formaterResultatsChampsEcologie($resultat) {
196
		$resultat_json = $resultat;
197
		$this->champs_ontologiques = $this->recupererTableauConfig('champs_ontologiques');
198
		foreach ($this->champs_ontologiques as $cle => $valeur){
199
			if ($resultat_json[$cle] != ""){
200
				$tab_ontologie = $this->recupererOntologies($resultat_json[$cle], $cle);
201
				unset($resultat_json[$cle]);
202
				$resultat_json= array_merge($resultat_json,$tab_ontologie);
203
			}
204
		}
205
		$resultat_json['graphique_climat']['libelle'] = 'climat';
206
		$resultat_json['graphique_climat']['href'] = $this->ajouterHref('graphiques/climat', strtolower($resultat_json['BDNT']).'.nn:'.$resultat_json['num_nomen']);
207
		$resultat_json['graphique_sol']['libelle'] = 'sol';
208
		$resultat_json['graphique_sol']['href'] = $this->ajouterHref('graphiques/sol', strtolower($resultat_json['BDNT']).'.nn:'.$resultat_json['num_nomen']);
209
		return $resultat_json ;
210
	}
499 jpm 211
 
452 mathilde 212
	public function formaterResultatsChampsDescription($resultat) {
213
		$resultat_json = $resultat;
214
		if ($resultat_json['type_bio'] != ""){
215
			$tab_ontologie = $this->recupererOntologiePrTypeBio($resultat_json['type_bio']);
216
			unset($resultat_json['type_bio']);
217
			$resultat_json = array_merge($resultat_json,$tab_ontologie);
218
		}
219
		return $resultat_json ;
220
	}
221
	public function formaterResultatsInformations($resultat) {
222
		$resultat_json = array();
223
		$resultat_json['entete'] = $this->ajouterEnteteResultat();
224
		foreach ($resultat as $tab) {
225
			if ($tab['BDNT'] != 'nc'){
226
				$num = $tab['cle'];
227
				unset($tab['cle']);
228
				foreach ($tab as $param => $valeur) {
229
					$resultat_json[$num][$param] = $valeur;
230
				}
231
				$resultat_json[$num]['href'] = $this->ajouterHref('informations',strtolower($tab['BDNT']).".nn:".$tab['num_nomen']);
232
			}
233
		}
234
		return $resultat_json;
235
	}
499 jpm 236
 
237
 
238
 
452 mathilde 239
	public function ajouterEnteteResultat() {
240
		$entete['depart'] = $this->limite_requete['depart'];
241
		$entete['limite'] = $this->limite_requete['limite'];
242
		$entete['total']  =  $this->total_resultat;
243
		$entete['version']  = $this->version_projet;
244
		$url = $this->formulerUrl($this->total_resultat, '/informations');
245
		if (isset($url['precedent']) && $url['precedent'] != '') {
246
			$entete['href.precedent'] = $url['precedent'];
247
		}
248
		if (isset($url['suivant']) && $url['suivant'] != '') {
249
			$entete['href.suivant']   = $url['suivant'];
250
		}
251
		return $entete;
252
	}
499 jpm 253
 
254
 
452 mathilde 255
//+--------------------------traitement ontologies -------------------------------------------+
256
	public function recupererOntologies($valeur, $champs){
257
		$url = $this->ajouterHref('ontologies',$this->champs_ontologiques[$champs].':'.urlencode(urlencode($valeur)));
258
		$val = $this->consulterHref($url);
259
		$resultat_json[$champs.'.libelle'] = $val->nom;
260
		$resultat_json[$champs.'.code'] = $valeur;
261
		$resultat_json[$champs.'.href'] = $url;
262
		return $resultat_json;
263
	}
499 jpm 264
 
452 mathilde 265
	public function recupererOntologiePrTypeBio($type_a_traiter){
266
		$resultat_typeBio = "";
499 jpm 267
		if ($type_a_traiter != "") {
452 mathilde 268
			$resultat_typeBio['type_bio.code'] = $type_a_traiter;
269
			$types_prim_sec = $this->separerTypesPrimairesSecondaires($type_a_traiter);
499 jpm 270
			foreach ($types_prim_sec as $cle => $tb) {
452 mathilde 271
				$types_sstypes[$cle]= $this->separerTypes_SousTypes($tb, $cle);
272
			}
499 jpm 273
			switch (count($types_sstypes)) {
452 mathilde 274
				case 1 :
275
					$types_sstypes = $types_sstypes['principal'];
276
					break;
499 jpm 277
				case 2 :
452 mathilde 278
					$types_sstypes = array_merge($types_sstypes['principal'],$types_sstypes['secondaire']);
279
					break;
499 jpm 280
				case 3 :
452 mathilde 281
					$types_sstypes = array_merge($types_sstypes['principal'],
282
												$types_sstypes['secondaire'],
283
												$types_sstypes['special']);
284
					break;
285
			}
499 jpm 286
 
287
			foreach ($types_sstypes as $cle => $tb) {
288
				if (($cle == 'type.principal') || ($cle == 'type.secondaire')) {
452 mathilde 289
					$url = $this->ajouterHref('ontologies','TB:'.urlencode(urlencode($tb)));
290
					$val = $this->consulterHref($url);
291
					$libelle[$cle]= $val->nom;
292
					$detail[$cle]['libelle'] = $val->nom;
293
					$detail[$cle]['code'] = $val->code;
294
					$detail[$cle]['href'] = $url;
295
				}
499 jpm 296
				if ($cle == 'sous_type.principal' || $cle == 'sous_type.secondaire' || $cle == 'sous_type.special') {
297
					$i = 0;
298
					foreach ($tb as $sstypes) {
452 mathilde 299
						$url = $this->ajouterHref('ontologies','ssTT:'.urlencode(urlencode($sstypes)));
300
						$val = $this->consulterHref($url);
301
						$libelle[$cle]=$val->nom;
302
						$detail[$cle][$i]['libelle'] = $val->nom;
303
						$detail[$cle][$i]['code'] = $val->code;
499 jpm 304
						$detail[$cle][$i]['href'] = $url;
452 mathilde 305
						$i++;
306
					}
307
				}
308
			}
499 jpm 309
			$resultat_typeBio['type_bio.libelle']= $this->formaterTypeBioPrLibelle($libelle);
310
			$resultat_typeBio['type_bio.detail'] = $detail;
452 mathilde 311
		}
312
		return $resultat_typeBio;
313
	}
499 jpm 314
 
315
	public function formaterTypeBioPrLibelle($info) {
452 mathilde 316
		$libelle = $info['type.principal']." ";
317
		$libelle .= isset($info['sous_type.principal']) ? " (".$info['sous_type.principal'].") " : "";
318
		$libelle .= isset($info['type.secondaire']) ? ", ".$info['type.secondaire']." " : "";
319
		$libelle .= isset($info['sous_type.secondaire']) ? "(".$info['sous_type.secondaire'].") " : "";
320
		$libelle .= isset($info['sous_type.special']) ? "(".$info['sous_type.special'].") " : "";
321
		return $libelle;
322
	}
323
 
499 jpm 324
	public function separerTypesPrimairesSecondaires($type) {
325
		$types = array();
452 mathilde 326
		//séparation des principaux et des secondaires
499 jpm 327
		if (preg_match("/(.+)\((.+)\)\-{0,1}(.+){0,1}/", $type,$retour) == 1) {
328
			$types['principal'] = $retour[1];
452 mathilde 329
			$types['secondaire'] = $retour[2];
330
			if (isset($retour[3])){$types['special'] = $retour[3];}
499 jpm 331
		} else {
452 mathilde 332
			$types['principal'] = $type;
333
		}
334
		return $types;
335
	}
499 jpm 336
 
337
	public function separerTypes_SousTypes($type_a_traiter, $typePrimOuSec) {
452 mathilde 338
		$types = array();
499 jpm 339
		if (preg_match("/^([a-zA-Zé]+)\-(.+)$|^([a-zA-Zé]+[^\-])$/", $type_a_traiter, $retour) == 1) {
452 mathilde 340
    		//recupère le type unique
499 jpm 341
 
452 mathilde 342
			$type = (isset($retour[3]) && ($typePrimOuSec != 'special') ) ? $retour[3] : $retour[1] ;
343
			$types['type.'.$typePrimOuSec]= $type;
344
    		//recupère le ou les sous-types
499 jpm 345
    		if (isset($retour[3]) && $typePrimOuSec == 'special') {
452 mathilde 346
    			$ss_types[0] = (isset($retour[3]) && ($typePrimOuSec == 'special') ) ? $retour[3] : "" ;
499 jpm 347
    		} elseif (isset($retour[2]) && $retour[2] != '') {
452 mathilde 348
    			$ss_types[0]= (isset($retour[2]) && ($retour[2] != "") ) ? $retour[2] : "" ;
349
    		}
499 jpm 350
     		if (isset($ss_types[0])) {
351
    			if (preg_match("/\-/", $ss_types[0]) == 1) {
452 mathilde 352
    				$ss_types = preg_split("/\-/", $ss_types[0]);
353
    			}
499 jpm 354
				for ($i = 0 ; $i < count($ss_types); $i++) {
452 mathilde 355
    				$types['sous_type.'.$typePrimOuSec][$i] = $ss_types[$i];
499 jpm 356
        		}
452 mathilde 357
    		}
358
    	}
359
 		return $types;
360
	}
499 jpm 361
 
452 mathilde 362
//+--------------------------FONCTIONS D'ASSEMBLAGE DE LA REQUETE-------------------------------------------+
499 jpm 363
 
452 mathilde 364
	public function assemblerLaRequete() {
365
		$requete = 	' SELECT '.$this->champs_recherches.' FROM '.$this->table.' '
499 jpm 366
			.$this->retournerRequeteCondition().' '
367
			.$this->delimiterResultatsRequete();
452 mathilde 368
		return $requete;
369
	}
370
 
371
	public  function retournerRequeteCondition() {
372
		$condition = '';
373
		if ($this->requete_condition !== "") {
374
			$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
375
		}
376
		return $condition;
377
	}
378
 
379
	public function calculerTotalResultat() {
380
		//on récupère le nombre total de résultats de la requete
499 jpm 381
		$requete = 'SELECT count(*) as nombre FROM '.$this->table.' '.$this->retournerRequeteCondition();
452 mathilde 382
		$res = $this->getBdd()->recuperer($requete);
383
		if ($res) {
384
			$this->total_resultat = $res['nombre'];
385
		} else {
386
			$this->total_resultat = 0;
387
			$e = 'Données introuvables dans la base';
388
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
389
		}
390
	}
499 jpm 391
 
452 mathilde 392
	public function delimiterResultatsRequete() {
393
		$this->calculerTotalResultat();
483 mathilde 394
		$this->requete_limite = '';
499 jpm 395
		if ((count($this->ressources)) == 0) {
396
			if (($this->limite_requete['depart'] <  $this->total_resultat) &&
481 mathilde 397
				(($this->limite_requete['limite'] + $this->limite_requete['depart'] )
499 jpm 398
				 < $this->total_resultat  )) {
452 mathilde 399
					$this->requete_limite = 'LIMIT '.$this->limite_requete['depart'].', '
400
					.$this->limite_requete['limite'];
499 jpm 401
			}
452 mathilde 402
		}
403
		return $this->requete_limite;
404
	}
405
}
406
?>