Subversion Repositories eFlore/Projets.eflore-projets

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
727 alex 1
<?php
2
 
747 alex 3
/**
4
 * Classe qui remplit un fond cartographique SVG a partir des observations en base de donnees
5
 * pour un taxon de plante. Elle verifie dans un premier temps la validite des parametres saisis,
6
 * puis charge le fond cartographique depuis le fichier, recupere dans la base de donnees
7
 * les observations sur la France metropolitaine pour le taxon donne et remplit la carte
8
 * en changeant le style CSS des mailles en fonction des coordonnees des points d'observation.
9
 * Le format et la taille de la carte renvoyee au client est parametrable.
10
 *
11
 * Parametres :
12
 *   - referentiel : le referentiel taxonomique a interroger pour verifier le taxon. Pour l'instant,
13
 *     seul bdtfx (Tracheophytes de France metropolirtaine) est utilise par le web service
14
 *   - num_taxon : le numero taxonomique de la plante dont on veut obtenir la carte de repartition.
15
 *     Le rang des taxons traites par le web service sont la famille, le genre, l'espece et la sous-espece.
16
 *     La recherche des observations s'etend en pus sur les sous taxons et les synonymes.
17
 *   - source : une ou plusieurs sources de donnees a interroger. Si le parametre n'est pas indique,
18
 *     le web service ira rechercher les observatipons dans toutes les sources de donnees.
19
 *   - format : la largeur de la carte, exprimee dans une valeur entiere en pixels.
20
 *     Le ratio largeur:hauteur est conserve lors du redimensionnement de la carte pour le retour
21
 *   - retour : le type MIME (ou format de fichier) de retour. Sont acceptes par le web service
22
 *     le PNG (image/png) et le XML (text/html) pour renvoyer le web service
23
 *
24
 * @package framework-0.4
25
 * @author Alexandre GALIBERT <alexandre.galibert@tela-botanica.org>
26
 * @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
27
 * @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
28
 * @version $Id$
29
 * @copyright 2013 Tela Botanica (accueil@tela-botanica.org)
30
 *
31
 */
32
 
