Subversion Repositories eFlore/Applications.del

Rev

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

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