/branches/v1.7-oxygene/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; |
} |
} |
/branches/v1.7-oxygene/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.7-oxygene/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; |
} |
} |