Subversion Repositories eFlore/Applications.del

<?php

/**

 * Web service retournant toutes les infos d'une observation donnée :

 * images, votes sur image et protocole, commentaires, votes sur commentaires, ...

 *

 * @category	DEL

 * @package		Observations

 * @version		0.1

 * @author		Raphaël Droz <raphael@tela-botanica.org>

 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>

 * @copyright	Copyright (c) 2013, Tela Botanica (accueil@tela-botanica.org)

 * @license		GPL v3 <http://www.gnu.org/licenses/gpl.txt>

 * @license		CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>

 * @see			http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Observations

 *

 * @config-depend: "url_image" (dans configurations/config_observations.ini) ex: http://www.tela-botanica.org/appli:cel-img:%09dXL.jpg

 */

// http://localhost/del/services/0.1/observations/#id => une observation donnée et ses images, SANS LES propositions & nombre de commentaire

require_once(dirname(__FILE__) . '/../DelTk.php');

class ObservationDetails {

	private $conteneur;

	private $bdd;

	private $sql;

	private $idObs;

	private $protocole;

	private $observation;

	private $mappings = array();

	public function __construct(Conteneur $conteneur) {

		$this->conteneur = $conteneur;

		$this->bdd = $this->conteneur->getBdd();

		$this->sql = $this->conteneur->getSql();

		$this->mappings['observations'] = $this->conteneur->getParametreTableau('observations.mapping');

		$this->mappings['images'] = $this->conteneur->getParametreTableau('images.mapping');

		$this->mappings['votes'] = $this->conteneur->getParametreTableau('votes.mapping');

		$this->mappings['commentaires'] = $this->conteneur->getParametreTableau('commentaires.mapping');

		// les deux alias suivants sont particuliers afin d'éviter un conflit d'alias lors des jointures avec del_commentaire_vote

		$this->mappings['commentaires']['ce_utilisateur'] = '__auteur_com';

		$this->mappings['commentaires']['date'] = '__date_com';

	}

	public function consulter($ressources, $parametres) {

		$this->idObs = $ressources[0];

		$this->protocole = isset($parametres['protocole']) && is_numeric($parametres['protocole']) ? intval($parametres['protocole']) : null;

		// 1) récupération de l'observation (et de ses images (v_del_image est une vue utilisant des INNER JOIN))

		$infos = $this->getInfosObservationEtImages();

		if (! $infos) {

			$message = "Aucune observation ne possède d'identifiant '{$this->idObs}'.";

			throw new Exception($message, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);

		}

		$this->formaterObservation($infos);

		//var_dump($this->observation);

		// 3) charge les données de votes et protocoles associés aux images

		if ($this->observation['images']) {

			$idsImages = array_keys($this->observation['images']);

			$votes = $this->sql->getVotesDesImages($idsImages, $this->protocole);

			$this->sql->ajouterInfosVotesProtocoles($votes, $this->observation['images']);

		}

		// 4) charge les commentaires et les votes associés -> modifie/créé $observation['commentaires']

		$commentaires = $this->getCommentaires();

		$this->ajouterCommentaires($commentaires);

		// désindexe le tableau (tel qu'apparement attendu par les applis), c'est une exception

		// TODO : corriger l'appli cliente pour utiliser les index puis supprimer cette ligne

		$this->observation['images'] = array_values($this->observation['images']);

		// autre élément de post-processing: le ce_utilisateur de l'observation non-numeric...

		$this->nettoyerAuteur();

		// Mettre en forme le résultat et l'envoyer pour affichage

		$resultat = new ResultatService();

		$resultat->corps = $this->observation;

		return $resultat;

	}

	private function getInfosObservationEtImages() {

		$obsChamps = $this->sql->getAliasDesChamps($this->mappings['observations'], null, 'dob');

		$imgChamps = $this->sql->getAliasDesChamps($this->mappings['images'], null, 'dob');

		// champs de l'annuaire (del_utilisateur): id_utilisateur prenom, nom, courriel

		$annuaireChamps = implode(', ', array(

			"IFNULL(du.prenom, prenom_utilisateur) AS `auteur.prenom`",

			"IFNULL(du.nom, nom_utilisateur) AS `auteur.nom`",

			"IFNULL(du.courriel, courriel_utilisateur) AS `auteur.courriel`"));

		$requete = "SELECT $obsChamps, $imgChamps, $annuaireChamps ".

			"FROM v_del_image as dob ".

			"LEFT JOIN del_utilisateur AS du ".

			"	ON CAST(du.id_utilisateur AS CHAR) = CAST(dob.ce_utilisateur AS CHAR) ".

			"WHERE dob.id_observation = {$this->idObs} ".

			'-- '.__FILE__.':'.__LINE__;

		//var_dump($requete);

		return $this->bdd->recupererTous($requete);

	}

