Subversion Repositories Applications.referentiel

<?php
// declare(encoding='UTF-8');
/**
* Classe modèle spécifique à l'application, donc d'accés au données, elle ne devrait pas être appelée de l'extérieur.
*
* @category     php5
* @package      Widget
* @author               Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @copyright    2010 Tela-Botanica
* @license              http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
* @license              http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
* @version              SVN: $Id$
*/
class RestClient {
        const ORDRE_ASCENDANT = 'ASC';
        const ORDRE_DESCENDANT = 'DESC';
        const HTTP_REQUETE_SEPARATEUR = '&';
        protected $distinction = '0';
        protected $limite_debut = null;
        protected $limite_nbre = null;
        protected $ordre = null;
        
        //+----------------------------------------------------------------------------------------------------------------+
        // ACCESSEURS
        
        public function setDistinction($distinct) {
                $this->distinction = $distinct;
        }
        public function getDistinction() {
                return $this->distinction;
        }
        public function viderDistinction() {
                $this->distinction = null;
        }
        
        public function avoirLimitation() {
                $limitation = false;
                if (!is_null($this->limite_debut) && !is_null($this->limite_nbre)) {
                        $limitation = true;
                }
                return $limitation;
        }
        public function setLimitation($limite_debut, $limite_nbre) {
                $this->limite_debut = $limite_debut;
                $this->limite_nbre = $limite_nbre;
        }
        public function getLimiteDebut() {
                return $this->limite_debut;
        }
        public function getLimiteNbre() {
                return $this->limite_nbre;
        }
        public function viderLimite() {
                $this->limite_debut = null;
                $this->limite_nbre = null;
        }
        
        public function addOrdre($champ, $trie = self::ORDRE_ASCENDANT) {
                if (!isset($this->ordre[$champ])) {
                        if (self::ORDRE_ASCENDANT == $trie || self::ORDRE_DESCENDANT == $trie) {
                                $this->ordre[$champ] = $trie;
                        } else {
                                $e = "La valeur pour le trie doit être : {self::ORDRE_ASCENDANT} ou {self::ORDRE_DESCENDANT}.";
                                trigger_error($e, E_USER_WARNING);
                        }
                } else {
                        $e = "Le champ $champ existe déjà dans le tableau des ordres.";
                        trigger_error($e, E_USER_WARNING);
                }
        }
        public function getOrdre() {
                $champs = array();
                foreach ($this->ordre as $champ => $trie) {
                        $champs[] = "$champ $trie";
                }
                return implode(', ', $champs);
        }
        public function viderOrdre() {
                $this->ordre = null;
        }
        
        //+----------------------------------------------------------------------------------------------------------------+
        // MÉTHODES
        
        public function envoyerRequeteConsultation($url) {
                $url = $this->traiterUrlParametres($url);
                $retour = $this->envoyerRequete($url, 'GET');
                return $retour;
        }
        
        public function envoyerRequeteAjout($url, Array $donnees) {
                $retour = $this->envoyerRequete($url, 'PUT', $donnees);
                return $retour;
        }
        
        public function envoyerRequeteModif($url, Array $donnees) {
                $retour = $this->envoyerRequete($url, 'POST', $donnees);
                return $retour;
        }
        
        public function envoyerRequeteSuppression($url) {
                $retour = $this->envoyerRequete($url, 'DELETE');
                return $retour;
        }
        
        private function envoyerRequete($url, $mode, Array $donnees = array()) {
                $contenu = false;
                if ($mode != 'GET' && $mode != 'PUT' && $mode != 'POST' && $mode != 'DELETE') {
                        $e = "Le mode de requête '$mode' n'est pas accepté!";
                        trigger_error($e, E_USER_WARNING);
                } else {
                        $contexte = stream_context_create(array(
                                'http' => array(
                                'method' => $mode,
                                        'header' => "Content-type: application/x-www-form-urlencoded\r\n",
                                'content' => http_build_query($donnees, null, self::HTTP_REQUETE_SEPARATEUR))));
                        $flux = @fopen($url, 'r', false, $contexte);
                        if (!$flux) {
                                $this->traiterEntete($http_response_header, $url);
                                $e = "L'ouverture de l'url '$url' par la méthode HTTP '$mode' a échoué!";
                                trigger_error($e, E_USER_WARNING);
                        } else {
                                // Informations sur les en-têtes et métadonnées du flux
                                $entetes = stream_get_meta_data($flux);
                                $this->traiterEntete($entetes, $url);
                                
                                // Contenu actuel de $url
                                $contenu = stream_get_contents($flux);
                                
                                fclose($flux);
                        }
                }
                $this->reinitialiser();
                return $contenu;
        }
        
        private function traiterUrlParametres($url) {
                $parametres = array();
                if (! is_null($this->getLimiteDebut())) {
                        $parametres[] = 'start='.$this->getLimiteDebut();
                }
                if (! is_null($this->getLimiteNbre())) {
                        $parametres[] = 'limit='.$this->getLimiteNbre();
                }
                if (! is_null($this->ordre)) {
                        $parametres[] = 'orderby='.urlencode($this->getOrdre());
                }
                if ($this->getDistinction() != 0) {
                        $parametres[] = 'distinct='.$this->getDistinction();
                }
                if (count($parametres) > 0) {
                        $url_parametres = implode('&', $parametres);
                        $url = $url.'?'.$url_parametres;
                }
                return $url;
        }
        
        private function traiterEntete($entetes, $uri) {
                $infos = $this->analyserEntete($entetes, $uri);
                $this->traiterEnteteDebug($infos);
                $this->traiterEnteteMessage($infos);
        }
        
        private function analyserEntete($entetes, $uri) {
                $infos = array('date' => null, 'uri' => $uri, 'debugs' => null, 'messages' => null);
                
                if (isset($entetes['wrapper_data'])) {
                        $entetes = $entetes['wrapper_data'];
                }
                foreach ($entetes as $entete) {
                        if (preg_match('/^X-DebugJrest-Data: (.+)$/', $entete, $match)) {
                                $infos['debugs'] = json_decode($match[1]);
                        }
                        if (preg_match('/^X-MessageJrest-Data: (.+)$/', $entete, $match)) {
                                $infos['messages'] = json_decode($match[1]);
                        }
                        if (preg_match('/^Date: .+ ([012][0-9]:[012345][0-9]:[012345][0-9]) .*$/', $entete, $match)) {
                                $infos['date'] = $match[1];
                        }
                }
                return $infos;
        }
        
        private function traiterEnteteDebug($entetes) {
                if (isset($entetes['debugs'])) {
                        $date = $entetes['date'];
                        $uri = $entetes['uri'];
                        $debugs = $entetes['debugs'];
                        foreach ($debugs as $debug) {
                                $e = "DEBUG : $date - $uri :\n$debug";
                                trigger_error($e, E_USER_NOTICE);
                        }
                }
        }
        
        private function traiterEnteteMessage($entetes) {
                if (isset($entetes['messages'])) {
                        $date = $entetes['date'];
                        $uri = $entetes['uri'];
                        $messages = $entetes['messages'];
                        foreach ($messages as $message) {
                                $e = "MESSAGE : $date - $uri :\n$message";
                                trigger_error($e, E_USER_NOTICE);
                        }
                }
        }
        
        private function reinitialiser() {
                $this->viderDistinction();
                $this->viderLimite();
                $this->viderOrdre();
        }
}