Rev 452 | Rev 481 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed
<?php
/**
* Classe InformationsBaseflor.php permet de faire des requetes de baseflor en fonction d'un référentiel
*( BDTFX, BDAFX, BDBFX ) et d'un numéro nomenclatural ( différent de 0 ).
* fin d'url possibles :
* /informations/#bdnt.nn:#num_nomen --> retourne tous les champs pour un BDNT et un num_nomen
* /informations/#bdnt.nn:#num_nomen?champs=description --> retourne champs description pour un BDNT et un num_nomen
* /informations/#bdnt.nn:#num_nomen?champs=ecologie --> retourne champs ecologiques pour un BDNT et un num_nomen
* /informations --> retourne les 10 premiers résultats
* /informations?navigation.limite=..&navigation.depart=.. --> retourne les 10 premiers résultats avec limites
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package eflore-projets
* @author Mathilde SALTHUN-LASSALLE <mathilde@tela-botanica.org>
* @author Delphine CAUQUIL <delphine@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-2011 Tela Botanica (accueil@tela-botanica.org)
*/
class InformationsBaseflor extends Commun{
protected $table = "";
private $requete_condition = "";
private $format_reponse = 'informations';
private $total_resultat;
private $retour_format = 'max';
protected $limite_requete = array( 'depart' => 0, 'limite' => 10);
private $champs_recherches = '*';
private $champs_ontologiques = array();
protected $serviceNom = 'informations';
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
$this->traiterParametres();
$this->traiterVersionProjet();
$resultats = null;
foreach ($this->table_version as $version) {
$this->table = $version;
$this->recupererNomChamp($this->table);
$this->traiterRessources();
$requete = $this->assemblerLaRequete();
$resultat = $this->getBdd()->recupererTous($requete);
$versionResultat = $this->traiterResultat($resultat, $version, $requete);
if (count($this->table_version) > 1) {
$resultats[$version] = $versionResultat;
} else {
$resultats = $versionResultat;
}
}
return $resultats;
}
public function traiterResultat($resultat, $version, $requete) {
$versionResultat = null;
if ($resultat == '') {
$message = 'La requête SQL formée comporte une erreur!';
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
} elseif ($resultat) {
$versionResultat = $this->retournerResultatFormate($resultat, $version);
}
return $versionResultat;
}
//+--------------------------traitement ressources ou paramètres -------------------------------------------+
public function traiterParametres() {
if (isset($this->parametres) && !empty($this->parametres)) {
foreach ($this->parametres as $param => $valeur) {
switch ($param) {
case 'navigation.depart' :
$this->limite_requete['depart'] = $valeur; break;
case 'navigation.limite' : $this->limite_requete['limite'] = $valeur; break;
case 'champs' :
if ($valeur == "description") {
$this->champs_recherches = "num_nomen, BDNT, chorologie, inflorescence,"
." sexualite, ordre_maturation, "
."pollinisation, fruit, dissemination, couleur_fleur, macule, floraison, type_bio, "
."form_vegetale ";
$this->requete_condition[] = "( chorologie != '' OR inflorescence != '' ".
"OR sexualite != '' OR ordre_maturation != '' OR pollinisation != '' ".
"OR fruit != '' OR dissemination != '' OR couleur_fleur != '' OR macule != '' ".
"OR floraison != '' OR type_bio != '' OR form_vegetale != '' )";
}elseif ($valeur == "ecologie"){
$this->champs_recherches = " num_nomen, BDNT, ve_lumiere , ve_temperature,"
." ve_continentalite, ve_humidite_atmos, ve_humidite_edaph, ve_reaction_sol,"
." ve_nutriments_sol, ve_salinite, ve_texture_sol, ve_mat_org_sol ";
$this->requete_condition[] = "( ve_lumiere != '' OR ve_temperature != '' ".
"OR ve_continentalite != '' OR ve_humidite_atmos != '' ".
"OR ve_humidite_edaph != '' OR ve_reaction_sol != '' ".
"OR ve_nutriments_sol != '' OR ve_salinite != '' ".
"OR ve_texture_sol != '' OR ve_mat_org_sol != '' )";
}else {
$e = 'Valeur de paramètre inconnue pour \'test\'. ';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
}
break;
case 'retour.format' :
$this->retour_format = $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;
}
}
}
}
public function traiterRessources() {
if (isset($this->ressources) && !empty($this->ressources[0])) {
if(preg_match('/^(.+)\.nn:([0-9]+)$/', $this->ressources[0], $retour)==1){
switch ($retour[1]) {
case 'bdtfx' :
$this->requete_condition[] = "num_nomen = ".$retour[2]." AND BDNT = 'BDTFX' ";
break;
case 'bdafx' :
$this->requete_condition[] = "num_nomen = ".$retour[2]." AND BDNT = 'BDAFX' ";
break;
case 'bdbfx' :
$this->requete_condition[] = "num_nomen = ".$retour[2]." AND BDNT = 'BDBFX' ";
break;
default :
$e = 'Erreur dans l\'url de votre requête : </br> La ressource " '
.$retour[1].' " n\'existe pas.';
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
break;
}
}
} else {
$this->champs_recherches=" cle, catminat_code, BDNT, num_taxon, num_nomen ";
}
}
//+--------------------------formatages de resultats -------------------------------------------+
public function retournerResultatFormate($resultat) {
if ((count($this->ressources)) == 0) {
$table_retour_json['resultat'] = $this->formaterResultatsInformations($resultat);
} else {
$table_retour_json = $this->formaterResultatsInformationsBDNTnn($resultat);
}
return $table_retour_json;
}
public function formaterResultatsInformationsBDNTnn($resultat){
$resultat_json = $resultat[0];
if ($this->retour_format == 'max'){
if (!isset($this->parametres['champs']) ) {
$resultat_json = $this->formaterResultatsTousChamps($resultat_json);
} elseif ($this->parametres['champs'] == 'ecologie') {
$resultat_json = $this->formaterResultatsChampsEcologie($resultat_json);
} elseif ($this->parametres['champs'] == 'description') {
$resultat_json = $this->formaterResultatsChampsDescription($resultat_json);
}
}
return $resultat_json;
}
public function formaterResultatsTousChamps($resultat) {
$resultat_json = $resultat;
if ($resultat_json['type_bio'] != ""){
$tab_ontologie = $this->recupererOntologiePrTypeBio($resultat_json['type_bio']);
unset($resultat_json['type_bio']);
$resultat_json= array_merge($resultat_json,$tab_ontologie);
}
$this->champs_ontologiques = $this->recupererTableauConfig('champs_ontologiques');
foreach ($this->champs_ontologiques as $cle => $valeur){
if ($resultat_json[$cle] != ""){
$tab_ontologie = $this->recupererOntologies($resultat_json[$cle], $cle);
unset($resultat_json[$cle]);
$resultat_json = array_merge($resultat_json,$tab_ontologie);
}
}
$resultat_json['graphique_climat']['libelle'] = 'climat';
$resultat_json['graphique_climat']['href'] = $this->ajouterHref('graphiques/climat', strtolower($resultat_json['BDNT']).'.nn:'.$resultat_json['num_nomen']);
$resultat_json['graphique_sol']['libelle'] = 'sol';
$resultat_json['graphique_sol']['href'] = $this->ajouterHref('graphiques/sol', strtolower($resultat_json['BDNT']).'.nn:'.$resultat_json['num_nomen']);
return $resultat_json ;
}
public function formaterResultatsChampsEcologie($resultat) {
$resultat_json = $resultat;
$this->champs_ontologiques = $this->recupererTableauConfig('champs_ontologiques');
foreach ($this->champs_ontologiques as $cle => $valeur){
if ($resultat_json[$cle] != ""){
$tab_ontologie = $this->recupererOntologies($resultat_json[$cle], $cle);
unset($resultat_json[$cle]);
$resultat_json= array_merge($resultat_json,$tab_ontologie);
}
}
$resultat_json['graphique_climat']['libelle'] = 'climat';
$resultat_json['graphique_climat']['href'] = $this->ajouterHref('graphiques/climat', strtolower($resultat_json['BDNT']).'.nn:'.$resultat_json['num_nomen']);
$resultat_json['graphique_sol']['libelle'] = 'sol';
$resultat_json['graphique_sol']['href'] = $this->ajouterHref('graphiques/sol', strtolower($resultat_json['BDNT']).'.nn:'.$resultat_json['num_nomen']);
return $resultat_json ;
}
public function formaterResultatsChampsDescription($resultat) {
$resultat_json = $resultat;
if ($resultat_json['type_bio'] != ""){
$tab_ontologie = $this->recupererOntologiePrTypeBio($resultat_json['type_bio']);
unset($resultat_json['type_bio']);
$resultat_json = array_merge($resultat_json,$tab_ontologie);
}
return $resultat_json ;
}
public function formaterResultatsInformations($resultat) {
$resultat_json = array();
$resultat_json['entete'] = $this->ajouterEnteteResultat();
foreach ($resultat as $tab) {
if ($tab['BDNT'] != 'nc'){
$num = $tab['cle'];
unset($tab['cle']);
foreach ($tab as $param => $valeur) {
$resultat_json[$num][$param] = $valeur;
}
$resultat_json[$num]['href'] = $this->ajouterHref('informations',strtolower($tab['BDNT']).".nn:".$tab['num_nomen']);
}
}
return $resultat_json;
}
public function ajouterEnteteResultat() {
$entete['depart'] = $this->limite_requete['depart'];
$entete['limite'] = $this->limite_requete['limite'];
$entete['total'] = $this->total_resultat;
$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;
}
//+--------------------------traitement ontologies -------------------------------------------+
public function recupererOntologies($valeur, $champs){
$url = $this->ajouterHref('ontologies',$this->champs_ontologiques[$champs].':'.urlencode(urlencode($valeur)));
$val = $this->consulterHref($url);
$resultat_json[$champs.'.libelle'] = $val->nom;
$resultat_json[$champs.'.code'] = $valeur;
$resultat_json[$champs.'.href'] = $url;
return $resultat_json;
}
public function recupererOntologiePrTypeBio($type_a_traiter){
$resultat_typeBio = "";
if ($type_a_traiter != ""){
$resultat_typeBio['type_bio.code'] = $type_a_traiter;
$types_prim_sec = $this->separerTypesPrimairesSecondaires($type_a_traiter);
foreach ($types_prim_sec as $cle => $tb){
$types_sstypes[$cle]= $this->separerTypes_SousTypes($tb, $cle);
}
switch (count($types_sstypes)){
case 1 :
$types_sstypes = $types_sstypes['principal'];
break;
case 2 :
$types_sstypes = array_merge($types_sstypes['principal'],$types_sstypes['secondaire']);
break;
case 3 :
$types_sstypes = array_merge($types_sstypes['principal'],
$types_sstypes['secondaire'],
$types_sstypes['special']);
break;
default :
break;
}
foreach ($types_sstypes as $cle => $tb){
if (($cle == 'type.principal') || ($cle == 'type.secondaire')){
$url = $this->ajouterHref('ontologies','TB:'.urlencode(urlencode($tb)));
$val = $this->consulterHref($url);
$libelle[$cle]= $val->nom;
$detail[$cle]['libelle'] = $val->nom;
$detail[$cle]['code'] = $val->code;
$detail[$cle]['href'] = $url;
}
if ( ($cle == 'sous_type.principal') || ($cle == 'sous_type.secondaire') || ($cle == 'sous_type.special') ){
$i = 0;
foreach ($tb as $sstypes){
$url = $this->ajouterHref('ontologies','ssTT:'.urlencode(urlencode($sstypes)));
$val = $this->consulterHref($url);
$libelle[$cle]=$val->nom;
$detail[$cle][$i]['libelle'] = $val->nom;
$detail[$cle][$i]['code'] = $val->code;
$detail[$cle][$i]['href'] = $url;
$i++;
}
}
}
$resultat_typeBio['type_bio.libelle']= $this->formaterTypeBioPrLibelle($libelle);
$resultat_typeBio['type_bio.detail'] = $detail;
}
return $resultat_typeBio;
}
public function formaterTypeBioPrLibelle($info){
$libelle = $info['type.principal']." ";
$libelle .= isset($info['sous_type.principal']) ? " (".$info['sous_type.principal'].") " : "";
$libelle .= isset($info['type.secondaire']) ? ", ".$info['type.secondaire']." " : "";
$libelle .= isset($info['sous_type.secondaire']) ? "(".$info['sous_type.secondaire'].") " : "";
$libelle .= isset($info['sous_type.special']) ? "(".$info['sous_type.special'].") " : "";
return $libelle;
}
public function separerTypesPrimairesSecondaires($type){
$types = array();
//séparation des principaux et des secondaires
if (( preg_match("/(.+)\((.+)\)\-{0,1}(.+){0,1}/", $type,$retour) == 1 )){
$types['principal'] = $retour[1];
$types['secondaire'] = $retour[2];
if (isset($retour[3])){$types['special'] = $retour[3];}
}else {
$types['principal'] = $type;
}
return $types;
}
public function separerTypes_SousTypes($type_a_traiter, $typePrimOuSec){
$types = array();
if(( preg_match("/^([a-zA-Zé]+)\-(.+)$|^([a-zA-Zé]+[^\-])$/", $type_a_traiter, $retour) == 1 )){
//recupère le type unique
$type = (isset($retour[3]) && ($typePrimOuSec != 'special') ) ? $retour[3] : $retour[1] ;
$types['type.'.$typePrimOuSec]= $type;
//recupère le ou les sous-types
if ((isset($retour[3]) && ($typePrimOuSec == 'special') )){
$ss_types[0] = (isset($retour[3]) && ($typePrimOuSec == 'special') ) ? $retour[3] : "" ;
}elseif(isset($retour[2]) && ($retour[2] != "")){
$ss_types[0]= (isset($retour[2]) && ($retour[2] != "") ) ? $retour[2] : "" ;
}
if (isset($ss_types[0])){
if (( preg_match("/\-/", $ss_types[0])) == 1 ){
$ss_types = preg_split("/\-/", $ss_types[0]);
}
for($i = 0 ; $i < count($ss_types); $i++){
$types['sous_type.'.$typePrimOuSec][$i] = $ss_types[$i];
}
}
}
return $types;
}
//+--------------------------FONCTIONS D'ASSEMBLAGE DE LA REQUETE-------------------------------------------+
public function assemblerLaRequete() {
$requete = ' SELECT '.$this->champs_recherches.' FROM '.$this->table.' '
.$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() {
//on récupère le nombre total de résultats de la requete
$requete = 'SELECT count(*) as nombre FROM '.$this->table.' '
.$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();
if ((count($this->ressources)) == 0) {
if (($this->limite_requete['depart'] < $this->total_resultat) &&
(($this->limite_requete['depart'] + $this->limite_requete['limite'])
< $this->total_resultat )){
$this->requete_limite = 'LIMIT '.$this->limite_requete['depart'].', '
.$this->limite_requete['limite'];
}else {
$e = 'Données introuvables dans la base. ';
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
}
}else {
$this->requete_limite='';
}
return $this->requete_limite;
}
}
?>