Subversion Repositories eFlore/Applications.del

Compare Revisions

Ignore whitespace Rev 2217 → Rev 2218

/trunk/services/modules/0.1/tepik/ListeImages.php
New file
0,0 → 1,148
<?php
// declare(encoding='UTF-8');
/**
* Listes des images avec leurs infos liées.
*
* del/services/0.1/images?navigation.depart=0&navigation.limite=12&tri=votes&ordre=desc
* del/services/0.1/images?navigation.depart=0&navigation.limite=12&tri=votes&ordre=desc&masque=plop
* del/services/0.1/images?navigation.depart=0&navigation.limite=12&tri=votes&ordre=desc&protocole=3
* del/services/0.1/images?navigation.depart=0&navigation.limite=12&tri=votes&ordre=desc&protocole=3&masque=plop
*
* @category DEL
* @package Services
* @subpackage Images
* @version 0.1
* @author Mathias CHOUET <mathias@tela-botanica.org>
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Aurelien PERONNET <aurelien@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>
* @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org>
*/
 
//restore_error_handler();
//restore_exception_handler();
//error_reporting(E_ALL);
class ListeImages {
 
private $conteneur;
private $bdd;
private $filtrage;
private $sql;
private $navigation;
private $paramsFiltres = array();
private $mappings = array();
private $idsImagesOrdonnees = array();
private $infosImages = array();
private $infosImagesOrdonnees = array();
 
public function __construct(Conteneur $conteneur) {
$this->conteneur = $conteneur;
$this->bdd = $this->conteneur->getBdd();
$this->filtrage = $this->conteneur->getParametresFiltrage();
$this->sql = $this->conteneur->getSql();
$this->navigation = $this->conteneur->getNavigation();
 
$this->mappings['observations'] = $this->conteneur->getParametreTableau('observations.tepik');
$this->mappings['images'] = $this->conteneur->getParametreTableau('images.mapping');
}
 
public function consulter($ressources, $parametres) {
$this->paramsFiltres = $this->filtrage->filtrerUrlParamsAppliImg();
$this->sql->setAppli(Sql::APPLI_IMG);
$this->sql->setParametres($this->paramsFiltres);
$this->sql->ajouterContraintes();
$this->sql->ajouterConstrainteAppliImg();
$this->sql->definirOrdreSqlAppliImg();
 
$this->idsImagesOrdonnees = $this->getIdImages();
$this->navigation->setTotal($this->sql->getTotalLignesTrouvees());
 
// Ce n'est pas la peine de continuer s'il n'y a pas eu de résultats
$resultat = new ResultatService();
$resultat->corps = array('entete' => $this->navigation->getEntete(), 'resultats' => array());
if (count($this->idsImagesOrdonnees) > 0) {
$this->infosImages = $this->getInfosImages();
$this->infosImagesOrdonnees = $this->formaterImages();
 
// Chargement des votes pour ces images et pour *tous* les protocoles
$votes = $this->sql->getVotesDesImages($this->idsImagesOrdonnees);
if ($votes) {
// ATTENTION : $images est récupéré par référence !
$this->sql->ajouterInfosVotesProtocoles($votes, $this->infosImagesOrdonnees);
}
 
$resultat->corps = array(
'entete' => $this->navigation->getEntete(),
'resultats' => array_values($this->infosImagesOrdonnees));
}
return $resultat;
}
 
private function getIdImages() {
$requete = 'SELECT SQL_CALC_FOUND_ROWS DISTINCT di.id_image '.
'FROM del_image AS di '.
$this->sql->getJoin().
'WHERE '.$this->sql->getWhere().
$this->sql->getGroupBy().
$this->sql->getOrderBy().
$this->sql->getLimit().
' -- '.__FILE__.':'.__LINE__;
// TODO : si le DISCTINCT dans la requête pose des pb de perf, supprimer les doublons d'id à l'aide de PHP
//Debug::printr($requete);exit();
$resultats = $this->bdd->recupererTous($requete);
$idImgs = array();
if ($resultats !== false ) {
foreach ($resultats as $resultat) {
$idImgs[] = $resultat['id_image'];
}
}
return $idImgs;
}
 
private function getInfosImages() {
// Traitement du champ mots clés text à part pour éviter un écrasement des mots
// clés img par ceux de l'obs
// TODO: gérer ce problème pour tous les champs où ça peut arriver
$mot_cles_texte_concat = "di.mots_cles_texte as mots_cles_texte_img";
$obsChamps = $this->sql->getAliasDesChamps($this->mappings['observations'], null, 'do');
$imgChamps = $this->sql->getAliasDesChamps($this->mappings['images'], null, 'di');
$idImgsConcat = implode(',', $this->idsImagesOrdonnees);
 
$requete = "SELECT $obsChamps, $imgChamps, $mot_cles_texte_concat ".
'FROM del_image AS di '.
' LEFT JOIN del_observation AS do ON (di.ce_observation = do.id_observation) '.
"WHERE di.id_image IN ($idImgsConcat) ".
'-- '.__FILE__.':'.__LINE__;
//Debug::printr($requete);
return $this->bdd->recupererTous($requete);
}
 
// cf Observation::reformateObservationSimpleIndex() et ListeObservations::reformateObservation()
// (trop de variétés de formatage, à unifier côté client pour unifier côté backend ...)
private function formaterImages() {
$urlImgTpl = $this->conteneur->getParametre('cel_img_url_tpl');
$imageFormat = isset($this->paramsFiltres['format']) ? $this->paramsFiltres['format'] : 'XL';
$obsFormatees = array_flip($this->idsImagesOrdonnees);// Permet de garder l'ordre de sortie !
foreach ($this->infosImages as $infos) {
$id = $infos['id_image'];
// ainsi nous utilisons deux tableaux: le final, indexé par couple d'id(image-obs)
// et celui indexé par simple id_image qui est fort utile pour mapVotesToImages()
// mais tout deux partage leur référence à "protocole"
$image = array(
'id_image' => $id,
'binaire.href' => sprintf($urlImgTpl, $infos['id_image'], $imageFormat),
'mots_cles_texte' => isset($infos['mots_cles_texte_img']) ? $infos['mots_cles_texte_img'] : null,
);
unset($infos['id_image'], $infos['mots_cles_texte'], $infos['mots_cles_texte_img']);
 
$obsFormatees[$id] = $image;
$obsFormatees[$id]['observation'] = $infos;
$obsFormatees[$id]['protocoles_votes'] = array();
}
return $obsFormatees;
}
 
 
}
/trunk/services/modules/0.1/tepik/VotesImage.php
New file
0,0 → 1,120
<?php
// declare(encoding='UTF-8');
/**
* Le web service image récupère toutes les données de la table del_obs_images
* pour retourner une liste d'images associée à une observation
*
* @category DEL
* @package Services
* @subpackage Images
* @version 0.1
* @author Mathias CHOUET <mathias@tela-botanica.org>
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @author Aurelien PERONNET <aurelien@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>
* @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org>
*/
 
