| New file |
|---|
| 0,0 → 1,332 |
|---|
| <?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 php 5.2 |
| * @package del |
| * @subpackage images |
| * @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
| * @copyright Copyright (c) 2012, Tela Botanica (accueil@tela-botanica.org) |
| * @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
| * @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL |
| * @version $Id: Bdd.php 403 2012-02-22 14:35:20Z gduche $ |
| * @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Images |
| */ |
| |
| class VotesImage { |
| |
| private $imageIds = array(); |
| private $conteneur; |
| private $navigation; |
| private $masque; |
| protected $gestionBdd; |
| protected $bdd; |
| private $ressources; |
| private $parametres; |
| |
| public function __construct(Conteneur $conteneur = null) { |
| $this->conteneur = $conteneur == null ? new Conteneur() : $conteneur; |
| $this->conteneur->chargerConfiguration('config_votes.ini'); |
| $this->conteneur->chargerConfiguration('config_mapping_votes.ini'); |
| $this->navigation = $conteneur->getNavigation(); |
| $this->masque = $conteneur->getMasque(); |
| $this->gestionBdd = $conteneur->getGestionBdd(); |
| $this->bdd = $this->gestionBdd->getBdd(); |
| } |
| |
| /** |
| * 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) { |
| // Gestion des configuration du script |
| $this->ressources = $ressources; |
| $this->parametres = $parametres; |
| $this->configurer(); |
| $this->verifierConfiguration(); |
| |
| // 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->conteneur->getEntete(), 'resultats' => $votes); |
| return $resultat; |
| } |
| |
| public function ajouter($ressources, $parametres) { |
| |
| $this->verifierParametresAjoutModif($ressources, $parametres); |
| |
| $insertion = 'INSERT INTO del_image_vote '. |
| '(ce_image, ce_protocole, ce_utilisateur, valeur, date) '. |
| 'VALUES ('. |
| $this->proteger($ressources[0]).','. |
| $this->proteger($parametres['protocole']).','. |
| $this->proteger($parametres['utilisateur']).','. |
| $this->proteger($parametres['valeur']).', '. |
| 'NOW()'. |
| ');'; |
| |
| $resultat = $this->bdd->requeter($insertion); |
| if ($resultat == false) { |
| throw new Exception($e, RestServeur::HTTP_CODE_ERREUR); |
| } else { |
| $retour = $this->bdd->recupererIdDernierAjout(); |
| |
| $resultat = new ResultatService(); |
| $resultat->corps = array('id_vote' => $retour); |
| |
| self::updateStats($this->bdd, $ressources[0],$parametres['protocole']); |
| |
| return $resultat; |
| } |
| } |
| |
| public function modifier($ressources, $parametres) { |
| |
| $this->verifierParametresAjoutModif($ressources, $parametres); |
| |
| //TODO: est il nécessaire de tester si ça existe et renoyer une erreur 404 |
| // si l'on vote ? Cela peut ralentir considérablement les choses |
| // une contrainte d'unicité sur le triplet image, protocole, vote existe, |
| // ça suffira pour provoquer une erreur 500 |
| $modification = 'UPDATE del_image_vote '. |
| 'SET valeur = '.$this->proteger($parametres['valeur']).', '. |
| ' date = NOW() '. |
| 'WHERE '. |
| 'ce_image = '.$this->proteger($ressources[0]).' AND '. |
| 'ce_protocole = '.$this->proteger($parametres['protocole']).' AND '. |
| 'ce_utilisateur = '.$this->proteger($parametres['utilisateur']).' '; |
| $resultat = $this->bdd->requeter($modification); |
| if ($resultat == false) { |
| throw new Exception($e, RestServeur::HTTP_CODE_ERREUR); |
| } else { |
| self::updateStats($this->bdd, $ressources[0],$parametres['protocole']); |
| RestServeur::envoyerEnteteStatutHttp(RestServeur::HTTP_CODE_OK); |
| } |
| } |
| |
| public function supprimer($ressources) { |
| |
| $id_image = $ressources[0]; |
| $id_vote = $ressources[2]; |
| $id_vote_p = $this->proteger($id_vote); |
| |
| $requete_infos_vote = 'SELECT * FROM del_image_vote '. |
| 'WHERE id_vote = '.$id_vote_p; |
| |
| $infos_vote = $this->bdd->recuperer($requete_infos_vote); |
| if ($infos_vote == false) { |
| throw new Exception("Aucun vote ne correspond à cet identifiant", RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE); |
| } |
| |
| $controle_acces = new ControleAcces($this->conteneur); |
| $utilisateur = $controle_acces->getInfosUtilisateurConnecte(); |
| |
| if($utilisateur['id_utilisateur'] != $infos_vote['ce_utilisateur'] && |
| $controle_acces->getIdAnonymeTemporaire() != $infos_vote['ce_utilisateur']) { |
| throw new Exception("Vous n'êtes pas autorisé à supprimer ce vote", |
| RestServeur::HTTP_CODE_ACCES_NON_AUTORISE); |
| } |
| |
| $suppression = 'DELETE FROM del_image_vote '. |
| 'WHERE id_vote = '.$id_vote_p; |
| |
| $resultat = $this->bdd->requeter($suppression); |
| if ($resultat == false) { |
| throw new Exception("Impossible de supprimer le vote", RestServeur::HTTP_CODE_ERREUR); |
| } else { |
| self::updateStats($this->bdd, $ressources[0],$infos_vote['ce_protocole']); |
| } |
| } |
| |
| static function updateStats($db, $id_image, $id_proto) { |
| $id_image = intval($id_image); |
| $id_proto = intval($id_proto); |
| if(!$id_image || !$id_proto) throw new Exception("Ne peut mettre à jour les statistiques de vote", |
| RestServeur::HTTP_CODE_ERREUR); |
| /* REPLACE ... SELECT: réinitalise les champs non-défini (MySQL 5.1) |
| REPLACE ... SET a=b, c=d: idem ou plusieurs requête |
| Du coup il faut récupérer les données actuelles mais REPLACE ne le permet pas |
| (http://dev.mysql.com/doc/refman/5.5/en/replace.html : |
| You cannot refer to values from the current row and use them in the new row.) |
| D'où INSERT ... ON DUPLICATE KEY UPDATE. Notons que VALUES() récupère la valeur |
| *associée* au champ passé en paramètre, c'est à dire VALUES(moyenne) == divo.moyenne */ |
| $db->requeter(sprintf('INSERT INTO del_image_stat (ce_image, ce_protocole, moyenne, nb_votes)'. |
| ' SELECT ce_image, ce_protocole, AVG(valeur) AS moyenne, COUNT(valeur) AS nb_votes'. |
| ' FROM del_image_vote divo'. |
| ' WHERE ce_image = %d AND ce_protocole = %d GROUP BY ce_image, ce_protocole'. |
| ' ON DUPLICATE KEY UPDATE moyenne = VALUES(moyenne), nb_votes = VALUES(nb_votes)', |
| $id_image, $id_proto)); |
| |
| |
| } |
| |
| /*------------------------------------------------------------------------------- |
| CONFIGURATION DU SERVICE |
| --------------------------------------------------------------------------------*/ |
| /** |
| * Configuration du service en fonction du fichier de config config_del.ini |
| * */ |
| public function configurer() { |
| $this->mappingFiltre = $this->conteneur->getParametre('mapping_masque'); |
| $this->mappingVotes = $this->conteneur->getParametre('mapping_votes'); |
| } |
| |
| /** |
| * Vérifier que le service est bien configuré |
| * */ |
| public function verifierConfiguration() { |
| |
| $erreurs = array(); |
| $tableauImages = $this->conteneur->getParametre('images'); |
| if (empty($tableauImages)) { |
| $erreurs[] = '- le fichier de configuration ne contient pas le tableau [images] ou celui-ci est vide ;'; |
| } else { |
| if ($this->conteneur->getParametre('url_service') == null) { |
| $erreurs[] = '- paramètre "url_service" manquant ;'; |
| } |
| } |
| |
| if (empty($this->mappingVotes)) { |
| $erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_votes] ou celui-ci est vide ;'; |
| } else { |
| $champsMappingObs = array('ce_protocole','id_vote','valeur','ce_image', 'ce_utilisateur', 'nom', 'prenom'); |
| foreach ($champsMappingObs as $champ) { |
| if (!isset($this->mappingVotes[$champ])) { |
| $erreurs[] = '- le mapping du champ "'.$champ.'" pour le vote est manquant ;'; |
| } |
| } |
| } |
| |
| |
| if (!empty($erreurs)) { |
| $e = 'Erreur lors de la configuration : '."\n"; |
| $e .= implode("\n", $erreurs); |
| throw new Exception($e, RestServeur::HTTP_CODE_ERREUR); |
| } |
| } |
| |
| |
| public function verifierParametresAjoutModif($ressources, $parametres) { |
| $erreurs = array(); |
| if (!is_numeric($ressources[0])) { |
| $erreurs[] = '- le paramètre indiquant l\'identifiant de l\'image doit être numérique ;'; |
| } |
| |
| if (!isset($parametres['utilisateur'])) { |
| $erreurs[] = '- paramètre "utilisateur" manquant ;'; |
| } |
| |
| if (!isset($parametres['protocole'])) { |
| $erreurs[] = '- paramètre "id_protocole" manquant ;'; |
| } else { |
| if (!is_numeric($parametres['protocole'])) { |
| $erreurs[] = '- le paramètre "protocole" doit être numérique ;'; |
| } |
| } |
| |
| if (!isset($parametres['valeur'])) { |
| $erreurs[] = '- paramètre "valeur" manquant ;'; |
| } else { |
| if (!is_numeric($parametres['valeur'])) { |
| $erreurs[] = '- le paramètre "valeur" doit être numérique ;'; |
| } |
| } |
| |
| if (!empty($erreurs)) { |
| $e = 'Erreur lors de la configuration : '."\n"; |
| $e .= implode("\n", $erreurs); |
| throw new Exception($e, RestServeur::HTTP_CODE_ERREUR); |
| } |
| } |
| |
| public function verifierParametresSuppression($ressources, $parametres) { |
| $erreurs = array(); |
| if (!is_numeric($ressources[0])) { |
| $erreurs[] = '- le paramètre indiquant l\'identifiant de l\'image doit être numérique ;'; |
| } |
| |
| /*if (!is_numeric($parametres['id_protocole'])) { |
| $erreurs[] = '- le paramètre indiquant l\'identifiant du vote doit être numérique ;'; |
| }*/ |
| |
| if (!empty($erreurs)) { |
| $e = 'Erreur lors de la configuration : '."\n"; |
| $e .= implode("\n", $erreurs); |
| throw new Exception($e, RestServeur::HTTP_CODE_ERREUR); |
| } |
| } |
| |
| /** |
| * Charger la clause WHERE en fonction des paramètres de masque |
| * */ |
| private function chargerClauseWhere() { |
| $where[] = 'WHERE ce_image = '.$this->proteger($this->ressources[0]); |
| if (isset($this->parametres['protocole'])) { |
| $where[] = 'ce_protocole = '.$this->proteger($this->parametres['protocole']); |
| } |
| return implode(' AND ', $where); |
| } |
| /*------------------------------------------------------------------------------- |
| CHARGEMENT DES IMAGES |
| --------------------------------------------------------------------------------*/ |
| /** |
| * Charger les votes pour chaque image |
| * */ |
| private function chargerVotes() { |
| $requeteVotes = 'SELECT * FROM '. |
| $this->gestionBdd->formaterTable('del_image_vote'). |
| $this->chargerClauseWhere(); |
| $resultatsVotes = $this->bdd->recupererTous($requeteVotes); |
| $votes = $this->formaterVotes($resultatsVotes); |
| return $votes; |
| } |
| |
| /** |
| * Compter le nombre total d'images dans la base pour affichage dans entete. |
| * */ |
| private function compterVotes() { |
| $requete = 'SELECT FOUND_ROWS() AS nbre '; |
| $resultats = $this->bdd->recuperer($requete); |
| return (int) $resultats['nbre']; |
| } |
| |
| |
| /*------------------------------------------------------------------------------- |
| FORMATER ET METTRE EN FORME |
| --------------------------------------------------------------------------------*/ |
| |
| /** |
| * Formater une observation depuis une ligne liaison |
| * @param $liaison liaison issue de la recherche |
| * @return $observation l'observation mise en forme |
| * */ |
| private function formaterVotes($votes) { |
| $retour = array(); |
| foreach ($votes as $vote) { |
| foreach ($vote as $p=>$valeur) { |
| $retour[$vote['id_vote']][$this->mappingVotes[$p]] = $valeur; |
| } |
| } |
| |
| return $retour; |
| } |
| |
| private function proteger($valeur) { |
| if (is_array($valeur)) { |
| return $this->bdd->protegerTableau($valeur); |
| } else { |
| return $this->bdd->proteger($valeur); |
| } |
| } |
| } |
| ?> |