Subversion Repositories eFlore/Applications.del

Rev

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

Rev 1604 Rev 1622
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
 
-
 
49
	public function ajouter($ressources, $requeteDonnees) {
-
 
50
		$this->methode = 'ajouter';
-
 
51
		$this->initialiserRessourcesEtParametres($ressources, $requeteDonnees);
-
 
52
		return $this->executerService();
-
 
53
	}
-
 
54
 
-
 
55
	public function modifier($ressources, $requeteDonnees) {
-
 
56
		$this->methode = 'supprimer';
-
 
57
		$this->initialiserRessourcesEtParametres($ressources, $requeteDonnees);
-
 
58
		return $this->executerService();
-
 
59
	}
48
 
60
 
49
	public function supprimer($ressources) {
61
	public function supprimer($ressources) {
50
		$this->methode = 'supprimer';
62
		$this->methode = 'supprimer';
51
		$this->initialiserRessourcesEtParametres($ressources);
63
		$this->initialiserRessourcesEtParametres($ressources);
52
		return $this->executerService();
64
		return $this->executerService();
53
	}
65
	}
54
 
66
 
55
	private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
67
	private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
56
		$this->ressources = $ressources;
68
		$this->ressources = $ressources;
57
		$this->parametres = $parametres;
69
		$this->parametres = $parametres;
58
	}
70
	}
59
 
71
 
60
	private function executerService() {
72
	private function executerService() {
61
		$resultat = '';
73
		$resultat = '';
62
		$reponseHttp = new ReponseHttp();
74
		$reponseHttp = new ReponseHttp();
63
		try {
75
		try {
64
			$this->conteneur = new Conteneur($this->parametres);
76
			$this->conteneur = new Conteneur($this->parametres);
65
			$resultat = $this->traiterRessources();
77
			$resultat = $this->traiterRessources();
66
			$reponseHttp->setResultatService($resultat);
78
			$reponseHttp->setResultatService($resultat);
67
		} catch (Exception $e) {
79
		} catch (Exception $e) {
68
			$reponseHttp->ajouterErreur($e);
80
			$reponseHttp->ajouterErreur($e);
69
		}
81
		}
70
		$reponseHttp->emettreLesEntetes();
82
		$reponseHttp->emettreLesEntetes();
71
		$corps = $reponseHttp->getCorps();
83
		$corps = $reponseHttp->getCorps();
72
		return $corps;
84
		return $corps;
73
	}
85
	}
74
 
86
 
75
	private function traiterRessources() {
87
	private function traiterRessources() {
76
		$this->chargerConfigService();
88
		$this->chargerConfigService();
77
		$this->analyserRessources();
89
		$this->analyserRessources();
78
		$retour = $this->initialiserService();
90
		$retour = $this->initialiserService();
79
		return $retour;
91
		return $retour;
80
	}
92
	}
81
 
93
 
82
	private function chargerConfigService() {
94
	private function chargerConfigService() {
83
		$chemin = Config::get('chemin_configurations')."config_{$this->serviceNom}.ini";
95
		$chemin = Config::get('chemin_configurations')."config_{$this->serviceNom}.ini";
84
		Config::charger($chemin);
96
		Config::charger($chemin);
85
	}
97
	}
86
 
98
 
87
	/**
99
	/**
88
	 * URLs possibles GET :
100
	 * URLs possibles GET :
89
	 * http://localhost/del/services/0.1/images/ => toutes les images : classe ListeImages
101
	 * 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
102
	 * http://localhost/del/services/0.1/images/#id/votes => tous les votes d'une image classés par protocole : classe VotesImage
91
	 *
103
	 *
92
	 * Non Implémenté : http://localhost/del/services/0.1/images/#id => une image donnée => en test pour remplacer les appels à eflore/cel
104
	 * 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é
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é
94
	 *
106
	 *
95
	 * URLs possibles DELETE :
107
	 * URLs possibles DELETE :
96
	 * http://localhost/del/services/0.1/images/#id => supprimer une image donnée
108
	 * http://localhost/del/services/0.1/images/#id => supprimer une image donnée
97
	 */
109
	 */
98
	private function analyserRessources() {
110
	private function analyserRessources() {
99
		if ($this->methode == 'consulter') {
111
		if ($this->methode == 'consulter' || $this->methode == 'modifier' || $this->methode == 'ajouter') {
100
			$this->analyserRessoucerConsultation();
112
			$this->analyserRessoucerConsultation();
101
		} else if ($this->methode == 'supprimer') {
113
		} else if ($this->methode == 'supprimer') {
102
			$this->analyserRessoucerSuppression();
114
			$this->analyserRessoucerSuppression();
103
		}
115
		}
104
	}
116
	}
105
 
117
 
106
	private function analyserRessoucerConsultation() {
118
	private function analyserRessoucerConsultation() {
107
		if (count($this->ressources) == 0) {
119
		if (count($this->ressources) == 0) {
108
			$this->sousServiceNom = 'liste-images';
120
			$this->sousServiceNom = 'liste-images';
109
		} else if (count($this->ressources) == 2) {
121
		} else if (count($this->ressources) == 2) {
110
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes')) {
122
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes')) {
111
				$this->sousServiceNom = 'votes-image';
123
				$this->sousServiceNom = 'votes-image';
112
			}
124
			}
113
		}
125
		}
114
 
126
 
115
		if ($this->sousServiceNom == null) {
127
		if ($this->sousServiceNom == null) {
116
			$this->lancerMessageErreurRessource();
128
			$this->lancerMessageErreurRessource();
117
		}
129
		}
