Subversion Repositories eFlore/Applications.del

Compare Revisions

Ignore whitespace Rev 1806 → Rev 2171

/branches/v1.11-magnesium/services/modules/0.1/mots_cles/ListeMotsCles.php
New file
0,0 → 1,106
<?php
// declare(encoding='UTF-8');
/**
* Récupère des listes de mots clés associés aux images
*
* @category DEL
* @package Services
* @subpackage MotsCles
* @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 ListeMotsCles {
 
private $conteneur;
private $navigation;
private $bdd;
 
private $mapping = array();
private $mappingInverse = array();
 
public function __construct(Conteneur $conteneur = null) {
$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
$this->navigation = $conteneur->getNavigation();
$this->bdd = $this->conteneur->getBdd();
 
$this->mapping = $this->conteneur->getParametreTableau('mots-cles.mapping');
$this->mappingInverse = array_flip($this->mapping);
}
 
/**
* 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) {
// Lancement du service
$motsCles = $this->chargerMotsCles();
$total = $this->compterMotsClesTotal();
 
$motsClesSortie = $this->formaterMotsCles($motsCles);
$this->navigation->setTotal($total);
 
$resultat = new ResultatService();
$resultat->corps = array('entete' => $this->navigation->getEntete(), 'resultats' => $motsClesSortie);
return $resultat;
}
 
private function chargerMotsCles() {
$requete = 'SELECT DISTINCT SQL_CALC_FOUND_ROWS * '.
'FROM del_image_tag '.
'WHERE actif = 1 '.$this->creerClauseWhere().
'LIMIT '.$this->navigation->getDepart().','.$this->navigation->getLimite().' '.
' -- '.__FILE__.' : '.__LINE__;
$resultat = $this->bdd->recupererTous($requete);
return is_array($resultat) ? $resultat : array();
}
 
private function creerClauseWhere() {
$where = array();
$filtres = $this->navigation->getFiltre();
if (!empty($filtres)) {
foreach ($filtres as $cle => $valeur) {
$where[] = $this->mappingInverse[$cle].' = '.$this->bdd->proteger($valeur);
}
}
$clauseWhere = (!empty($where)) ? ' AND '.implode(' AND ', $where).' ' : '';
return $clauseWhere;
}
 
/**
* Compter le nombre total de commentaires dans la base vis à vis des filtres de l'url.
* Utilisation du mécanisme SQL_CALC_FOUND_ROW de Mysql pour éviter une deuxième requete avec un COUNT.
*/
private function compterMotsClesTotal() {
$requete = 'SELECT FOUND_ROWS() AS nbre ';
$resultats = $this->bdd->recuperer($requete);
return (int) $resultats['nbre'];
}
 
/**
* Formater les mots clés pour la sortie.
*
* @param $mots_cles les mots clés à formater
* @return $mots_cles les mots clés mis à jour au format de la sortie du web service
*/
private function formaterMotsCles($mots_cles) {
$retour = array();
foreach ($mots_cles as $mot_cle) {
// Boucle sur le mapping pour respecter l'ordre des champs de sortie
foreach ($this->mapping as $nomChampBdd => $nomAttributSortie) {
if (isset($mot_cle[$nomChampBdd])) {
$retour[$mot_cle['id_tag']][$nomAttributSortie] = $mot_cle[$nomChampBdd];
}
}
}
return $retour;
}
}
/branches/v1.11-magnesium/services/modules/0.1/mots_cles/SupprimerMotCle.php
New file
0,0 → 1,76
<?php
// declare(encoding='UTF-8');
/**
* Supprime un mot clé par son identifiant
*
* @category DEL
* @package Services
* @subpackage MotsCles
* @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 SupprimerMotCle {
 
private $conteneur;
private $bdd;
private $ressources = array();
private $motCleId;
 
public function __construct(Conteneur $conteneur = null) {
$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
$this->bdd = $this->conteneur->getBdd();
}
 
/**
* Supprime un mot-clé si les données fournis en paramètres sont valides.
*
* @param array $ressources les ressources situées après l'url de base (ex : http://url/ressource1/ressource2)
*/
public function supprimer($ressources) {
$this->ressources = $ressources;
$this->verifierRessources();
 
$this->motCleId = $this->ressources[0];
$this->supprimerMotCle();
TelaBotanica\Del\Commun\MotsClesImage::updateStats($this->bdd, $this->motCleId);
 
// Mettre en forme le résultat et l'envoyer pour affichage
$resultat = new ResultatService();
return $resultat;
}
 
private function verifierRessources() {
$erreurs = array();
 
if (!isset($this->ressources[0])) {
$erreurs[] = " - impossible de supprimer un mot clé sans l'identifiant associé ;";
} else if(!is_numeric($this->ressources[0])) {
$erreurs[] = " - l'identifiant de mot clé doit être un entier ;";
}
 
if (!empty($erreurs)) {
$msg = "Erreur de configuration :\n".implode("\n", $erreurs);
throw new Exception($msg, RestServeur::HTTP_CODE_ERREUR);
}
}
 
