Subversion Repositories eFlore/Applications.del

Rev

Rev 1621 | Rev 1631 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
702 gduche 1
<?php
2
/**
1604 jpm 3
* Classe principale du service Images de DEL.
702 gduche 4
*
1604 jpm 5
* Cette classe se charge toujours de :
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.
11
*
702 gduche 12
* Encodage en entrée : utf8
13
* Encodage en sortie : utf8
1604 jpm 14
*
15
* @category DEL
16
* @package Images
17
* @version 0.1
702 gduche 18
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
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>
21
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
22
*/
1604 jpm 23
restore_error_handler();
24
restore_exception_handler();
25
error_reporting(E_ALL);
746 gduche 26
class Images extends RestService {
702 gduche 27
	private $parametres = array();
28
	private $ressources = array();
782 delphine 29
	private $methode = null;
1604 jpm 30
	private $serviceNom = 'images';
31
	private $sousServiceNom = null;
718 gduche 32
	private $cheminCourant = null;
33
 
34
	private $conteneur;
1604 jpm 35
 
718 gduche 36
	/** Indique si oui (true) ou non (false), on veut utiliser les paramètres bruts. */
702 gduche 37
	protected $utilisationParametresBruts = true;
38
 
39
	public function __construct() {
718 gduche 40
		$this->cheminCourant = dirname(__FILE__).DS;
702 gduche 41
	}
42
 
43
	public function consulter($ressources, $parametres) {
782 delphine 44
		$this->methode = 'consulter';
1604 jpm 45
		$this->initialiserRessourcesEtParametres($ressources, $parametres);
46
		return $this->executerService();
47
	}
48
 
1623 mathias 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
	}
60
 
1604 jpm 61
	public function supprimer($ressources) {
62
		$this->methode = 'supprimer';
63
		$this->initialiserRessourcesEtParametres($ressources);
64
		return $this->executerService();
65
	}
66
 
67
	private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
68
		$this->ressources = $ressources;
69
		$this->parametres = $parametres;
70
	}
71
 
72
	private function executerService() {
702 gduche 73
		$resultat = '';
74
		$reponseHttp = new ReponseHttp();
75
		try {
718 gduche 76
			$this->conteneur = new Conteneur($this->parametres);
702 gduche 77
			$resultat = $this->traiterRessources();
78
			$reponseHttp->setResultatService($resultat);
79
		} catch (Exception $e) {
80
			$reponseHttp->ajouterErreur($e);
81
		}
82
		$reponseHttp->emettreLesEntetes();
83
		$corps = $reponseHttp->getCorps();
84
		return $corps;
85
	}
86
 
87
	private function traiterRessources() {
1604 jpm 88
		$this->chargerConfigService();
89
		$this->analyserRessources();
90
		$retour = $this->initialiserService();
702 gduche 91
		return $retour;
92
	}
758 delphine 93
 
1604 jpm 94
	private function chargerConfigService() {
95
		$chemin = Config::get('chemin_configurations')."config_{$this->serviceNom}.ini";
96
		Config::charger($chemin);
702 gduche 97
	}
98
 
1604 jpm 99
	/**
100
	 * URLs possibles GET :
101
	 * 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
103
	 *
104
	 * 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é
106
	 *
107
	 * URLs possibles DELETE :
108
	 * http://localhost/del/services/0.1/images/#id => supprimer une image donnée
109
	 */
110
	private function analyserRessources() {
1623 mathias 111
		if ($this->methode == 'consulter' || $this->methode == 'modifier' || $this->methode == 'ajouter') {
1604 jpm 112
			$this->analyserRessoucerConsultation();
113
		} else if ($this->methode == 'supprimer') {
114
			$this->analyserRessoucerSuppression();
115
		}
702 gduche 116
	}
117
 
1604 jpm 118
	private function analyserRessoucerConsultation() {
119
		if (count($this->ressources) == 0) {
120
			$this->sousServiceNom = 'liste-images';
121
		} else if (count($this->ressources) == 2) {
122
			if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes')) {
123
				$this->sousServiceNom = 'votes-image';
758 delphine 124
			}
702 gduche 125
		}
1604 jpm 126
 
127
		if ($this->sousServiceNom == null) {
128
			$this->lancerMessageErreurRessource();
129
		}
702 gduche 130
	}
1604 jpm 131
 
132
	private function analyserRessoucerSuppression() {
133
		if (count($this->ressources) == 1 && $this->etreRessourceIdentifiant(0)) {
134
			$this->sousServiceNom = 'liste-images';
758 delphine 135
		}
1604 jpm 136
 
137
		if ($this->sousServiceNom == null) {
138
			$this->lancerMessageErreurRessource();
139
		}
758 delphine 140
	}
1604 jpm 141
 
758 delphine 142
	private function etreRessourceIdentifiant($num) {
143
		$presenceId = false;
1604 jpm 144
		if (isset($this->ressources[$num]) && is_numeric($this->ressources[$num])) {
758 delphine 145
			$presenceId = true;
754 delphine 146
		}
758 delphine 147
		return $presenceId;
754 delphine 148
	}
702 gduche 149
 
1604 jpm 150
	private function verifierRessourceValeur($num, $valeur) {
151
		$ok = false;
152
		if (isset($this->ressources[$num]) && $this->ressources[$num] == $valeur) {
153
			$ok = true;
154
		}
155
		return $ok;
156
	}
157
 
158
	private function lancerMessageErreurRessource() {
159
		$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
160
		$message = "La ressource demandée '$ressource' ".
161
			"n'est pas disponible pour le service ".$this->serviceNom." !\n".
162
			"Les URLs disponibles sont : \n".
163
			" - en GET : images, images/#id/votes \n".
164
			" - en DELETE : images/#id";
165
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
166
		throw new Exception($message, $code);
167
	}
168
 
702 gduche 169
	private function initialiserService() {
1604 jpm 170
		$classe = $this->obtenirNomClasseService($this->sousServiceNom);
171
		//echo $this->sousServiceNom.':'.$classe."\n";
172
		//echo 'Ressources :'.print_r($this->ressources, true);
173
		//echo 'Parametres :'.print_r($this->parametres, true);
702 gduche 174
		$chemins = array();
1604 jpm 175
		$chemins[] = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php';
718 gduche 176
		$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php';
702 gduche 177
		$retour = '';
178
		$service = null;
179
		foreach ($chemins as $chemin) {
180
			if (file_exists($chemin)) {
1604 jpm 181
				$this->conteneur->chargerConfiguration('config_'.$this->serviceNom.'.ini');
751 delphine 182
				require_once $chemin;
724 gduche 183
				$service = new $classe($this->conteneur);
782 delphine 184
				if ($this->methode == 'consulter') {
185
					$retour = $service->consulter($this->ressources, $this->parametres);
1472 aurelien 186
				} elseif ($this->methode == 'supprimer') {
187
					$retour = $service->supprimer($this->ressources);
782 delphine 188
				}
702 gduche 189
			}
190
		}
1604 jpm 191
 
702 gduche 192
		if (is_null($service)) {
1604 jpm 193
			$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
194
			$message = "Le classe '$classe' correspondant à la ressource '$ressource' ".
195
				"n'existe pas dans le service '{$this->serviceNom}' !";
702 gduche 196
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
197
			throw new Exception($message, $code);
198
		}
199
		return $retour;
200
	}
201
 
202
	private function obtenirNomClasseService($mot) {
203
		$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
204
		return $classeNom;
205
	}
206
}
207
?>