Subversion Repositories eFlore/Applications.del

Rev

Rev 1795 | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 1795 Rev 1827
1 
<?php
 1 
<?php
2 
// declare(encoding='UTF-8');
 2 
// declare(encoding='UTF-8');
3 
/**
 3 
/**
4 
 * Classe principale de chargement des sous-services "images" de DEL.
 4 
 * Classe principale de chargement des sous-services "images" de DEL.
5 
 *
 5 
 *
6 
 * Cette classe se charge toujours de :
 6 
 * Cette classe se charge toujours de :
7 
 *  - vérifier l'existance des ressources (services) demandés
 7 
 *  - vérifier l'existance des ressources (services) demandés
8 
 *  - vérifier la cohérence et le format des paramêtres passées dans l'url
 8 
 *  - vérifier la cohérence et le format des paramêtres passées dans l'url
9 
 * En fonction, de la compléxité du service, elle peut :
 9 
 * En fonction, de la compléxité du service, elle peut :
10 
 *  - dans un premier temps, exécuter directement les actions : consulter, ajouter, modifier, supprimer.
 10 
 *  - dans un premier temps, exécuter directement les actions : consulter, ajouter, modifier, supprimer.
11 
 *  - dans un second temps, charger dynamiquement d'éventuelles sous-classes du service en fonction des ressources présentes dans l'URL.
 11 
 *  - dans un second temps, charger dynamiquement d'éventuelles sous-classes du service en fonction des ressources présentes dans l'URL.
12 
 *
 12 
 *
13 
 * URLs possibles :
 13 
 * URLs possibles :
14 
 * GET :
 14 
 * GET :
15 
 * http://localhost/del/services/0.1/images/ => toutes les images : classe ListeImages
 15 
 * http://localhost/del/services/0.1/images/ => toutes les images : classe ListeImages
16 
 * http://localhost/del/services/0.1/images/#idImg/votes => tous les votes d'une image (#idImg) classés par protocole : classe VotesImage
 16 
 * http://localhost/del/services/0.1/images/#idImg/votes => tous les votes d'une image (#idImg) classés par protocole : classe VotesImage
17 
 *
 17 
 *
18 
 * Non Implémenté : http://localhost/del/services/0.1/images/#id => une image donnée => en test pour remplacer les appels à eflore/cel
 18 
 * Non Implémenté : http://localhost/del/services/0.1/images/#id => une image donnée => en test pour remplacer les appels à eflore/cel
19 
 * Non Implémenté : http://localhost/del/services/0.1/images/#id/votes?protocole=#id => tous les votes d'une image et d'un protocole donné
 19 
 * Non Implémenté : http://localhost/del/services/0.1/images/#id/votes?protocole=#id => tous les votes d'une image et d'un protocole donné
20 
 *
 20 
 *
21 
 * PUT :
 21 
 * PUT :
22 
 * http://localhost/del/services/0.1/images/#idImg => ajouter un vote sur une image donnée (#idImg)
 22 
 * http://localhost/del/services/0.1/images/#idImg => ajouter un vote sur une image donnée (#idImg)
23 
 *
 23 
 *
24 
 * POST :
 24 
 * POST :
25 
 * http://localhost/del/services/0.1/images/#idImg => modifier un vote sur une image donnée (#idImg)
 25 
 * http://localhost/del/services/0.1/images/#idImg => modifier un vote sur une image donnée (#idImg)
26 
 *
 26 
 *
27 
 * DELETE :
 27 
 * DELETE :
28 
 * http://localhost/del/services/0.1/images/#idImg => supprimer une image donnée (#idImg)
 28 
 * http://localhost/del/services/0.1/images/#idImg => supprimer une image donnée (#idImg)
29 
 * http://localhost/del/services/0.1/images/#idImg/votes/#idVote => supprimer un vote (#idVote) d'une image donnée (#idImg)
 29 
 * http://localhost/del/services/0.1/images/#idImg/votes/#idVote => supprimer un vote (#idVote) d'une image donnée (#idImg)
30 
 *
 30 
 *
31 
 * @category   DEL
 31 
 * @category   DEL
32 
 * @package    Services
 32 
 * @package    Services
33 
 * @subpackage Images
 33 
 * @subpackage Images
34 
 * @version    0.1
 34 
 * @version    0.1
35 
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
 35 
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
36 
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
 36 
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
37 
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
 37 
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
38 
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 38 
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
39 
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 39 
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
40 
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
 40 
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
41 
 */
 41 
 */
