Subversion Repositories eFlore/Projets.eflore-projets

Rev

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

Rev Author Line No. Line
379 mathilde 1 
<?php
2 
 
3 
/**
548 mathilde 4 
* Classe Informations.php interroge la table Index
5 
* et redirige vers une autre classe si besoin
6 
* d'interroger une autre table (comme baseflor ou baseflor_rang_sup)
7 
* elle traite également le retour du web service : /informations
447 mathilde 8 
*
379 mathilde 9 
* Encodage en entrée : utf8
10 
* Encodage en sortie : utf8
11 
* @package eflore-projets
12 
* @author Mathilde SALTHUN-LASSALLE <mathilde@tela-botanica.org>
13 
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
14 
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
15 
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
16 
* @version 1.0
548 mathilde 17 
* @copyright 1999-2012 Tela Botanica (accueil@tela-botanica.org)
525 mathilde 18 
*
529 mathilde 19 
*
379 mathilde 20 
*/
21 
 
529 mathilde 22 
 
548 mathilde 23 
 
525 mathilde 24 
class Informations extends Commun {
379 mathilde 25 
 
525 mathilde 26 
	protected $limite_requete = array( 'depart' => 0, 'limite' => 10);
27 
	private $table = "";
28 
	private $champs_recherches = '*';
548 mathilde 29 
	private $requete_jointure = "";
525 mathilde 30 
	private $requete_condition = "";
548 mathilde 31 
	private $total_resultat;
525 mathilde 32 
	protected $serviceNom = 'informations';
395 mathilde 33 
 
447 mathilde 34 
	public function consulter($ressources, $parametres) {
525 mathilde 35 
			$this->ressources = $ressources;
36 
			$this->parametres =  $parametres;
517 mathilde 37 
			$versionResultat = null;
525 mathilde 38 
			if (empty($this->ressources)){
39 
				$this->traiterParametres();
379 mathilde 40 
			}
525 mathilde 41 
			$this->traiterRessources();
548 mathilde 42 
			$requete = $this->assemblerLaRequete();
525 mathilde 43 
			$resultat = $this->Bdd->recupererTous($requete);
548 mathilde 44 
			$versionResultat = $this->renvoyerResultat($resultat);
517 mathilde 45 
			if ($versionResultat == null) {
46 
				$message = 'Les données recherchées sont introuvables.';
47 
				$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
48 
				throw new Exception($message, $code);
49 
			}
447 mathilde 50 
		return $versionResultat;
379 mathilde 51 
	}
548 mathilde 52 
 
525 mathilde 53 
	public function __construct() {
548 mathilde 54 
		$Conteneur = new Conteneur();
55 
		$this->Bdd = $Conteneur ->getBdd();
56 
		$prefixe_table = array ('index' => config::get('bdd_table_index'),
57 
								'baseflor' => config::get('bdd_table'),
58 
								'rangSup' => config::get('bdd_table_rang_sup'));
59 
		$this->tables = $this->definirTables($prefixe_table);
60 
		$this->table = $this->tables['index'];
525 mathilde 61 
	}
379 mathilde 62 
 
548 mathilde 63 
	public function renvoyerResultat($resultat) {
525 mathilde 64 
	$res_formate = array();
65 
	if (empty($this->ressources)) {
66 
		$res_formate = $this->retournerResultatFormate($resultat);
67 
	} else {
68 
		$classe = empty($resultat[0]['baseflor']) ? 'InformationsTaxonsSup' : 'InformationsBaseflor';
69 
		$info = new $classe(new Conteneur());
70 
		$res_formate = $info->consulter($this->ressources, $this->parametres);
71 
	}
72 
	return $res_formate;
73 
	}
517 mathilde 74 
 
75 
 
525 mathilde 76 
 
77 
	//+--------------------------traitement ressources ou paramètres  -------------------------------------+
78 
 
548 mathilde 79 
 
525 mathilde 80 
	public function traiterRessources() {
548 mathilde 81 
		if (empty($this->ressources)) {
82 
 
83 
			$this->requete_jointure = array(
84 
				'LEFT JOIN '. $this->tables['baseflor'].' ON '
85 
				.$this->tables['baseflor'].".cle =".$this->table.".baseflor",
86 
				'LEFT JOIN '. $this->tables['rangSup'].' ON '
87 
				.$this->tables['rangSup'].".cle = ".$this->table.".RangSup");
88 
 
89 
			$this->champs_recherches = " {$this->tables['baseflor']}.num_nomen as 'baseflor.nn',
90 
						{$this->tables['baseflor']}.BDNT as 'baseflor.bdnt',
91 
						{$this->tables['baseflor']}.catminat_code,
92 
						{$this->tables['baseflor']}.num_taxon ,
93 
						{$this->tables['rangSup']}.num_nomen as 'rangSup.nn',
94 
						{$this->tables['rangSup']}.bdnt as 'rangSup.bdnt',
95 
						{$this->table}.cle as 'index.cle' ";
525 mathilde 96 
		} else {
97 
			if(preg_match('/^(.+)\.nn:([0-9]+)$/', $this->ressources[0], $retour)){
548 mathilde 98 
				$this->champs_recherches = " baseflor, rangSup ";
99 
				$this->requete_condition[] = " `bdnt.nn` = '{$retour[0]}'  ";
525 mathilde 100 
			} else {
101 
				$e = 'Erreur dans l\'url de votre requête : </br> La ressource demandée n\'existe pas.';
102 
				throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
103 
				break;
104 
			}
105 
		}
106 
	}
107 
 
548 mathilde 108 
 
109 
 
525 mathilde 110 
	public function traiterParametres() {
111 
		if (isset($this->parametres) && !empty($this->parametres) ) {
112 
			foreach ($this->parametres as $param => $valeur) {
113 
				switch ($param) {
114 
					case 'navigation.depart'  :
548 mathilde 115 
						$this->definirNavigationDepart($valeur);
116 
						break;
525 mathilde 117 
					case 'navigation.limite'  :
548 mathilde 118 
						$this->definirNavigationLimite($valeur);
119 
						break;
525 mathilde 120 
					case 'version.projet' :
121 
						$this->traiterVersion($valeur);
122 
						break;
123 
					default :
124 
						$e = 'Erreur dans les parametres de votre requête : </br> Le paramètre " '
125 
					.$param.' " n\'existe pas.';
126 
					$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);	break;
127 
				}
128 
			}
129 
		}
130 
	}
