Subversion Repositories eFlore/Applications.del

Rev

Rev 1818 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
1617 mathias 1 
<?php
1820 jpm 2 
// declare(encoding='UTF-8');
1617 mathias 3 
/**
1818 jpm 4 
 * Accès aux sous-services de statistiques pour Identiplante / Pictoflora
1795 jpm 5 
 *
1818 jpm 6 
 * @see Documentation : <http://www.tela-botanica.org/wikini/DevInformatiques/wakka.php?wiki=AppliDelStats>
1795 jpm 7 
 *
8 
 * @category   DEL
9 
 * @package    Services
10 
 * @subpackage Statistiques
11 
 * @version    0.1
12 
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
13 
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
14 
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
15 
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
16 
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
17 
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
18 
 */
1617 mathias 19 
class Statistiques extends RestService {
20 
 
1818 jpm 21 
	private $parametres = array();
22 
	private $ressources = array();
23 
	private $methode = null;
24 
	private $serviceNom = 'statistiques';
25 
	private $sousServiceNom = null;
26 
	private $cheminCourant = null;
1617 mathias 27 
 
1818 jpm 28 
	private $conteneur;
29 
 
30 
	/** Indique si oui (true) ou non (false), on veut utiliser les paramètres bruts. */
31 
	protected $utilisationParametresBruts = true;
32 
 
1617 mathias 33 
	public function __construct() {
1818 jpm 34 
		$this->cheminCourant = dirname(__FILE__).DS;
1617 mathias 35 
	}
36 
 
37 
	public function consulter($ressources, $parametres) {
1818 jpm 38 
		$this->methode = 'consulter';
39 
		$this->initialiserRessourcesEtParametres($ressources, $parametres);
40 
		return $this->executerService();
41 
	}
1617 mathias 42 
 
1818 jpm 43 
	private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
44 
		$this->ressources = $ressources;
45 
		$this->parametres = $parametres;
46 
	}
1617 mathias 47 
 
1818 jpm 48 
	private function executerService() {
49 
		$reponseHttp = new ReponseHttp();
50 
		try {
51 
			$this->conteneur = new Conteneur($this->parametres);
52 
			$resultat = $this->traiterRessources();
53 
			$reponseHttp->setResultatService($resultat);
54 
		} catch (Exception $e) {
55 
			$reponseHttp->ajouterErreur($e);
1617 mathias 56 
		}
57 
		$reponseHttp->emettreLesEntetes();
58 
		$corps = $reponseHttp->getCorps();
59 
		return $corps;
60 
	}
61 
 
1818 jpm 62 
	private function traiterRessources() {
63 
		$this->analyserRessources();
64 
		$retour = $this->initialiserService();
65 
		return $retour;
1617 mathias 66 
	}
67 
 
1818 jpm 68 
	private function analyserRessources() {
69 
		if ($this->methode == 'consulter') {
70 
			$this->sousServiceNom = 'statistiques-par-annee';
71 
		}
72 
		if ($this->sousServiceNom == null) {
73 
			$this->lancerMessageErreurRessource();
74 
		}
1617 mathias 75 
	}
76 
 
1818 jpm 77 
	private function lancerMessageErreurRessource() {
78 
		$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
79 
		$message = "La ressource demandée '$ressource' ".
80 
			"n'est pas disponible pour le service {$this->serviceNom} !\n".
81 
			self::getDoc();
82 
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
83 
		throw new Exception($message, $code);
1788 mathias 84 
	}
85 
 
1818 jpm 86 
	public static function getDoc() {
87 
		return "Les URLs disponibles pour ce service sont :\n".
88 
			" * en GET :\n".
89 
			" - statistiques/tout\n".
90 
			" - statistiques/moyenneObsSansNomParMois\n".
91 
			" - statistiques/moyenneObsIdentifieesParMois\n".
92 
			" - statistiques/pourcentageObsIdentifieesEnFinDAnnee\n".
93 
			" - statistiques/pourcentageObsIdentifieesEnFinDAnneePlusPlus\n".
94 
			" - statistiques/moyenneActionsParJour\n".
95 
			" - statistiques/personnesEnvoyantUnePropositionParMois\n";
1617 mathias 96 
	}
97 
 
1818 jpm 98 
	private function initialiserService() {
99 
		$classe = $this->obtenirNomClasseService($this->sousServiceNom);
100 
		$chemins = array();
101 
		$chemins[] = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php';
102 
		$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php';
103 
		$retour = '';
104 
		$service = null;
1788 mathias 105 
 
1818 jpm 106 
		foreach ($chemins as $chemin) {
107 
			if (file_exists($chemin)) {
108 
				require_once $chemin;
109 
				$service = new $classe($this->conteneur);
110 
				if ($this->methode == 'consulter') {
111 
					$retour = $service->consulter();
112 
				} else {
113 
					$message = "Le sous-service '{$this->sousServiceNom}' du service '{$this->serviceNom}' ".
114 
						"ne possède pas de méthode '{$this->methode}' !";
115 
					$code = RestServeur::HTTP_NON_IMPLEMENTE;
116 
					throw new Exception($message, $code);
117 
				}
1788 mathias 118 
			}
119 
		}
1624 mathias 120 
 
1818 jpm 121 
		if (is_null($service)) {
122 
			$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
123 
			$message = "Le classe '$classe' correspondant à la ressource '$ressource' ".
124 
				"est introuvable par le service '{$this->serviceNom}' !";
125 
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
126 
			throw new Exception($message, $code);
1788 mathias 127 
		}
1818 jpm 128 
		return $retour;
1624 mathias 129 
	}
130 
 
1818 jpm 131 
	private function obtenirNomClasseService($mot) {
132 
		$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot))));
133 
		return $classeNom;
1617 mathias 134 
	}
1795 jpm 135 
}