42 
restore_error_handler();
 42 
restore_error_handler();
43 
restore_exception_handler();
 43 
restore_exception_handler();
44 
error_reporting(E_ALL);
 44 
error_reporting(E_ALL);
45 
 
 45 
 
46 
class Images extends RestService {
 46 
class Images extends RestService {
- 
 
 47 
 
- 
 
 48 
	private $conteneur;
47 
 
 49 
	private $cheminCourant;
48 
	private $parametres = array();
 50 
	private $parametres = array();
49 
	private $ressources = array();
 51 
	private $ressources = array();
50 
	private $methode = null;
 52 
	private $methode;
51 
	private $serviceNom = 'images';
 53 
	private $serviceNom = 'images';
52 
	private $sousServiceNom = null;
 - 
 
53 
	private $cheminCourant = null;
 - 
 
54 
 
 - 
 
55 
	private $conteneur;
 54 
	private $sousServiceNom;
56 
 
 55 
 
57 
	/** Indique si oui (true) ou non (false), on veut utiliser les paramètres bruts. */
 56 
	/** Indique si oui (true) ou non (false), on veut utiliser les paramètres bruts. */
58 
	protected $utilisationParametresBruts = true;
 57 
	protected $utilisationParametresBruts = true;
59 
 
 58 
 
60 
	public function __construct() {
 59 
	public function __construct() {
- 
 
 60 
		$this->conteneur = new Conteneur();
61 
		$this->cheminCourant = dirname(__FILE__).DS;
 61 
		$this->cheminCourant = dirname(__FILE__).DS;
62 
	}
 62 
	}
63 
 
 63 
 
64 
	public function consulter($ressources, $parametres) {
 64 
	public function consulter($ressources, $parametres) {
65 
		$this->methode = 'consulter';
 65 
		$this->methode = 'consulter';
66 
		$this->initialiserRessourcesEtParametres($ressources, $parametres);
 66 
		$this->initialiserRessourcesEtParametres($ressources, $parametres);
67 
		return $this->executerService();
 67 
		return $this->executerService();
68 
	}
 68 
	}
69 
 
 69 
 
70 
	public function ajouter($ressources, $requeteDonnees) {
 70 
	public function ajouter($ressources, $requeteDonnees) {
71 
		$this->methode = 'ajouter';
 71 
		$this->methode = 'ajouter';
72 
		$this->initialiserRessourcesEtParametres($ressources, $requeteDonnees);
 72 
		$this->initialiserRessourcesEtParametres($ressources, $requeteDonnees);
73 
		return $this->executerService();
 73 
		return $this->executerService();
74 
	}
 74 
	}
75 
 
 75 
 
76 
	public function modifier($ressources, $requeteDonnees) {
 76 
	public function modifier($ressources, $requeteDonnees) {
77 
		$this->methode = 'modifier';
 77 
		$this->methode = 'modifier';
78 
		$this->initialiserRessourcesEtParametres($ressources, $requeteDonnees);
 78 
		$this->initialiserRessourcesEtParametres($ressources, $requeteDonnees);
79 
		return $this->executerService();
 79 
		return $this->executerService();
80 
	}
 80 
	}
81 
 
 81 
 
82 
	public function supprimer($ressources) {
 82 
	public function supprimer($ressources) {
83 
		$this->methode = 'supprimer';
 83 
		$this->methode = 'supprimer';
84 
		$this->initialiserRessourcesEtParametres($ressources);
 84 
		$this->initialiserRessourcesEtParametres($ressources);
85 
		return $this->executerService();
 85 
		return $this->executerService();
86 
	}
 86 
	}
87 
 
 87 
 
88 
	private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
 88 
	private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
89 
		$this->ressources = $ressources;
 89 
		$this->ressources = $ressources;
90 
		$this->parametres = $parametres;
 90 
		$this->parametres = $parametres;
91 
	}
 91 
	}