131 
 
548 mathilde 132 
	public function definirNavigationLimite($valeur){
133 
		if (isset($this->parametres['navigation.depart'])) {
134 
			if(preg_match('/^([0-9]+)$/', $valeur) && $valeur != 0){
135 
					$this->limite_requete['limite'] = $valeur;
136 
			} else {
137 
					$e = "Erreur : valeur erronnée pour le paramètre navigation.limite.";
138 
					throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
139 
			}
140 
		} else {
141 
				$e = "indiquez également la valeur pour le paramètre navigation.depart.";
142 
				throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
143 
		}
144 
	}
145 
 
146 
	public function definirNavigationDepart($valeur){
147 
		if (isset($this->parametres['navigation.limite'])) {
148 
			if(preg_match('/^([0-9]+)$/', $valeur)){
149 
				$this->limite_requete['depart'] = $valeur;
150 
			} else {
151 
					$e = "Erreur : valeur erronnée pour le paramètre navigation.depart.";
152 
					throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
153 
					}
154 
		} else {
155 
				$e = "indiquez également la valeur pour le paramètre navigation.limite.";
156 
				throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
157 
		}
158 
	}
159 
 
525 mathilde 160 
	//+++------------------------------traitement des versions----------------------------------------++
161 
 
162 
	public function traiterVersion($valeur) {
163 
		if (preg_match('/^[0-9]+(?:[._][0-9]+)*$/', $valeur) || $valeur == '*' || $valeur == '+') {
164 
			$this->version_projet = $valeur;
165 
		} else {
166 
			$e = "Erreur : La version est inconnue.";
167 
			throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
168 
		}
169 
		if ($this->version_projet == '*' && empty($this->ressources)) {
170 
			$message = "L'affichage de plusieurs versions ne fonctionne que pour les ressources de type /ressources/#id";
171 
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
172 
			throw new Exception($message, $code);
173 
		}
174 
	}
175 
 
176 
	public function DefinirTables($prefixe_table) {
177 
		$table_num_version = $this->recupererVersionDisponible();
178 
		foreach ($prefixe_table as $nom => $prefixe ) {
179 
			if ( in_array($this->version_projet,$table_num_version) ) {
180 
				$tables[$nom] = $prefixe.'_v'.$this->version_projet;
181 
			} elseif ($this->version_projet == '+') {
182 
				$derniere_version = $table_num_version[count($table_num_version) - 1];
183 
				$tables[$nom] = $prefixe.'_v'.str_replace('.', '_', $derniere_version);
184 
			} else {
185 
				$e = "Erreur : La version est inconnue.";
186 
				throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
187 
			}
188 
		}
189 
		return $tables;
190 
	}
191 
 
192 
 
193 
	//+--------------------------formatages de resultats  -------------------------------------------+
194 
 