private function supprimerMotCle() {
$idMotCleP = $this->bdd->proteger($this->motCleId);
$requete = 'UPDATE del_image_tag '.
'SET actif = 0, date_modification = NOW() '.
"WHERE id_tag = $idMotCleP ".
' -- '.__FILE__.' : '.__LINE__;
$retour = $this->bdd->executer($requete);
if ($retour == null) {
$msg = "Erreur lors de la suppression du mot-clé d'id $idMotCleP";
throw new Exception($msg, RestServeur::HTTP_CODE_ERREUR);
}
return $retour;
}
}
/branches/v1.11-magnesium/services/modules/0.1/mots_cles/AjouterMotCle.php
New file
0,0 → 1,120
<?php
// declare(encoding='UTF-8');
/**
* Ajoute un ou plusieurs mots-clés en les associant à un identifiant d'image
*
* @category DEL
* @package Services
* @subpackage MotsCles
* @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 AjouterMotCle {
 
private $conteneur;
private $bdd;
private $parametres = array();
private $idDernierAjout = null;
private $nbreMotsClesAjoutes = null;
 
public function __construct(Conteneur $conteneur = null) {
$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
$this->bdd = $this->conteneur->getBdd();
}
 
/**
* Ajoute un mot-clé si les objets fournis en paramètres sont valides
* 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 ajouter($ressources, $parametres) {
$this->parametres = $parametres;
 
// Gestion des configuration du script
$this->verifierParametres();
$this->insererMotCle();
TelaBotanica\Del\Commun\MotsClesImage::updateStats($this->bdd, $this->parametres['image']);
 
// Mettre en forme le résultat et l'envoyer pour affichage
$resultat = new ResultatService();
$resultat->corps = array('nbre' => $this->nbreMotsClesAjoutes, 'id' => $this->idDernierAjout);
 
return $resultat;
}
 
public function verifierParametres() {
$erreurs = array();
 
if (!isset($this->parametres['image'])) {
$erreurs[] = " - impossible d'ajouter un mot clé sans l'indication de l'identifiant de l'image associée";
} else if(!is_numeric($this->parametres['image'])) {
$erreurs[] = " - l'identifiant d'image doit être un entier";
}
 
if (!isset($this->parametres['mot_cle'])) {
$erreurs[] = " - impossible d'ajouter un mot clé sans le mot clé";
}
 
if (!isset($this->parametres['auteur.id'])) {
$erreurs[] = " - impossible d'ajouter un mot clé sans l'identifiant de l'auteur associé";
}
 
if (!empty($erreurs)) {
$msg = "Erreur de configuration :\n".implode("\n", $erreurs);
throw new Exception($msg, RestServeur::HTTP_CODE_MAUVAISE_REQUETE);
}
}
 
/**
* Insère un mot clé dans la table
* */
private function insererMotCle() {
$clauseValues = $this->creerClauseValues();
$requete = 'INSERT INTO del_image_tag '.
'(ce_image, ce_utilisateur, tag, tag_normalise, date, actif, date_modification) '.
"VALUES $clauseValues ".
' -- '.__FILE__.' : '.__LINE__;
$nbreInsertion = $this->bdd->executer($requete);
$idDernierAjout = $this->bdd->recupererIdDernierAjout();
if ($nbreInsertion == null) {
$msgTpl = "Erreur lors de l'insertion d'un des tags «%s» pour l'image «%s» de l'auteur «%s»";
$msg = sprintf($msgTpl, $this->parametres['mot_cle'], $this->parametres['image'], $this->parametres['auteur.id']);
throw new Exception($msg, RestServeur::HTTP_CODE_ERREUR);
}
$this->nbreMotsClesAjoutes = $nbreInsertion;
$this->listerIdAjoutes($idDernierAjout, $nbreInsertion);
}
 
private function listerIdAjoutes($dernierId, $nbreInsertion) {
$this->idDernierAjout[] = $dernierId;
for ($i = 1 ; $i <= ($nbreInsertion - 1); $i++ ) {
$this->idDernierAjout[] = ++$dernierId;
}
}
 
private function creerClauseValues() {
$id_image = intval($this->parametres['image']);
$idImageP = $this->bdd->proteger($id_image);
$id_auteur = $this->parametres['auteur.id'];
$idAuteurP = $this->bdd->proteger($id_auteur);
$mots_cles = explode(',', $this->parametres['mot_cle']);
 
$values = array();
foreach ($mots_cles as $mot_cle) {
$motCleP = $this->bdd->proteger(trim($mot_cle));
$mot_cle_normalise = TelaBotanica\Del\Commun\MotsClesImage::normaliserMotCle($mot_cle);
$motCleNormaliseP = $this->bdd->proteger($mot_cle_normalise);
 
$values[] = "($idImageP, $idAuteurP, $motCleP, $motCleNormaliseP, NOW(), 1, NOW())";
}
$clauseValues = implode(',', $values);
return $clauseValues;
}
}