Subversion Repositories eFlore/Applications.del

Rev

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

Rev 1462 Rev 1795
1
<?php
1
<?php
-
 
2
// declare(encoding='UTF-8');
2
/**
3
/**
-
 
4
 * Classe principale de chargement des sous-service "mots-clés" de DEL.
-
 
5
 *
3
* Description :
6
 * URLs possibles :
-
 
7
 * GET
-
 
8
 * http://localhost/del/services/0.1/mots-cles?image=#id&auteur.id=#id => les différents mots-clés des images en fonction des paramètres.
-
 
9
 * PUT
-
 
10
 * http://localhost/del/services/0.1/mots-cles?image=#id&auteur.id=#id&mot_cle=motCle1,motCle2,... => Ajoute différents mots-clés pour une image d'un utilisateur
-
 
11
 * DELETE
4
* Classe principale de chargement des services d'eFlore.
12
 * http://localhost/del/services/0.1/mots-cles?image=#id&auteur.id=#id => les différents mots-clés des images en fonction des paramètres.
5
*
13
 *
6
* Encodage en entrée : utf8
14
 * @category   DEL
7
* Encodage en sortie : utf8
15
 * @package    Services
8
* @package del
16
 * @subpackage MotsCles
-
 
17
 * @version    0.1
-
 
18
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
-
 
19
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
9
* @author Aurélien Peronnet <aurelien@tela-botanica.org>
20
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
10
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
21
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
11
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
22
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
12
* @version 0.1
-
 
13
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
23
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
14
*/
24
 */