195 
	public function retournerResultatFormate($resultat) {
196 
		$resultat_json = array();
197 
		$resultat_json['entete'] = $this->ajouterEnteteResultat();
198 
		foreach ($resultat as $ligne => $tab) {
199 
			$num = $tab['index.cle'];
548 mathilde 200 
 
525 mathilde 201 
			$resultat_json['resultats'][$num]['num_nomen'] =
202 
				(empty ($tab['baseflor.nn'])) ? $tab['rangSup.nn'] : $tab['baseflor.nn'];
548 mathilde 203 
 
525 mathilde 204 
			$resultat_json['resultats'][$num]['bdnt'] =
548 mathilde 205 
				(empty ($tab['baseflor.bdnt'])) ? $tab['rangSup.bdnt'] : $tab['baseflor.bdnt'];
206 
 
525 mathilde 207 
			$resultat_json['resultats'][$num]['catminat_code'] =
548 mathilde 208 
				(empty ($tab['catminat_code'])) ? '' : $tab['catminat_code'];
209 
 
525 mathilde 210 
			$resultat_json['resultats'][$num]['num_taxon'] =
548 mathilde 211 
				(empty ($tab['num_taxon'])) ? '' : $tab['num_taxon'];
525 mathilde 212 
 
548 mathilde 213 
			if ($resultat_json['resultats'][$num]['num_nomen'] != 0) {
214 
				$bdnt = strtolower($resultat_json['resultats'][$num]['bdnt']);
215 
				$nn = $resultat_json['resultats'][$num]['num_nomen'];
216 
				$resultat_json['resultats'][$num]['href'] =
217 
				$this->ajouterHref('informations',$bdnt.".nn:".$nn);
525 mathilde 218 
				}
219 
		}
220 
		return $resultat_json;
221 
	}
222 
 
223 
 
224 
	public function ajouterEnteteResultat() {
548 mathilde 225 
		$entete['depart'] = $this->limite_requete['depart'];
226 
		$entete['limite'] = $this->limite_requete['limite'];
227 
		$entete['total']  =  $this->total_resultat;
525 mathilde 228 
		$entete['version']  = $this->version_projet;
548 mathilde 229 
		$url = $this->formulerUrl($this->total_resultat, '/informations');
525 mathilde 230 
		if (isset($url['precedent']) && $url['precedent'] != '') {
231 
			$entete['href.precedent'] = $url['precedent'];
232 
		}
233 
		if (isset($url['suivant']) && $url['suivant'] != '') {
234 
			$entete['href.suivant']   = $url['suivant'];
235 
		}
236 
		return $entete;
237 
	}
238 
 
548 mathilde 239 
 
240 
	//+-------------------------------------assemblage de requête------------------------------------//
241 
 
242 
 
243 
	public function assemblerLaRequete() {
244 
		$requete = 	' SELECT '.$this->champs_recherches.' FROM '.$this->table.' '
245 
		.$this->retournerRequeteJointure().' '.$this->retournerRequeteCondition().
246 
		' '.$this->delimiterResultatsRequete();
247 
		return $requete;
248 
	}
249 
 
250 
	public function retournerRequeteCondition() {
251 
		$condition = '';
252 
		if ($this->requete_condition !== "") {
253 
			$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
254 
		}
255 
		return $condition;
256 
	}
257 
 
258 
 
259 
	public function calculerTotalResultat() {
260 
		$requete = 'SELECT count(*) as nombre FROM '.$this->table;
261 
		$res = $this->getBdd()->recuperer($requete);
262 
		if ($res) {
263 
			$this->total_resultat = $res['nombre'];
264 
		} else {
265 
			$this->total_resultat = 0;
266 
			$e = 'Données introuvables dans la base';
267 
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
268 
		}
269 
	}
270 
 
271 
	public function delimiterResultatsRequete() {
272 
		$this->calculerTotalResultat();
273 
		$requete_limite = '';
274 
			if (($this->limite_requete['depart'] <=  $this->total_resultat) ){
275 
				if (($this->limite_requete['limite'] + $this->limite_requete['depart'] )
276 
				< $this->total_resultat  ){
277 
					$requete_limite = 'LIMIT '.$this->limite_requete['depart'].', '
278 
					.$this->limite_requete['limite'];
279 
				}
280 
			} else {
281 
				$e = "Erreur : la valeur pour le paramètre navigation.départ est supérieure".
282 
					" au nombre total de résultats.";
283 
				throw new Exception($e, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
284 
			}
285 
		return $requete_limite;
286 
	}
287 
 
288 
	public  function retournerRequeteJointure() {
289 
		$jointure = '';
290 
		if ($this->requete_jointure !== "") {
291 
			$jointure = implode(' ', $this->requete_jointure);
292 
		}
293 
		return $jointure;
294 
	}
295 
 
379 mathilde 296 
}