class VotesImage {
 
private $conteneur;
private $navigation;
private $bdd;
private $mapping = array();
private $ressources;
private $parametres;
 
public function __construct(Conteneur $conteneur) {
$this->conteneur = $conteneur;
$this->navigation = $conteneur->getNavigation();
$this->bdd = $this->conteneur->getBdd();
 
$this->mapping = $this->conteneur->getParametreTableau('votes.tepik');
}
 
/**
* Méthode principale de la classe.
* Lance la récupération des images dans la base et les place dans un objet ResultatService
* pour l'afficher.
* @param array $ressources les ressources situées après l'url de base (ex : http://url/ressource1/ressource2)
* @param array $parametres les paramètres situés après le ? dans l'url
* */
public function consulter($ressources, $parametres) {
$this->ressources = $ressources;
$this->parametres = $parametres;
 
// Lancement du service
$votes = $this->chargerVotes();
$total = $this->compterVotes();
$this->navigation->setTotal($total);
 
// Mettre en forme le résultat et l'envoyer pour affichage
$resultat = new ResultatService();
$resultat->corps = array('entete' => $this->navigation->getEntete(), 'resultats' => $votes);
return $resultat;
}
 
private function chargerVotes() {
$idImgP = $this->bdd->proteger($this->ressources[0]);
$idProtocoleP = isset($this->parametres['protocole']) ? $this->bdd->proteger($this->parametres['protocole']) : null;
$requete = 'SELECT * FROM del_image_vote '.
"WHERE ce_image = $idImgP ".
($idProtocoleP != null ? "AND ce_protocole = $idProtocoleP " : '').
' -- '.__FILE__.' : '.__LINE__;
$resultats = $this->bdd->recupererTous($requete);
return $this->formaterVotes($resultats);
}
 
private function compterVotes() {
$requete = 'SELECT FOUND_ROWS() AS nbre -- '.__FILE__.' : '.__LINE__;
$resultats = $this->bdd->recuperer($requete);
return (int) $resultats['nbre'];
}
 
private function formaterVotes($votes) {
$retour = array();
foreach ($votes as $vote) {
foreach ($vote as $champ => $valeur) {
$attribut = $this->mapping[$champ];
$retour[$vote['id_vote']][$attribut] = $valeur;
}
}
return $retour;
}
 
private function verifierAutorisationProtocoleIdentifie($idProtocole, $idUtilisateur) {
$idProtocoleP = $this->bdd->proteger($idProtocole);
$gestion_utilisateur = $this->conteneur->getUtilisateur();
$utilisateur = $gestion_utilisateur->getUtilisateur();
$utilisateurAComparer = $gestion_utilisateur->getIdAnonymeTemporaire();
// Si l'utilisateur n'est pas identifié on vérifie que le protocole n'impose
// pas d'être connecté pour voter, et le cas échéant, on refuse le vote
if(!$utilisateur['connecte']) {
$requete_proto_identifie = 'SELECT identifie FROM del_image_protocole '.
'WHERE id_protocole = '.$idProtocoleP;
$proto_identifie = $this->bdd->recuperer($requete_proto_identifie);
if($proto_identifie['identifie'] == 1) {
$msg = "Ce protocole nécéssite d'être identifié pour voter.";
throw new Exception($msg, RestServeur::HTTP_CODE_ERREUR);
}
} else {
$utilisateurAComparer = $utilisateur['id_utilisateur'];
}
// Sinon on vérifie tout de même que la personne identifiée est bien celle
// associée aux votes dans les paramètres
if($utilisateurAComparer != $idUtilisateur) {
$msg = "L'utilisateur identifié et l'utilisateur du vote ne correspondent pas.";
throw new Exception($msg, RestServeur::HTTP_CODE_ERREUR);
}
}
 
}
/trunk/services/modules/0.1/Tepik.php
1,36 → 1,36
<?php
// declare(encoding='UTF-8');
/**
* Classe principale de chargement des services Observations.
* Classe principale de chargement des sous-services "images" de DEL.
*
* Cette classe se charge toujours de :
* - vérifier l'existance des ressources (services) demandés
* - vérifier la cohérence et le format des paramêtres passées dans l'url
* En fonction, de la compléxité du service, elle peut :
* - dans un premier temps, exécuter directement les actions : consulter, ajouter, modifier, supprimer.
* - dans un second temps, charger dynamiquement d'éventuelles sous-classes du service en fonction des ressources présentes dans l'URL.
*
* URLs possibles :
* GET :
* http://localhost/service:del:0.1/observations
* toutes les observations (infos obs, infos images, infos propositions, infos nb commentaires)
* http://localhost/del/services/0.1/images/ => toutes les images : classe ListeImages
* http://localhost/del/services/0.1/images/#idImg/votes => tous les votes d'une image (#idImg) classés par protocole : classe VotesImage
*
* http://localhost/service:del:0.1/observations?retour.format=widget
* toutes les infos des observations pour le Widget DEL
* Non Implémenté : http://localhost/del/services/0.1/images/#id => une image donnée => en test pour remplacer les appels à eflore/cel
* 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é
*
* http://localhost/service:del:0.1/observations/#idObs
* une observation donnée et ses images, SANS LES propositions & nombre de commentaire*
*
* http://localhost/service:del:0.1/observations/#idObs/#idVote/vote
* toutes les infos sur les votes d'une proposition
*
* PUT :
* http://localhost/service:del:0.1/observations/#idObs/#idCommentaire/vote
* ajoute un vote (+ ou -) pour une obs et une proposition donnée
* http://localhost/del/services/0.1/images/#idImg => ajouter un vote sur une image donnée (#idImg)
*
* POST :
* http://localhost/service:del:0.1/observations/#idObs
* utilisé seulement par les admins pour modifier une obs depuis DEL (dépublication des obs)
* http://localhost/del/services/0.1/images/#idImg => modifier un vote sur une image donnée (#idImg)
*
* http://localhost/service:del:0.1/observations/#idObs/#idCommentaire/vote
* modifie un vote (+ ou -) pour une obs et une proposition donnée
* DELETE :
* http://localhost/del/services/0.1/images/#idImg => supprimer une image donnée (#idImg)
* http://localhost/del/services/0.1/images/#idImg/votes/#idVote => supprimer un vote (#idVote) d'une image donnée (#idImg)
*
* @category DEL
* @package Services
* @subpackage Observations
* @subpackage Images
* @version 0.1
* @author Mathias CHOUET <mathias@tela-botanica.org>
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
39,22 → 39,25
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
* @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org>
*/
restore_error_handler();
restore_exception_handler();
error_reporting(E_ALL);
 
