Subversion Repositories Applications.referentiel

Rev

Rev 53 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
6 jpm 1 
<?php
2 
// declare(encoding='UTF-8');
3 
/**
4 
* 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.
5 
* Elle est abstraite donc doit obligatoirement être étendue.
6 
*
7 
* @category		Php5
8 
* @package 		Referentiel
9 
* @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
10 
* @copyright	2010 Tela-Botanica
11 
* @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
12 
* @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
13 
* @version		SVN: $Id$
14 
*/
20 jpm 15 
abstract class Dao {
52 jpm 16 
	const ORDRE_ASCENDANT = 'ASC';
17 
	const ORDRE_DESCENDANT = 'DESC';
36 jpm 18 
	const HTTP_REQUETE_SEPARATEUR = '&';
6 jpm 19 
	protected $distinction = '0';
20 
	protected $limite_debut = null;
21 
	protected $limite_nbre = null;
53 jpm 22 
	protected $ordre = null;
6 jpm 23 
	protected $url_jrest = null;
24 
 
25 
	public function __construct() {
26 jpm 26 
		$this->url_jrest = Config::get('url_jrest');
6 jpm 27 
	}
28 
 
23 jpm 29 
	//+----------------------------------------------------------------------------------------------------------------+
30 
	// ACCESSEURS
31 
 
52 jpm 32 
	public function setDistinction($distinct) {
33 
		$this->distinction = $distinct;
34 
	}
35 
	public function getDistinction() {
36 
		return $this->distinction;
37 
	}
38 
	public function viderDistinction() {
39 
		$this->distinction = null;
40 
	}
41 
 
6 jpm 42 
	public function avoirLimitation() {
43 
		$limitation = false;
44 
		if (!is_null($this->limite_debut) && !is_null($this->limite_nbre)) {
45 
			$limitation = true;
46 
		}
47 
		return $limitation;
48 
	}
49 
	public function setLimitation($limite_debut, $limite_nbre) {
50 
		$this->limite_debut = $limite_debut;
51 
		$this->limite_nbre = $limite_nbre;
52 
	}
53 
	public function getLimiteDebut() {
54 
		return $this->limite_debut;
55 
	}
56 
	public function getLimiteNbre() {
57 
		return $this->limite_nbre;
58 
	}
52 jpm 59 
	public function viderLimite() {
60 
		$this->limite_debut = null;
61 
		$this->limite_nbre = null;
62 
	}
23 jpm 63 
 
52 jpm 64 
	public function addOrdre($champ, $trie = self::ORDRE_ASCENDANT) {
65 
		if (!isset($this->ordre[$champ])) {
66 
			if (self::ORDRE_ASCENDANT == $trie || self::ORDRE_DESCENDANT == $trie) {
67 
				$this->ordre[$champ] = $trie;
68 
			} else {
69 
				$e = "La valeur pour le trie doit être : {self::ORDRE_ASCENDANT} ou {self::ORDRE_DESCENDANT}.";
70 
				trigger_error($e, E_USER_WARNING);
71 
			}
72 
		} else {
73 
			$e = "Le champ $champ existe déjà dans le tableau des ordres.";
74 
			trigger_error($e, E_USER_WARNING);
75 
		}
76 
	}
77 
	public function getOrdre() {
78 
		$champs = array();
79 
		foreach ($this->ordre as $champ => $trie) {
80 
			$champs[] = "$champ $trie";
81 
		}
82 
		return implode(', ', $champs);
83 
	}
84 
	public function viderOrdre() {
85 
		$this->ordre = null;
86 
	}
87 
 
23 jpm 88 
	//+----------------------------------------------------------------------------------------------------------------+
89 
	// MÉTHODES
24 jpm 90 
 
91 
	protected function envoyerRequeteConsultation($url) {
38 jpm 92 
		$url = $this->traiterUrlParametres($url);
24 jpm 93 
		$retour = $this->envoyerRequete($url, 'GET');
94 
		return $retour;
95 
	}
96 
 
23 jpm 97 
	protected function envoyerRequeteAjout($url, Array $donnees) {
24 jpm 98 
		$retour = $this->envoyerRequete($url, 'PUT', $donnees);
23 jpm 99 
		return $retour;
100 
	}
101 
 
26 jpm 102 
	protected function envoyerRequeteModif($url, Array $donnees) {
24 jpm 103 
		$retour = $this->envoyerRequete($url, 'POST', $donnees);
23 jpm 104 
		return $retour;
105 
	}
106 
 
107 
	protected function envoyerRequeteSuppression($url) {
36 jpm 108 
		$retour = $this->envoyerRequete($url, 'DELETE');
23 jpm 109 
		return $retour;
110 
	}
111 
 
24 jpm 112 
	private function envoyerRequete($url, $mode, Array $donnees = array()) {
113 
		$contenu = false;
114 
		if ($mode != 'GET' && $mode != 'PUT' && $mode != 'POST' && $mode != 'DELETE') {
23 jpm 115 
			$e = "Le mode de requête '$mode' n'est pas accepté!";
116 
			trigger_error($e, E_USER_WARNING);
117 
		} else {
24 jpm 118 
			$contexte = stream_context_create(array(
119 
				'http' => array(
120 
      				'method' => $mode,
23 jpm 121 
					'header' => "Content-type: application/x-www-form-urlencoded\r\n",
37 jpm 122 
      				'content' => http_build_query($donnees, null, self::HTTP_REQUETE_SEPARATEUR))));
24 jpm 123 
			$flux = @fopen($url, 'r', false, $contexte);
124 
			if (!$flux) {
125 
				$this->traiterEntete($http_response_header, $url);
54 jpm 126 
				$e = "L'ouverture de l'url '$url' par la méthode HTTP '$mode' a échoué!";
24 jpm 127 
				trigger_error($e, E_USER_WARNING);
128 
			} else {
129 
				// Informations sur les en-têtes et métadonnées du flux
130 
				$entetes = stream_get_meta_data($flux);
131 
				$this->traiterEntete($entetes, $url);
132 
 
133 
				// Contenu actuel de $url
134 
				$contenu = stream_get_contents($flux);
135 
 
136 
				fclose($flux);
137 
			}
23 jpm 138 
		}
52 jpm 139 
		$this->reinitialiser();
24 jpm 140 
		return $contenu;
23 jpm 141 
	}
24 jpm 142 
 
38 jpm 143 
	private function traiterUrlParametres($url) {
144 
		$parametres = array();
145 
		if (! is_null($this->getLimiteDebut())) {
146 
			$parametres[] = 'start='.$this->getLimiteDebut();
147 
		}
148 
		if (! is_null($this->getLimiteNbre())) {
149 
			$parametres[] = 'limit='.$this->getLimiteNbre();
150 
		}
52 jpm 151 
		if (! is_null($this->ordre)) {
152 
			$parametres[] = 'orderby='.urlencode($this->getOrdre());
153 
		}
38 jpm 154 
		if ($this->getDistinction() != 0) {
155 
			$parametres[] = 'distinct='.$this->getDistinction();
156 
		}
157 
		if (count($parametres) > 0) {
158 
			$url_parametres = implode('&', $parametres);
159 
			$url = $url.'?'.$url_parametres;
160 
		}
161 
		return $url;
162 
	}
163 
 
24 jpm 164 
	private function traiterEntete($entetes, $uri) {
165 
		$infos = $this->analyserEntete($entetes, $uri);
166 
		$this->traiterEnteteDebug($infos);
167 
		$this->traiterEnteteMessage($infos);
168 
	}
169 
 
170 
	private function analyserEntete($entetes, $uri) {
171 
		$infos = array('date' => null, 'uri' => $uri, 'debugs' => null, 'messages' => null);
172 
 
173 
		if (isset($entetes['wrapper_data'])) {
174 
			$entetes = $entetes['wrapper_data'];
175 
		}
176 
		foreach ($entetes as $entete) {
177 
			if (preg_match('/^X-DebugJrest-Data: (.+)$/', $entete, $match)) {
178 
				$infos['debugs'] = json_decode($match[1]);
179 
			}
180 
			if (preg_match('/^X-MessageJrest-Data: (.+)$/', $entete, $match)) {
181 
				$infos['messages'] = json_decode($match[1]);
182 
			}
183 
			if (preg_match('/^Date: .+ ([012][0-9]:[012345][0-9]:[012345][0-9]) .*$/', $entete, $match)) {
184 
				$infos['date'] = $match[1];
185 
			}
186 
		}
187 
		return $infos;
188 
	}
189 
 
190 
	private function traiterEnteteDebug($entetes) {
191 
		if (isset($entetes['debugs'])) {
192 
			$date = $entetes['date'];
193 
			$uri = $entetes['uri'];
194 
			$debugs = $entetes['debugs'];
195 
			foreach ($debugs as $debug) {
196 
				Debug::printr("DEBUG : $date - $uri :\n$debug");
197 
			}
198 
		}
199 
	}
200 
 
201 
	private function traiterEnteteMessage($entetes) {
202 
		if (isset($entetes['messages'])) {
203 
			$date = $entetes['date'];
204 
			$uri = $entetes['uri'];
205 
			$messages = $entetes['messages'];
206 
			foreach ($messages as $message) {
207 
				Debug::printr("MESSAGE : $date - $uri :\n$message");
208 
			}
209 
		}
210 
	}
52 jpm 211 
 
212 
	private function reinitialiser() {
213 
		$this->viderDistinction();
214 
		$this->viderLimite();
215 
		$this->viderOrdre();
216 
	}
6 jpm 217 
}