15
class MotsCles extends RestService {
25
class MotsCles extends RestService {
16
 
-
 
17
	
-
 
18
	/*
-
 
19
	 * url possibles : 
-
 
20
	 * http://localhost/del/services/0.1/motscles/#id =>  les mots clés associés à une image donnée
-
 
21
	 * */
-
 
22
	
26
 
23
	private $parametres = array();
27
	private $parametres = array();
24
	private $ressources = array();
28
	private $ressources = array();
25
	private $methode = null;
29
	private $methode = null;
26
	private $projetNom = array();
30
	private $serviceNom = 'mots_cles';
27
	private $serviceNom = array();
31
	private $sousServiceNom = null;
28
	private $cheminCourant = null;
32
	private $cheminCourant = null;
29
 
33
 
30
	private $conteneur;
34
	private $conteneur;
31
	
35
 
32
	/** 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. */
33
	protected $utilisationParametresBruts = true;
37
	protected $utilisationParametresBruts = true;
34
 
38
 
35
	public function __construct() {
39
	public function __construct() {
36
		$this->cheminCourant = dirname(__FILE__).DS;
40
		$this->cheminCourant = dirname(__FILE__).DS;
37
	}
41
	}
38
 
42
 
39
	public function consulter($ressources, $parametres) {
43
	public function consulter($ressources, $parametres) {
40
		$this->methode = 'consulter';
44
		$this->methode = 'consulter';
41
		$resultat = '';
-
 
42
		$reponseHttp = new ReponseHttp();
-
 
43
		try {
-
 
44
			$this->initialiserRessourcesEtParametres($ressources, $parametres);
45
		$this->initialiserRessourcesEtParametres($ressources, $parametres);
45
			$this->conteneur = new Conteneur($this->parametres);
-
 
46
			$resultat = $this->traiterRessources();
46
		return $this->executerService();
47
			$reponseHttp->setResultatService($resultat);
-
 
48
		} catch (Exception $e) {
-
 
49
			$reponseHttp->ajouterErreur($e);
-
 
50
		}
-
 
51
		$reponseHttp->emettreLesEntetes();
-
 
52
		$corps = $reponseHttp->getCorps();
-
 
53
		return $corps;
-
 
54
	}
47
	}
55
	
48
 
56
	public function ajouter($ressources, $parametres) {
49
	public function ajouter($ressources, $requeteDonnees) {
57
		$this->methode = 'ajouter';
50
		$this->methode = 'ajouter';
58
		$resultat = '';
-
 
59
		$reponseHttp = new ReponseHttp();
-
 
60
		
-
 
61
		try {
-
 
62
			$this->initialiserRessourcesEtParametres($ressources, $parametres);
51
		$this->initialiserRessourcesEtParametres($ressources, $requeteDonnees);
63
			$this->conteneur = new Conteneur($this->parametres);
-
 
64
			$resultat = $this->traiterRessources();
52
		return $this->executerService();
65
			$reponseHttp->setResultatService($resultat);
-
 
66
		} catch (Exception $e) {
-
 
67
			$reponseHttp->ajouterErreur($e);
-
 
68
		}
-
 
69
		$corps = $reponseHttp->getCorps();
-
 
70
		return $corps;
-
 
71
	}
53
	}
72
	
54
 
73
	public function supprimer($ressources) {
55
	public function supprimer($ressources) {
74
		$this->methode = 'supprimer';
56
		$this->methode = 'supprimer';
-
 
57
		$this->initialiserRessourcesEtParametres($ressources);
-
 
58
		return $this->executerService();
-
 
59
	}
-
 
60
 
-
 
61
	private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
-
 
62
		$this->ressources = $ressources;
-
 
63
		$this->parametres = $parametres;
-
 
64
	}
-
 
65
 
-
 
66
	private function executerService() {
75
		$resultat = '';
67
		$resultat = '';
76
		$reponseHttp = new ReponseHttp();
68
		$reponseHttp = new ReponseHttp();
77
		try {
69
		try {
78
			$this->ressources = $ressources;
-
 
79
			$this->conteneur = new Conteneur();
70
			$this->conteneur = new Conteneur($this->parametres);
80
			$resultat = $this->traiterRessources();
71
			$resultat = $this->traiterRessources();
81
			$reponseHttp->setResultatService($resultat);
72
			$reponseHttp->setResultatService($resultat);
82
		} catch (Exception $e) {
73
		} catch (Exception $e) {
83
			$reponseHttp->ajouterErreur($e);
74
			$reponseHttp->ajouterErreur($e);
84
			$reponseHttp->emettreLesEntetes();
-
 
85
			echo $reponseHttp->getCorps();
-
 
86
		}
75
		}
87
	}
-
 
88
	
-
 
89
	public function modifier($ressources, $requeteDonnees) {
76
		$reponseHttp->emettreLesEntetes();
90
		
-
 
91
	}
-
 
92
 
-
 
93
	private function initialiserRessourcesEtParametres($ressources, $parametres) {
-
 
94
		$this->ressources = $ressources;
77
		$corps = $reponseHttp->getCorps();
95
		$this->parametres = $parametres;
78
		return $corps;
96
	}
79
	}
97
 
80
 
98
	private function traiterRessources() {
81
	private function traiterRessources() {
99
		$retour = '';
-
 
100
		$this->initialiserProjet();
82
		$this->analyserRessources();
101
		$retour = $this->initialiserService();
83
		$retour = $this->initialiserService();
102
		return $retour;
84
		return $retour;
103
	}
85
	}
104
	
-
 
105
 
-
 
106
	/*------------------------------------------------------------------------------------------------------------------
-
 
107
										CONFIGURATION DU PROJET
-
 
108
	------------------------------------------------------------------------------------------------------------------*/
-
 
109
	private function initialiserProjet() {
-
 
110
		$this->chargerNomDuProjet();
-
 
111
		$this->chargerConfigProjet();
-
 
112
 
-
 
113
	}
-
 
114
 
86
 
115
	private function chargerNomDuProjet() {
87
	private function analyserRessources() {
116
		$this->projetNom = 'motscles';
-
 
117
	}
-
 
118
 
88
		if ($this->methode == 'consulter') {
119
	private function chargerConfigProjet() {
-
 
120
		$projet = $this->projetNom;
89
			if (!isset($this->ressources) || empty($this->ressources)) {
121
		$chemin = Config::get('chemin_configurations')."config_mots_cles.ini";
-
 
122
		Config::charger($chemin);
90
				$this->sousServiceNom = 'liste-mots-cles';
123
	}
-
 
124
 
-
 
125
	/*------------------------------------------------------------------------------------------------------------------
-
 
126
								CONFIGURATION DU SERVICE
-
 
127
	------------------------------------------------------------------------------------------------------------------*/
-
 
128
	private function chargerNomService() {
-
 
129
		// si la méthode est POST, on ajouter un commentaire
91
			}
130
		if ($this->methode == 'ajouter') {
92
		} else if ($this->methode == 'ajouter') {
131
			$this->serviceNom = 'ajouter-mot-cle';
93
			$this->sousServiceNom = 'ajouter-mot-cle';
-
 
94
		} else if ($this->methode == 'supprimer') {
132
		} else if ($this->methode == 'supprimer') {
95
			if (isset($this->ressources[0]) && count($this->ressources) == 1 && is_numeric($this->ressources[0])) {
-
 
96
				$this->sousServiceNom = 'supprimer-mot-cle';
133
			$this->serviceNom = 'supprimer-mot-cle';
97
			}
134
		}
98
		}
135
		else {
-
 
136
			//S'il n'y a pas de ressources => tous les commentaires
-
 
137
			if (!isset($this->ressources) || empty($this->ressources)) {
99
 
138
				$this->serviceNom = 'liste-mots-cles';
-
 
139
			} else {
-
 
140
				if (!is_numeric($this->ressources[0])) {
-
 
141
					$message = "La première ressource doit être un identifiant";
-
 
142
					$code = RestServeur::HTTP_CODE_ERREUR;
-
 
143
					throw new Exception($message, $code);
-
 
144
				} else {
100
		if ($this->sousServiceNom == null) {
145
					$this->serviceNom = 'consulter-mots-cles';
-
 
146
				}
-
 
147
			}			
101
			$this->lancerMessageErreurRessource();
148
		}
102
		}
149
	}
103
	}
150
	
104
 
151
	private function editerMessageErreurRessource() {
105
	private function lancerMessageErreurRessource() {
-
 
106
		$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
152
		$message = "Le service demandé '".$this->projetNom.'/'.implode('/', $this->ressources).
107
		$message = "La ressource demandée '$ressource' ".
-
 
108
			"n'est pas disponible pour le service «".$this->serviceNom."» !\n".
-
 
109
			"Les URLs disponibles sont : \n".
153
					"' n'est pas disponible pour le projet ".$this->projetNom." !\n".
110
			" - en GET : mots-cles?image=#idImg&auteur.id=#idUtilisateur \n".
-
 
111
			" - en PUT : mots-cles?image=#idImg&auteur.id=#idUtilisateur&mots_cles=motCle1,motCle2,...".
154
					"Les services disponibles sont : images, images/#id/votes, images/#id/vote/#id_vote";
112
			" - en DELETE : mots-cles/#idMotCle";
155
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
113
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
156
		throw new Exception($message, $code);
114
		throw new Exception($message, $code);
157
	}
115
	}
158
	
-
 
159
	private function etreRessourceIdentifiant($num) {
-
 
160
		$presenceId = false;
-
 
161
		if (is_numeric($this->ressources[$num])) {
-
 
162
			$presenceId = true;
-
 
163
		} else {
-
 
164
			$message = "Le service demandé '$service' nécessite d'avoir un identifiant d'image valide";
-
 
165
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
-
 
166
			throw new Exception($message, $code);
-
 
167
		}
-
 
168
		return $presenceId;
-
 
169
	}
-
 
170
 
116
 
171
	private function initialiserService() {
-
 
172
		$this->chargerNomService();
-
 
173
		
117
	private function initialiserService() {
174
		$classe = $this->obtenirNomClasseService($this->serviceNom);
-
 
175
		$chemins = array();
118
		$classe = $this->obtenirNomClasseService($this->sousServiceNom);
176
		$chemins[] = $this->cheminCourant.$this->projetNom.DS.$classe.'.php';
-
 
177
		$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php';
-
 
178
		
119
		$chemin = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php';
179
		$retour = '';
120
		$retour = '';
180
		$service = null;
-
 
181
		foreach ($chemins as $chemin) {
121
		$service = null;
182
			if (file_exists($chemin)) {
-
 
183
				$this->conteneur->chargerConfiguration('config_mots_cles.ini');
122
		if (file_exists($chemin)) {
184
				require_once $chemin;
123
			require_once $chemin;
185
				$service = new $classe($this->conteneur);
124
			$service = new $classe($this->conteneur);
186
				if ($this->methode == 'consulter') {
125
			if ($this->methode == 'consulter') {
187
					$retour = $service->consulter($this->ressources, $this->parametres);
126
				$retour = $service->consulter($this->ressources, $this->parametres);
188
				} elseif ($this->methode == 'ajouter') {
127
			} elseif ($this->methode == 'ajouter') {
189
					$retour = $service->ajouter($this->ressources, $this->parametres);
-
 
190
				} elseif ($this->methode == 'modifier') {
-
 
191
					$retour = $service->modifier($this->ressources, $this->parametres);
128
				$retour = $service->ajouter($this->ressources, $this->parametres);
192
				} elseif ($this->methode == 'supprimer') {
129
			} elseif ($this->methode == 'supprimer') {
193
					$retour = $service->supprimer($this->ressources, $this->parametres);
-
 
194
				}
130
				$retour = $service->supprimer($this->ressources);
195
			}
131
			}
196
		}
132
		}
197
		
133
 
-
 
134
		if (is_null($service)) {
198
		if (is_null($service)) {
135
			$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
-
 
136
			$message = "Le classe '$classe' correspondant à la ressource '$ressource' ".
199
			$message = "Le service demandé '{$this->serviceNom}' n'existe pas dans le projet {$this->projetNom} !";
137
				"n'existe pas dans le service '{$this->serviceNom}' !";
200
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
138
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
201
			throw new Exception($message, $code);
139
			throw new Exception($message, $code);
202
		}
140
		}
203
		return $retour;
141
		return $retour;
204
	}
142
	}
205
 
143
 
206
	private function obtenirNomClasseService($mot) {
144
	private function obtenirNomClasseService($mot) {
207
		$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
145
		$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
208
		return $classeNom;
146
		return $classeNom;
209
	}
147
	}
210
}
-
 
211
?>
-
 
212
148
}
-
 
149
213
150