Subversion Repositories Sites.obs-saisons.fr

<?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.

* Elle est abstraite donc doit obligatoirement être étendue.

*

* @category     Php5

* @package      ODS_saisie

* @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$

*/

abstract class Dao {

    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;

    protected $url_jrest = null;

    public function __construct() {

        $this->url_jrest = Config::get('url_jrest');

    }

    //+----------------------------------------------------------------------------------------------------------------+

    // 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 tri 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

    protected function envoyerRequeteConsultation($url) {

        $url = $this->traiterUrlParametres($url);

        $retour = $this->envoyerRequete($url, 'GET');

        return $retour;

    }

    protected function envoyerRequeteAjout($url, Array $donnees) {

        $retour = $this->envoyerRequete($url, 'PUT', $donnees);

        return $retour;

    }

    protected function envoyerRequeteModif($url, Array $donnees) {

        $retour = $this->envoyerRequete($url, 'POST', $donnees);

        return $retour;

    }

    protected 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) {

                Debug::printr("DEBUG : $date - $uri :\n$debug");

            }

        }

    }

    private function traiterEnteteMessage($entetes) {

        if (isset($entetes['messages'])) {

            $date = $entetes['date'];

            $uri = $entetes['uri'];

            $messages = $entetes['messages'];

            foreach ($messages as $message) {

                Debug::printr("MESSAGE : $date - $uri :\n$message");

            }

        }

    }

    private function reinitialiser() {

        $this->viderDistinction();

        $this->viderLimite();

        $this->viderOrdre();

    }

}

?>