811 raphael 33
class MoissonnageCartes {
727 alex 34
 
35
	const MIME_MAP = "text/html";
36
	const MIME_PNG = "image/png";
37
 
38
	private $ressources;
39
	private $parametres;
40
 
41
	private $referentiel = '';
42
	private $taxon   = null;
43
	private $sources = array();
747 alex 44
	private $format  = 0;
727 alex 45
	private $retour  = self::MIME_MAP;
46
	private $erreurs = array();
47
 
48
 
49
	public function consulter($ressources, $parametres) {
50
		$this->parametres = $parametres;
51
		$this->ressources = $ressources;
52
		$resultat = null;
53
		$this->chargerClassesSousDossier();
54
		if ($this->analyserRessources() == true) {
55
			$resultat = $this->formerLegende();
56
		} else {
57
			$this->traiterParametres();
58
			$resultat = $this->formerCarte();
59
		}
60
		return $resultat;
61
	}
62
 
63
	private function analyserRessources() {
64
		$ok = false;
65
		if (isset($this->ressources[0]) && $this->ressources[0] == 'legende') {
66
			$ok = true;
67
		}
68
		return $ok;
69
	}
70
 
71
	private function formerLegende() {
72
		$legende = new LegendeCartes();
73
		$resultat = $legende->obtenirLegende();
74
		return $resultat;
75
	}
76
 
77
	private function chargerClassesSousDossier() {
78
		$this->verifierExistenceDossier("cartes");
79
		$nomDossier = dirname(__FILE__).DS."cartes";
80
		$dossier = opendir($nomDossier);
81
		$fichiersAInclure = array();
82
		while ($fichier = readdir($dossier)) {
83
			if (filetype($nomDossier.DS.$fichier) == 'file') {
84
				$fichiersAInclure[] = $nomDossier.DS.$fichier;
85
			}
86
		}
87
		$fichiersAInclure = array_reverse($fichiersAInclure);
88
		foreach ($fichiersAInclure as $fichier) {
89
			include_once($fichier);
90
		}
91
	}
92
 
93
	private function verifierExistenceDossier($nomDossier) {
94
		$dossier = dirname(__FILE__).DS.$nomDossier;
95
		if (!file_exists($dossier) || !is_dir($dossier)) {
96
			$message = "Problème rencontré lors de la génération de la carte : des ressources ".
97
				"nécessaires au fonctionnement du service n'ont pas été localisées sur le serveur.\n";
98
			throw new Exception($message);
99
		}
100
	}
101
 
102
	private function verifierExistenceFichier($nomFichier) {
103
		if (!file_exists($nomFichier)) {
104
			$message = "Problème rencontré lors de la génération de la carte : des ressources ".
105
				"nécessaires au fonctionnement du service n'ont pas été localisées sur le serveur.\n";
106
			throw new Exception($message);
107
		}
108
	}
109
 
110
	private function traiterParametres() {
111
		$this->verifierReferentielEtTaxon();
112
		$this->verifierParametreSource();
113
		$this->verifierParametreFormat();
114
		$this->verifierParametreRetour();
115
		if (count($this->erreurs) > 0) {
116
			$this->renvoyerErreurs();
117
		}
118
	}
119
 
120
	private function verifierParametreFormat() {
121
		if (!isset($this->parametres['format'])) {
122
			$this->erreurs[] = "Le paramètre format (dimensions) de l'image n'a pas été indiqué dans l'URL du service.";
123
		} elseif (preg_match('/^[1-9]\d{2}$/', $this->parametres['format']) != 1) {
124
			$this->erreurs[] = "La valeur du paramètre format n'est pas acceptée par le service. ".
125
				"Une largeur valide doit être un nombre entier compris entre 100 et 999.";
126
		} else {
127
			$this->format = $this->parametres['format'];
128
		}
129
	}
130
 
131
	private function verifierParametreRetour() {
132
		$typesMime = array(self::MIME_MAP, self::MIME_PNG);
133
		if (!isset($this->parametres['retour'])) {
134
			$this->erreurs[] = "Le paramètre type de retour de l'image n'a pas été indiqué dans l'URL du service.";
135
		} elseif (!in_array($this->parametres['retour'], $typesMime)) {
136
			$this->erreurs[] = "Le format de retour ".$this->parametres['retour']." n'est pas acceptée par le service. ".
137
				" Seuls les types MIME suivants sont gérés : ".implode(',', $typesMime);
138
		} else {
139
			$this->retour = $this->parametres['retour'];
140
		}
141
	}
142
 
143
	private function verifierParametreSource() {
144
		$sourcesDisponibles = explode(',', trim(Config::get('sourcesDonnees')));
145
		if (isset($this->parametres['source'])) {
146
			$sourcesParametre = explode(',', trim($this->parametres['source']));
147
			foreach ($sourcesParametre as $source) {
148
				if (!in_array($source, $sourcesDisponibles)) {
149
					$this->erreurs[] = "La source de données $source n'est pas disponible pour ce service. ".
150
						"Les sources suivantes sont utilisables : ".implode(',', $sourcesDisponibles).".";
151
				} else {
152
					$this->sources[] = $source;
153
				}
154
			}
155
		} else {
156
			$this->sources = $sourcesDisponibles;
157
		}
158
	}
159
 
160
	private function verifierReferentielEtTaxon() {
161
		if (!$this->estReferentielDisponible()) {
162
			$this->erreurs[] = "Le référentiel ".$this->parametres['referentiel']." n'a pas été trouvé. ".
163
				"La liste des référentiels disponibles pour ce service sont : ".Config::get('referentielsDispo');
164
		} else {
165
			$this->referentiel = $this->parametres['referentiel'];
166
			$taxon = $this->recupererInformationsTaxon();
167
			if (is_null($taxon)) {
168
				$this->erreurs[] = "Le taxon d'espèce que vous avez demandé n'a pas été trouvé dans le référentiel.";
169
			} else {
170
				$this->taxon = $taxon;
171
			}
172
		}
173
	}
174
 
175
	private function renvoyerErreurs() {
176
		$message = "Les erreurs suivantes ont été rencontrées : \n".implode('\n', $this->erreurs);
177
		throw new Exception($message, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
178
	}
179
 
180
	private function estReferentielDisponible() {
181
		$referentielsDispo = explode(',', Config::get('referentielsDispo'));
182
		$estDisponible = (isset($this->parametres['referentiel'])
183
			&& in_array($this->parametres['referentiel'], $referentielsDispo));
184
		return $estDisponible;
185
	}
186
 
187
	private function recupererInformationsTaxon() {
188
		$taxon = null;
189
		if (isset($this->parametres['num_taxon'])) {
190
			$numTaxon = $this->parametres['num_taxon'];
191
			$nomTable = $this->recupererNomTableReferentiel();
192
			$bdd = new Bdd();
193
			$requete = "SELECT num_nom, num_nom_retenu, nom_sci, rang, num_taxonomique FROM {$nomTable} ".
194
				"WHERE num_taxonomique={$numTaxon} ORDER BY If(num_nom=num_nom_retenu,0,1) LIMIT 0,1";
195
			$taxon = $bdd->recuperer($requete);
196
			if ($taxon === false) {
197
				$taxon = null;
198
			}
199
		}
200
		return $taxon;
201
	}
202
 
203
	private function recupererNomTableReferentiel() {
204
		$tablesReferentiel = explode(',', Config::get('bdd_table_referentiel'));
205
		$nomTable = '';
206
		foreach ($tablesReferentiel as $table) {
207
			if (strstr($table, $this->referentiel) !== false) {
208
				$nomTable = $table;
209
			}
210
		}
211
		return $nomTable;
212
	}
213
 
214
	private function formerCarte() {
215
		$suffixe = 'france_moissonnage';
216
		$nomFichierSVG = Config::get('chemin')."{$suffixe}.svg";
217
		$this->verifierExistenceFichier($nomFichierSVG);
218
 
219
		$formateur = new FormateurSVG($nomFichierSVG, $this->sources, $this->retour, $this->format);
220
		$formateur->formaterCarte($this->taxon);
221
		$resultat = new ResultatService();
222
		$resultat->corps = $formateur->renvoyerCarte();
223
		$resultat->mime = $this->retour;
224
 
225
		return $resultat;
226
	}
227
 
228
}
229
 
230
?>