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();

	}

}