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

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