class Tepik extends RestService {
 
private $conteneur;
private $cheminCourant;
private $parametres = array();
private $ressources = array();
private $methode = null;
private $methode;
private $serviceNom = 'tepik';
private $sousServiceNom = null;
private $cheminCourant = null;
private $sousServiceNom;
 
private $conteneur;
 
/** Indique si oui (true) ou non (false), on veut utiliser les paramètres bruts. */
protected $utilisationParametresBruts = true;
 
public function __construct() {
$this->conteneur = new Conteneur();
$this->cheminCourant = dirname(__FILE__).DS;
}
 
65,26 → 68,23
}
 
 
private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
$this->ressources = $ressources;
$this->parametres = $parametres;
}
 
private function executerService() {
$resultat = $this->traiterRessources();
if ($resultat === true || $resultat === false) {
return $resultat;
}
 
$reponseHttp = new ReponseHttp();
try {
$this->conteneur = new Conteneur($this->parametres);
$resultat = $this->traiterRessources();
$reponseHttp->setResultatService($resultat);
} catch (Exception $e) {
$reponseHttp->ajouterErreur($e);
}
$reponseHttp->setResultatService($resultat);
$reponseHttp->emettreLesEntetes();
$corps = $reponseHttp->getCorps();
return $corps;
return $reponseHttp->getCorps();
}
 
