Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 145 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?php
/**
* Description :
* Classe principale de chargement des services d'eFlore.
*
* Encodage en entrée : utf8
* Encodage en sortie : utf8
* @package eflore-projets
* @author Jennifer DHÉ <jennifer.dhe@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 0.1
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
*/
class Projets extends RestService {

        /** Contients les paramètres.*/
        private $parametres = array();
        /** Contients les ressources.*/
        private $ressources = array();
        /** Contients les erreurs HTTP levées par le service.*/
        private $erreursHttp = array();

        /** Nom du projet courrant. */
        private $projetNom = array();
        /** Nom du service demandé. */
        private $serviceNom = array();
        /** Chemin vers le dossier courrant. */
        private $cheminCourrant = null;
        /** Indique si oui (true) ou non (false), on veut utiliser les paramètres brutes. */
        protected $utilisationParametresBruts = true;

        public function __construct() {
                $this->cheminCourrant = dirname(__FILE__).DS;
        }

        public function consulter($ressources, $parametres) {
                $resultat = '';
                try {
                        $this->initialiserRessourcesEtParametres($ressources, $parametres);
                        $resultat = $this->traiterRessources();
                } catch (Exception $e) {
                        $this->ajouterErreurHttp($e->getCode(), $e->getMessage());
                }

                $corps = $this->genererReponseHttp($resultat);
                return $corps;
        }

        private function initialiserRessourcesEtParametres($ressources, $parametres) {
                $this->ressources = $ressources;
                $this->parametres = $parametres;
        }

        private function traiterRessources() {
                $retour = '';
                if ($this->avoirRessources()) {
                        if ($this->avoirRessourceProjet()) {
                                $this->initialiserProjet();
                                if ($this->avoirRessourceService()) {
                                        $retour = $this->initialiserService();
                                }
                        }
                }
                return $retour;
        }

        private function avoirRessources() {
                $presenceDeRessources = false;
                if (isset($this->ressources) && count($this->ressources) > 0) {
                        $presenceDeRessources = true;
                } else {
                        $message = "Aucune ressource n'a été indiquée.\n".
                                "Veuillez indiquer au moins un code de projet et un type de service.";
                        $code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
                        throw new Exception($message, $code);
                }
                return $presenceDeRessources;
        }

        private function avoirRessourceProjet() {
                $presenceRessourceProjet = false;
                $projet = $this->ressources[0];
                $projetsDispo = Outils::recupererTableauConfig('projetsDispo');
                if (in_array($projet, $projetsDispo)) {
                        $presenceRessourceProjet = true;
                } else {
                        $message = "La ressource '$projet' n'indique pas un projet existant.\n".
                                "Les projets existant sont :\n".implode(', ', $projetsDispo);
                        $code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
                        throw new Exception($message, $code);
                }
                return $presenceRessourceProjet;
        }

        private function initialiserProjet() {
                $this->chargerNomDuProjet();
                $this->chargerConfigProjet();
                // Enregistrement en première position des autoload de la méthode gérant les classes des services
                spl_autoload_register(array($this, 'chargerClasseProjet'), true , true);
        }

        private function chargerNomDuProjet() {
                $this->projetNom = $this->ressources[0];
        }

        private function chargerConfigProjet() {
                $projet = $this->projetNom;
                $chemin = Config::get('chemin_configurations')."config_$projet.ini";
                Config::charger($chemin);
        }

        private function chargerClasseProjet($classe) {
                if (class_exists($classe)) {
                        return null;
                }

                $chemins = array();
                $chemins[] = $this->cheminCourrant.$this->projetNom.DS;
                $chemins[] = $this->cheminCourrant.'commun'.DS;
                $chemins[] = Config::get('chemin_bibliotheque');

                foreach ($chemins as $chemin) {
                        $chemin = $chemin.$classe.'.php';
                        if (file_exists($chemin)) {
                                require_once $chemin;
                        }
                }
        }

        private function avoirRessourceService() {
                $presenceRessourceService = false;
                $servicesDispo = Outils::recupererTableauConfig('servicesDispo');
                $service = $this->ressources[1];
                if (in_array($service, $servicesDispo)) {
                        $presenceRessourceService = true;
                } else {
                        $message = "La service demandé '$service' n'est pas disponible pour le projet {$this->projetNom} !\n".
                                "Les services disponibles sont : ".implode(', ', $servicesDispo);
                        $code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
                        throw new Exception($message, $code);
                }
                return $presenceRessourceService;
        }

        private function initialiserService() {
                $this->chargerNomDuService();
                $classe = $this->obtenirNomClasse($this->serviceNom);
                $chemins = array();
                $chemins[] = $this->cheminCourrant.$this->projetNom.DS.$classe.'.php';
                $chemins[] = $this->cheminCourrant.'commun'.DS.$classe.'.php';

                $retour = '';
                $service = null;
                foreach ($chemins as $chemin) {
                        if (file_exists($chemin)) {
                                $service = new $classe($this->getBdd());
                                $ressourcesPourService = $this->filtrerRessourcesPourService();
                                $retour = $service->consulter($ressourcesPourService, $this->parametres);
                        }
                }
                if (is_null($service)) {
                        $message = "La service demandé '{$this->serviceNom}' n'existe pas dans le projet {$this->projetNom} !";
                        $code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
                        throw new Exception($message, $code);
                }
                return $retour;
        }

        private function chargerNomDuService() {
                $this->serviceNom = $this->ressources[1];
        }

        private function obtenirNomClasse($mot) {
                $classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
                return $classeNom;
        }

        private function filtrerRessourcesPourService() {
                $ressourcesPourService = array();
                $nbreDeRessources = count($this->ressources);
                for ($i = 2; $i < $nbreDeRessources; $i++) {
                        $ressourcesPourService[] = $this->ressources[$i];
                }
                return $ressourcesPourService;
        }

        private function ajouterErreurHttp($entete, $message) {
                $this->erreursHttp[] = array('entete' => $entete, 'message' => $message);
        }

        private function etreEnErreurHttp() {
                $enErreur = false;
                if (count($this->erreursHttp) > 0) {
                        $enErreur = true;
                }
                return $enErreur;
        }

        private function genererReponseHttp($resultat) {
                $this->genererEnteteHttp();
                $corps = $this->genererCorpsHttp($resultat);
                return $corps;
        }

        private function genererEnteteHttp($mime = 'application/json', $encodage= 'utf-8') {
                // Si aucune erreur n'a été établie (donc un tableau de résultat a bien ete renvoyé...)
                if ($this->etreEnErreurHttp()) {
                        $this->emettreEntete($this->erreursHttp[0]['entete'], 'text/html', $encodage);
                } else {
                        $this->emettreEntete(RestServeur::HTTP_CODE_OK, $mime, $encodage);
                }
        }

        private function emettreEntete($entete, $mime, $encodage) {
                // Gestion du type de contenu
                if (!is_null($mime) && !is_null($encodage)) {
                        header("Content-Type: $mime; charset=$encodage");
                } else if (!is_null($mime) && is_null($encodage)) {
                        header("Content-Type: $mime");
                }
                // Envoie de l'entête
                RestServeur::envoyerEnteteStatutHttp($entete);
        }

        private function genererCorpsHttp($resultats) {
                $corps = '';
                if ($this->etreEnErreurHttp()) {
                        $corps = $this->erreursHttp[0]['message'];
                } else {
                        $corps = json_encode($resultats);
                }
                return $corps;
        }
}
?>