118
	}
130
	}
119
 
131
 
120
	private function analyserRessoucerSuppression() {
132
	private function analyserRessoucerSuppression() {
121
		if (count($this->ressources) == 1 && $this->etreRessourceIdentifiant(0)) {
133
		if (count($this->ressources) == 1 && $this->etreRessourceIdentifiant(0)) {
122
			$this->sousServiceNom = 'liste-images';
134
			$this->sousServiceNom = 'liste-images';
123
		}
135
		}
124
 
136
 
125
		if ($this->sousServiceNom == null) {
137
		if ($this->sousServiceNom == null) {
126
			$this->lancerMessageErreurRessource();
138
			$this->lancerMessageErreurRessource();
127
		}
139
		}
128
	}
140
	}
129
 
141
 
130
	private function etreRessourceIdentifiant($num) {
142
	private function etreRessourceIdentifiant($num) {
131
		$presenceId = false;
143
		$presenceId = false;
132
		if (isset($this->ressources[$num]) && is_numeric($this->ressources[$num])) {
144
		if (isset($this->ressources[$num]) && is_numeric($this->ressources[$num])) {
133
			$presenceId = true;
145
			$presenceId = true;
134
		}
146
		}
135
		return $presenceId;
147
		return $presenceId;
136
	}
148
	}
137
 
149
 
138
	private function verifierRessourceValeur($num, $valeur) {
150
	private function verifierRessourceValeur($num, $valeur) {
139
		$ok = false;
151
		$ok = false;
140
		if (isset($this->ressources[$num]) && $this->ressources[$num] == $valeur) {
152
		if (isset($this->ressources[$num]) && $this->ressources[$num] == $valeur) {
141
			$ok = true;
153
			$ok = true;
142
		}
154
		}
143
		return $ok;
155
		return $ok;
144
	}
156
	}
145
 
157
 
146
	private function lancerMessageErreurRessource() {
158
	private function lancerMessageErreurRessource() {
147
		$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
159
		$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
148
		$message = "La ressource demandée '$ressource' ".
160
		$message = "La ressource demandée '$ressource' ".
149
			"n'est pas disponible pour le service ".$this->serviceNom." !\n".
161
			"n'est pas disponible pour le service ".$this->serviceNom." !\n".
150
			"Les URLs disponibles sont : \n".
162
			"Les URLs disponibles sont : \n".
151
			" - en GET : images, images/#id/votes \n".
163
			" - en GET : images, images/#id/votes \n".
152
			" - en DELETE : images/#id";
164
			" - en DELETE : images/#id";
153
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
165
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
154
		throw new Exception($message, $code);
166
		throw new Exception($message, $code);
155
	}
167
	}
156
 
168
 
157
	private function initialiserService() {
169
	private function initialiserService() {
158
		$classe = $this->obtenirNomClasseService($this->sousServiceNom);
170
		$classe = $this->obtenirNomClasseService($this->sousServiceNom);
159
		//echo $this->sousServiceNom.':'.$classe."\n";
171
		//echo $this->sousServiceNom.':'.$classe."\n";
160
		//echo 'Ressources :'.print_r($this->ressources, true);
172
		//echo 'Ressources :'.print_r($this->ressources, true);
161
		//echo 'Parametres :'.print_r($this->parametres, true);
173
		//echo 'Parametres :'.print_r($this->parametres, true);
162
		$chemins = array();
174
		$chemins = array();
163
		$chemins[] = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php';
175
		$chemins[] = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php';
164
		$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php';
176
		$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php';
165
		$retour = '';
177
		$retour = '';
166
		$service = null;
178
		$service = null;
167
		foreach ($chemins as $chemin) {
179
		foreach ($chemins as $chemin) {
168
			if (file_exists($chemin)) {
180
			if (file_exists($chemin)) {
169
				$this->conteneur->chargerConfiguration('config_'.$this->serviceNom.'.ini');
181
				$this->conteneur->chargerConfiguration('config_'.$this->serviceNom.'.ini');
170
				require_once $chemin;
182
				require_once $chemin;
171
				$service = new $classe($this->conteneur);
183
				$service = new $classe($this->conteneur);
172
				if ($this->methode == 'consulter') {
184
				if ($this->methode == 'consulter') {
173
					$retour = $service->consulter($this->ressources, $this->parametres);
185
					$retour = $service->consulter($this->ressources, $this->parametres);
174
				} elseif ($this->methode == 'supprimer') {
186
				} elseif ($this->methode == 'supprimer') {
175
					$retour = $service->supprimer($this->ressources);
187
					$retour = $service->supprimer($this->ressources);
176
				}
188
				}
177
			}
189
			}
178
		}
190
		}
179
 
191
 
180
		if (is_null($service)) {
192
		if (is_null($service)) {
181
			$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
193
			$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
182
			$message = "Le classe '$classe' correspondant à la ressource '$ressource' ".
194
			$message = "Le classe '$classe' correspondant à la ressource '$ressource' ".
183
				"n'existe pas dans le service '{$this->serviceNom}' !";
195
				"n'existe pas dans le service '{$this->serviceNom}' !";
184
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
196
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
185
			throw new Exception($message, $code);
197
			throw new Exception($message, $code);
186
		}
198
		}
187
		return $retour;
199
		return $retour;
188
	}
200
	}
189
 
201
 
190
	private function obtenirNomClasseService($mot) {
202
	private function obtenirNomClasseService($mot) {
191
		$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
203
		$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
192
		return $classeNom;
204
		return $classeNom;
193
	}
205
	}
194
}
206
}
195
?>
207
?>