92 
 
 92 
 
93 
	private function executerService() {
 93 
	private function executerService() {
94 
		$reponseHttp = new ReponseHttp();
 - 
 
95 
		try {
 - 
 
96 
			$this->conteneur = new Conteneur($this->parametres);
 - 
 
97 
			$resultat = $this->traiterRessources();
 94 
		$resultat = $this->traiterRessources();
98 
			$reponseHttp->setResultatService($resultat);
 95 
		if ($resultat === true || $resultat === false) {
99 
		} catch (Exception $e) {
 - 
 
100 
			$reponseHttp->ajouterErreur($e);
 96 
			return $resultat;
101 
		}
 97 
		}
- 
 
 98 
 
- 
 
 99 
		$reponseHttp = new ReponseHttp();
- 
 
 100 
		$reponseHttp->setResultatService($resultat);
102 
		$reponseHttp->emettreLesEntetes();
 101 
		$reponseHttp->emettreLesEntetes();
103 
		$corps = $reponseHttp->getCorps();
 102 
		return $reponseHttp->getCorps();
104 
		return $corps;
 - 
 
105 
	}
 103 
	}
106 
 
 104 
 
107 
	private function traiterRessources() {
 105 
	private function traiterRessources() {
108 
		$this->chargerConfigService();
 - 
 
109 
		$this->analyserRessources();
 106 
		$this->analyserRessources();
110 
		$retour = $this->initialiserService();
 107 
		$retour = $this->initialiserService();
111 
		return $retour;
 108 
		return $retour;
112 
	}
 109 
	}
113 
 
 - 
 
114 
	private function chargerConfigService() {
 - 
 
115 
		$chemin = Config::get('chemin_configurations')."config_{$this->serviceNom}.ini";
 - 
 
116 
		Config::charger($chemin);
 - 
 
117 
	}
 - 
 
118 
 
 110 
 
119 
	private function analyserRessources() {
 111 
	private function analyserRessources() {
120 
		if ($this->methode == 'consulter') {
 112 
		if ($this->methode == 'consulter') {
121 
			$this->analyserRessoucesConsultation();
 113 
			$this->analyserRessoucesConsultation();
122 
		} else if ($this->methode == 'modifier' || $this->methode == 'ajouter') {
 114 
		} else if ($this->methode == 'modifier' || $this->methode == 'ajouter') {
123 
			$this->analyserRessoucesModification();
 115 
			$this->analyserRessoucesModification();
124 
		} else if ($this->methode == 'supprimer') {
 116 
		} else if ($this->methode == 'supprimer') {
125 
			$this->analyserRessoucesSuppression();
 117 
			$this->analyserRessoucesSuppression();
126 
		}
 118 
		}
- 
 
 119 
		if ($this->sousServiceNom == null) {
- 
 
 120 
			$this->lancerMessageErreurRessource();
- 
 
 121 
		}
127 
	}
 122 
	}
128 
 
 123 
 
129 
	private function analyserRessoucesConsultation() {
 124 
	private function analyserRessoucesConsultation() {
130 
		if (count($this->ressources) == 0) {
 125 
		if (count($this->ressources) == 0) {
131 
			$this->sousServiceNom = 'liste-images';
 126 
			$this->sousServiceNom = 'liste-images';
132 
		} else if (count($this->ressources) == 2) {
 127 
		} else if (count($this->ressources) == 2) {
133 
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes')) {
 128 
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes')) {
134 
				$this->sousServiceNom = 'votes-image';
 129 
				$this->sousServiceNom = 'votes-image';
135 
			}
 130 
			}
136 
		}
 131 
		}
137 
 
 - 
 
138 
		if ($this->sousServiceNom == null) {
 - 
 
139 
			$this->lancerMessageErreurRessource();
 - 
 
140 
		}
 - 
 
141 
	}
 132 
	}
142 
 
 133 
 