	private function formaterObservation($infos) {

		$urlImgTpl = $this->conteneur->getParametre('cel_img_url_tpl');

		$imageFormat = 'XL';

		$infos = array_map('array_filter', $infos);

		foreach ($infos as $info) {

			$image = array_intersect_key($info, array_flip(array('id_image', 'date', 'hauteur' , 'largeur', 'nom_original')));

			$image['binaire.href'] = sprintf($urlImgTpl, $image['id_image'], $imageFormat);

			unset($info['id_image'], $info['date'], $info['hauteur'], $info['largeur'], $info['nom_original']);

			if (!isset($this->observation)) $this->observation = $info;

			$this->observation['images'][$image['id_image']] = $image;

		}

	}

	private function getCommentaires() {

		$selectVotes = array('id_vote', 'ce_proposition', 'ce_utilisateur', 'valeur', 'date');

		$selectCommentaires = array('id_commentaire', 'ce_observation', 'ce_proposition', 'ce_commentaire_parent', 'texte',

			'ce_utilisateur', 'utilisateur_prenom', 'utilisateur_nom', 'utilisateur_courriel',

			'nom_sel', 'nom_sel_nn', 'nom_ret', 'nom_ret_nn', 'nt', 'famille', 'nom_referentiel', 'date',

			'proposition_initiale');

		$voteChamps = $this->sql->getAliasDesChamps($this->mappings['votes'], $selectVotes, 'cv');

		$commentaireChamps = $this->sql->getAliasDesChamps($this->mappings['commentaires'], $selectCommentaires, 'dc');

		// LEFT JOIN optionnel, mais explicatif : récupèration des infos de vote que pour les commentaires comportant un nom_sel "valide"

		$requete = "SELECT $commentaireChamps, $voteChamps ".

			"FROM del_commentaire AS dc ".

			"	LEFT JOIN del_commentaire_vote AS cv ".

			"	ON (cv.ce_proposition = dc.id_commentaire AND dc.nom_sel != '' AND dc.nom_sel IS NOT NULL) ".

			"WHERE ce_observation = {$this->idObs} ".

			'-- '.__FILE__.':'.__LINE__;

		$commentaires = $this->bdd->recupererTous($requete);

		return $commentaires;

	}

	private function ajouterCommentaires($commentaires) {

		if (!$commentaires) return;

		$ret = array();

		foreach ($commentaires as $comment) {

			$commentId = $comment['id_commentaire'];

			$voteId = $comment['vote.id'];

			if (!array_key_exists($commentId, $ret)) {

				$comment_extract = array_intersect_key($comment, array_flip($this->mappings['commentaires']));

				// cas particulier: conflit d'aliases avec del_commentaire_vote

				$comment_extract['auteur.id'] = $comment_extract['__auteur_com'];

				$comment_extract['date'] = $comment_extract['__date_com'];

				unset($comment_extract['__auteur_com'], $comment_extract['__date_com']);

				// toujours un éléments "votes", quand bien même il n'y en aurait pas

				$comment_extract['votes'] = array();

				$ret[$commentId] = $comment_extract;

			}

			if (!$comment['nom_sel'] || ! $voteId) continue;

			$vote = array_intersect_key($comment, array_flip($this->mappings['votes']));

			$ret[$commentId]['votes'][$voteId] = $vote;

		}

		$this->observation['commentaires'] = $ret;

	}

	private function nettoyerAuteur() {

		if (!is_numeric($this->observation['auteur.id'])) {

			$this->observation['auteur.id'] = '0';

		}

		if (!isset($this->observation['auteur.nom'])) {

			$this->observation['auteur.nom'] = '[inconnu]';

		}

	}

	/**

	 * Modifie une observation directement dans le CEL en faisant un appel à un web service du CEL.

	 * Utilisé uniquement par les admins.

	 * Permet de dépublier une observation.

	 *

	 * @param array		$ressources tableau des informations contenues dans l'url après le nom du service

	 * @param array		$parametres contenu du post

	 * @return mixed	Chaine "OK" (en majuscule) en cas de succès, booléen "false" en cas d'échec

	 */

	public function modifier($ressources, $parametres) {

		$controlAcces = $this->conteneur->getControleAcces();

		$controlAcces->etreUtilisateurAvecDroitAdmin();

		$retour = false;

		if (isset($parametres['transmission'])) {

			$idObs = $ressources[0];

			$clientRest = $this->conteneur->getRestClient();

			$urlTpl = $this->conteneur->getParametre('urlServiceCelObs');

			$url = $urlTpl.$idObs;

			$retourCel = $clientRest->modifier($url, $parametres);

			$retour = preg_match('/^OK$/i', $retourCel) ? 'OK' : false;

			if ($retour === false) {

				$message = "Erreur du web service CEL : ".$retourCel;

				$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;

				throw new Exception($message, $code);

			}

		} else {

			$message = "Ce web service doit contenir un paramètre 'transmission'.";

			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;

			throw new Exception($message, $code);

		}

		return $retour;

	}

}