Rev 788 | Blame | Last modification | View Log | RSS feed
<?php
/**
* Classe Informations.php interroge la table Index
* et redirige vers une autre classe si besoin
* d'interroger une autre table (comme baseflor ou baseflor_rang_sup)
* elle traite également le retour du web service : /informations
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package eflore-projets
* @author Mathilde SALTHUN-LASSALLE <mathilde@tela-botanica.org>
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
* @version 1.0
* @copyright 1999-2012 Tela Botanica (accueil@tela-botanica.org)
*
*
*/
class Informations extends Commun {
protected $limite_requete = array( 'depart' => 0, 'limite' => 10);
private $tables;
private $champs_recherches = '*';
private $requete_jointure = "";
private $requete_condition = "";
private $total_resultat;
protected $serviceNom = 'informations';
private $masque;
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
$versionResultat = null;
if (empty($this->ressources)){
$this->traiterParametres();
}
$this->definirTables(array ('index' => config::get('bdd_table_index'),
'baseflor' => config::get('bdd_table'),
'rangSup' => config::get('bdd_table_rang_sup')
)
);
$this->traiterRessources();
$requete = $this->assemblerLaRequete();
// exemple:
// SELECT * FROM baseflor_index_v2012_12_31 WHERE `bdnt.nn` = 'bdtfx.nn:XXXXX';
$resultat = $this->Bdd->recupererTous($requete . ' -- ' . __FILE__ . ':' .__LINE__);
$versionResultat = $this->renvoyerResultat($resultat);
if ($versionResultat == null) {
$message = 'Les données recherchées sont introuvables.';
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
return $versionResultat;
}
public function __construct() {
$Conteneur = new Conteneur();
$this->Bdd = $Conteneur ->getBdd();
}
public function renvoyerResultat($resultat) {
$res_formate = array();
if (empty($this->ressources)) {
$res_formate = $this->retournerResultatFormate($resultat);
} else {
$classe = empty($resultat[0]['baseflor']) ? 'InformationsTaxonsSup' : 'InformationsBaseflor';
$info = new $classe(new Conteneur());
$res_formate = $info->consulter($this->ressources, $this->parametres);
}
return $res_formate;
}
//+--------------------------traitement ressources ou paramètres -------------------------------------+
public function traiterRessources() {
if (empty($this->ressources)) {
$this->requete_jointure = array(
'LEFT JOIN '. $this->tables['baseflor'].' ON '
.$this->tables['baseflor'].".cle =".$this->tables['index'].".baseflor",
'LEFT JOIN '. $this->tables['rangSup'].' ON '
.$this->tables['rangSup'].".cle = ".$this->tables['index'].".RangSup");
$this->champs_recherches = " {$this->tables['baseflor']}.num_nomen as 'baseflor.nn',
{$this->tables['baseflor']}.BDNT as 'baseflor.bdnt',
{$this->tables['baseflor']}.catminat_code,
{$this->tables['baseflor']}.num_taxon ,
{$this->tables['baseflor']}.idiotaxon ,
{$this->tables['rangSup']}.num_nomen as 'rangSup.nn',
{$this->tables['rangSup']}.bdnt as 'rangSup.bdnt',
{$this->tables['index']}.cle as 'index.cle' ";
} else {
if(preg_match('/^(.+)\.nn:([0-9]+)$/', $this->ressources[0], $retour)){
$this->champs_recherches = " baseflor, rangSup ";
$this->requete_condition[] = " `bdnt.nn` = '{$retour[0]}' ";
} else {
$e = 'Erreur dans l\'url de votre requête : </br> La ressource demandée n\'existe pas.';
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
break;
}
}
}
public function traiterParametres() {
if (isset($this->parametres) && !empty($this->parametres) ) {
foreach ($this->parametres as $param => $valeur) {
switch ($param) {
case 'navigation.depart' :
if(!isset($this->parametres['navigation.limite']))
throw new Exception("indiquez également la valeur pour le paramètre navigation.limite.",
RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
$this->definirNavigationDepart($valeur);
break;
case 'navigation.limite' :
if(!isset($this->parametres['navigation.depart']))
throw new Exception("indiquez également la valeur pour le paramètre navigation.depart.",
RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
$this->definirNavigationLimite($valeur);
break;
case 'version.projet' :
$this->traiterVersion($valeur);
break;
case 'masque.cat' :
$this->masque = 'catminat='.str_replace('-','/',$valeur);
$this->requete_condition[] = " catminat_code = '".str_replace('-','/',$valeur)."' ";
break;
default :
$e = 'Erreur dans les parametres de votre requête : </br> Le paramètre " '
.$param.' " n\'existe pas.';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e); break;
}
}
}
}
//+++------------------------------traitement des versions----------------------------------------++
public function traiterVersion($valeur) {
if (preg_match('/^[0-9]+(?:[._][0-9]+)*$/', $valeur) || $valeur == '*' || $valeur == '+') {
$this->version_projet = $valeur;
} else {
$e = "Erreur : La version est inconnue.";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
if ($this->version_projet == '*' && empty($this->ressources)) {
$message = "L'affichage de plusieurs versions ne fonctionne que pour les ressources de type /ressources/#id";
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($message, $code);
}
}
public function definirTables($prefixe_table) {
$table_num_version = $this->recupererVersionDisponible();
foreach ($prefixe_table as $nom => $prefixe ) {
if ( in_array($this->version_projet,$table_num_version) ) {
$tables[$nom] = $prefixe.'_v'.$this->version_projet;
} elseif ($this->version_projet == '+') {
$derniere_version = $table_num_version[count($table_num_version) - 1];
$tables[$nom] = $prefixe.'_v'.str_replace('.', '_', $derniere_version);
} else {
$e = "Erreur : La version est inconnue.";
throw new Exception($e, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
$this->tables = $tables;
}
//+--------------------------formatages de resultats -------------------------------------------+
public function retournerResultatFormate($resultat) {
$resultat_json = array();
$resultat_json['entete'] = $this->ajouterEnteteResultat();
$resultat_json['resultats'] = array();
foreach ($resultat as $ligne => $tab) {
$num = $tab['index.cle'];
$resultat_json['resultats'][$num]['num_nomen'] =
(empty ($tab['baseflor.nn'])) ? $tab['rangSup.nn'] : $tab['baseflor.nn'];
$resultat_json['resultats'][$num]['bdnt'] =
(empty ($tab['baseflor.bdnt'])) ? $tab['rangSup.bdnt'] : $tab['baseflor.bdnt'];
$resultat_json['resultats'][$num]['catminat_code'] =
(empty ($tab['catminat_code'])) ? '' : $tab['catminat_code'];
$resultat_json['resultats'][$num]['idiotaxon'] =
(empty ($tab['idiotaxon'])) ? '' : $tab['idiotaxon'];
$resultat_json['resultats'][$num]['num_taxon'] =
(empty ($tab['num_taxon'])) ? '' : $tab['num_taxon'];
if ($resultat_json['resultats'][$num]['num_nomen'] != 0) {
$bdnt = strtolower($resultat_json['resultats'][$num]['bdnt']);
$nn = $resultat_json['resultats'][$num]['num_nomen'];
$resultat_json['resultats'][$num]['href'] =
$this->ajouterHref('informations',$bdnt.".nn:".$nn);
}
}
return $resultat_json;
}
public function ajouterEnteteResultat() {
$entete['depart'] = $this->limite_requete['depart'];
$entete['limite'] = $this->limite_requete['limite'];
$entete['total'] = $this->total_resultat;
if ($this->masque) {
$entete['masque'] = $this->masque;
}
$entete['version'] = $this->version_projet;
$url = $this->formulerUrl($this->total_resultat, '/informations');
if (isset($url['precedent']) && $url['precedent'] != '') {
$entete['href.precedent'] = $url['precedent'];
}
if (isset($url['suivant']) && $url['suivant'] != '') {
$entete['href.suivant'] = $url['suivant'];
}
return $entete;
}
//+-------------------------------------assemblage de requête------------------------------------//
public function assemblerLaRequete() {
$requete = ' SELECT '.$this->champs_recherches.' FROM '.$this->tables['index'].' '
.$this->retournerRequeteJointure().' '.$this->retournerRequeteCondition().
' '.$this->delimiterResultatsRequete();
return $requete;
}
public function retournerRequeteCondition() {
$condition = '';
if ($this->requete_condition !== "") {
$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
}
return $condition;
}
public function calculerTotalResultat() {
$requete = 'SELECT count(*) as nombre FROM '.$this->tables['index'].' '
.$this->retournerRequeteJointure().' '.$this->retournerRequeteCondition();
$res = $this->getBdd()->recuperer($requete);
if ($res) {
$this->total_resultat = $res['nombre'];
} else {
$this->total_resultat = 0;
$e = 'Données introuvables dans la base';
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
}
}
public function delimiterResultatsRequete() {
$this->calculerTotalResultat();
$requete_limite = '';
if (($this->limite_requete['depart'] <= $this->total_resultat) ){
if ( $this->limite_requete['depart'] < $this->total_resultat ){
$requete_limite = 'LIMIT '.$this->limite_requete['depart'].', '
.$this->limite_requete['limite'];
}
} else {
$e = "Erreur : la valeur pour le paramètre navigation.départ est supérieure".
" au nombre total de résultats.";
throw new Exception($e, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
}
return $requete_limite;
}
public function retournerRequeteJointure() {
$jointure = '';
if ($this->requete_jointure !== "") {
$jointure = implode(' ', $this->requete_jointure);
}
return $jointure;
}
}