143 
	private function analyserRessoucesModification() {
 134 
	private function analyserRessoucesModification() {
144 
		if (count($this->ressources) == 2) {
 135 
		if (count($this->ressources) == 2) {
145 
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes')) {
 136 
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes')) {
146 
				$this->sousServiceNom = 'votes-image';
 137 
				$this->sousServiceNom = 'votes-image';
147 
			}
 138 
			}
148 
		}
 139 
		}
149 
 
 - 
 
150 
		if ($this->sousServiceNom == null) {
 - 
 
151 
			$this->lancerMessageErreurRessource();
 - 
 
152 
		}
 - 
 
153 
	}
 140 
	}
154 
 
 141 
 
155 
	private function analyserRessoucesSuppression() {
 142 
	private function analyserRessoucesSuppression() {
156 
		if (count($this->ressources) == 1 && $this->etreRessourceIdentifiant(0)) {
 143 
		if (count($this->ressources) == 1 && $this->etreRessourceIdentifiant(0)) {
157 
			$this->sousServiceNom = 'liste-images';
 144 
			$this->sousServiceNom = 'liste-images';
158 
		} else if (count($this->ressources) == 3) {
 145 
		} else if (count($this->ressources) == 3) {
159 
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes') && $this->etreRessourceIdentifiant(2) ) {
 146 
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes') && $this->etreRessourceIdentifiant(2) ) {
160 
				$this->sousServiceNom = 'votes-image';
 147 
				$this->sousServiceNom = 'votes-image';
161 
			}
 148 
			}
162 
		}
 149 
		}
163 
 
 - 
 
164 
		if ($this->sousServiceNom == null) {
 - 
 
165 
			$this->lancerMessageErreurRessource();
 - 
 
166 
		}
 - 
 
167 
	}
 150 
	}
168 
 
 151 
 
169 
	private function etreRessourceIdentifiant($num) {
 152 
	private function etreRessourceIdentifiant($num) {
170 
		$presenceId = false;
 153 
		$presenceId = false;
171 
		if (isset($this->ressources[$num]) && is_numeric($this->ressources[$num])) {
 154 
		if (isset($this->ressources[$num]) && is_numeric($this->ressources[$num])) {
172 
			$presenceId = true;
 155 
			$presenceId = true;
173 
		}
 156 
		}
174 
		return $presenceId;
 157 
		return $presenceId;
175 
	}
 158 
	}
176 
 
 159 
 
177 
	private function verifierRessourceValeur($num, $valeur) {
 160 
	private function verifierRessourceValeur($num, $valeur) {
178 
		$ok = false;
 161 
		$ok = false;
179 
		if (isset($this->ressources[$num]) && $this->ressources[$num] == $valeur) {
 162 
		if (isset($this->ressources[$num]) && $this->ressources[$num] == $valeur) {
180 
			$ok = true;
 163 
			$ok = true;
181 
		}
 164 
		}
182 
		return $ok;
 165 
		return $ok;
183 
	}
 166 
	}
184 
 
 167 
 
185 
	private function lancerMessageErreurRessource() {
 168 
	private function lancerMessageErreurRessource() {
186 
		$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
 169 
		$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
187 
		$message = "La ressource demandée '$ressource' ".
 170 
		$message = "La ressource demandée '$ressource' ".
188 
			"n'est pas disponible pour le service ".$this->serviceNom." !\n".
 171 
			"n'est pas disponible pour le service ".$this->serviceNom." !\n".
189 
			"Les URLs disponibles sont : \n".
 - 
 
190 
			" - en GET : images, images/#id/votes \n".
 - 
 
191 
			" - en DELETE : images/#id";
 172 
			$this->getDoc();
192 
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
 173 
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
193 
		throw new Exception($message, $code);
 174 
		throw new Exception($message, $code);
194 
	}
 175 
	}
- 
 
 176 
 
