Subversion Repositories eFlore/Projets.eflore-projets

<?php

/**
* classe pour web service qui affiche les images de Coste.
* il n'existe qu'une seule version pour les images de Coste : 2.00
* retour en application/json
* 
* exemple d'appel du service  : 
* .../service:eflore:0.1/coste/images?masque.nt=1053
* .../service:eflore:0.1/coste/images?masque.nn=39594,39601
* .../service:eflore:0.1/coste/images
* 
* paramètres disponibles : navigation.depart, navigation.limite, masque.nn, masque.nt
* 
* @package eFlore/services
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Mathilde Salthun-Lassalle <mathilde@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 Images extends Commun {
        
        protected  $table ;
        private $requete_condition = array(" image != '' ");
        private $champs_recherches = " num_nom, image, flore_bdtfx_nn, flore_bdtfx_nt ";
        private $total_resultat;
        protected $limite_requete = array('depart' => 0, 'limite' => 100);
        private $masque = array();
        
        

        
        public function consulter($ressources, $parametres) {
                $this->ressources = $ressources;
                $this->parametres = $parametres;
                $this->traiterRessources();
                $this->traiterParametres();
                $this->table = config::get('bdd_table').'_v2_00'; 
                $requete = $this->assemblerLaRequete();
                $resultat = $this->getBdd()->recupererTous($requete);
                $resultats = $this->formaterResultat($resultat);
                return $resultats;
        }
        
        //+-----------------------------------traitement ressources et paramètres --------------------------------+
        
        
        public function traiterRessources() {
                        if (empty($this->ressources) ) {
                                if (isset($this->parametres['masque.nn']) == false
                                && isset($this->parametres['masque.nt']) == false) {
                                $this->requete_condition[] = " flore_bdtfx_nt != '' AND flore_bdtfx_nn != '' ";
                                }
                        } else {
                                $e = "La ressource {$this->ressources[0]} n'existe pas.";
                                $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,$e);
                        }
        }
        
        public function traiterParametres() {
                foreach ($this->parametres as $param => $val ) {
                        switch ($param) {
                                case 'masque.nt' :
                                        $this->analyserMasque($val,'nt');
                                        break;
                                case 'masque.nn' :
                                        $this->analyserMasque($val,'nn');
                                        break;
                                case 'referentiel' :
                                        // ce paramètre est ignoré dans le cas de coste
                                        // car seul le cel le prend en compte pour le moment
                                        // on l'indique ici dans le switch car ce sont les mêmes url
                                        // qui sont appelées pour le cel et coste (à retirer donc si ça change)
                                        break;
                                case 'navigation.depart' :
                                        $this->limite_requete['depart'] = $val;
                                        break;
                                case 'navigation.limite' :
                                        $this->limite_requete['limite'] = $val;
                                        break;
                                default : 
                                        $e = 'Erreur dans les paramètres de recherche de votre requête : </br> Le parametre " '
                                        .$param.' " n\'existe pas.';
                                        $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,$e);
                                        break;
                        }
                }
        }
        
        

        
        private function analyserMasque($valeur, $type_masque) {
                $this->masque[] = "$type_masque=$valeur";
                if (!$valeur) {
                        $e = 'renseignez une valeur pour masque.nn';
                        $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,$e);
                }
                $arr = array_filter(array_map('intval', explode(',', $valeur)));
                if(!$arr) $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, "valeur incorrecte pour masque.".$type_masque);
                $this->requete_condition[] = sprintf(" flore_bdtfx_%s IN (%s)", $type_masque, implode(',', $arr));
        }
        
        
        
        

//+-------------------------------------------formatage résultats---------------------------------------------+

        public function formaterResultat($resultat) {
                $versionResultat['entete'] = $this->formaterEnteteResultat();;
                if ($resultat == '') {
                        $message = 'La requête SQL formée comporte une erreur!';
                        $code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
                        throw new Exception($message, $code);
                } elseif ($resultat) {
                        $versionResultat = $this->retournerResultatFormate($resultat);
                } else {
                        $versionResultat['resultats'] = array();
                }
                return $versionResultat;
        }
        
        public function retournerResultatFormate($resultat) {
                $resultat_json = array();
                        foreach ($resultat as $tab) {
                                $num_coste = $tab['num_nom'];
                                unset($tab['num_nom']);
                                $resultat_json['resultats'][$num_coste]['num_nomenclatural'] = $tab['flore_bdtfx_nn'];
                                $resultat_json['resultats'][$num_coste]['num_taxonomique'] = $tab['flore_bdtfx_nt'];
                                $resultat_json['resultats'][$num_coste]['binaire.href'] = $this->formaterUrlImage($tab['image']);
                                $resultat_json['resultats'][$num_coste]['mime'] = "images/png";
                        }
                return $resultat_json;
        }
        
        public function formaterUrlImage($fichier) {
                $chemin = config::get('donnees')."2.00/img/$fichier"; 
                return $chemin;
        }
        

        
        
        public function formaterEnteteResultat() {
                $entete['depart'] = $this->limite_requete['depart'];
                $entete['limite'] = $this->limite_requete['limite'];
                $entete['total']  =  $this->total_resultat;
                $entete['masque']  = empty($this->masque) ? 'aucun' : implode('&', $this->masque);
                $url = $this->formulerUrl($this->total_resultat, '/images');
                if (isset($url['precedent']) && $url['precedent'] != '') {
                        $entete['href.precedent'] = $url['precedent'];
                }
                if (isset($url['suivant']) && $url['suivant'] != '') {
                        $entete['href.suivant']   = $url['suivant'];
                }
                return $entete;
        }
        
        //+--------------------------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 (empty($this->requete_condition) == false) {
                        $condition = ' WHERE '.implode(' AND ', $this->requete_condition);
                }
                return $condition;
        }
        

        
        public function calculerTotalResultat() {
                $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();
                $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  )) {  
                                        $requete_limite = 'LIMIT '.$this->limite_requete['depart'].', '
                                        .$this->limite_requete['limite'];
                        } 
                }
                return $requete_limite;
        }
        
}
?>