WebSVN – eFlore/Projets.eflore-projets – /trunk/services/modules/0.1/baseflor/InformationsBaseflor.php

<?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'  :
                                                if (isset($this->parametres['navigation.limite'])) {
                                                        if(preg_match('/^([0-9]+)$/', $valeur)){
                                                                $this->limite_requete['depart'] = $valeur;
                                                                break;
                                                        } else {
                                                                $e = "Erreur : valeur erronnée pour le paramètre navigation.depart.";
                                                                $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
                                                        }
                                                } else {
                                                        $e = "indiquez également la valeur pour le paramètre navigation.limite.";
                                                        $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
                                                }
                                        case 'navigation.limite'  :
                                                if (isset($this->parametres['navigation.depart'])) { 
                                                        if(preg_match('/^([0-9]+)$/', $valeur) && $valeur != 0){
                                                                $this->limite_requete['limite'] = $valeur;
                                                                break;
                                                        } else {
                                                                $e = "Erreur : valeur erronnée pour le paramètre navigation.limite.";
                                                                $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
                                                        }
                                                        
                                                } else {
                                                        $e = "indiquez également la valeur pour le paramètre navigation.depart.";
                                                        $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
                                                 }
                                        case 'categorie'  :
                                                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, "
                                                                ." vi_lumiere, vi_temperature, vi_continentalite, vi_humidite_edaph,"
                                                                ." vi_reaction_sol, vi_nutriments_sol, vi_salinite ";
                                                        $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 'categorie'.";
                                                        $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
                                                }
                                                break;
                                        case 'retour.format'  :
                                                if ($valeur == 'min' || $valeur == 'max') {
                                                        $this->retour_format = $valeur;
                                                        break;
                                                } else {
                                                        $e = "Valeur de paramètre inconnue pour 'retour.format'.";
                                                        $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
                                                }
                                        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> Le référentiel " '
                                                        .$retour[1].' " n\'existe pas.';
                                                $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
                                                break;
                                }

                        } else {
                                $e = 'Erreur dans l\'url de votre requête : </br> La ressource demandée 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 = $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['categorie']) ) {
                                $resultat_json = $this->formaterResultatsTousChamps($resultat_json);
                        } elseif ($this->parametres['categorie'] == 'ecologie') {
                                $resultat_json = $this->formaterResultatsChampsEcologie($resultat_json);
                        } elseif ($this->parametres['categorie'] == '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');
                $Graphique_presence =  false;
                foreach ($this->champs_ontologiques as $cle => $valeur){
                        if ($resultat_json[$cle] != ""){
                                $Graphique_presence =  true;
                                $tab_ontologie = $this->recupererOntologies($resultat_json[$cle], $cle);
                                unset($resultat_json[$cle]);
                                $resultat_json = array_merge($resultat_json,$tab_ontologie);
                        }
                }
                if ($Graphique_presence) {
                        $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');
                $Graphique_presence =  false;
                foreach ($this->champs_ontologiques as $cle => $valeur){
                        if ($resultat_json[$cle] != ""){
                                $Graphique_presence =  true;
                                $tab_ontologie = $this->recupererOntologies($resultat_json[$cle], $cle);
                                unset($resultat_json[$cle]);
                                $resultat_json = array_merge($resultat_json,$tab_ontologie);
                        }
                }
        if ($Graphique_presence) {
                        $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['resultats'][$num][$param] = $valeur;
                                }
                                if ($tab['num_nomen'] != 0) {
                                        $resultat_json['resultats'][$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;
                        }

                        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();
                $this->requete_limite = '';
                if ((count($this->ressources)) == 0) {
                        if ($this->limite_requete['depart'] <  $this->total_resultat)  {
                                if (($this->limite_requete['limite'] 
                                        + $this->limite_requete['depart'])
                                         >= $this->total_resultat  ){
                                        $this->requete_limite = 'LIMIT '.$this->limite_requete['depart'].', '
                                        .$this->total_resultat;
                                } else {
                                        $this->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.";
                                $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
                        }
                        
                }
                return $this->requete_limite;
        }
}
?>
Subversion Repositories eFlore/Projets.eflore-projets

(root)/trunk/services/modules/0.1/baseflor/InformationsBaseflor.php – Rev 517