- 
 
 177 
	public function getDoc() {
- 
 
 178 
		return "Les URLs disponibles sont : \n".
- 
 
 179 
			" * en GET : \n".
- 
 
 180 
			"  - images => toutes les images\n".
- 
 
 181 
			"  - images/#idImg/votes => tous les votes d'une image (#idImg) classés par protocole\n".
- 
 
 182 
			" * en PUT : \n".
- 
 
 183 
			"  - /images/#idImg/votes => ajouter un vote sur une image donnée (#idImg)\n".
- 
 
 184 
			" * en POST : \n".
- 
 
 185 
			"  - /images/#idImg/votes => modifier un vote sur une image donnée (#idImg)\n".
- 
 
 186 
			" * en DELETE : \n".
- 
 
 187 
			"  - /images/#idImg => supprimer une image donnée (#idImg)\n".
- 
 
 188 
			"  - /images/#idImg/votes/#idVote => supprimer un vote (#idVote) d'une image donnée (#idImg)";
- 
 
 189 
	}
195 
 
 190 
 
196 
	private function initialiserService() {
 191 
	private function initialiserService() {
197 
		$classe = $this->obtenirNomClasseService($this->sousServiceNom);
 - 
 
198 
		//echo $this->sousServiceNom.':'.$classe."\n";
 - 
 
199 
		//echo 'Ressources :'.print_r($this->ressources, true);
 - 
 
200 
		//echo 'Parametres :'.print_r($this->parametres, true);
 192 
		$classe = $this->obtenirNomClasseService($this->sousServiceNom);
201 
		$chemins = array();
 193 
		$chemins = array();
202 
		$chemins[] = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php';
 194 
		$chemins[] = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php';
203 
		$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php';
 195 
		$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php';
204 
		$retour = '';
 196 
		$retour = '';
205 
		$service = null;
 197 
		$service = null;
206 
		foreach ($chemins as $chemin) {
 198 
		foreach ($chemins as $chemin) {
207 
			if (file_exists($chemin)) {
 199 
			if (file_exists($chemin)) {
208 
				$this->conteneur->chargerConfiguration('config_'.$this->serviceNom.'.ini');
 - 
 
209 
				require_once $chemin;
 200 
				require_once $chemin;
210 
				$service = new $classe($this->conteneur);
 201 
				$service = new $classe($this->conteneur);
211 
				if ($this->methode == 'consulter') {
 202 
				if ($this->methode == 'consulter') {
212 
					$retour = $service->consulter($this->ressources, $this->parametres);
 203 
					$retour = $service->consulter($this->ressources, $this->parametres);
213 
				} elseif ($this->methode == 'ajouter') {
 204 
				} elseif ($this->methode == 'ajouter') {
214 
					$retour = $service->ajouter($this->ressources, $this->parametres);
 205 
					$retour = $service->ajouter($this->ressources, $this->parametres);
215 
				} elseif ($this->methode == 'modifier') {
 206 
				} elseif ($this->methode == 'modifier') {
216 
					$retour = $service->modifier($this->ressources, $this->parametres);
 207 
					$retour = $service->modifier($this->ressources, $this->parametres);
217 
				} elseif ($this->methode == 'supprimer') {
 208 
				} elseif ($this->methode == 'supprimer') {
218 
					$retour = $service->supprimer($this->ressources);
 209 
					$retour = $service->supprimer($this->ressources);
219 
				}
 210 
				}
220 
			}
 211 
			}
221 
		}
 212 
		}
222 
 
 213 
 
223 
		if (is_null($service)) {
 214 
		if (is_null($service)) {
224 
			$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
 215 
			$ressource = implode('/', $this->ressources);
225 
			$message = "Le classe '$classe' correspondant à la ressource '$ressource' ".
 216 
			$msg = "Le classe '$classe' correspondant à la ressource '$ressource' ".
226 
				"n'existe pas dans le service '{$this->serviceNom}' !";
 217 
				"n'existe pas dans le service '{$this->serviceNom}' !\n".$this->getDoc();
227 
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
 218 
			throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
228 
			throw new Exception($message, $code);
 - 
 
229 
		}
 219 
		}
230 
		return $retour;
 220 
		return $retour;
231 
	}
 221 
	}
232 
 
 222 
 
233 
	private function obtenirNomClasseService($mot) {
 223 
	private function obtenirNomClasseService($mot) {
234 
		$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
 224 
		$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
235 
		return $classeNom;
 225 
		return $classeNom;
236 
	}
 226 
	}
237 
}
 227 
}