Subversion Repositories eFlore/Applications.del

Rev

Rev 1478 | Rev 1622 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

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