private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
$this->ressources = $ressources;
$this->parametres = $parametres;
}
 
private function traiterRessources() {
$this->analyserRessources();
$retour = $this->initialiserService();
94,37 → 94,27
private function analyserRessources() {
if ($this->methode == 'consulter') {
$this->analyserRessoucesConsultation();
}
}
 
private function analyserRessoucesConsultation() {
if (count($this->ressources) == 0) {
// http://localhost/service:del:0.1/observations
$this->sousServiceNom = 'liste-observations';
} else if (count($this->ressources) == 1) {
if ($this->etreRessourceIdentifiant(0)) {
// http://localhost/service:del:0.1/observations/#idObs
$this->sousServiceNom = 'observation-details';
}
}
} else if ($this->methode == 'modifier' || $this->methode == 'ajouter') {
$this->analyserRessoucesModification();
} else if ($this->methode == 'supprimer') {
$this->analyserRessoucesSuppression();
}
if ($this->sousServiceNom == null) {
$this->lancerMessageErreurRessource();
}
}
 
private function analyserRessoucesModification() {
if (count($this->ressources) == 1) {
if ($this->methode == 'modifier' && $this->etreRessourceIdentifiant(0)) {
// http://localhost/service:del:0.1/observations/#idObs
$this->sousServiceNom = 'observation-details';
private function analyserRessoucesConsultation() {
if (count($this->ressources) == 0) {
$this->sousServiceNom = 'liste-images';
} else if (count($this->ressources) == 2) {
if ($this->etreRessourceIdentifiant(0) && $this->verifierRessourceValeur(1, 'votes')) {
$this->sousServiceNom = 'votes-image';
}
}
if ($this->sousServiceNom == null) {
$this->lancerMessageErreurRessource();
}
}
 
 
private function etreRessourceIdentifiant($num) {
$presenceId = false;
if (isset($this->ressources[$num]) && is_numeric($this->ressources[$num])) {
141,26 → 131,22
return $ok;
}
 
private function verifierParametreValeur($cle, $valeur) {
$ok = false;
if (isset($this->parametres[$cle]) && $this->ressources[$cle] == $valeur) {
$ok = true;
}
return $ok;
}
 
private function lancerMessageErreurRessource() {
$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
$message = "La ressource demandée '$ressource' ".
"n'est pas disponible pour le service ".$this->serviceNom." !\n".
"Les URLs disponibles sont : \n".
" - en GET : observations, observations/#idObs/#idProposition/vote \n".
" - en POST : observations/#id, observations/#idObs/#idProposition/vote \n".
" - en PUT : observations/#idObs/#idProposition/vote \n";
$this->getDoc();
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
 
public function getDoc() {
return "Les URLs disponibles sont : \n".
" * en GET : \n".
" - images => toutes les images\n".
" - images/#idImg/votes => tous les votes d'une image (#idImg) classés par protocole\n";
}
 
private function initialiserService() {
$classe = $this->obtenirNomClasseService($this->sousServiceNom);
$chemins = array();
174,21 → 160,15
$service = new $classe($this->conteneur);
if ($this->methode == 'consulter') {
$retour = $service->consulter($this->ressources, $this->parametres);
} else {
$message = "Le sous-service '{$this->sousServiceNom}' du service '{$this->serviceNom}' ".
"ne possède pas de méthode '{$this->methode}' !";
$code = RestServeur::HTTP_NON_IMPLEMENTE;
throw new Exception($message, $code);
}
}
}
}
 
if (is_null($service)) {
$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
$message = "Le classe '$classe' correspondant à la ressource '$ressource' ".
"n'existe pas dans le service '{$this->serviceNom}' !";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
$ressource = implode('/', $this->ressources);
$msg = "Le classe '$classe' correspondant à la ressource '$ressource' ".
"n'existe pas dans le service '{$this->serviceNom}' !\n".$this->getDoc();
throw new Exception($msg, RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE);
}
return $retour;
}