/trunk/services/modules/0.1/coste/A_LIRE.txt |
---|
New file |
0,0 → 1,8 |
Ce projet contient les services suivant : |
- Noms |
- Taxons |
- Images |
- Textes |
Il faut ajouter des services supplémentaire à lier depuis le projet commun : |
- Aide |
- MetaDonnees |
Property changes: |
Added: svn:eol-style |
+native |
\ No newline at end of property |
Added: svn:executable |
+* |
\ No newline at end of property |
/trunk/services/modules/0.1/coste/Images.php |
---|
New file |
0,0 → 1,391 |
<?php |
class Images extends Commun { |
protected $limite_requete = array('depart' => 0, 'limite' => 100); |
protected $requete_champ = '*'; |
protected $requete_condition = null; |
protected $requete_group_by = ' ORDER BY CAST( id_image AS DECIMAL )'; |
protected $entete_http; |
protected $corps_http; |
protected $table_retour; |
protected $retour_format = 'max'; |
protected $format_reponse = 'images'; |
protected $table_param = array(); |
protected $total_resultat; |
protected $table_ressources = array(); |
protected $html = 'txt'; |
protected $recherche = 'stricte'; |
protected $service = 'images'; |
public function consulter($ressources, $parametres) { |
$resultat_formate = ''; |
$this->table[] = Config::get("bdd_images"); //." t1,".Config::get("bdd_triples")." t2, ".Config::get("bdd_pages")." p"; |
$this->traiterParametres($parametres); |
$this->traiterRessources($ressources); |
if ($this->corps_http == '' && $this->entete_http == '') { |
$requete = $this->assemblerLaRequete(); |
$resultat = $this->getBdd()->recupererTous($requete); |
$this->testerResultat($resultat, $resultat_formate, $requete); |
} |
return $this->formerReponseHTTP($resultat_formate); |
} |
public function testerResultat($resultat, &$resultat_formate, $requete) { |
if ($resultat == '') { //cas ou coste/services/ ou la requete comporte des erreurs |
$e = 'La requête SQL formée comporte une erreur!'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,$e); |
Debug::printr($requete); |
} elseif ($resultat) { |
$resultat_formate = $this->retournerResultatFormate($resultat); |
} else { |
if ($this->format_reponse == 'images/relations') { |
$resultat_formate = 'null'; |
} else { |
$m = 'Données introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,$m); |
Debug::printr($requete); |
} |
} |
} |
//-------------------------------------------------------TRAITER RESSOURCES---------------------------------------------- |
public function traiterRessources(&$ressources) { |
if (isset($ressources) && !empty($ressources)) { |
$this->table_ressources = $ressources; |
//traiter ressources/id |
if ($ressources[0] == 'relations') { |
$this->traiterRelationsProjet($ressources); |
$this->format_reponse .= '/relations'; |
} elseif (isset($this->table_ressources[0]) && !empty($this->table_ressources[0])) { |
$this->traiterRessourceId($this->table_ressources[0]); |
//traiter ressources/id/champ |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
$this->format_reponse .= '/id/champ'; |
} |
} |
} |
} |
public function traiterRelationsProjet($tab_ress) { |
$projet = $tab_ress[1]; |
$num_nom = $tab_ress[2]; |
if (isset($tab_ress[3])) { |
$e = "Pas de type pour le service images"; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e); |
} |
$this->requete_condition[] = "num_nom = ".$this->getBdd()->proteger($num_nom); |
} |
public function traiterRessourceId($id) { |
$this->format_reponse .= '/id'; |
$this->requete_condition[] = 'id_image LIKE '.$this->getBdd()->proteger($id.'.png'); |
} |
//-------------------------------------------------------TRAITER PARAMETRES---------------------------------------------- |
public function traiterParametres($parametres) { |
if (isset($parametres) && !empty($parametres)) { |
$this->table_param = $parametres; |
//print_r($parametres); |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $val) { |
switch ($param) { |
case 'retour_format' : $this->retour_format = $val; break; |
case 'masque_nn' : $this->ajouterLeFiltreMasque('num_nom', $val); break; |
case 'masque_no' : $this->ajouterLeFiltreMasque('nom_photographe', $val); break; |
case 'masque_ns' : $this->ajouterLeFiltreMasque('nom_sci', $val); break; |
case 'masque_date' : $this->ajouterLeFiltreMasque('date', $val); break; |
case 'masque_station' : $this->ajouterLeFiltreMasque('station', $val); break; |
case 'navigation_depart': $this->limite_requete['depart'] = $val; break; |
case 'navigation_limite': $this->limite_requete['limite'] = $val; break; |
case 'recherche' : break; |
default : |
$e = 'Erreur dans les paramètres de recherche de votre requête : </br> Le parametre " ' |
.$param.' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,$e); |
break; |
} |
} |
} |
} |
public function ajouterLeFiltreMasque($masque, $valeur) { |
if ($this->recherche == 'etendue') { |
$valeur = '%'.str_replace(' ','%', $valeur).'%'; |
} |
//$this->table .= ', '.Config::get("bdd_table").'_v0_1 c'; |
switch ($masque) { |
case 'nom_sci' : |
$this->requete_champ = 'cb.*'; |
$this->table[] = ' cb , '.Config::get("bdd_table").'_v0_1 c'; |
$this->requete_condition[] = 'c.nom_sci LIKE ' |
.$this->getBdd()->proteger($valeur); |
$this->requete_condition[] = 'c.num_nom_coste = CONCAT(cb.id_image,\',.png\')'; |
$this->ajouterRechercheFloue('nom_sci', $valeur); |
break; |
case 'num_nom' : |
$val = (strrpos($valeur, ',') !== false)? " IN (".str_replace(',', '.png,', $valeur).")" : " = ".$this->getBdd()->proteger($valeur.".png"); |
$this->requete_condition[] = "id_image $val"; |
break; |
default : |
break; |
} |
} |
public function ajouterRechercheFloue($nom_champ, $id) { |
if ($this->recherche == 'floue') { |
$id = $this->getBdd()->proteger($id); |
$this->requete_condition[array_search("$nom_champ LIKE $id", |
$this->requete_condition)] = |
"($nom_champ LIKE $id)". |
" OR ( SOUNDEX($nom_champ) = SOUNDEX($id))". |
" OR SOUNDEX(REVERSE($nom_champ)) = SOUNDEX(REVERSE($id))))"; |
} |
} |
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE----------------------------------------------------- |
public function assemblerLaRequete() { |
$requete = ' SELECT '.$this->requete_champ. |
' FROM '.implode(', ', $this->table) |
.$this->formerRequeteCondition() |
.$this->requete_group_by |
.$this->formerRequeteLimite(); |
return $requete; |
} |
public function formerRequeteCondition() { |
$condition = ''; |
if ($this->requete_condition !== null) { |
$condition = ' WHERE '.implode(' AND ', $this->requete_condition); |
} |
return $condition; |
} |
public function formerRequeteLimite() { |
if (in_array($this->format_reponse , array('images/id', 'images/id/relations'))) { |
$this->requete_limite = ''; |
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) { |
$this->limite_requete['depart'] = |
(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']); |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} else { |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} |
return $this->requete_limite; |
} |
/** |
* Recupere le nombre total de résultat d'une requete lancée. |
* Est utilisée lors de l'affichage du total dans le résultat retourné et pr déterminer les limites et départ |
* @return nombre total de résultat |
*/ |
public function recupererTotalResultat() { |
$total = null; |
$requete = 'SELECT count(*) as nombre FROM '.implode(', ', $this->table).$this->formerRequeteCondition().$this->requete_group_by; |
$res = $this->getBdd()->recuperer($requete); |
if ($res) { |
$total = $res['nombre']; |
} else { |
$e = 'Données introuvables dans la base ou erreur dans la requête SQL'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e); |
} |
return $total; |
} |
//-------------------FONCTIONS POUR LE FORMATAGE EN JSON---------------------------------------------------------------- |
public function retournerResultatFormate($resultat) { |
$reponse = ''; |
switch ($this->format_reponse) { |
case 'images' : $reponse = $this->formaterImages($resultat); break; |
case 'images/relations' : $reponse = $this->formaterImagesRelations($resultat[0]); break; |
case 'images/id' : $reponse = $this->formaterImagesId($resultat[0]); break; |
case 'images/id/champ' : $reponse = $this->formaterImagesIdChamp($resultat[0]); break; |
default : break; |
} |
$reponse = json_encode($reponse); |
return $reponse; |
} |
public function formaterImages($resultat) { |
//print_r($resultat); |
$this->ajouterEnteteResultat($resultat); |
$reponse['entete'] = $this->table_retour; |
$this->table_retour = array(); |
foreach ($resultat as $images) { |
$id = str_replace('.png', '', $images['id_image']); |
$id_coste = $this->recupererNumNom($id); |
if ($id != '') { |
$this->table_retour['url.image'] = Config::get('url_images').$images['id_image']; |
$this->afficherDonnees('id', $id_coste); |
$reponse['resultat'][$id] = $this->table_retour; |
$this->table_retour = array(); |
$reponse['resultat'][$id]['href'] = $this->ajouterHref('images', $id); |
} |
} |
return $reponse; |
} |
public function ajouterEnteteResultat($resultat) { |
$this->table_retour['depart'] = $this->limite_requete['depart']; |
$this->table_retour['limite'] = $this->limite_requete['limite']; |
$this->table_retour['total'] = $this->total_resultat; |
//formuler les urls |
$url = $this->formulerUrl($this->total_resultat, '/'.$this->service); |
if ($url['precedent'] != '') { $this->table_retour['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $this->table_retour['href.suivant'] = $url['suivant']; } |
} |
public function formaterImagesRelations($resultat) { |
$reponse['url.image'] = Config::get('url_images').$resultat['id_image']; |
return $reponse; |
} |
public function formaterImagesId($resultat) { |
$id = str_replace('.png', '', $resultat['id_image']); |
$id_coste = $this->recupererNumNom($id); |
$this->table_retour['url.image'] = Config::get('url_images').$resultat['id_image']; |
$this->table_retour['id'] = $id; |
$this->table_retour['auteur'] = $resultat['auteur']; |
$this->table_retour['station.pays'] = "ISO-3166-1.FR"; |
$this->afficherDonnees('id', $id_coste); |
$res = $this->ajouterRelationBdnff($resultat['num_nom']); |
return $res; |
} |
public function recupererNumNom($num_nom_coste) { |
$req = "SELECT num_nom FROM coste_v0_1 WHERE num_nom_coste = " |
.$this->getBdd()->proteger($num_nom_coste)." AND num_nom = num_nom_retenu"; |
$res = $this->getBdd()->recuperer($req); |
if ($res) { |
$num_nom = $res['num_nom']; |
} |
return $num_nom; |
} |
public function ajouterRelationBdnff($num_nom) { |
$res = $this->table_retour; |
$this->table_retour = array(); |
$this->afficherDonnees('id', $num_nom, 'bdtfx'); |
$res['relations']['nom'] = $this->table_retour; |
return $res; |
} |
public function formaterImagesIdChamp($resultat) { |
//on recupère tous les resultats possibles |
$reponse_id = $this->formaterImagesId($resultat); |
$this->table_retour = array(); |
//on recupère les résultats demandés à partir du tableau de résultat complet |
$this->table_retour['id'] = $resultat['tag']; |
$champs = explode(' ', $this->table_ressources[1]); |
foreach ($champs as $champ) { |
if ($this->verifierValiditeChamp($champ, $reponse_id)) { |
if (preg_match('/^[^.]+\.\*$/', $champ)) { |
$this->afficherPointEtoile($champ, $reponse_id); |
} else { |
$this->table_retour[$champ] = $reponse_id[$champ]; |
} |
} |
} |
return $this->table_retour; |
} |
public function afficherPointEtoile($champ, $reponse_id) { |
preg_match('/^([^.]+\.)\*$/', $champ, $match); |
foreach ($reponse_id as $chp => $valeur) { |
if (strrpos($chp, $match[1]) !== false) { |
$this->table_retour[$chp] = $valeur; |
} |
} |
} |
public function verifierValiditeChamp($champ, $reponse_id) { |
$validite = false; |
preg_match('/^([^.]+)(:?\.([^.]+))?$/', $champ, $match); |
if (array_key_exists($match[1], $reponse_id)) { |
$validite = true; |
if (isset($match[2]) && !empty($match[2])) { |
if ($match[1] == 'type') { |
$suffixes = array('.code', '.href', '.*'); |
$validite = (in_array($match[2], $suffixes)) ? true : false; |
} else { |
$validite = false; |
} |
} |
} |
if (!$validite) { |
$champs = implode('</li><li>', array_keys($reponse_id)); |
$e = 'Erreur dans votre requête : </br> Le champ "'.$champ.'" n\'existe pas. Les champs disponibles |
sont : <li>'.$champs.'</li>'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e); |
} |
return $validite; |
} |
//------------------------------------------------Fonction d'affichage ------------------------------------------------ |
public function afficherDonnees($champ, $valeur, $projet = null) { |
if ($this->retour_format == 'min') { |
$champ = ($champ == 'type') ? $champ.'.code' : $champ; |
$this->table_retour[$champ] = $valeur; |
} else { |
$this->afficherDonneesMax($champ, $valeur, $projet); |
} |
} |
public function afficherDonneesMax($champ, $valeur, $projet = null) { |
if (!$projet) $projet = 'coste'; |
if ($champ == 'id') { |
$this->table_retour['nom_sci.id'] = $projet.'.'.$valeur; |
$fct = "recupererNomSci".ucfirst($projet); |
$this->table_retour['nom_sci'] = $this->$fct($valeur); |
$this->table_retour['nom_sci.href'] = $this->ajouterHrefAutreProjet('noms', '', $valeur, $projet); |
} elseif (in_array($champ, array('type'))) { |
$this->table_retour[$champ.'.code'] = $valeur; |
$this->table_retour[$champ] = $this->recupererSignificationCode($valeur); |
$this->table_retour[$champ.'.href'] = $this->ajouterHrefAutreProjet($champ, '', $valeur, 'commun'); |
} else { |
$this->table_retour[$champ] = $valeur; |
} |
} |
public function recupererSignificationCode($code) { |
$url = $this->ajouterHrefAutreProjet('ontologies', 'texteType:', $code.'/nom', 'commun'); |
$res = $this->consulterHref($url); |
return $res->nom; |
} |
public function recupererNomSciCoste($id) { |
$req = 'SELECT nom_sci FROM coste_v0_1 WHERE num_nom = '.$id; |
if ($this->html == 'htm') { |
$req = str_replace('nom_sci', 'nom_sci_html as nom_sci', $req); |
} |
$res = $this->getBdd()->recuperer($req); |
return $res['nom_sci']; |
} |
public function recupererNomSciBdtfx($id) { |
$req = 'SELECT flore_bdnff_nom_sci FROM coste_v0_1 WHERE flore_bdnff_num = '.$id; |
$res = $this->getBdd()->recuperer($req); |
return $res['flore_bdnff_nom_sci']; |
} |
} |
?> |
/trunk/services/modules/0.1/coste/CommunNomsTaxons.php |
---|
New file |
0,0 → 1,785 |
<?php |
abstract class CommunNomsTaxons extends Commun { |
protected $table_param = array(); /** Permet de stocker le tableau des parametres (= $parametres) */ |
protected $table_ressources = array(); /** Permet de stocker le tableau des ressources (= $ressources) */ |
protected $table_retour; /** Permet de stocker le tableau de résultat (non encodé en json)*/ |
protected $resultat_req; /** Permet de stocker le résultat de la requete principale. */ |
/** Permet de stocker sous forme de tableau les composant du nom à ajouter au nom scientifique (fonction du paramètre ns.structure) */ |
protected $compo_nom; |
protected $ordre_masque = array('masque', 'masque_sg', 'masque_gen', 'masque_sp', 'masque_ssp', 'masque_au', |
'masque_an', 'masque_bib', 'masque_ad', 'masque_nn', 'masque_rg' ); |
protected $tab_nom_sci = array('nom_supra_generique', 'genre', 'epithete_infra_generique', 'epithete_sp', |
'type_epithete', 'epithete_infra_sp', 'cultivar_groupe', 'cultivar', 'nom_commercial'); |
protected $retour_format = 'max'; |
protected $html = 'txt'; /** Valeur du paramètre de requete ns.format */ |
protected $table_version; /** Stocke les noms des tables de toutes les versions du projet disponibles */ |
/** Nom de la table dans laquelle on récupèrera les données (remplace Config::get('bdd_table') dans les requetes SQL */ |
protected $table; |
protected $total_resultat = null; |
/** Stocke le service appelé correspondant. Est utilisé principalement lors de l'affichage du href d'un synonyme |
(ex id=12, basionyme num 25 est un synonyme) dans le service taxon */ |
protected $service_href = null; |
//----------------------------------Fonctions d'analyse des ressources-------------------------------------------------- |
/** Permet de remplir la variable version_projet et de retirer cette donnée du tableau des ressources */ |
public function traiterVersionProjet(&$ressources) { |
if (isset($ressources) && !empty($ressources)) { |
if (preg_match('/(?:[0-9]+(?:_|[.])[0-9]+|[*])/', $ressources[0])) { |
$this->version_projet = array_shift($ressources); |
$this->version_projet = str_replace('_', '.', $this->version_projet); |
} else { |
if ($ressources[0] == ' ') array_shift($ressources); //si un + a été ajouté |
$this->version_projet = '+'; |
} |
} |
//si la liste des noms est demandée pr toutes les versions, on affiche seulement la dernière version pour : |
// - la liste des noms et taxons: /noms et /taxons |
// - la liste des taxons inferieurs/supérieur : /taxons/relations/inferieurs et /taxons/relations/superieurs |
// - la liste des relations : /taxons/relations ou /noms/relations |
if ($this->version_projet == '*' && ($ressources == array() |
|| (isset($ressources[1]) && $ressources[1] == 'relations' && isset($ressources[2]) && in_array($ressources[2], array('superieurs', 'inferieurs'))) |
|| (isset($ressources[1]) && $ressources[1] == 'relations' && !isset($ressources[2])) )) { |
$this->version_projet = '+'; |
} |
//on recupère les versions du projet disponible dans la table des meta-donnees (utilisation service MetaDonnees) |
$table_num_version = $this->recupererVersionDisponible(); |
//on recupere la liste des noms des tables de la bdd correspondant aux differentes versions du projet en fct de la ou les versions demandées |
$this->recupererListeNomTablePrChaqueVersion($table_num_version); |
} |
public function traiterRessources($ressources) { |
$this->table_ressources = $ressources; |
if (isset($ressources) && !empty($ressources)) { |
if ($this->estUnIdentifiant()) { //l'identifiant peut etre de type /#id ou /nt:#id |
$this->traiterRessourcesIdentifiant(); // dans le service noms ou taxons |
} elseif ($this->table_ressources[0] == 'stats') { //ressource = noms/stats |
$this->traiterRessourcesStats(); |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requete </br> Ressources disponibles : <br/> |
<li> /'.$this->service.'/#id (id : L\'identifiant du nom rechercher)</li> |
<li> /'.$this->service.'/nt:#id (id : Numero du taxon recherche)</li> |
<li> /'.$this->service.'/stats </li>' ); |
} |
} |
} |
public function traiterRessourcesStats() { |
$this->format_reponse = $this->service.'/stats'; |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
switch ($this->table_ressources[1]) { |
case 'annees' : |
$this->traiterRessourceStatsAnnees(); |
break; |
case 'rangs' : |
$this->traiterRessourceStatsRangs(); |
break; |
case 'initiales' : |
$this->traiterRessourceStatsInitiales(); |
break; |
default : |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requete </br> Ressources disponibles : <br/> |
<li> /'.$this->service.'/stats/annees </li> |
<li> /'.$this->service.'/stats/rangs </li> |
<li> /'.$this->service.'/stats/initiales </li>' ); |
break; |
} |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requete </br> Ressources disponibles : <br/> |
<li> /'.$this->service.'/stats/annees </li> |
<li> /'.$this->service.'/stats/rangs </li> |
<li> /'.$this->service.'/stats/initiales </li>' ); |
} |
} |
/** Vérifie si la première valeur de la table de ressource est un identifiant : un numerique ou un numéro |
* taxonomique sous la forme nt:xx */ |
public function estUnIdentifiant() { |
return (is_numeric($this->table_ressources[0]) || (strrpos($this->table_ressources[0],'nt:') !== false |
&& is_numeric(str_replace('nt:','',$this->table_ressources[0])))); |
} |
//---------------------------------------------Fonction d'analyse des parametres---------------------------------------- |
/** Permet de remplir le tableau compo_nom. Il comprendra en fct du paramètre ns.structure les éléments à rajouter |
* au nom_sci (annee, auteur, biblio ou addendum).*/ |
public function remplirTableCompositionNom($valeur) { |
$structure_nom = explode(",",$valeur); |
foreach ($structure_nom as $structure) { |
switch ($structure) { |
case 'au' : $this->compo_nom['au'] = 'auteur'; break; |
case 'an' : $this->compo_nom['an'] = 'annee'; break; |
case 'bib' : $this->compo_nom['bib'] = 'biblio_origine'; break; |
case 'ad' : $this->compo_nom['ad'] = 'nom_addendum'; break; |
default : $this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur : Le parametre "'.$structure.'" n\'existe pas. <br/><br/> |
Les parametres du nom possibles sont : <li> au (auteur)</li><li> an (annee)</li> |
<li> bib (bibliographie)</li><li> ad (nom_addendum)</li>'); |
break; |
} |
} |
} |
/** Permet de recupérer le nom scientigfique au format html. Le champ nom_sci de la requete sql est remplacé par |
* le champ nom_sci_html */ |
public function mettreAuFormat() { |
if ($this->html == 'htm') { |
if (strrpos($this->requete_champ, 'nom_sci_html as nom_sci') === false) { |
$this->requete_champ = str_replace('nom_sci', 'nom_sci_html as nom_sci', $this->requete_champ); |
} |
} elseif ($this->html != 'txt') { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requete </br> ns.format = htm ou txt (par defaut)' ); |
} |
} |
//--------------------------------fonctions de formatage---------------------------------------------------------- |
/** Fonction permettant de creer la table dont le nom est passé en paramètre (champs_api, champs_bdtfx, |
* correspondance_champs...). Les données de chaque table sont présentes dans le fichier de configuration config.ini |
* @param String $table : Peut contenir plusieurs nom de table dont on souhaite récupérer les données : table,table,table. |
* Ex : recupererTableSignification('champs_api,champs_bdtfx') */ |
public function recupererTableSignification($table) { |
$tables = explode(',', $table); |
foreach ($tables as $tab) { |
if ($tab == 'champs_comp') { |
$champ_bdnff_api = array_keys($this->champs_api); //on recupère le nom des champ ds la bdd |
$this->champs_comp = array_diff($this->champs_table, $champ_bdnff_api); |
} elseif ($tab == 'champs_api') { |
foreach ($this->correspondance_champs as $key => $val) { |
preg_match('/(hybride[.]parent_0[12](?:[.]notes)?|nom_sci[.][^.]+|[^.]+)(?:[.](id|code))?/', $val, $match); |
$val = $match[1]; |
$this->champs_api[$key] = $val; |
} |
} else { |
$tableau = explode(',', Config::get($tab)); |
$tableau = array_map('trim', $tableau); |
foreach ($tableau as $champ) { |
list($code, $rang) = explode('=', $champ); |
$tab_tampon[$code] = $rang; |
} |
$this->$tab = $tab_tampon; |
$tab_tampon = array(); |
} |
} |
} |
public function formaterEnOss($resultat) { |
$res = array(); |
$table_nom = array(); |
foreach ($resultat as $version => $res_version) { |
$oss = ''; |
foreach ($res_version as $tab) { |
if (isset($tab['nom_sci']) ) { |
if (!in_array($tab['nom_sci'], $table_nom)) { |
$table_nom[] = $tab['nom_sci']; |
$oss [] = $tab['nom_sci'].$this->ajouterCompositionNom($tab); |
} |
} |
} |
$masque = $this->ordonnerMasque(); |
if ($masque == '') $masque = 'Pas de masque'; |
$table_retour_oss = array($masque, $oss); |
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version |
$res = $this->afficherVersionOuPas($version, $table_retour_oss, $res); |
} |
return $res; |
} |
/** Permet de récupérer le masque de rang superieur parmi les parametres de la requete. |
* Sera affiche dans l'entete du fichier json (clé 'masque') et oss. |
* @return string le masque de rang supérieur ou '' si aucun masque n'a été mis en parametre de |
* requete (la clé masque ne sera alors pas affichée dans l'entete).*/ |
public function ordonnerMasque() { |
$masque = ''; |
foreach ($this->ordre_masque as $key => $filtre) { |
if (isset($this->table_param[$filtre])) { |
$masque .= '&'.$filtre.'='.$this->table_param[$filtre]; |
} |
} |
$masque = ltrim($masque, '&'); //on enlève le & du début |
$masque = str_replace('masque_','',$masque); |
return $masque; |
} |
/** Affiche l'entete du résultat pour le service /noms et /noms/relations. L'entete comprend le rang (s'il est un |
* filtre), le départ, la limite, le total des résultats et les urls suivante et precedente. */ |
public function afficherEnteteRangBorneTotalUrls($resultat, $url_service) { |
if (isset($this->table_param['masque_rg'])) $this->afficherDonnees('rang', $this->table_param['masque_rg']); |
$this->table_retour['depart'] = $this->limite_requete['depart']; |
$this->table_retour['limite'] = $this->limite_requete['limite']; |
$this->table_retour['total'] = $this->total_resultat; |
//formuler les urls precedentes et suivantes |
$url = $this->formulerUrl($this->total_resultat, $url_service); |
if ($url['precedent'] != '') { $this->table_retour['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $this->table_retour['href.suivant'] = $url['suivant']; } |
} |
//----------------------------Fonction de formatage pour les services /#id/--------------------------------------------- |
/** Ajout du numero de la version au tableau de résultat à retourner : |
* 'bdtfx_v2_00' : {'infos' : 'toto' ...}, 'bdtfx_v3_00' : {'infos' : 'tata' ...} |
* @param string $num_version : numéro de version (sous la forme de l'intitulé du nom de la table bdd) |
* @param array $tab : tableau contenant le resultat à retourner pour une version donnée |
* @param array $res : tableau contenant le resultat à retourner pour toutes les versions disponibles */ |
public function afficherVersionOuPas($version, &$tab, &$res) { |
if (count($this->table_version) > 1) { |
$res[$version] = $tab; |
$tab = array(); |
} else { |
$res = $tab; |
} |
return $res; |
} |
public function formaterId($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
$res_version = $res_version[0]; |
$this->resultat_req = $res_version; |
foreach ($res_version as $key => $valeur) { |
if ($valeur != '') { |
$this->afficherDonnees($key, $valeur); |
} |
} |
unset($this->table_retour['href']); |
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version |
$res = $this->afficherVersionOuPas($version, $this->table_retour, $res); |
} |
return $res; |
} |
public function formaterIdChamp($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
$res_version = $res_version[0]; |
$this->resultat_req = $res_version; |
$this->table_retour['id'] = $res_version['num_nom']; |
//on récupère les champs (le + est transformé en espace par le navigateur) |
$tab_ress = explode(' ', $this->table_ressources[1]); |
foreach ($tab_ress as $nom_champ_api) { |
if ($this->verifierValiditeChamp($nom_champ_api)) { |
switch ($nom_champ_api) { |
case 'nom_sci' : $this->afficherNomSci($res_version); break; |
case 'nom_sci.*' : $this->afficherNomSciPointEpithete($res_version); break; |
case 'hybride.*' : |
$this->afficherChamps('hybride.parent_01.*', $res_version['hybride_parent_01']); |
$this->afficherChamps('hybride.parent_02.*', $res_version['hybride_parent_02']); break; |
default : |
$this->afficherChamps($nom_champ_api, |
$res_version[$this->trouverChampBddCorrespondant($nom_champ_api)]); break; |
} |
} |
} |
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version |
$res = $this->afficherVersionOuPas($version, $this->table_retour, $res); |
} |
return $res; |
} |
/** Les champs passés dans l'url lors de la requete /noms|taxons/#id/#champ+#champ son sous la forme de l'api. |
* Les noms de l'api ne st pas les meme que ceux des champs de la base de données. |
* Cette fct permet de récupérer le nom du champs de la base de données */ |
public function trouverChampBddCorrespondant($champ) { |
$radical_champ = $champ; |
if ($this->estUnPoint($champ) && strrpos($champ, '.notes') === false) { |
preg_match('/^(?:([^.]+\.parent_0[12]|[^.]+))(?:\.(.+))?$/', $champ, $match); |
$radical_champ = $match[1]; |
} |
// - Soit un champ de l'api est recherché (pour les champs du référentiel : les noms des champs ont été modifiés), |
// - Soit un champ complementaire de la bdnff (les noms de ces champs complementaire sont les memes que ds la base) |
if ($this->estChampApi($radical_champ)) { |
$champ_bdd = array_search($radical_champ, $this->champs_api); |
} elseif ($this->estDansBdnff($radical_champ)) { |
$champ_bdd = $radical_champ; |
} else { |
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Fct trouverChampBddCorrespondant : Le parametre "'.$radical_champ.'" n\'existe pas. <br/><br/>'); |
} |
return $champ_bdd; |
} |
/** Permet d'afficher des informations précisées des données liées. Utilisé par le service id/champ |
* lors de l'appel d'un champ tel que : champ.id, champ.code, champ.*, champ.href. */ |
public function afficherChamps($champ, $valeur) { |
$reponse = $this->table_retour; |
$this->table_retour = array(); |
if ($valeur == '') { |
$this->table_retour[$champ] = null; |
} else { |
preg_match('/^(?:([^.]+\.parent_0[12]|[^.]+))(?:\.(.+))?$/', $champ, $match); |
//si on a un point etoile |
if (isset($match[2]) && $match[2] == '*') { |
$this->afficherPointEtoile($match[1], $valeur); |
//si le champ comprend plusieurs identifiants : pour le champ proparte (liste ou .details recherché, pas de .href) |
} elseif ($this->presentePlusieursId($match[1], $valeur)) { |
if (isset($match[2]) && $match[2] != 'id') { |
$this->afficherInfosPrecises($match[1], $match[2], $valeur); |
} else { |
$this->table_retour[str_replace('.id', '', $champ)] = $valeur; |
} |
//si on est en présence d'une donnée liée (la donnée représente un identifiant ou un code) |
} elseif ($this->correspondAUnId($match[1]) || $champ == 'id' || $this->correspondAUnCode($match[1])) { |
if (isset($match[2])) { //si un .id, un .code ou un .href est demandé : |
$this->afficherInfosPrecises($match[1], $match[2], $valeur); |
} else { |
$this->afficherInfosPrecises($match[1], 'signification', $valeur); |
} |
//sinon on affiche tel quel |
} else { |
$this->table_retour[$champ] = $valeur; |
} |
} |
$this->table_retour = array_merge($reponse, $this->table_retour); |
} |
/**Vérifie la validité d'un champ passé dans la requete /#id/#champ+#champ */ |
public function verifierValiditeChamp($champ) { |
preg_match('/^(?:([^.]+\.parent_0[12]|[^.]+))(?:\.(.+))?$/', $champ, $match); |
$radical_champ = $match[1]; |
$validite_ressource = true; |
//on verifie si le nom du champ existe bien |
if (!$this->estChampApi($radical_champ) && !$this->estDansBdnff($radical_champ)) { |
$validite_ressource = false; |
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Fct verifierValiditeChamp : Le parametre "'.$radical_champ.'" n\'existe pas. <br/><br/>'); |
} elseif ($this->estUnPoint($champ)) { |
$suffixe = $match[2]; |
//On verifie les suffixes pour les identifiants |
if ($this->correspondAUnId($radical_champ) || $radical_champ == 'id') { |
$this->verificationSuffixesIdentifiant($suffixe, $radical_champ, $validite_ressource); |
//On verifie les suffixes pour les codes |
} elseif ($this->correspondAUnCode($radical_champ)) { |
$this->verficationSuffixesCodes($suffixe, $radical_champ, $validite_ressource); |
} elseif ($radical_champ == 'nom_sci' && $suffixe != '*') { |
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur : Le suffixe demandé n\'existe pas pour le champ "'.$radical_champ.'".<br/> |
Les suffixes possibles sont les suivants : <li> * </li>'); |
} else { |
$validite_ressource = false; |
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur : Le parametre "'.$radical_champ.'" ne peut pas présenter de suffixe. <br/><br/>'); |
} |
} |
return $validite_ressource; |
} |
public function verficationSuffixesCodes(&$suffixe, &$radical_champ, &$validite_ressource ) { |
if (!in_array($suffixe, array('*', 'code', 'href', 'details'))) { |
$validite_ressource = false; |
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur : Le suffixe demandé n\'existe pas pour le champ "'.$radical_champ.'.<br/> |
Les suffixes possibles sont les suivants : |
<li> .* </li><li> .code </li><li> .href </li><li> .details </li>'); |
} |
} |
public function verificationSuffixesIdentifiant(&$suffixe, &$radical_champ, &$validite_ressource) { |
if ((strrpos($radical_champ, 'parent') !== false && !in_array($suffixe, array('*', 'id', 'href', 'details', 'notes'))) |
|| !in_array($suffixe, array('*', 'id', 'href', 'details')) && strrpos($radical_champ, 'parent') === false) { |
$validite_ressource = false; |
$this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur : Le suffixe demandé n\'existe pas pour le champ "'.$radical_champ.'".<br/> |
Les suffixes possibles sont les suivants : |
<li> .* </li><li> .id </li><li> .href </li><li> .details </li><li> .notes (seulement pour les hybride.parent)'); |
} |
} |
//------------------------------fonction de formatage pour les services /stats/----------------------------------------- |
public function formaterStatsAnnee($resultat) { |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
foreach ($res_version as $cle_annee) { |
foreach ($cle_annee as $key => $val) { |
switch($key) { |
case 'annee' : $annee = ($val != '') ? $val : 'N.D.'; break; |
case 'nombre': $nb = $val; break; |
default : break; |
} |
} |
$retour_stats_annee[$annee] = $nb; |
} |
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version |
$res = $this->afficherVersionOuPas($version, $retour_stats_annee, $res); |
} |
return $res; |
} |
public function formaterStatsRang($resultat) { |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
foreach ($res_version as $rangs) { |
if ($rangs['rang'] != 0) { |
foreach ($rangs as $key => $val) { |
switch ($key) { |
case 'rang' : $rang = $val; break; |
case 'nombre' : $nombre = $val; break; |
default : break; |
} |
} |
$retour_rang[$rang] = array( |
'rang' => $this->ajouterSignificationCode('rang', $rang), |
'nombre' => $nombre |
); |
} |
} |
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version |
$res = $this->afficherVersionOuPas($version, $retour_rang, $res); |
} |
return $res; |
} |
public function formaterStatsInitiales($resultat) { |
$res = array(); |
$table_rang = array(); |
foreach ($resultat as $version => $res_version) { |
foreach ($res_version as $tuple) { |
if ($tuple['rang'] != 0) { |
if (!isset($table_rang[$tuple['rang']])) { |
$rang = $this->ajouterSignificationCode('rang', $tuple['rang']); |
$table_rang[$tuple['rang']] = $rang; |
} else { |
$rang = $table_rang[$tuple['rang']]; |
} |
if ($tuple['lettre'] == 'x ') { |
if (isset($this->table_retour[$rang]['hyb'])) { |
$this->table_retour[$rang]['hybride'] += floatval($tuple['nb']); |
} else { |
$this->table_retour[$rang]['hybride'] = floatval($tuple['nb']); |
} |
} elseif ($tuple['lettre'] == '+ ') { |
if (isset($this->table_retour[$rang]['chimère'])) { |
$this->table_retour[$rang]['chimère'] += floatval($tuple['nb']); |
} else { |
$this->table_retour[$rang]['chimère'] = floatval($tuple['nb']); |
} |
} else { |
$l = substr($tuple['lettre'], 0, 1); |
if (isset($this->table_retour[$rang][$l])) { |
$this->table_retour[$rang][substr($tuple['lettre'], 0, 1)] += floatval($tuple['nb']); |
} else { |
$this->table_retour[$rang][substr($tuple['lettre'], 0, 1)] = floatval($tuple['nb']); |
} |
} |
} |
} |
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version |
$res = $this->afficherVersionOuPas($version, $this->table_retour, $res); |
} |
return $res; |
} |
//-----------------------------Fonctions d'affichage utiliser dans les fonctions de formatage--------------------------- |
/** Affiche les résultats en fonction du paramètre retour_format. */ |
public function afficherDonnees($key, $valeur) { |
//on souhaite afficher le nom au format de l'api |
if ($this->retour_format == 'min') { |
if ($this->correspondAChampApi($key)) { //on affiche l'intitulé selon decrit dans l'api |
if ($key == 'nom_sci') $valeur = $valeur.$this->ajouterCompositionNom($this->resultat_req); |
$this->table_retour[$this->correspondance_champs[$key]] = $valeur; |
} else { |
$this->table_retour[$key] = $valeur; |
} |
} else { |
if ($this->correspondAChampApi($key)) { |
$nom_champ_api = $this->correspondance_champs[$key]; //on récupere le nom comme définit ds l'api |
$this->afficherToutesLesInfos($nom_champ_api, $valeur); |
} elseif ($this->estDansBdnff($key)) { |
$this->table_retour[$key] = $valeur; |
} |
} |
} |
public function afficherToutesLesInfos($nom_champ_api, $valeur) { |
if ($this->presentePlusieursId($nom_champ_api, $valeur)) { |
preg_match('/^([^.]+\.parent_0[12]|[^.]+)(?:\.id)?$/', $nom_champ_api, $match); |
$this->afficherInfosPrecises($match[1], 'details', $valeur); |
$this->table_retour[$nom_champ_api] = $valeur; |
} elseif (strrpos($nom_champ_api, 'parent') !== false && strrpos($nom_champ_api, 'notes') !== false) { |
$this->table_retour[$nom_champ_api] = $valeur; |
} elseif (($this->correspondAUnId($nom_champ_api) || $nom_champ_api == 'id') && $valeur != '0') { |
preg_match('/^([^.]+\.parent_0[12]|[^.]+)(?:\.id)?$/', $nom_champ_api, $match); |
$this->afficherInfosPrecises($match[1], 'id,signification,href', $valeur); |
} elseif ($this->correspondAUnCode($nom_champ_api)) { |
preg_match('/^([^.]+)(?:\.code)?$/', $nom_champ_api, $match); |
$this->afficherInfosPrecises($match[1], 'code,signification,href', $valeur); |
} |
} |
public function presentePlusieursId($ressource, $valeur = null) { |
if ($valeur) { |
$presente = strrpos($ressource, 'proparte') !== false && strrpos($valeur, ',') !== false; |
} else { //pour la vérification du champ, on ignore alors la valeur de la ressource |
$presente = strrpos($ressource, 'proparte') !== false; |
} |
return $presente; |
} |
public function afficherTableDetails($nom_champ_api, $valeur) { |
$tab_id = explode(',',$valeur); |
$tab_res = $this->table_retour; |
$this->table_retour = array(); |
foreach ($tab_id as $id) { |
$this->afficherInfosPrecises($nom_champ_api, 'id,signification,href', $id); |
$tab_res[$nom_champ_api.'.details'][] = $this->table_retour; |
$this->table_retour = array(); |
} |
$this->table_retour = $tab_res; |
} |
public function afficherPointEtoile($champ, $valeur) { |
if ($this->presentePlusieursId($champ, $valeur)) { |
$this->afficherInfosPrecises($champ, 'details', $valeur); |
$this->table_retour[$champ] = $valeur; |
} elseif (strrpos($champ, 'parent') !== false) { |
$this->afficherInfosPrecises($champ, 'id,href,notes', $valeur); |
} elseif ($this->correspondAUnId($champ) || $champ == 'id') { |
$this->afficherInfosPrecises($champ, 'id,href', $valeur); |
} elseif ($this->correspondAUnCode($champ)) { |
$this->afficherInfosPrecises($champ, 'code,href', $valeur); |
} |
} |
public function afficherInfosPrecises($champ, $suffixe, $valeur) { |
$suffixes = explode(',', $suffixe); |
//on initialise au service appelé. Sera potentiellement modifié dans la fonction afficherSignification() |
$this->service_href = $this->service; |
foreach ($suffixes as $suff) { |
switch ($suff) { |
case 'id' : |
$this->table_retour[str_replace('id.id', 'id', $champ.'.id')] = $valeur; |
break; |
case 'details' : |
$this->afficherTableDetails($champ, $valeur); |
break; |
case 'signification' : |
$this->afficherSignification($champ, $valeur); |
break; |
case 'href' : |
if ($this->correspondAUnId($champ) || $champ == 'id') { |
$service = $this->service_href; |
$url = $this->ajouterHref($service, $valeur); |
} else { |
$service = 'ontologies'; |
$champ_url = $champ; |
$url = $this->ajouterHrefAutreProjet($service, $val, $champ_url); |
} |
$this->table_retour[str_replace('id.href', 'href', $champ.'.href')] = $url; |
break; |
case 'code' : |
$val = ( $champ == 'rang' ) ? 'bdnt.rangTaxo:'.$valeur : 'bdnt.'.rtrim($champ, '_Ga,_Co').':'.$valeur; |
$this->table_retour[$champ.'.code'] = $val; |
break; |
case 'notes' : |
$this->table_retour[$champ.'.notes'] = $this->resultat_req[str_replace('.', '_', $champ).'_notes']; |
break; |
default : |
break; |
} |
} |
} |
public function afficherSignification($champ, $valeur) { |
if ($champ == 'id' && isset($this->resultat_req['nom_sci']) && $this->resultat_req['num_nom'] == $valeur) { |
//si le nom_sci du num_nom que l'on veut afficher est déjà dans la table de résultat : |
$this->table_retour['nom_sci'] = $this->resultat_req['nom_sci'].$this->ajouterCompositionNom($this->resultat_req); |
} elseif ($this->correspondAUnId($champ) || $champ == 'id') { |
$nom = $this->recupererNomSci($valeur); |
$champ = ($champ == 'id') ? 'nom_sci' : $champ; |
if ($nom != array()) { |
$this->table_retour[$champ] = $nom['nom_sci']; |
$this->service_href = $nom['service']; |
} |
} elseif ($this->correspondAUnCode($champ)) { |
$this->table_retour[$champ] = $this->ajouterSignificationCode($champ, $valeur); |
} |
} |
/** Permet d'afficher les élements nomenclatural du nom_sci lors de l'appel dans le service noms/id/champ du champ^nom_sci.*/ |
public function afficherNomSciPointEpithete($resultat) { |
foreach ($this->tab_nom_sci as $compo_nom) { |
if (isset($resultat[$compo_nom]) && !empty($resultat[$compo_nom])) { |
$this->table_retour['nom_sci.'.$compo_nom] = $resultat[$compo_nom]; |
} |
} |
} |
/** utilisé dans le formatage de /noms/id et de /noms/id/champ seulement */ |
public function afficherNomSci($resultat) { |
if ($this->html == 'htm') { |
$this->table_retour['nom_sci'] = $resultat['nom_sci_html'].$this->ajouterCompositionNom($resultat); |
} else { |
$this->table_retour['nom_sci'] = $resultat['nom_sci'].$this->ajouterCompositionNom($resultat); |
} |
} |
/** Permet d'afficher la signification d'un code pour le rang, la présence, et les differents statuts */ |
public function ajouterSignificationCode($champ, $valeur) { |
$champ = ($champ == 'rang') ? 'rangTaxo' : rtrim($champ, '_Co,_Ga'); |
if (preg_match('/^([^_-]+)(?:_|-)([^_-]+)$/', $champ, $match)) { |
$champ = $match[1].ucfirst($match[2]); |
} |
$url = Config::get('url_ontologie').$champ.':'.$valeur.'/nom'; |
$res = $this->consulterHref($url); //dans commun.php |
$nom_code = $res->nom; |
return $nom_code; |
} |
/** Recupere le nom_scientifique (formaté ou non en fonction du parametre ns.format) à partir du num_nom */ |
public function recupererNomSci($id) { |
$nom = array(); |
if ($id != 0) { |
if ($this->compo_nom == null) { |
$req = 'SELECT nom_sci, num_nom_retenu FROM '.$this->table.' WHERE num_nom = '.$id; |
} else { //on ajoute à la requete sql, les champs de ns.structure |
$req = 'SELECT nom_sci, num_nom_retenu, '.implode(', ', $this->compo_nom) |
.' FROM '.$this->table |
.' WHERE num_nom = '.$id; |
} |
if ($this->html == 'htm') { |
$req = str_replace('nom_sci', 'nom_sci_html as nom_sci', $req); |
} |
$res = $this->getBdd()->recuperer($req); |
if ($res) { |
$nom['nom_sci'] = $res['nom_sci'].$this->ajouterCompositionNom($res); |
$nom['service'] = ($res['num_nom_retenu'] == $id && $this->service == 'taxons') ? 'taxons' : 'noms'; |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Fct recupererNomSci() : Donnees introuvables dans la base pour l\'id '.$id); |
} |
} |
return $nom; |
} |
/** Permet de retourner une chaine de caractère composée des parametres du nom (ns.structure : annnée, auteur, |
* bibilio et addendum). A ajouter au nom scientifique */ |
public function ajouterCompositionNom($tab_res) { |
$nom_complet = ' '; |
$this->ajouterAuteur($tab_res, $nom_complet); |
$this->ajouterAnneeEtBiblio($tab_res, $nom_complet); |
$this->ajouterAnneeSansBilio($tab_res, $nom_complet); |
$this->ajouterBiblioSansAnnee($tab_res, $nom_complet); |
$this->ajouterAddendum($tab_res, $nom_complet); |
return rtrim($nom_complet); |
} |
public function ajouterAuteur($tab_res, &$nom_complet) { |
if (isset($this->compo_nom['au']) && isset($tab_res['auteur']) && $tab_res['auteur'] != '') { |
if ($this->html == 'htm') { |
$nom_complet .= '<span class="auteur">'.$tab_res['auteur'].'</span> '; |
} else { |
$nom_complet .= $tab_res['auteur'].' '; |
} |
} |
} |
public function ajouterAnneeEtBiblio($tab_res, &$nom_complet) { |
if (isset($this->compo_nom['an']) && isset($this->compo_nom['bib']) |
&& isset($tab_res['annee']) && ($tab_res['annee'] != '') |
&& isset($tab_res['biblio_origine']) && ($tab_res['biblio_origine'] != '')) { |
if ($this->html == 'htm') { |
$nom_complet .= '[<span class="annee">'.$tab_res['annee'].'</span>, <span class="biblio">' |
.$tab_res['biblio_origine'].'</span>]'; |
} else { |
$nom_complet .= '['.$tab_res['annee'].', '.$tab_res['biblio_origine'].']'; |
} |
} |
} |
public function ajouterAnneeSansBilio($tab_res, &$nom_complet) { |
if (isset($this->compo_nom['an']) && !isset($this->compo_nom['bib']) |
&& isset($tab_res['annee']) && ($tab_res['annee'] != '')) { |
if ($this->html == 'htm') { |
$nom_complet .= '[<span class="annee">'.$tab_res['annee'].'</span>]'; |
} else { |
$nom_complet .= '['.$tab_res['annee'].']'; |
} |
} |
} |
public function ajouterBiblioSansAnnee($tab_res, &$nom_complet) { |
if (!isset($this->compo_nom['an']) && isset($this->compo_nom['bib']) && ($tab_res['biblio_origine'] != '')) { |
if ($this->html == 'htm') { |
$nom_complet .= '[<span class="biblio">'.$tab_res['biblio_origine'].'</span>]'; |
} else { |
$nom_complet .= '['.$tab_res['biblio_origine'].']'; |
} |
} |
} |
public function ajouterAddendum($tab_res, &$nom_complet) { |
if (isset($this->compo_nom['ad']) && ($tab_res['nom_addendum'] != '')) { |
if ($this->html == 'htm') { |
$nom_complet .= '[<span class="adendum">'.$tab_res['nom_addendum'].'</span>]'; |
} else { |
$nom_complet .= '['.$tab_res['nom_addendum'].']'; |
} |
} |
} |
public function correspondAUnCode($key) { |
return (strrpos($key, '.code') !== false) || (in_array($key.'.code', $this->correspondance_champs)); |
} |
public function correspondAUnId($key) { |
return (strrpos($key, '.id') !== false) || (in_array($key.'.id', $this->correspondance_champs)); |
} |
public function estChampApi($champ) { |
return (in_array($champ, $this->champs_api) || in_array($champ, $this->correspondance_champs)); |
} |
public function correspondAChampApi($champ_bdd) { |
return (array_key_exists($champ_bdd, $this->champs_api) || array_key_exists($champ_bdd, $this->correspondance_champs)); |
} |
public function estDansBdnff($champ) { |
return (in_array($champ, $this->champs_comp)); |
} |
public function estUnPoint($key) { |
if (strrpos($key, 'hybride.parent') !== false) { |
$key = str_replace('hybride.parent', 'hybride_parent', $key); |
} |
return (strrpos($key, '.') !== false); |
} |
} |
?> |
Property changes: |
Added: svn:executable |
+* |
\ No newline at end of property |
/trunk/services/modules/0.1/coste/Noms.php |
---|
New file |
0,0 → 1,711 |
<?php |
/** |
* Description : |
* Classe Noms.php permettant de fournir des informations sur les noms scientifiques. |
* Si l'url finit par /noms on retourne une liste de noms latin et leurs identifiants (seulement les 100 premeiers noms par défaut). |
* L'url peut contenir des paramètres optionnels passés après le ? : /noms?param1=val1¶m2=val2&... |
* |
* Les paramètres de requête disponibles sont : masque, masque.gen (nom de genre), masque.sp (épithète d'espèce), masque.ssp (épithète infra-spécifique), |
* masque.au (auteur du nom), masque.an (année de publication du nom), masque.bib (réf biblio de la publi d'origine du nom), masque.ad (nomen addendum), |
* masque.nn (identifiant du nom), recherche, rang, distinct, retour.format, nl.format, nl.structure, navigation.depart et navigation.limite. |
* |
* Encodage en entrée : utf8 |
* Encodage en sortie : utf8 |
* @package framework-v3 |
* @author Jennifer Dhé <jennifer.dhe@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> |
* @version 1.0 |
* @copyright 1999-${year} Tela Botanica (accueil@tela-botanica.org) |
*/ |
class Noms extends CommunNomsTaxons { |
/** Permet de stocker la requete formulée : |
* - noms | noms/#id | noms/#id/#champ+#champ |
* - noms/#id/relations | noms/#id/relations/synonymie | noms/#id/relations/homonymie | noms/#id/relations/flores |
* - noms/stats/rangs | noms/stats/annees | noms/stats/initiales */ |
protected $format_reponse = 'noms'; |
protected $service = 'noms'; |
/** Valeur du paramètre de requete recherche : stricte etendue floue */ |
protected $recherche = false; |
/** Valeur du paramètre de requete distinct (=0|1) */ |
protected $distinct = null; |
/** Représente la première partie de la requete SQL (entre le SELECT et le WHERE) */ |
protected $requete_champ = 'num_nom, nom_sci, num_nom_retenu'; |
/** Représente la partie de la requete SQL ajoutant une condition (WHERE ...) */ |
protected $requete_condition = ''; |
/** Représente la partie GROUP BY de la requete SQL (GROUP BY ...) */ |
protected $requete_group_by = ''; |
/** Permet de stocker les limite de la requete SQL (par défaut seul les 100 premiers résultats seront retournés).*/ |
protected $limite_requete = array( |
'depart' => 0, |
'limite' => 100 |
); |
public function consulter($ressources, $parametres) { |
$resultat_formate = ''; |
$res_version = ''; |
$this->initialiserRestClient(); //création d'un objet RestClient |
$this->traiterParametres($parametres); |
//On récupère les différentes versions existantes ds la table des meta-données (WS metaDonnees) et on traite la version demandée : |
$this->traiterVersionProjet($ressources); |
if ($this->corps_http == '' && $this->entete_http == '') { |
foreach ($this->table_version as $version) { |
$this->table = $version; //on stocke le nom de la table correspondant à la version du projet en cours |
$this->recupererNomChamp($this->table); //on récupère les noms des champs disponibles (Ds Commun.php) |
$this->traiterRessources($ressources); //dans CommunNomsTaxons.php |
$requete = $this->assemblerLaRequete(); |
$resultat = $this->getBdd()->recupererTous($requete); |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'La requête SQL formée comporte une erreur !!'); |
} elseif ($resultat) { |
$res_version[$version] = $resultat; |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Les données recherchées sont introuvables dans la version '.$version); |
} |
} |
} |
if ($this->corps_http == '' && $this->entete_http == '') { |
$resultat_formate = $this->retournerResultatFormate($res_version); |
} |
$this->formerReponseHTTP($resultat_formate); |
} |
//-----------------FONCTION D'ANALYSE DES PARAMETRES-------------------------------------------------------------------- |
/** |
* |
* Permet d'analyser les paramètres |
* @param array $parametres |
*/ |
public function traiterParametres($parametres) { |
$this->table_param = $parametres; |
if (isset($parametres) && !empty($parametres)) { |
//définition de $recherche permettant d'ajouter les % ds la requete sql (cas recherche étendue) utilisé dans la fct ajouterLeFiltreMasque() |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $val) { |
switch ($param) { |
case 'ns_format' : $this->html = $val; break; |
case 'ns_structure' : $this->remplirTableCompositionNom($val); //ds CommunNomsTaxons.php |
$this->requete_champ .= ' ,'.implode(', ',$this->compo_nom); break; |
case 'masque' : $this->ajouterLeFiltreMasque('nom_sci', $val); break; |
case 'masque_sg' : $this->ajouterLeFiltreMasque('nom_supra_generique', $val); break; |
case 'masque_gen' : $this->ajouterLeFiltreMasque('genre', $val); break; |
case 'masque_sp' : $this->ajouterLeFiltreMasque('epithete_sp', $val); break; |
case 'masque_ssp' : $this->ajouterLeFiltreMasque('epithete_infra_sp',$val); break; |
case 'masque_au' : $this->ajouterLeFiltreMasque('auteur', $val); break; |
case 'masque_an' : $this->ajouterLeFiltreMasque('annee', $val); break; |
case 'masque_bib' : $this->ajouterLeFiltreMasque('biblio_origine',$val); break; |
case 'masque_ad' : $this->ajouterLeFiltreMasque('nom_addendum', $val); break; |
case 'masque_nn' : $this->requete_condition .= ' AND num_nom IN ('.$val.')'; break; |
case 'masque_rg' : $this->ajouterLeFiltreMasque('rang', $val); break; |
case 'navigation_depart': $this->limite_requete['depart'] = $val; break; |
case 'navigation_limite': $this->limite_requete['limite'] = $val; break; |
case 'retour_format' : $this->retour_format = $val; break; |
case 'distinct' : $this->distinct = $val; break; |
case 'recherche' : break; |
default : $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans les parametres de recherche de votre requête : |
</br> Le parametre " '.$param.' " n\'existe pas.'); break; |
} |
} |
$this->ajouterNomDistinct(); |
if ($this->recherche == 'floue') { |
$this->rechercheFloue(); |
} |
} |
} |
/** |
* |
* fonction d'ajout dans la requete SQL des conditions (WHERE ...) en fonctions des parametres demandés |
* @param $nom_champ |
* @param $valeur |
* @param $masque |
*/ |
public function ajouterLeFiltreMasque($nom_champ, $valeur) { |
if ($nom_champ == 'annee' || $nom_champ == 'rang') { |
$this->requete_condition .= ' AND '.$nom_champ.' = '.$this->getBdd()->proteger($valeur); |
} else { |
if ($this->recherche == 'etendue') { |
$valeur = str_replace(' ','%', $valeur); |
$valeur .= '%'; |
} |
$this->requete_condition .= ' AND '.$nom_champ.' LIKE '.$this->getBdd()->proteger($valeur); |
} |
} |
/** |
* Permet de rajouter à la requete sql le parametre distinct. N'est utilisé qu'avec le format oss |
*/ |
public function ajouterNomDistinct() { |
if (isset($this->distinct)) { |
if (($this->distinct == 1) && ($this->retour_format == 'oss')) { |
if ($this->compo_nom == '') { |
$this->requete_champ = ' DISTINCT nom_sci '; |
} else { |
$this->requete_champ = ' DISTINCT nom_sci, '.implode(', ',$this->compo_nom); |
} |
} elseif (($this->distinct == 1) && ($this->retour_format != 'oss')) { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,'Erreur dans votre requête </br> |
L\'utilisation du parametre distinct ne se fait que sous le format oss'); |
} |
} |
} |
/** |
* |
* Permet d'ajouter à notre requete une condition de recherche floue à l'aide de l'alhorithme soundex. |
* On remplace ainsi les filtres exceptés le masque année et le filtre rang |
*/ |
public function rechercheFloue() { |
foreach ($this->ordre_masque as $masque) { |
if (array_key_exists($masque, $this->table_param)) { |
$radical = $this->table_param[$masque]; |
switch ($masque) { |
case 'masque' : $this->ajoutSoundex('nom_sci', $radical); break; |
case 'masque_sg' : $this->ajoutSoundex('nom_supra_generique', $radical); break; |
case 'masque_gen' : $this->ajoutSoundex('genre', $radical); break; |
case 'masque_sp' : $this->ajoutSoundex('epithete_sp', $radical); break; |
case 'masque_ssp' : $this->ajoutSoundex('epithete_infra_sp', $radical); break; |
case 'masque_au' : $this->ajoutSoundex('auteur', $radical); break; |
default : break; |
} |
} |
} |
} |
/** Ajoute à la requete SQL l'expression pour la recherche floue en fonction du masque demandé */ |
public function ajoutSoundex($champ, $radical) { |
$this->requete_condition = str_replace(' AND '.$champ.' LIKE \''.$radical.'\'', |
' AND (SOUNDEX('.$champ.') = SOUNDEX(\''.$radical.'\')'. |
' OR SOUNDEX(REVERSE('.$champ.')) = SOUNDEX(REVERSE(\''.$radical.'\'))) ', |
$this->requete_condition |
); |
} |
//-----------------FONCTION D'ANALYSE DES RESSOURCES-------------------------------------------------------------------- |
public function traiterRessourcesIdentifiant() { |
//on initialise la condition de la requete sql et le format de réponse |
$this->requete_condition = ' num_nom = '.$this->getBdd()->proteger($this->table_ressources[0]); |
$this->format_reponse = $this->service.'/id'; |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
// requete de type noms/#id/#champ+#champ |
if (($this->table_ressources[1] != 'relations')) { |
$this->requete_champ = ' *, nom_sci '; |
$this->format_reponse .= '/champ'; |
// requete de type noms/#id/relations/#relations |
} elseif ($this->table_ressources[1] == 'relations') { |
$this->traiterRessourceIdRelations(); |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requête </br> Ressources disponibles : <br/> |
<li> noms/#id/relations </li> <li> noms/#id/#champ+#champ </li> |
<li> noms/#id/relations/synonymie </li> <li> noms/#id/relations/flores </li> |
<li> noms/#id/relations/homonymie </li>'); |
} |
} else { |
// requete de type noms/#id : rajout du nom_sci pour récupérer le format html par la fct mettreAuFormat() |
// SELECT *, nom_sci FROM bdtfx_v2_00 WHERE num_nom = X; |
$this->requete_champ = ' *, nom_sci '; |
} |
} |
public function traiterRessourceIdRelations() { |
$this->format_reponse .= '/relations'; |
if (isset($this->table_ressources[2]) && !empty($this->table_ressources[2])) { |
// requete de type noms/#id/relations/#relation |
switch ($this->table_ressources[2]) { |
case 'synonymie' : $this->traiterRessourceIdSynonymie(); break; |
case 'flores' : $this->traiterRessourceIdFlores(); break; |
case 'homonymie' : $this->traiterRessourceIdHomonymie(); break; |
default : $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requête </br> Ressources disponibles : <br/> |
<li> noms/#id/relations </li> <li> noms/#id/relations/synonymie </li> |
<li> noms/#id/relations/flores </li> <li> noms/#id/relations/homonymie </li>'); break; |
} |
} |
} |
public function traiterRessourceIdSynonymie() { |
// SELECT num_nom, nom_sci, num_nom_retenu, basionyme FROM bdtfx_v2_00 WHERE num_nom = X LIMIT 0,100; |
$this->format_reponse .= '/synonymie'; |
if (strrpos($this->requete_champ, ', basionyme') === false) $this->requete_champ .= ', basionyme '; |
$this->requete_condition = ' num_nom_retenu = (SELECT num_nom_retenu FROM '.$this->table |
.' WHERE '.$this->requete_condition.')'; |
} |
public function traiterRessourceIdHomonymie() { |
// SELECT num_nom, nom_sci, num_nom_retenu FROM bdtfx_v2_00 WHERE nom_sci = |
// (SELECT nom_sci FROM bdtfx_v2_00 WHERE num_nom = X); |
$this->format_reponse .= '/homonymie'; |
$this->requete_condition = 'nom_sci = (SELECT nom_sci FROM '.$this->table |
.' WHERE '.$this->requete_condition.')'; |
} |
public function traiterRessourceIdFlores() { |
$champ_flores = ''; |
foreach ($this->champs_table as $champ) { |
if (preg_match('/^flore_.*$/', $champ)) { |
$champ_flores .= ', '.$champ; |
} |
} |
$this->format_reponse .= '/flores'; |
$this->requete_champ = 'num_nom'.$champ_flores; |
} |
public function traiterRessourceStatsRangs() { |
// SELECT count(*) as nombre, rang FROM bdtfx_v2_00 [WHERE rang = 290] GROUP BY rang ORDER BY rang; |
$this->format_reponse .= '/rangs'; |
$this->requete_champ = 'count(*) as nombre, rang '; |
$this->requete_group_by = ' GROUP BY rang ORDER BY rang '; |
} |
public function traiterRessourceStatsAnnees() { |
// SELECT count(*) as nombre, annee FROM bdtfx_v2_00 GROUP BY annee ORDER BY annee; |
$this->format_reponse .= '/annees'; |
$this->requete_champ = 'count(*) as nombre, annee '; |
$this->requete_condition = ''; |
$this->requete_group_by = ' GROUP BY annee ORDER BY annee '; |
} |
public function traiterRessourceStatsInitiales() { |
// SELECT count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre GROUP BY rang, left(nom_sci, 2); |
$this->format_reponse .= '/initiales'; |
$this->requete_condition = ''; |
$this->requete_champ = 'count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre '; |
$this->requete_group_by = ' GROUP BY rang, left(nom_sci, 2)'; |
} |
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE----------------------------------------------------- |
public function assemblerLaRequete() { |
if ( strrpos($this->format_reponse, 'noms/stats/') === false ) { |
$this->mettreAuFormat(); //Ds CommunNomsTaxons.php |
} |
if ($this->requete_condition != '') { |
$this->requete_condition = ltrim($this->requete_condition, ' AND, WHERE'); |
$this->requete_condition = ' WHERE '.$this->requete_condition; |
} |
if ($this->format_reponse != 'noms' && $this->format_reponse != 'noms/id/relations/synonymie' && $this->format_reponse != 'noms/id/relations/homonymie') { |
$this->requete_limite = ''; |
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) { |
$this->limite_requete['depart'] = |
(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']); |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} else { |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} |
$requete = ' SELECT '.$this->requete_champ. |
' FROM '.$this->table |
.$this->requete_condition |
.$this->requete_group_by |
.$this->requete_limite; |
return $requete; |
} |
/** |
* Recupere le nombre total de résultat d'une requete lancée. |
* Est utilisée lors de l'affichage du total dans le résultat retourné et pr déterminer les limites et départ |
* @return nombre total de résultat |
*/ |
public function recupererTotalResultat() { |
$total = null; |
$requete = 'SELECT count(*) as nombre FROM '.$this->table.$this->requete_condition.$this->requete_group_by; |
$res = $this->getBdd()->recuperer($requete); |
if ($res) { |
$total = $res['nombre']; |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Fct recupererTotalResultat() : <br/>Données introuvables dans la base'); |
} |
return $total; |
} |
//-------------------FONCTIONS POUR LE FORMATAGE EN JSON---------------------------------------------------------------- |
/** |
* Permet de récupérer le résultat à retourner propre à chaque requete et de l'encoder en json |
* @param array $resultat |
* @param array $ressources |
* @return le résultat encoder en json |
*/ |
public function retournerResultatFormate($resultat) { |
switch ($this->format_reponse) { |
case 'noms/id' : $reponse = $this->formaterId($resultat); break; //ds CommunNomsTaxons |
case 'noms/id/champ' : $reponse = $this->formaterIdChamp($resultat); break; //ds CommunNomsTaxons |
case 'noms/id/relations' : $reponse = $this->formaterIdRelations($resultat); break; |
case 'noms/id/relations/synonymie' : $reponse = $this->formaterIdSynonymie($resultat); break; |
case 'noms/id/relations/homonymie' : $reponse = $this->formaterIdHomonymie($resultat); break; |
case 'noms/id/relations/flores' : $reponse = $this->formaterIdFlores($resultat); break; //ds CommunsNomsTaxons |
case 'noms/stats/annees' : $reponse = $this->formaterStatsAnnee($resultat); break; //ds CommunNomsTaxons |
case 'noms/stats/rangs' : $reponse = $this->formaterStatsRang($resultat); break; //ds CommunNomsTaxons |
case 'noms/stats/initiales' : $reponse = $this->formaterStatsInitiales($resultat); break; //ds CommunNomsTaxons |
case 'noms' : $reponse = $this->formaterNoms($resultat); break; |
default : break; |
} |
return json_encode($reponse); |
} |
//----------------------concerne les resultats pour des requetes de type noms/id---------------------------------------- |
/** |
* Formate et retourne toutes les relations correpondant au nom recherché : les flores, les synonyme et les homonymes |
* @param array $resultat |
*/ |
public function formaterIdRelations($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
$res_version = $res_version[0]; |
$this->resultat_req = $res_version; |
$retour_id_rel = array ('entete' => array()); //on initialise pr que l'entete apparaisse en premier lors de l'affichage |
//on recupère le resultat de chaque relation (appel du WS correspondant) |
$flores = $this->ajouterRelations('flores', $version); |
if (isset($flores)) $retour_id_rel['resultat']['flores'] = $flores; |
$homonymes = $this->ajouterRelations('homonymie', $version); |
if (isset($homonymes)) $retour_id_rel['resultat']['homonymes'] = $homonymes; |
$synonymes = $this->ajouterRelations('synonymie', $version); |
if (isset($synonymes)) $retour_id_rel['resultat']['synonyme'] = $synonymes; |
//on renvoit un tableau null si il n'existe aucune relations (on efface l'entete en premier lieu) |
if (!isset($retour_id_rel['resultat'])) { |
$retour_id_rel = null; |
//on rajoute l'entete si des relations existent |
} else { |
$this->afficherDonnees('num_nom', $this->table_ressources[0]); |
$retour_id_rel['entete'] = $this->table_retour; |
$this->table_retour = array(); |
} |
//recuperation du resultat de chaque version |
$res = $this->afficherVersionOuPas($version, $retour_id_rel, $res); |
} |
return $res; |
} |
/** |
* Recupere les relations (type de la relation passée en paramètres :[type_relation] = synonymie, homonymie ou |
* flores) par l'appel du web service [version]/noms/#id/relations/[type_relation] |
* @param String $relation |
* @param String $version (numéro de la version) |
*/ |
public function ajouterRelations($relation, $version) { |
$version = str_replace(Config::get('bdd_table').'_v', '', $version); |
$res = null; |
$parametres_url = ''; |
if ($this->table_param != array()) $parametres_url = '?'.http_build_query($this->table_param, '', '&'); |
$url = Config::get('url_service').'/'.$version.'/'.$this->service.'/'.$this->table_ressources[0].'/relations/' |
.$relation.$parametres_url; |
$relation = $this->rest_client->consulter($url); |
$entete = $this->rest_client->getReponseEntetes(); |
//Si le service meta-donnees fonctionne correctement, l'entete comprend la clé wrapper_data |
if (isset($entete['wrapper_data'])) { |
$relation = json_decode($relation); |
if (isset($relation->resultat)) { |
$res = $relation->resultat; |
} |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Le service '.$this->service.' de ce projet comporte des erreurs. url lancée : '.$url); |
} |
return $res; |
} |
/** |
* Formate et retourne toutes les synonymes correpondants au nom recherché |
* @param array $resultat |
*/ |
public function formaterIdSynonymie($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
$retour_id_syn = array(); |
if ($res_version[0]['num_nom_retenu'] == '') { |
$retour_id_syn[] = 'nom_retenu N.D.'; |
} elseif (count($res_version) != 1) { |
//on remplit d'abord l'entete du resultat |
$this->table_retour['id'] = $this->table_ressources[0]; |
$this->afficherEnteteRangBorneTotalUrls($res_version, '/'.$this->service.'/'.$this->table_ressources[0].'/relations/synonymie'); |
$retour_id_syn['entete'] = $this->table_retour; |
$this->table_retour = array(); |
//on remplit ensuite les resultats |
foreach ($res_version as $tab) { |
//pour chaque basionyme, on recupère le résultat : num_nom, nom_sci, basionyme et num_nom_retenu : |
$this->resultat_req = $tab; |
foreach ($tab as $key => $val) { |
if ($val != '') { |
switch ($key) { |
case 'num_nom_retenu' : $retenu = ($val == $num) ? 'true' : 'false'; |
$this->table_retour['retenu'] = $retenu; break; |
case 'basionyme' : $this->afficherDonnees($key, $val); break; |
case 'num_nom' : $num = $val; |
$this->afficherDonnees($key, $val); |
unset($this->table_retour['id']); break; |
default : break; |
} |
} |
} |
$retour_id_syn['resultat'][$num] = $this->table_retour; |
$this->table_retour = array(); |
} |
} |
if (!isset($retour_id_syn['resultat']) && !in_array('nom_retenu N.D.', $retour_id_syn)) { |
$retour_id_syn = null; //on initialise le resultat à null |
} |
$res = $this->afficherVersionOuPas($version, $retour_id_syn, $res); |
} |
return $res; |
} |
/** |
* Formate et retourne toutes les homonymes correpondants au nom recherché |
* @param array $resultat |
*/ |
public function formaterIdHomonymie($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
if (count($res_version) != 1) { |
$this->table_retour['id'] = $this->table_ressources[0]; |
$this->afficherEnteteRangBorneTotalUrls($res_version, '/'.$this->service.'/'.$this->table_ressources[0].'/relations/homonymie'); |
$retour_id_hom['entete'] = $this->table_retour; |
$this->table_retour = array(); |
foreach ($res_version as $homonyme) { |
$this->resultat_req = $homonyme; |
$id = $homonyme['num_nom']; |
$this->afficherDonnees('num_nom', $id); |
if ($homonyme['num_nom_retenu'] != '') { |
$retenu = ($id == $homonyme['num_nom_retenu']) ? 'true' : 'false'; |
$this->table_retour['retenu'] = $retenu; |
} |
$retour_id_hom['resultat'][$id] = $this->table_retour; |
unset($retour_id_hom['resultat'][$id]['id']); |
$this->table_retour = array(); |
} |
} else { |
$retour_id_hom = null; |
} |
$res = $this->afficherVersionOuPas($version, $retour_id_hom, $res); |
} |
return $res; |
} |
public function formaterIdFlores($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp,noms_projets'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
$res_version = $res_version[0]; |
$this->resultat_req = $res_version; |
$id = array_shift($res_version); |
//-----formatage de l'entete du résultat |
$reponse['entete']['id'] = $id; |
//-----formatage du résultat |
$total = 0; |
foreach ($res_version as $flores => $valeur) { |
if ($valeur != '' && $valeur != '0') { |
$this->afficherInfosFlore($res_version, $flores, $valeur); |
$total++; |
} |
} |
$reponse['entete']['total'] = $total; |
if ($this->table_retour != array()) { |
$reponse['resultat'] = $this->table_retour; |
$this->table_retour = array(); |
} else { |
$reponse = null; |
} |
//Si les infos de plrs versions sont renvoyés, on ajoute au tableau de resultat le numéro de la version |
$res = $this->afficherVersionOuPas($version, $reponse, $res); |
} |
return $res; |
} |
public function afficherInfosFlore(&$resultat, $flores, $valeur) { |
$flore = substr($flores,0,strrpos($flores, '_')); |
if (strrpos($flores, 'num') !== false) { |
$projet = $this->noms_projets[$flore]; |
if (preg_match('/^([0-9]+)(?:[.]syn[^a-z]*|(.*))?$/', $valeur, $match)) { |
$this->table_retour[$flore]['id'] = $match[1]; |
$this->table_retour[$flore]['href'] = $this->ajouterHrefAutreProjet('noms', $match[1], $projet); |
if (isset($match[2]) && $match[2] != '') $this->table_retour[$flore]['cle'] = $match[2]; |
} |
if (isset($resultat[$flore.'_rem']) && !empty($resultat[$flore.'_rem'])) { |
$this->table_retour[$flore]['remarque'] = $resultat[$flore.'_rem']; |
unset($resultat[$flore.'_rem']); |
} |
} elseif (strrpos($flores,'belge') !== false) { |
$projet = $this->noms_projets[$flore]; |
if (preg_match('/^([0-9]+) (R|S)?$/', $valeur, $match)) { |
if (isset($match[2])) $type = ($match[2] == 'R') ? 'taxons' : 'synonyme'; |
$this->table_retour[$flore]['page'] = $match[1]; |
$this->table_retour[$flore]['type'] = $type; |
//$this->table_retour[$flore]['href'] = $this->ajouterHrefAutreProjet('noms', $match[1], $projet); |
} |
} |
} |
//----------------------concerne les resultats pour des requetes de type /noms avec ou sans paramètres------------------ |
/** |
* |
* Est utilisée pour les requetes de type /noms avec ou sans parametres. Détermine le format json ou oss. |
* @param retourne le résultat sous forme de tableau, à encoder en json. |
*/ |
public function formaterNoms($resultat) { |
if ($this->retour_format == 'oss') { |
$reponse = $this->formaterEnOss($resultat); //Ds CommunNomsTaxons.php |
} else { |
$reponse = $this->formaterEnJsonMax($resultat); |
} |
return $reponse; |
} |
/** |
* |
* Permet de créer un tableau ($table_retour_json) au format defaut puis de l'encoder en json (json_encode). |
* Le format comprend deux parties, une partie entete (contenu dans le tableau $entete_json) et une partie |
* resultat (contenu dans le tableau $resultat_json). |
* @param string $resultat : résultat de la requete (liste des noms et leur identifiant) |
* @return une chaine encodé json (format par default) |
*/ |
public function formaterEnJsonMax($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
//on remplit la table $table_retour_json['entete'] |
$masque = $this->ordonnerMasque(); |
if ($masque != '') $this->table_retour['masque'] = $masque; |
$this->afficherEnteteRangBorneTotalUrls($res_version, '/'.$this->service); |
$table_retour_json['entete'] = $this->table_retour; |
$this->table_retour = array(); |
//on remplit la table $table_retour_json['resultat'] |
foreach ($res_version as $tab) { |
$this->resultat_req = $tab; |
foreach ($tab as $key => $val) { |
if ($val != '') { |
switch ($key) { |
case 'num_nom' : $num = $val; |
$this->afficherDonnees($key, $val); break; |
case 'nom_sci' : if ($this->retour_format == 'min') { |
// sinon est affiché ds afficherDonnees(num_nom, $val) ci-dessus |
$this->table_retour[$key] = $val.$this->ajouterCompositionNom($tab); |
} break; |
case 'num_nom_retenu' : |
$retenu = ($val == $num) ? 'true' : 'false'; |
$this->table_retour['retenu'] = $retenu; break; |
default : break; |
} |
unset($this->table_retour['id']); |
} |
} |
$resultat_json[$num] = $this->table_retour; |
$this->table_retour = array(); |
} |
$table_retour_json['resultat'] = $resultat_json; |
$res = $this->afficherVersionOuPas($version, $table_retour_json, $res); |
} |
return $res; |
} |
} |
?> |
Property changes: |
Added: svn:executable |
+* |
\ No newline at end of property |
/trunk/services/modules/0.1/coste/Taxons.php |
---|
New file |
0,0 → 1,732 |
<?php |
// declare(encoding='UTF-8');// ou ISO-8859-15 |
/** |
* Description : |
* Classe Taxons.php permettant de fournir des informations sur les noms scientifiques retenu. |
* Si l'url finit par /taxons on retourne une liste de noms latin et leurs identifiants (seulement les 100 premeiers noms par défaut). |
* L'url peut contenir des paramètres optionnels passés après le ? : /taxons?param1=val1¶m2=val2&... |
* |
* Les paramètres de requête disponibles sont : masque, recherche, rang, distinct, retour.format, nl.format, |
* nl.structure, navigation.depart et navigation.limite. |
* |
* Encodage en entrée : utf8 |
* Encodage en sortie : utf8 |
* @package framework-v3 |
* @author Jennifer Dhé <jennifer.dhe@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> |
* @version 1.0 |
* @copyright 1999-${year} Tela Botanica (accueil@tela-botanica.org) |
*/ |
class Taxons extends CommunNomsTaxons { |
/** |
* Valeur du paramètre de requete recherche stricte, etendue, floue */ |
protected $recherche = false; |
/** Permet de stocker la requete formulée : |
* - taxons | taxons/#id | taxons/#id/#champ+#champ |
* - taxons/#id/relations | taxons/#id/relations/synonymie | taxons/#id/relations/homonymie |
* | taxons/#id/relations/flores | taxons/#id/relations/superieurs | taxons/#id/relations/inferieurs |
* - taxons/stats/rangs | taxons/stats/annees | taxons/stats/initiales */ |
protected $format_reponse = 'taxons'; |
/** Représente la première partie de la requete SQL (entre le SELECT et le WHERE)*/ |
protected $requete_champ = 'num_nom, nom_sci, num_nom_retenu, num_tax '; |
/** Représente la partie de la requete SQL ajoutant une condition (WHERE ...)*/ |
protected $requete_condition = 'num_nom = num_nom_retenu '; |
/** Représente la partie GROUP BY de la requete SQL (GROUP BY ...) */ |
protected $requete_group_by = ' '; |
/** Permet de stocker les limite de la requete SQL (par défaut seul les 100 premiers résultats seront retournés). */ |
protected $limite_requete = array('depart' => 0, 'limite' => 100); |
/** Stocke le num_nom du nom retenu du num_nom recherché */ |
protected $num_nom_taxon; |
protected $service = 'taxons'; |
protected $presence_num_tax = true; |
public function consulter($ressources, $parametres) { |
$resultat_formate = ''; |
$this->initialiserRestClient(); //création d'un objet RestClient |
$this->traiterParametres($parametres); |
$this->traiterVersionProjet($ressources) ; |
if ($this->corps_http == '' && $this->entete_http == '') { |
foreach ($this->table_version as $version) { |
$this->table = $version; //on stocke ici la table correspondant à la version du projet analysée |
$this->recupererNomChamp($this->table); |
$this->gererNumTax(); |
$this->traiterRessources($ressources); |
if ($this->corps_http == '' && $this->entete_http == '') { |
$requete = $this->assemblerLaRequete(); |
$resultat = $this->getBdd()->recupererTous($requete); |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Fct consulter() : La requete formée comporte une erreur !!'); |
} elseif ($resultat) { |
$res_version[$version] = $resultat; |
} else { //cas ou la requete renvoi un tableau vide |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Données introuvables dans la base '.$version.' <br/> |
L\'identifiant demande n\'est pas un taxon et aucun taxon ne lui a ete attribue'); |
} |
} |
} |
} |
if ($this->corps_http == '' && $this->entete_http == '') { |
$resultat_formate = $this->retournerResultatFormate($res_version); |
} |
$this->formerReponseHTTP($resultat_formate); |
} |
/** |
* |
* Permet d'analyser les paramètres |
* @param array $parametres |
*/ |
public function traiterParametres($parametres) { |
$this->table_param = $parametres; |
if (isset($parametres) && ($parametres)) { |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $val) { |
switch ($param) { |
case 'ns_format' : $this->html = $val; break; |
case 'ns_structure' : $this->remplirTableCompositionNom($val); |
$this->requete_champ .= ' ,'.implode(', ',$this->compo_nom); break; |
case 'masque' : $this->ajouterFiltreMasque($val); break; |
case 'masque_nt' : $this->ajouterFiltreMasqueNt($val); break; |
case 'masque_rg' : $this->requete_condition .= ' AND rang = '.$this->getBdd()->proteger($val); break; |
case 'navigation_depart': $this->limite_requete['depart'] = $val; break; |
case 'navigation_limite': $this->limite_requete['limite'] = $val; break; |
case 'retour_format' : $this->retour_format = $val; break; |
case 'recherche' : break; |
default : $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans les parametres de recherche de votre |
requete : </br> Le parametre " '.$param.' " n\'existe pas.'); |
break; |
} |
} |
} |
} |
public function ajouterFiltreMasque($val) { |
if ($this->recherche == 'etendue') { |
$val = str_replace(' ','%', $val); |
$val .= '%'; |
$this->requete_condition .= ' AND nom_sci LIKE '.$this->getBdd()->proteger($val); |
} elseif ($this->recherche == 'floue') { |
$this->requete_condition .= ' AND (SOUNDEX(nom_sci) = SOUNDEX(\''.$val.'\')' |
.' OR SOUNDEX(REVERSE(nom_sci)) = SOUNDEX(REVERSE(\'' |
.$val.'\'))) '; |
} else { |
$this->requete_condition .= ' AND nom_sci LIKE '.$this->getBdd()->proteger($val); |
} |
} |
public function ajouterFiltreMasqueNt($val) { |
if (strrpos($val, ',') !== false) { |
$ids_taxon = explode(",", $val); |
} else { |
$ids_taxon[] = $val; |
} |
foreach ($ids_taxon as $id) { |
$this->requete_condition .= ' OR num_tax = '.$this->getBdd()->proteger($id); |
} |
$this->requete_condition = str_replace('num_nom = num_nom_retenu OR ', |
'num_nom = num_nom_retenu AND (' , $this->requete_condition).')'; |
} |
/** |
* Permet d'ajouter à la requete_champ les parametres demandés qui composeront le nom_sci. |
* Permet de remplir le tableau compo_nom qui regroupe les parametres demandés qui composeront le nom_sci. |
* (parametres à ajouter aux nom_sci sous la forme : Auteur [annee, biblio] [addendum]) |
* @param la valeur du parametre nl.structure |
*/ |
public function recupererParametreNom($valeur) { |
$structure_nom = explode(",",$valeur); |
foreach ($structure_nom as $structure) { |
switch ($structure) { |
case 'au' : $this->compo_nom['au'] = 'auteur'; break; |
case 'an' : $this->compo_nom['an'] = 'annee'; break; |
case 'bib' : $this->compo_nom['bib'] = 'biblio_origine'; break; |
case 'ad' : $this->compo_nom['ad'] = 'nom_addendum'; break; |
default : $this->renvoyerErreur( RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur : Le parametre "'.$structure.'" n\'existe pas. <br/><br/> |
Les parametres du nom possibles sont : |
<li> au (auteur)</li><li> an (annee)</li> |
<li> bib (bibliographie)</li><li> ad (nom_addendum)</li>'); |
break; |
} |
} |
if (isset($this->compo_nom)) { |
$this->requete_champ .= ' ,'.implode(', ',$this->compo_nom); |
} |
} |
//------------------------------------------Fonction ressources--------------------------------------------------------------------- |
public function gererNumTax() { |
if (!in_array('num_tax', $this->champs_table)) { |
$this->presence_num_tax = false; |
$this->requete_champ = str_replace(', num_tax ', '', $this->requete_champ); |
} else { |
$this->presence_num_tax = true; |
} |
} |
public function traiterRessourcesIdentifiant() { |
$this->format_reponse = 'taxons/id'; |
$this->num_nom_taxon = $this->recupererNumNomTaxon(); //on recupere le taxon correspondant au num_nom recherché |
if ($this->entete_http == '') { |
$this->requete_condition = ' num_nom = '.$this->num_nom_taxon; |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
//---------------- requete de type taxons/#id/#champ+#champ-------------------------------------- |
if ($this->table_ressources[1] != 'relations') { |
// SELECT *, nom_sci FROM bftfx_v2_00 WHERE num_nom = X; |
$this->requete_champ = ' *, nom_sci '; |
$this->format_reponse .= '/champ'; |
//---------------- requete de type taxons/#id/relations/#relation-------------------------------- |
} elseif ($this->table_ressources[1] == 'relations') { |
$this->traiterRessourceIdRelations(); |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requete </br> Ressources disponibles : <br/> |
<li> #id/relations </li> <li> #id/#champ+#champ </li> <li> #id/relations </li> |
<li> #id/relations/inferieurs </li> <li> #id/relations/superieurs </li>'); |
} |
} else { |
//--------------- requete de type taxons/#id----------------------------------------------------- |
$this->requete_champ = ' *, nom_sci '; |
} |
} |
} |
/** |
* Permet de récupérer le num_nom du taxon recherché. Soit le numéro taxonomique est demandé (avec nt: ) |
* soit un num_nom dont on recherche le num_nom_retenu |
*/ |
public function recupererNumNomTaxon() { |
$identifiant = ''; |
if (strrpos($this->table_ressources[0], 'nt:') !== false) { |
if ($this->presence_num_tax) { |
// SELECT num_nom FROM bdtfx_v2_00 WHERE num_nom = num_nom_retenu AND num_tax = X; |
$this->requete_condition = ' num_nom = num_nom_retenu AND num_tax = ' |
.str_replace('nt:', '', $this->table_ressources[0]).' '; |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requete : </br> Le numero taxonomique n\'existe pas dans ce projet' ); |
} |
} else { |
// SELECT num_nom FROM bdtfx_v2_00 WHERE num_nom = (SELECT num_nom_retenu FROM bdtfx_v2_00 WHERE num_nom = X); |
$this->requete_condition = ' num_nom = (SELECT num_nom_retenu FROM ' |
.$this->table.' WHERE num_nom = '.$this->table_ressources[0].')'; |
} |
if ($this->entete_http == '') { |
//on récupere l'identifiant du taxon correspondant au num_nom ou num_tax demandé pour pouvoir l'afficher |
$res = ''; |
$req_tax = 'SELECT num_nom FROM '.$this->table.' WHERE '.$this->requete_condition; |
$res_tax = $this->getBdd()->recuperer($req_tax); |
//on recherche ensuite les identifiants des taxons supérieurs ou inférieurs |
if ($res_tax == '') { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Le numéro de taxon ou l\'identifiant de nom correspondant au num_nom ' |
.$this->table_ressources[0].' n\'existe pas dans la table '.$this->table); |
} elseif ($res_tax) { |
$identifiant = $res_tax['num_nom']; |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Le numéro de taxon ou l\'identifiant de nom correspondant au num_nom ' |
.$this->table_ressources[0].' n\'existe pas dans la table '.$this->table); |
} |
} |
return $identifiant; |
} |
public function traiterRessourceIdRelations() { |
//----------------- requete de type taxons/#id/relations------------------------------------------- |
// SELECT *, nom_sci FROM bftfx_v2_00 WHERE num_nom = X; |
$this->format_reponse .= '/relations'; |
if (isset($this->table_ressources[2])) { |
//------------- requete de type taxons/#id/relations/#relation-------------------------------- |
switch ($this->table_ressources[2]) { |
case 'superieurs' : $rel = 'recupererIdSup'; |
$this->format_reponse .= '/superieurs'; |
$this->traiterRessourceIdRelationInfSup($rel); break; |
case 'inferieurs' : $rel = 'recupererIdInf'; |
$this->format_reponse .= '/inferieurs'; |
$this->traiterRessourceIdRelationInfSup($rel); break; |
default : $this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, |
'Erreur dans votre requête </br> Ressources disponibles : <br/> |
<li> taxons/#id/relations </li> <li> taxons/#id/relations/flores </li> |
<li> taxons/#id/relations/homonymie </li> <li> #id/relations/inferieurs </li> |
<li> #id/relations/superieurs </li>'); break; |
} |
} |
} |
public function traiterRessourceIdRelationInfSup($rel) { |
//Appel de la fct récupérerIdSup ou recupererIdInf : retourne les num_nom des noms inferieurs ou superieurs |
$res_relation = $this->$rel(); |
//analyse du résultat retourné par la requete de recherche des identifiants correspondant aux taxons inf|sup : |
if ($res_relation == '') { //dans le cas ou la requete comporte des erreurs |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Fct traiterRessourceIdHomonymie : La requete forme comporte une erreur !!'); |
} elseif ($res_relation) { |
//dans le cas ou une ou plusieurs relations est retournée, on récupère les identifiants ss la forme (id, id, id) |
foreach ($res_relation as $ligne) $res[] = $ligne['num_nom']; |
$res = implode(',',$res); |
$this->requete_condition = ' num_nom IN ('.$res.')'; |
$this->requete_champ .= ', rang, num_tax_sup '; |
} else { //dans le cas ou aucune relation n'existe |
$res = array($this->num_nom_taxon => null); |
$this->corps_http = json_encode($res); |
$this->entete_http = RestServeur::HTTP_CODE_OK; |
} |
} |
public function recupererIdInf() { |
//SELECT num_nom FROM bfdtx_v2_00 WHERE num_tax_sup = (SELECT num_nom FROM bdtfx_v2_00 WHERE num_nom = X); |
$req_relation = 'SELECT num_nom FROM '.$this->table |
.' WHERE num_tax_sup = (SELECT num_nom FROM ' |
.$this->table |
.' WHERE '.$this->requete_condition.')'; |
$res_relation = $this->getBdd()->recupererTous($req_relation); |
return $res_relation; |
} |
public function recupererIdSup() { |
//SELECT num_nom FROM bfdtx_v2_00 WHERE num_nom = (SELECT num_tax_sup FROM bdtfx_v2_00 WHERE num_nom = X); |
$req_relation = 'SELECT num_nom FROM '.$this->table |
.' WHERE num_nom = (SELECT num_tax_sup FROM ' |
.$this->table |
.' WHERE '.$this->requete_condition.')'; |
$res_relation = $this->getBdd()->recupererTous($req_relation); |
return $res_relation; |
} |
public function traiterRessourceStatsInitiales() { |
// SELECT count(nom_sci) as nb, rang, left(nom_sci, 2) as lettre FROM bdtfx_v2_00 GROUP BY rang, left(nom_sci, 2); |
$this->format_reponse = 'taxons/stats/initiales'; |
$this->requete_champ = 'count(nom_sci) as nb, rang, left(nom_sci, 2) as lettre '; |
$this->requete_group_by = ' GROUP BY rang, left(nom_sci, 2) '; |
} |
public function traiterRessourceStatsRangs() { |
// SELECT count(*) as nombre, rang FROM bdtfx_v2_00 [WHERE rang = 290] GROUP BY rang ORDER BY rang; |
$this->format_reponse = 'taxons/stats/rangs'; |
$this->requete_champ = 'count(*) as nombre, rang '; |
$this->requete_group_by = ' GROUP BY rang ORDER BY rang '; |
} |
public function traiterRessourceStatsAnnees() { |
// SELECT count(*) as nombre, annee FROM bdtfx_v2_00 GROUP BY annee ORDER BY annee; |
$this->format_reponse = 'taxons/stats/annees'; |
$this->requete_champ = 'count(*) as nombre, annee '; |
$this->requete_group_by = ' GROUP BY annee ORDER BY annee '; |
} |
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE----------------------------------------------------- |
public function assemblerLaRequete() { |
if ($this->format_reponse != 'taxons/stats/initiales') { |
$this->mettreAuFormat(); //on remplace les nom_sci par les nom_sci_html |
} |
if ($this->requete_condition != '') { |
$this->requete_condition = ltrim($this->requete_condition, ' AND, WHERE'); |
$this->requete_condition = ' WHERE '.$this->requete_condition; |
} |
if ($this->format_reponse != 'taxons' && $this->format_reponse != 'taxons/id/relations/homonymie') { |
$this->requete_limite = ''; |
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) { |
$this->limite_requete['depart'] = (($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']); |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} else { |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} |
$requete = ' SELECT '.$this->requete_champ. |
' FROM '.$this->table |
.$this->requete_condition |
.$this->requete_group_by |
.$this->requete_limite; |
return $requete; |
} |
/** |
* Recupere le nombre total de résultat d'une requete lancée. |
* Est utilisée lors de l'affichage du total dans le résultat retourné |
* @return Le nombre total de résultat |
*/ |
public function recupererTotalResultat() { |
$requete = 'SELECT count(*) as nombre FROM '.$this->table.$this->requete_condition.$this->requete_group_by; |
$res = $this->getBdd()->recuperer($requete); |
if ($res) { |
$total = $res['nombre']; |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Fct recupererTotalResultat() : <br/>Données introuvables dans la base'); |
} |
return $total; |
} |
//-------------------------FONCTIONS DE FORMATION DU RESULTAT----------------------------------------------------------- |
/** |
* Permet de récupérer le résultat à retourner propre à chaque requete et de l'encoder en json |
* @param array $resultat |
* @param array $ressources |
* @return le résultat encoder en json |
*/ |
public function retournerResultatFormate($resultat) { |
switch ($this->format_reponse) { |
case 'taxons/id' : $reponse = $this->formaterId($resultat); break; //ds CommunNomsTaxons |
case 'taxons/id/champ' : $reponse = $this->formaterIdChamp($resultat); break; //ds CommunNomsTaxons |
case 'taxons/id/relations' : $reponse = $this->formaterIdRelations($resultat); break; |
case 'taxons/id/relations/superieurs' : $reponse = $this->formaterIdSuperieur($resultat); break; |
case 'taxons/id/relations/inferieurs' : $reponse = $this->formaterIdInferieur($resultat); break; |
case 'taxons/stats/annees' : $reponse = $this->formaterStatsAnnee($resultat); break; //ds CommunNomsTaxons |
case 'taxons/stats/rangs' : $reponse = $this->formaterStatsRang($resultat); break; //ds CommunNomsTaxons |
case 'taxons/stats/initiales' : $reponse = $this->formaterStatsInitiales($resultat); break; //ds CommunNomsTaxons |
case 'taxons' : $reponse = $this->formatertaxons($resultat); break; |
default : break; |
} |
return json_encode($reponse); |
} |
//----------------------concerne les resultats pour des requetes de type /noms avec ou sans paramètres-------------- |
/** |
* |
* Est utilisée pour les requetes de type /noms avec ou sans parametres. Détermine le format json ou oss. |
* @param retourne le résultat sous forme de tableau, à encoder en json. |
*/ |
public function formaterTaxons($resultat) { |
if ($this->retour_format == 'oss') { |
$reponse = $this->formaterEnOss($resultat); |
} else { |
$reponse = $this->formaterEnJsonMax($resultat); |
} |
return $reponse; |
} |
/** |
* |
* Permet de créer un tableau ($table_retour_json) au format defaut puis de l'encoder en json (json_encode). |
* Le format comprend deux parties, une partie entete (contenu dans le tableau $entete_json) et une partie |
* resultat (contenu dans le tableau $resultat_json). |
* @param string $resultat : résultat de la requete (liste des noms et leur identifiant) |
* @return une chaine encodé json (format par default) |
*/ |
public function formaterEnJsonMax($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
//on remplit la table $table_retour_json['entete'] |
if (isset($this->table_param['masque'])) $this->afficherDonnees('masque', $this->table_param['masque']); |
if (isset($this->table_param['masque_nt'])) $this->afficherDonnees('masque.nt', $this->table_param['masque_nt']); |
$this->afficherEnteteRangBorneTotalUrls($res_version, '/'.$this->service); |
$table_retour_json['entete'] = $this->table_retour; |
$this->table_retour = array(); |
//on remplit la table $table_retour_json['resultat'] |
$tab_tax_inf = $this->recupererListeTaxonInf($res_version); |
foreach ($res_version as $tab) { |
$this->resultat_req = $tab; |
if (isset($this->table_param['masque_nt'])) $this->afficherDonnees('num_tax', $tab['num_tax']); |
foreach ($tab as $key => $val) { |
if ($val != '') { |
switch ($key) { |
case 'num_nom' : $num = $val; |
$this->afficherDonnees($key, $val); break; |
case 'num_nom_retenu' : $retenu = ($val == $num) ? 'true' : 'false'; |
$this->table_retour['retenu'] = $retenu; break; |
default : break; |
} |
} |
} |
$this->afficherTaxonInfNb($num, $tab_tax_inf); |
unset($this->table_retour['id']); |
$resultat_json[$num] = $this->table_retour; |
$this->table_retour = array(); //on vide le tableau table_retour |
} |
$table_retour_json['resultat'] = $resultat_json; |
$res = $this->afficherVersionOuPas($version, $table_retour_json, $res); |
} |
return $res; |
} |
//--------------------concerne les resultats pour des requetes de type noms/id---------------------------------------- |
public function formaterIdRelations($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
$this->resultat_req = $res_version; |
$retour_id_rel = array ('entete' => array()); //on initialise pr que l'entete apparaisse en premier |
//on affiche le resultat |
$superieurs = $this->ajouterRelations('superieurs', $version); |
if (isset($superieurs)) $retour_id_rel['resultat']['superieurs'] = $superieurs; |
$inferieurs = $this->ajouterRelations('inferieurs', $version); |
if (isset($inferieurs)) $retour_id_rel['resultat']['inferieurs'] = $inferieurs; |
//on renvoit un tableau null si il n'existe aucune relations |
if (!isset($retour_id_rel['resultat'])) { |
$retour_id_rel = null; |
//on rajoute l'entete si des relations existent |
} else { |
$this->afficherDonnees('num_nom', $this->num_nom_taxon); //$this->afficherEnteteRangBorneTotalUrls($resultat, '/'.$this->service.'/'.$this->table_ressources[0].'/relations/synonymie'); |
$retour_id_rel['entete'] = $this->table_retour; |
$this->table_retour = array(); |
} |
//recuperation du resultat de chaque version |
$res = $this->afficherVersionOuPas($version, $retour_id_rel, $res); |
} |
return $res; |
} |
public function ajouterRelations($relation, $version) { |
$version = str_replace(Config::get('bdd_table').'_v', '', $version); |
$res = null; |
$taxon = $this->num_nom_taxon; |
$parametres_url = ''; |
if ($this->table_param != array()) $parametres_url = '?'.http_build_query($this->table_param, '', '&'); |
$url = Config::get('url_service').'/'.$version.'/' |
.$this->service.'/'.$this->table_ressources[0].'/relations/' |
.$relation.$parametres_url; |
$relation = $this->rest_client->consulter($url); |
$entete = $this->rest_client->getReponseEntetes(); |
//Si le service meta-donnees fonctionne correctement, l'entete comprend la clé wrapper_data |
if (isset($entete['wrapper_data'])) { |
$relation = json_decode($relation); |
if (isset($relation->resultat)) { |
$res = $relation->resultat; |
} elseif (isset($relation->$taxon)) { //pour les relations inf et sup |
$res = $relation->$taxon; |
} |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Le service '.$this->service.' de ce projet comporte des erreurs. url lancée : '.$url); |
} |
return $res; |
} |
public function formaterIdSuperieur($resultat) { |
$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
//on remplit le tableau de formatage |
if (($res_version) != '' ) { |
//on recupere d'abord les rangs supérieurs |
$sup = $res_version[0]; |
do { |
$sup = $this->recupererIdSuperieur($sup['num_tax_sup'], $version); |
if ($sup['rang'] == '0') $sup['rang'] = '10'; //erreur dans la base |
if (isset($sup)) $res_version[] = $sup; |
} while ($sup != null); |
krsort($res_version); |
//on les affiche ensuite |
foreach ($res_version as $tab) { |
$this->resultat_req = $tab; |
foreach ($tab as $key => $val) { |
if ($val != '') { |
switch ($key) { |
case 'num_nom' : $num = $val; |
$this->afficherDonnees($key, $num); break; |
case 'num_nom_retenu' : $retenu = ($val == $num) ? 'true' : 'false'; |
$this->table_retour['retenu'] = $retenu; break; |
case 'rang' : $this->afficherDonnees($key, $val); break; |
default : break; |
} |
} |
} |
unset($this->table_retour['id']); |
$tab_inf[$num] = $this->table_retour; |
$this->table_retour = array(); |
} |
$tab_relation[$this->num_nom_taxon] = $tab_inf; |
} else { //si il n'existe aucune relation |
$tab_relation = null; |
} |
//recuperation du resultat de chaque version |
$res = $this->afficherVersionOuPas($version, $tab_relation, $res); |
} |
return $res; |
} |
public function recupererIdSuperieur($id, $version) { |
$req = 'SELECT num_nom, num_nom_retenu, num_tax_sup, rang FROM ' |
.$version.' WHERE num_nom = '.$this->getBdd()->proteger($id); |
$res = $this->getBdd()->recupererTous($req); |
if ($res) { |
$resultat = $res[0]; |
} else { |
$resultat = null; //on return null si il n'y a pas de taxon superieur |
} |
return $resultat; |
} |
public function formaterIdInferieur($resultat) { |
$this->recupererTableSignification('champs_api,champs_comp,correspondance_champs'); |
$res = array(); |
foreach ($resultat as $version => $res_version) { |
//on veut récupérer pour chacun des taxons inférieur le nb de taxons inf : |
$tab_tax_inf = $this->recupererListeTaxonInf($res_version); |
//on commence le formatage |
if (($res_version) != '' ) { |
foreach ($res_version as $tab) { |
$this->resultat_req = $tab; |
foreach ($tab as $key => $val) { |
if ($val != '') { |
switch ($key) { |
case 'num_nom' : $num = $val; |
$this->afficherDonnees($key, $num); break; |
case 'num_nom_retenu' : $retenu = ($val == $num) ? 'true' : 'false'; |
$this->table_retour['retenu'] = $retenu; break; |
default : break; |
} |
} |
} |
$this->afficherTaxonInfNb($num, $tab_tax_inf); |
unset($this->table_retour['id']); |
$tab_inf[$num] = $this->table_retour; |
$this->table_retour = array(); //on vide le tableau table_retour |
} |
$tab_relation[$this->num_nom_taxon] = $tab_inf; |
} else { |
$tab_relation = null; |
} |
//recuperation du resultat de chaque version |
$res = $this->afficherVersionOuPas($version, $tab_relation, $res); |
} |
return $res; |
} |
public function afficherTaxonInfNb($num, $tab_tax_inf) { |
foreach ($tab_tax_inf as $taxNb) { |
if ($taxNb['num_tax_sup'] == $num) { |
$this->table_retour['taxon_inferieur_nbre'] = $taxNb['nb']; |
} |
} |
if (!isset($this->table_retour['taxon_inferieur_nbre'])) { |
$this->table_retour['taxon_inferieur_nbre'] = '0'; |
} |
} |
public function recupererListeTaxonInf($resultat) { |
// SELECT num_tax_sup, count(*) as nb FROM bdtfx_v2_00 WHERE num_tax_sup IN (id, id, id) AND num_nom = num_nom_retenu GROUP BY num_tax_sup'; |
foreach ($resultat as $tab) { |
$tab_num[] = $tab['num_nom']; //on regroupe ici les id des taxons dont on cherche le nb de taxon inf |
} |
$req = 'SELECT num_tax_sup, count(*) as nb FROM '.$this->table |
.' WHERE num_tax_sup IN ('.implode(',',$tab_num) |
.') AND num_nom = num_nom_retenu GROUP BY num_tax_sup'; |
$res = $this->getBdd()->recupererTous($req); |
if ($res) { |
$resultat = $res; |
} else { |
$resultat = array(); //on return un tableau vide s'il n'y a pas de taxon inférieurs |
} |
return $resultat; |
} |
} |
?> |
/trunk/services/modules/0.1/coste/Textes.php |
---|
New file |
0,0 → 1,449 |
<?php |
/** |
* Description : |
* Classe Textes.php est une classe qui contient les méthodes permettant la consultation des textes (clé de détermination |
* ou description). Les identifiants des textes correspondent au tag de type CleCoste1937TXXPXXNomSci pour le projet |
* coste. |
* Encodage en entrée : utf8 |
* Encodage en sortie : utf8 |
* @package framework-v3 |
* @author Jennifer Dhé <jennifer.dhe@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> |
* @version 1.0 |
* @copyright 1999-${year} Tela Botanica (accueil@tela-botanica.org) |
*/ |
class Textes extends Commun { |
protected $limite_requete = array('depart' => 0, 'limite' => 100); |
protected $requete_champ = ' t1.resource AS tag, t1.value AS num_nom, t2.value AS titre, p.body AS texte'; |
protected $requete_condition = null; |
protected $requete_group_by = ' ORDER BY CAST( t1.value AS DECIMAL )'; |
protected $table_retour; |
protected $retour_format = 'max'; |
protected $format_reponse = 'textes'; |
protected $table_param = array(); |
protected $total_resultat; |
protected $table_ressources = array(); |
protected $html = 'txt'; |
protected $recherche = 'stricte'; |
protected $service = 'textes'; |
protected $masque = null; |
public function consulter($ressources, $parametres) { |
$resultat_formate = ''; |
$this->table = array(Config::get("bdd_triples")." t1", Config::get("bdd_triples")." t2", Config::get("bdd_pages")." p"); |
$this->traiterParametres($parametres); |
$this->traiterRessources($ressources); |
if ($this->corps_http == '' && $this->entete_http == '') { |
$requete = $this->assemblerLaRequete(); |
$resultat = $this->getBdd()->recupererTous($requete); |
$this->testerResultat($resultat, $resultat_formate, $requete); |
} |
return $this->formerReponseHTTP($resultat_formate); |
} |
public function testerResultat($resultat, &$resultat_formate, $requete) { |
if ($resultat == '') { //cas ou coste/services/ ou la requete comporte des erreurs |
$e = 'La requête SQL formée comporte une erreur!'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,$e); |
Debug::printr($requete); |
} elseif ($resultat) { |
$resultat_formate = $this->retournerResultatFormate($resultat); |
} else { |
if ($this->format_reponse = 'textes/relations') { |
$resultat_formate = 'null'; |
} else { |
$m = 'Données introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE,$m); |
Debug::printr($requete); |
} |
} |
} |
//---------------------------------TRAITER RESSOURCES----------------------------------------------------------------- |
public function traiterRessources(&$ressources) { |
if (isset($ressources) && !empty($ressources)) { |
$this->table = Config::get('bdd_triples'); |
$this->table_ressources = $ressources; |
if ($ressources[0] == 'relations') { |
$this->traiterRelationsProjet($ressources); |
$this->format_reponse .= '/relations'; |
} elseif (isset($this->table_ressources[0]) && !empty($this->table_ressources[0])) { |
$this->traiterRessourceId($this->table_ressources[0]); |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
$this->format_reponse .= '/champ'; |
} |
} else { |
$e = "Erreur dans votre requête. <br/> Les ressources disponibles sont : |
<li> /textes/#id (id correspondant au tag de la page </li> |
<li> /textes/#id/#champ+#champ </li> |
<li> /textes/relations/bdtfx/#id (id correspondant au num_nom du projet bdtfx </li>"; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e); |
} |
} else { |
$this->traiterRessourcesListe(); |
} |
$this->requete_condition[] = "p.latest = 'Y'"; |
} |
public function traiterRessourceId($id) { |
$this->format_reponse .= '/id'; |
if ($this->recherche == 'etendue') { |
$id = '%'.str_replace(' ','%', $id).'%'; |
} |
$this->requete_champ = ' t1.resource AS tag, t1.value AS num_nom, t2.value AS titre, p.body AS texte'; |
$this->requete_condition[] = 't1.resource LIKE '.$this->getBdd()->proteger($id); |
$this->requete_condition[] = 't1.property = "num_nom"'; |
$this->requete_condition[] = '(t1.resource = t2.resource AND t2.property = "titre")'; |
$this->requete_condition[] = 't1.resource = p.tag'; |
$this->table = array(Config::get("bdd_triples").' t1', |
Config::get("bdd_triples").' t2', |
Config::get("bdd_pages").' p'); |
$this->ajouterRechercheFloue('t1.resource', $id); |
} |
public function traiterRessourcesListe() { |
$this->requete_condition[] = "t1.property = 'num_nom'"; |
$this->requete_condition[] = "(t1.resource = t2.resource AND t2.property = 'titre')"; |
$this->requete_condition[] = "t1.resource = p.tag"; |
} |
public function traiterRelationsProjet($tab_ress) { |
$this->table = array(Config::get("bdd_triples")." t1", Config::get("bdd_pages")." p", Config::get("bdd_table").'_v0_1 c'); |
$projet = $tab_ress[1]; |
$num_nom = $tab_ress[2]; |
$nom_champ_projet = "flore_$projet"."_num"; |
if (isset($tab_ress[3])) { |
$type = $tab_ress[3]; |
if (!in_array($type, array('cle', 'dsc'))) { |
$e = "Le type de texte ne peut etre que clé ou description"; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e); |
} |
} |
$this->requete_condition[] = "c.flore_bdnff_num = ".$this->getBdd()->proteger($num_nom); |
$this->requete_condition[] = "t1.value = c.num_nom"; |
$this->requete_condition[] = "t1.property = 'num_nom'"; |
$this->requete_condition[] = "t1.resource = p.tag"; |
$this->requete_champ = 't1.resource AS tag, t1.value AS num_nom, p.body AS texte'; |
if (isset($type)) $this->requete_condition[] = "t1.resource LIKE ".$this->getBdd()->proteger(ucfirst($type.'%')); |
} |
public function ajouterRechercheFloue($nom_champ, $id) { |
if ($this->recherche == 'floue') { |
$id = $this->getBdd()->proteger($id); |
$this->requete_condition[array_search("$nom_champ LIKE $id", |
$this->requete_condition)] = |
"($nom_champ LIKE $id)". |
" OR ( SOUNDEX($nom_champ) = SOUNDEX($id))". |
" OR SOUNDEX(REVERSE($nom_champ)) = SOUNDEX(REVERSE($id))))"; |
} |
} |
//---------------------------------------TRAITER PARAMETRES------------------------------------------------------------- |
public function traiterParametres($parametres) { |
if (isset($parametres) && !empty($parametres)) { |
$this->table_param = $parametres; |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $val) { |
switch ($param) { |
case 'retour_format' : $this->retour_format = $val; break; |
case 'masque_titre' : $this->ajouterLeFiltreMasque('titre', $val); break; |
case 'masque_famille' : $this->ajouterLeFiltreMasque('famille', $val); break; |
case 'masque_ns' : $this->ajouterLeFiltreMasque('nom_sci', $val); break; |
case 'masque_type' : $this->ajouterLeFiltreMasque('type', $val); break; |
case 'masque_txt' : $this->ajouterLeFiltreMasque('texte', $val); break; |
case 'masque_page' : $this->ajouterLeFiltreMasque('page',$val); break; |
case 'masque_tome' : $this->ajouterLeFiltreMasque('tome',$val); break; |
case 'navigation_depart': $this->limite_requete['depart'] = $val; break; |
case 'navigation_limite': $this->limite_requete['limite'] = $val; break; |
case 'recherche' : break; |
default : |
$e = "Erreur dans les paramètres de recherche de votre requête : </br> Le parametre $param n\'existe pas."; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE,$e); |
break; |
} |
} |
} |
} |
public function ajouterLeFiltreMasque($masque, $valeur) { |
if ($this->recherche == 'etendue') { |
$valeur = '%'.str_replace(' ','%', $valeur).'%'; |
} |
$valeur = $this->getBdd()->proteger($valeur); |
$this->masque[] = "$masque=$valeur"; |
switch ($masque) { |
case 'famille' : |
break; |
case 'nom_sci' : |
$this->requete_condition[] = "t1.value = c.num_nom AND nom_sci LIKE $valeur)"; |
$this->ajouterRechercheFloue('nom_sci', $valeur); |
$this->table[] = Config::get("bdd_table").'_v0_1 c'; |
break; |
case 'type' : |
$type = ($this->getBdd()->proteger($valeur) == '"cle"') ? 'Cle%' : 'Dsc%'; |
$this->requete_condition[] = 't1.resource LIKE '.$this->getBdd()->proteger($type); |
break; |
case 'texte' : |
$this->requete_condition[] = "p.body LIKE $valeur"; |
$this->ajouterRechercheFloue('p.body', $valeur); |
break; |
case 'titre' : |
$this->requete_condition[] = "t2.value LIKE $valeur"; |
$this->ajouterRechercheFloue('t2.value', $valeur); |
break; |
case 'page' : |
$this->requete_condition[] = "t1.value = c.num_nom AND c.page = $valeur"; |
$this->table[] = Config::get("bdd_table").'_v0_1 c'; |
break; |
case 'tome' : |
$this->requete_condition[] = "t1.value = c.num_nom AND c.tome = $valeur"; |
$this->table[] = Config::get("bdd_table").'_v0_1 c'; |
break; |
default : |
break; |
} |
} |
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE----------------------------------------------------- |
public function assemblerLaRequete() { |
$requete = ' SELECT '.$this->requete_champ. |
' FROM '.implode(', ', $this->table) |
.$this->retourneRequeteCondition() |
.$this->requete_group_by |
.$this->formerRequeteLimite(); |
return $requete; |
} |
public function retourneRequeteCondition() { |
$condition = ''; |
if ($this->requete_condition !== null) { |
$condition = ' WHERE '.implode(' AND ', $this->requete_condition); |
} |
return $condition; |
} |
public function formerRequeteLimite() { |
if (in_array($this->format_reponse , array('textes/id', 'textes/id/relations'))) { |
$this->requete_limite = ''; |
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) { |
$this->limite_requete['depart'] = |
(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']); |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} else { |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} |
return $this->requete_limite; |
} |
/** |
* Recupere le nombre total de résultat d'une requete lancée. |
* Est utilisée lors de l'affichage du total dans le résultat retourné et pr déterminer les limites et départ |
* @return nombre total de résultat |
*/ |
public function recupererTotalResultat() { |
$total = null; |
$requete = 'SELECT count(*) as nombre FROM ' |
.implode(', ', $this->table).$this->retourneRequeteCondition() |
.$this->requete_group_by; |
$res = $this->getBdd()->recuperer($requete); |
if ($res) { |
$total = $res['nombre']; |
} else { |
$e = 'Données introuvables dans la base ou erreur dans la requête SQL'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e); |
} |
return $total; |
} |
//-------------------FONCTIONS POUR LE FORMATAGE EN JSON---------------------------------------------------------------- |
public function retournerResultatFormate($resultat) { |
$reponse = ''; |
switch ($this->format_reponse) { |
case 'textes' : $reponse = $this->formaterTextes($resultat); break; |
case 'textes/relations' : $reponse = $this->formaterTextesRelations($resultat); break; |
case 'textes/id' : $reponse = $this->formaterTextesId($resultat[0]); break; |
case 'textes/id/champ' : $reponse = $this->formaterTextesIdChamp($resultat[0]); break; |
default : break; |
} |
$reponse = json_encode($reponse); |
return $reponse; |
} |
public function formaterTextes($resultat) { |
$this->ajouterEnteteResultat($resultat); |
$reponse['entete'] = $this->table_retour; |
$this->table_retour = array(); |
foreach ($resultat as $description) { |
$tag = $description['tag']; |
$this->afficherDonnees('titre', $description['titre']); |
$type = (preg_match('/^Cle.*$/', $tag)) ? '1' : '2' ; |
$this->afficherDonnees('type', $type); |
$this->table_retour['texte'] = $description['texte']; |
$reponse['resultat'][$tag] = $this->table_retour; |
$this->table_retour = array(); |
$reponse['resultat'][$tag]['href'] = $this->ajouterHref('textes', $tag); |
} |
return $reponse; |
} |
public function formaterTextesRelations($resultat) { |
foreach ($resultat as $description) { |
$tag = $description['tag']; |
$type = (preg_match('/^Cle.*$/', $tag)) ? '1' : '2' ; |
$this->afficherDonnees('type', $type); |
$this->table_retour['texte'] = $description['texte']; |
$reponse[$tag] = $this->table_retour; |
$this->table_retour = array(); |
$reponse[$tag]['href'] = $this->ajouterHref('textes', $tag); |
} |
return $reponse; |
} |
public function ajouterEnteteResultat($resultat) { |
if ($this->masque) { |
$this->table_retour['masque'] = implode('&', $this->masque); |
} |
$this->table_retour['depart'] = $this->limite_requete['depart']; |
$this->table_retour['limite'] = $this->limite_requete['limite']; |
$this->table_retour['total'] = $this->total_resultat; |
//formuler les urls |
$url = $this->formulerUrl($this->total_resultat, '/'.$this->service); |
if ($url['precedent'] != '') { $this->table_retour['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $this->table_retour['href.suivant'] = $url['suivant']; } |
} |
public function formaterTextesId($reponse) { |
$this->afficherDonnees('titre', $reponse['titre']); |
$type = (preg_match('/^Cle.*$/', $reponse['tag'])) ? '2' : '1' ; |
$this->afficherDonnees('type', $type); |
$this->table_retour['texte'] = $reponse['texte']; |
$this->afficherDonnees('id', $reponse['num_nom']); |
return $this->table_retour; |
} |
public function formaterTextesIdChamp($resultat) { |
//on recupère tous les resultats possibles |
$reponse_id = $this->formaterTextesId($resultat); |
$this->table_retour = array(); |
//on recupère les résultats demandés à partir du tableau de résultat complet |
$this->table_retour['id'] = $resultat['tag']; |
$champs = explode(' ', $this->table_ressources[1]); |
foreach ($champs as $champ) { |
if ($this->verifierValiditeChamp($champ, $reponse_id)) { |
if (preg_match('/^[^.]+\.\*$/', $champ)) { |
$this->afficherPointEtoile($champ, $reponse_id); |
} else { |
$this->table_retour[$champ] = $reponse_id[$champ]; |
} |
} |
} |
return $this->table_retour; |
} |
public function afficherPointEtoile($champ, $reponse_id) { |
preg_match('/^([^.]+\.)\*$/', $champ, $match); |
foreach ($reponse_id as $chp => $valeur) { |
if (strrpos($chp, $match[1]) !== false) { |
$this->table_retour[$chp] = $valeur; |
} |
} |
} |
public function verifierValiditeChamp($champ, $reponse_id) { |
$validite = false; |
preg_match('/^([^.]+)(:?\.([^.]+))?$/', $champ, $match); |
if (array_key_exists($match[1], $reponse_id)) { |
$validite = true; |
if (isset($match[2]) && !empty($match[2])) { |
if ($match[1] == 'type') { |
$suffixes = array('.code', '.href', '.*'); |
$validite = (in_array($match[2], $suffixes)) ? true : false; |
} else { |
$validite = false; |
} |
} |
} |
if (!$validite) { |
$champs = implode('</li><li>', array_keys($reponse_id)); |
$e = 'Erreur dans votre requête : </br> Le champ "'.$champ.'" n\'existe pas. Les champs disponibles |
sont : <li>'.$champs.'</li>'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e); |
} |
return $validite; |
} |
//------------------------------------------------Fonction d'affichage ------------------------------------------------ |
public function afficherDonnees($champ, $valeur) { |
if ($this->retour_format == 'min') { |
$champ = ($champ == 'type') ? $champ.'.code' : $champ; |
$this->table_retour[$champ] = $valeur; |
} else { |
$this->afficherDonneesMax($champ, $valeur); |
} |
} |
public function afficherDonneesMax($champ, $valeur) { |
if ($champ == 'id') { |
$this->table_retour[$champ] = "coste.".$valeur; |
$this->table_retour['nom_sci'] = $this->recupererNomSci($valeur); |
$this->table_retour['id.href'] = $this->ajouterHref('noms', $valeur); |
} elseif (in_array($champ, array('type'))) { |
$this->table_retour[$champ.'.code'] = $valeur; |
$this->table_retour[$champ] = $this->recupererSignificationCode($valeur); |
$this->table_retour[$champ.'.href'] = $this->ajouterHrefAutreProjet('ontologies', 'texteType:', $valeur, 'commun'); |
} else { |
$this->table_retour[$champ] = $valeur; |
} |
} |
public function recupererSignificationCode($code) { |
$url = $this->ajouterHrefAutreProjet('ontologies', 'texteType:', $code.'/nom', 'commun'); |
$res = $this->consulterHref($url); |
return $res->nom; |
} |
public function recupererNomSci($id) { |
$req = 'SELECT nom_sci FROM coste_v0_1 WHERE num_nom = '.$id; |
if ($this->html == 'htm') { |
$req = str_replace('nom_sci', 'nom_sci_html as nom_sci', $req); |
} |
$res = $this->getBdd()->recuperer($req); |
return $res['nom_sci']; |
} |
} |
?> |
/trunk/services/modules/0.1/nvjfl/NomsVernaculaires.php |
---|
New file |
0,0 → 1,516 |
<?php |
/** |
* Description : |
* Classe NomsVernaculaires.php fournit une liste de noms vernaculaires et leur liaison à la bdtfx |
* Le but étant de fournir un ensemble minimal d'information comprenant : |
* un identifiant (numérique ou alphanumérique sous forme de ChatMot si possible), un nom, une langue et |
* une relation avec un taxon de la bdtfx. |
* Si l'url finit par /noms-vernaculaires on retourne une liste de noms (seulement les 100 premières par défaut). |
* L'url peut contenir des paramètres optionnels passés après le ? : /observations?param1=val1¶m2=val2&... |
* |
* Les paramètres de requête disponibles sont : masque, masque.code, masque.nom, masque.region , recherche, |
* distinct, retour.format, navigation.depart et navigation.limite. |
* |
* Encodage en entrée : utf8 |
* Encodage en sortie : utf8 |
* @package framework-v3 |
* @author Delphine Cauquil <delphine@tela-botanica.org> |
* @author Jennifer Dhé <jennifer.dhe@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> |
* @version 1.0 |
* @copyright 1999-${year} Tela Botanica (accueil@tela-botanica.org) |
*/ |
class NomsVernaculaires extends Commun { |
protected $champ_infos = array( |
'taxon' => array('service' => 'taxons', 'ressource' => 'nt:', 'projet' => 'bdtfx', 'nom' => 'nom_sci'), |
'conseil_emploi' => array('service' => 'ontologies', 'ressource' => 'numStatut:', 'projet' => 'nvjfl', 'nom' => 'nom'), |
'genre' => array('service' => 'ontologies', 'ressource' => 'genreNombre:', 'projet' => 'nvjfl', 'nom' => 'nom')); |
protected $service = 'noms-vernaculaires'; |
/** |
* Permet de stocker la requete formulée : /noms-vernaculaires | /noms-vernaculaires/#id | |
* /noms-vernaculaires/#id/champ | /noms-vernaculaires/#id/relations |
* Est remplit au cours de l'analyse des ressources (traiterRessources()), par défaut, a la valeur du service. |
* Est utilisée principalement pr déterminer le format du tableau à retourner. */ |
protected $format_reponse = 'noms-vernaculaires'; |
/** Variables constituant les parametres de la requete SQL (champ, condition, limit) remplie |
* selon ressources et paramètres */ |
protected $requete_champ = array(' * '); |
protected $requete_condition = ''; |
protected $limite_requete = array( |
'depart' => 0, |
'limite' => 100 |
); |
/** Stockage des ressources et paramétres */ |
protected $table_ressources = array(); |
protected $table_param = array(); |
/** |
* Precise la contenance plus ou moins précise du tableau à retourner : |
* - min = les données présentes dans la table |
* - max = les données de la table + les informations complémentaires (pour les identifiants et les codes) |
* - oss = la liste des nom_sci (uniquement pour noms et taxons) */ |
protected $retour_format = 'max'; |
/** Valeur du paramètre de requete recherche : |
* - stricte : le masque est passé tel quel à l'opérateur LIKE. |
* - etendue : ajout automatique du signe % à la place des espaces et en fin de masque avec utilisation de LIKE. |
* - floue : recherche tolérante vis-à-vis d'approximations ou d'erreurs (fautes d'orthographe par exemple) */ |
protected $recherche; |
/** Permet de stocker le tableau de résultat (non encodé en json) */ |
protected $table_retour = array(); |
/** Stocke le nombre total de résultats de la requete principale. Est calculée lors de l'assemblage de la requete */ |
protected $total_resultat; |
// +-------------------------------------------------------------------------------------------------------------------+ |
// fonction principale qui permet de construire la requête à partir de l'analyse des paramétres et ressources |
public function consulter($ressources, $parametres) { |
$this->traiterParametres($parametres); |
$this->traiterVersionProjet($ressources); |
$this->traiterRessources($ressources); |
$resultat_formate = ''; |
if ($this->corps_http == '' && $this->entete_http == '') { |
foreach ($this->table_version as $version) { |
$this->table = $version; //on stocke le nom de la table correspondant à la version du projet en cours |
$requete = $this->assemblerLaRequete(); //print_r($requete); |
$resultat = $this->getBdd()->recupererTous($requete); |
$res_version = $this->testerResultat($resultat, $requete); |
} |
if ($this->corps_http == '' && $this->entete_http == '') { |
if (isset($res_version)) { |
$resultat_formate = json_encode($res_version); |
} |
} |
} |
return $this->formerReponseHTTP($resultat_formate); |
} |
public function testerResultat($resultat, $requete) { |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$s = 'La requête SQL formée comporte une erreur !!'; |
Debug::printr($requete); |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $s); |
} elseif ($resultat) { |
if (count($this->table_version) > 1) { |
$res_version[$version] = $this->retournerResultatFormate($resultat); |
} else { |
$res_version = $this->retournerResultatFormate($resultat); |
} |
} else { |
if ($this->format_reponse == 'noms-vernaculaires/id/relations') { |
//si aucune relation n'existe, la valeur null est retournée |
$res_version = null; |
} else { |
$d = 'Données recherchées introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $d); |
Debug::printr($requete); |
} |
} |
return $res_version; |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
// créer une condition en fonction du paramétre |
public function traiterParametres($parametres) { |
if (isset($parametres) && !empty($parametres)) { |
$this->table_param = $parametres; |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $valeur) { |
switch ($param) { |
case 'masque' : $this->ajouterLeFiltreMasque('nom_vernaculaire', $valeur);break; |
case 'masque_nt' : $this->ajouterLeFiltreMasque('num_taxon', $valeur); break; |
case 'masque_nv' : $this->ajouterLeFiltreMasque('nom_vernaculaire', $valeur);break; |
case 'masque_lg' : $this->ajouterLeFiltreMasque('code_langue', $valeur); break; |
case 'masque_cce' : $this->ajouterLeFiltreMasque('num_statut', $valeur); break; |
case 'retour_format' : $this->retour_format = $valeur; break; |
case 'navigation_depart' : $this->limite_requete['depart'] = $valeur; break; |
case 'navigation_limite' : $this->limite_requete['limite'] = $valeur; break; |
case 'recherche' : break; |
default : $p = 'Erreur dans les paramètres de recherche de votre requête : '. |
'</br> Le paramètre " '.$param.' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $p); break; |
} |
} |
} |
} |
public function ajouterLeFiltreMasque($nom_champ, $valeur) { |
if ($nom_champ == 'num_taxon') { // si il s'agit d'un chiffre |
$this->requete_condition[] = $nom_champ.' = '.$this->getBdd()->proteger($valeur); |
} else { |
if ($this->recherche == 'floue') { |
$this->requete_condition[] = '(SOUNDEX('.$nom_champ.') = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE('.$nom_champ.')) = SOUNDEX(REVERSE(\''.$valeur.'\'))) '; |
} else { |
if ($this->recherche == 'etendue') { |
$valeur = str_replace(' ','%', $valeur); |
$valeur .= '%'; |
} |
$this->requete_condition[] = $nom_champ.' LIKE '.$this->getBdd()->proteger($valeur); |
} |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
// en fonction de la présence des ressources modifie requete_champ et requete_condition |
public function traiterRessources(&$ressources) { |
if (isset($ressources) && !empty($ressources)) { |
$this->table_ressources = $ressources; |
if (isset($this->table_ressources[0]) && !empty($this->table_ressources[0])) { |
$this->traiterRessourceId(); // ajoute condition id=#valeur |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
$this->traiterRessourceChampOuRelations(); //modifie requete_champ ou requete_condition |
} |
} |
} else { //rajoute distinct pour ne pas avoir plusieurs fois le même nom |
$this->requete_champ = array('distinct(id)', 'nom_vernaculaire '); |
} |
} |
//requete : /noms-vernaculaires/#id (ex : /noms-vernaculaires/7) |
public function traiterRessourceId() { |
if (is_numeric($this->table_ressources[0])) { |
$this->requete_condition[] = ' id = '.$this->getBdd()->proteger($this->table_ressources[0]); |
$this->format_reponse .= '/id'; |
} else { |
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->table_ressources[0]. |
' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r); |
} |
} |
public function traiterRessourceChampOuRelations() { |
//requete = /noms-vernaculaires/#id/relations : |
if ($this->table_ressources[1] == 'relations') { |
$this->format_reponse .= '/relations'; |
$this->requete_condition[] = 'num_taxon = (SELECT region FROM '.$this->table.' WHERE ' |
.implode(' AND ', $this->requete_condition).')'; |
//requete = /noms-vernaculaires/#id/#champ : |
} else { |
$this->format_reponse .= '/champ'; |
$this->analyserChamp(); |
} |
} |
public function analyserChamp() { |
$this->requete_champ = array(); |
$this->recupererTableConfig('champs_possibles');// s'il y a plusieurs champs correspondant au champ demandé ils sont séparé par des | |
$champs = explode(' ', $this->table_ressources[1]); |
foreach ($champs as $champ) { |
preg_match('/^([^.]+)(\.([^.]+))?$/', $champ, $match); |
if (isset($this->champs_possibles[$match[1]])) { |
$this->requete_champ[] = str_replace('|', ', ', $this->champs_possibles[$match[1]]); |
} elseif (isset($this->champs_possibles[$match[0]])) { |
$this->requete_champ[] = str_replace('|', ', ', $this->champs_possibles[$match[0]]); |
} else { |
$champs_possibles = implode('</li><li>', array_keys($this->champs_possibles)); |
$c = 'Erreur dans votre requête : </br> Le champ "'.$champ_possibles.'" n\'existe pas. '. |
'Les champs disponibles sont : <li>'.$champs_possibles.'</li> et leurs déclinaisons (ex. ".code").'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $c); |
} |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function assemblerLaRequete() { |
$requete = ' SELECT '.$this->formerRequeteChamp(). |
' FROM '.$this->table |
.$this->formerRequeteCondition() |
.$this->formerRequeteLimite(); |
return $requete; |
} |
public function formerRequeteChamp() { |
if (in_array('*', $this->requete_champ)) { |
$champ = ' * '; |
} else { |
$champ = implode(', ', $this->requete_champ); |
} |
return $champ; |
} |
public function formerRequeteCondition() { |
$condition = ''; |
if ($this->requete_condition != null) { |
$condition = ' WHERE '.implode(' AND ', $this->requete_condition); |
} |
return $condition; |
} |
//ajout d'une limite seulement pour les listes (pas plus de 100 resultats retournés pr les requetes |
// suivantes : /noms-vernaculaires et /noms-vernaculaires/#id/relations) |
public function formerRequeteLimite() { |
if (in_array($this->format_reponse , array($this->service.'/id', $this->service.'/id/champs'))) { |
$this->requete_limite = ''; |
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) { |
$this->limite_requete['depart'] = |
(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']); |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} else { |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} |
return $this->requete_limite; |
} |
//on récupère le nombre total de résultats de la requete (ex : le nombre d'id contenu dans la liste /noms-vernaculaires) |
public function recupererTotalResultat() { |
$requete = 'SELECT count(distinct(id)) as nombre FROM ' |
.$this->table |
.$this->formerRequeteCondition(); |
$res = $this->getBdd()->recuperer($requete); |
if ($res) { |
$total = $res['nombre']; |
} else { |
$t = 'Fonction recupererTotalResultat() : <br/>Données introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $t); |
} |
return $total; |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
// determine en fct du service appelé (/noms-vernaculaires | /noms-vernaculaires/#id | /noms-vernaculaires/#id/champ | |
// /noms-vernaculaires/#id/relations) le format du tableau à retourner. |
public function retournerResultatFormate($resultat) { |
$this->recupererTableConfig('correspondance_champs'); |
switch ($this->format_reponse) { |
case 'noms-vernaculaires' : $reponse = $this->formaterNomsVernaculaires($resultat); break; |
case 'noms-vernaculaires/id' : $reponse = $this->formaterNomsVernaculairesId($resultat); break; |
case 'noms-vernaculaires/id/champ' : $reponse = $this->formaterNomsVernaculairesIdChamp($resultat); break; |
default : break; |
} |
return $reponse; |
} |
public function formaterNomsVernaculaires($resultat) { |
//on remplit la table $table_retour_json['entete'] |
$table_retour_json['entete']['depart'] = $this->limite_requete['depart']; |
$table_retour_json['entete']['limite'] = $this->limite_requete['limite']; |
$table_retour_json['entete']['total'] = $this->total_resultat; |
$url = $this->formulerUrl($this->total_resultat, '/noms-vernaculaires'); |
if ($url['precedent'] != '') { $table_retour_json['entete']['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $table_retour_json['entete']['href.suivant'] = $url['suivant']; } |
//on remplit la table $table_retour_json['resultat'] |
if (isset($this->table_param['masque_nv'])) { |
$resultat = $this->trierRechercheFloue($this->table_param['masque_nv'], $resultat, 'nom_vernaculaire'); |
} |
foreach ($resultat as $tab) { |
foreach ($tab as $key => $valeur) { |
if ($valeur != '') { |
switch ($key) { |
case 'id' : $num = $valeur; break; |
case 'nom_vernaculaire' : $this->table_retour['nom'] = $valeur; break; |
default : break; |
} |
} |
} |
if ($this->retour_format == 'max') $this->table_retour['href'] = $this->ajouterHref('noms-vernaculaires', $num); |
$resultat_json[$num] = $this->table_retour; |
$this->table_retour = array(); |
} |
$table_retour_json['resultat'] = $resultat_json; |
return $table_retour_json; |
} |
// formatage de la reponse /id ss la forme |
// id, nom_vernaculaire, attributions |
// langue |
// num_nom (correspond à un taxon bdtfx) |
public function formaterNomsVernaculairesId($resultat) { |
foreach ($resultat as $taxon) { // pour chaque attribution à un taxon bdtfx |
// on crée les variables qui serviront de clés et on les enléves du tableau |
$num_nom = $taxon['num_nom_vernaculaire']; // unique pour un trinôme id, langue, taxon |
unset($taxon['num_nom_vernaculaire']); |
$langue = $taxon['code_langue']; |
unset($taxon['code_langue']); |
foreach ($this->correspondance_champs as $key => $correspondance) { // ordonne les infos pour affichage |
if (isset($taxon[$key]) && $taxon[$key] != "") { |
$this->afficherDonnees($correspondance, $taxon[$key], $langue, $num_nom); |
} |
} |
foreach ($taxon as $key => $valeur) { // rajoute les champs non prévus dans l'api |
if (!isset($this->correspondance_champs[$key]) && $valeur != "") { |
$this->afficherDonnees($key, $valeur, $langue, $num_nom); |
} |
} |
if ($this->retour_format == 'max') $this->chargerBiblio($num_nom, $langue); |
} |
if ($this->retour_format == 'max') $this->afficherTaxons(); // va chercher les noms de tous les taxons |
unset($this->table_retour['href']); |
return $this->table_retour; |
} |
public function afficherDonnees($champ, $valeur, $langue = '', $num_nom = '') { |
if ($champ == 'id' || $champ == 'nom_vernaculaire') { |
$this->table_retour[$champ] = $valeur; |
} elseif (preg_match('/^(.*)\.code$/', $champ, $match)) { |
switch ($match[1]) { |
case 'taxon' : if ($this->retour_format == 'max') {$this->taxons[$num_nom] = $valeur;} |
$this->afficherPointCode($match[1], $langue, $num_nom, $valeur); break; |
case 'langue' : //$this->afficherPointCode($match[1], 'iso-639-3', 'langues', $valeur); |
break; |
case 'genre' : $this->afficherPointCode($match[1], $langue, $num_nom, $valeur); break; |
case 'conseil_emploi' : $this->afficherPointCode($match[1], $langue, $num_nom, $valeur); break; |
default : break; |
} |
} elseif ($langue != '') { |
$this->table_retour['attributions'][$langue][$num_nom][$champ] = $valeur; |
} else { |
$this->table_retour[$champ] = $valeur; |
} |
} |
public function afficherPointCode($nomChamp, $langue, $num_nom, $valeur) { |
if (isset($this->champ_infos[$nomChamp])) { |
extract($this->champ_infos[$nomChamp]); |
} |
if ($this->retour_format == 'max') { |
$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur, $projet); |
if ($service == 'taxons') { |
$code_valeur = ''; |
} else { |
$code_valeur = $this->chercherSignificationCode($url, $nom); |
} |
if ($projet != '') $projet .= '.'; |
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp] = $code_valeur; |
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.code'] = $projet.$ressource.$valeur; |
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.href'] = $url; |
} else { |
if ($projet != '') $projet .= '.'; |
$this->table_retour['attributions'][$langue][$num_nom][$nomChamp.'.code'] = $projet.$ressource.$valeur; |
} |
} |
public function chercherSignificationCode($url, $nom) { |
if (isset($this->signification_code[$url])) { |
$valeur = $this->signification_code[$url]; |
} else { |
$res = $this->consulterHref($url); |
$valeur = $res->$nom; |
$this->signification_code[$url] = $valeur; |
} |
return $valeur; |
} |
public function afficherTaxons() { |
$url = Config::get('url_service_base').'bdtfx/taxons?navigation.limite=500&masque.nt='.$this->getBdd()->proteger(implode(',', $this->taxons)); |
$res = $this->consulterHref($url); |
foreach ($res->resultat as $id=>$taxon) { |
$resultat[$taxon->num_taxonomique] = $taxon->nom_sci; |
} |
foreach ($this->table_retour['attributions'] as $code_langue=>$langue) { |
foreach ($langue as $num_nom=>$taxon) { |
$num_tax = ltrim($taxon['taxon.code'], 'bdtfx.nt:'); |
if (isset($resultat[$num_tax])) { |
$this->table_retour['attributions'][$code_langue][$num_nom]['taxon'] = $resultat[$num_tax]; |
} |
} |
} |
} |
public function formaterNomsVernaculairesIdChamp($resultat) { |
$this->table_retour['id'] = $this->table_ressources[0]; |
$champs = explode(' ', $this->table_ressources[1]); |
if (in_array('attributions', $champs) != false) { |
$this->formaterNomsVernaculairesId($resultat); |
unset($this->table_retour['nom_vernaculaire']); |
} else {//print_r($resultat); |
$champ_attributions = array('num_taxon', 'zone_usage', 'num_statut', 'num_genre', 'notes'); |
foreach ($resultat as $taxon) { |
foreach ($taxon as $key=>$valeur) { |
if ($key == 'code_langue' && in_array('langue', $champs) != false) { |
$this->table_retour['attributions']['langue'][] = $valeur; |
} elseif (in_array($key, $champ_attributions) != false) { |
$this->afficherPoint($this->correspondance_champs[$key] , $valeur, $taxon['code_langue'], $taxon['num_nom_vernaculaire']); |
} elseif (in_array($key, $champs) != false) { |
$this->table_retour[$key] = $valeur; |
} |
} |
if (in_array('biblio', $champs) != false) $this->chargerBiblio($taxon['num_nom_vernaculaire'], $taxon['code_langue']); |
} |
if (in_array('biblio', $champs) != false && array_search('biblio.num_ref', $this->table_retour) != false) $this->table_retour['biblio'] = null; |
} |
return $this->table_retour; |
} |
public function afficherPoint($champ, $valeur, $langue, $num_nom) { |
preg_match('/^(.*)\.code$/', $champ, $match); |
$champ = $match[1]; |
if (isset($this->champ_infos[$champ])) { |
extract($this->champ_infos[$champ]); |
$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur, $projet); |
$projet .= '.'; |
} |
$champs = explode(' ', $this->table_ressources[1]); |
if (in_array($champ.'.*', $champs) !== false && isset($projet)) { |
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.code'] = $projet.$ressource.$valeur; |
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.href'] = $url; |
} |
if (in_array($champ.'.code', $champs) !== false && isset($projet)) { |
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.code'] = $projet.$ressource.$valeur; |
} |
if (in_array($champ.'.href', $champs) !== false && isset($projet)) { |
$this->table_retour['attributions'][$langue][$num_nom][$champ.'.href'] = $url; |
} |
if (in_array($champ, $champs) !== false) { |
if (isset($url)) { |
$this->table_retour['attributions'][$langue][$num_nom][$champ] = $this->chercherSignificationCode($url, $nom); |
} else { |
$this->table_retour['attributions'][$langue][$champ] = $valeur; |
} |
} |
} |
public function afficherLangue($nomChamp, $projet, $service, $valeur, $ressource = '', $nom = 'nom') { |
if ($this->retour_format == 'max') { |
$this->table_retour['attributions'][$nomChamp] = $nom; |
$this->table_retour['attributions'][$nomChamp.'.code'] = $projet.$ressource.$valeur; |
$this->table_retour['attributions'][$nomChamp.'.href'] = $url; |
} else { |
$this->table_retour['attributions'][$nomChamp.'.code'] = $projet.$ressource.$valeur; |
} |
} |
public function chargerBiblio($num_nom, $langue) { |
list($table, $version) = explode('_v',$this->table); |
$requete = "SELECT b.*, lb.notes FROM nvjfl_lien_biblio_v$version lb, nvjfl_biblio_v$version b ". |
"WHERE b.num_ref = lb.num_ref AND lb.num_nom = '$num_nom' ;"; |
$resultat = $this->getBdd()->recupererTous($requete); //Debug::printr($resultat); |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$r = 'La requête SQL formée comporte une erreur !!'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $r); |
Debug::printr($requete); |
} elseif ($resultat) { |
foreach ($resultat as $res) { |
foreach ($res as $cle => $valeur) { |
if ($valeur !== "") { |
$this->table_retour['attributions'][$langue][$num_nom]['biblio.'.$cle] = $valeur; |
} |
} |
} |
} |
} |
} |
?> |
/trunk/services/modules/0.1/chorodep/Observations.php |
---|
New file |
0,0 → 1,682 |
<?php |
/** |
* Description : |
* Classe Observations.php permettant de fournir des informations sur les observations. |
* Si l'url finit par /observations on retourne une liste d'observations (seulement les 100 premières par défaut) : |
* espèce, lieu, date, observateur. |
* L'url peut contenir des paramètres optionnels passés après le ? : /observations?param1=val1¶m2=val2&... |
* |
* Les paramètres de requête disponibles sont : masque, masque.type (type d'observation : chorologie), |
* masque.date_observation (date d'observation), masque.station (département), masque.determination (nom scientifique de l'espèce) |
* masque.observateur (prénom, nom), masque.nn (identifiant du nom), recherche, distinct, retour.format, |
* navigation.depart et navigation.limite. |
* |
* Encodage en entrée : utf8 |
* Encodage en sortie : utf8 |
* @package framework-v3 |
* @author Delphine Cauquil <delphine@tela-botanica.org> |
* @author Jennifer Dhé <jennifer.dhe@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> |
* @version 1.0 |
* @copyright 1999-${year} Tela Botanica (accueil@tela-botanica.org) |
*/ |
class Observations extends Commun { |
protected $service = 'observations'; |
/** Stockage des paramétres */ |
protected $table_param = array(); |
/** Valeur du paramètre de requete recherche : |
* - stricte : le masque est passé tel quel à l'opérateur LIKE. |
* - etendue : ajout automatique du signe % à la place des espaces et en fin de masque avec utilisation de LIKE. |
* - floue : recherche tolérante vis-à-vis d'approximations ou d'erreurs (fautes d'orthographe par exemple) */ |
protected $recherche = 'stricte'; |
/** Valeur du paramètre de requete distinct (=0|1) |
* Indique que l'on veut les noms distincts (par défaut tous les noms, même semblable, sont renvoyés) */ |
protected $distinct = null; |
protected $retour_format = 'max'; |
protected $presenceChorologie = ''; |
/** Variables constituant les parametres de la requete SQL (champ, condition, group by, limit) remplie |
* selon ressources et paramètres */ |
protected $requete_champ = ' id, num_nom, nom_sci '; |
protected $requete_condition = array(); |
/** Une observation est défini par départ qui correspont à un num_nom et dept qui correspond à un departement */ |
protected $limite_requete = array( |
'depart' => 0, |
'dept' => 01, |
'limite' => 20 |
); |
/** |
* Permet de stocker la requete formulée : |
* - noms | noms/#id | noms/#id/#champ+#champ |
* - noms/#id/relations | noms/#id/relations/synonymie | noms/#id/relations/homonymie | noms/#id/relations/flores |
* - noms/stats/rangs | noms/stats/annees | noms/stats/initiales |
* Est remplit au cours de l'analyse des ressources (traiterRessources()). |
* Est utilisée principalement pr déterminer le format du tableau à retourner. |
*/ |
protected $format_reponse = 'observations'; |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function consulter($ressources, $parametres) { |
$this->traiterVersionProjet($ressources); |
$this->traiterRessources($ressources); |
$resultat_formate = ''; |
if ($this->corps_http == '' && $this->entete_http == '') { |
foreach ($this->table_version as $version) { |
$this->table = $version; //on stocke le nom de la table correspondant à la version du projet en cours |
$this->traiterParametres($parametres); |
$requete = $this->assemblerLaRequete(); //print_r($requete); |
$resultat = $this->getBdd()->recupererTous($requete); |
$res_version = $this->testerResultat($resultat); |
} |
if ($this->corps_http == '' && $this->entete_http == '') { |
if (isset($res_version)) { |
$resultat_formate = json_encode($res_version); |
} |
} |
} |
$this->formerReponseHTTP($resultat_formate); |
} |
public function testerResultat($resultat) { |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$s = 'La requête SQL formée comporte une erreur !!'; |
Debug::printr($requete); |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $s); |
} elseif ($resultat) { |
if (count($this->table_version) > 1) { |
$res_version[$version] = $this->retournerResultatFormate($resultat); |
} else { |
$res_version = $this->retournerResultatFormate($resultat); |
} |
} else { |
if ($this->format_reponse == 'zone-geo/id/relations') { |
//si aucune relations n'existe, la valeur null est retournée |
$res_version = null; |
} else { |
$d = 'Données recherchées introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $d); |
Debug::printr($requete); |
} |
} |
return $res_version; |
} |
public function assemblerLaRequete() { |
$requete = "SELECT ".$this->formerRequeteChamp(). |
" FROM ".$this->table.$this->formerRequeteCondition(). |
' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
return $requete; |
} |
public function formerRequeteChamp() { |
if (!isset($this->table_ressources)) { |
if (!isset($this->table_param['masque_station']) && !isset($this->table_param['masque_contributeur']) ) { |
$champ = ' * '; |
} else { |
$champ = $this->requete_champ; |
} |
} else { |
$champ = $this->requete_champ; |
} |
return $champ; |
} |
public function formerRequeteCondition() { |
$condition = ''; |
if ($this->requete_condition != null) { |
$condition = ' WHERE '.implode(' AND ', $this->requete_condition); |
} |
return $condition; |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function traiterRessources(&$ressources) { |
if (isset($ressources) && !empty($ressources)) { |
$this->table_ressources = $ressources; |
if (isset($this->table_ressources[0]) && !empty($this->table_ressources[0])) { |
$this->traiterRessourceId(); |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
$this->traiterRessourceChamp; |
} |
} |
} |
} |
public function traiterRessourceId() { |
//requete : /observations/#num_nom:#dept (ex : /observations/10:34) |
if (preg_match('/^([0-9]*):([0-9]{2})$/', $this->table_ressources[0], $conditions)) { |
$this->requete_condition[] = ' num_nom = '.$this->getBdd()->proteger($conditions[1]).' AND `'.$conditions[2]."` != '' "; |
$this->requete_champ .= ' ,catminat, rang, num_tax, freq_abs, freq_rel, rare_nat, `'.$conditions[2].'`'; |
$this->format_reponse .= '/id'; |
//requete : /observations/nom:#dept (ex : /observations/coquelicot:30) |
} elseif (preg_match('/^(.*):([0-9]{2})$/', $this->table_ressources[0], $conditions)) { |
$this->requete_condition[] = ' nom_sci like '.$this->getBdd()->proteger($conditions[1].'%').' AND `'.$conditions[2]."` != '' "; |
$this->requete_champ .= ' ,catminat, rang, num_tax, freq_abs, freq_rel, rare_nat, `'.$conditions[2].'`'; |
$this->format_reponse .= '/id'; |
//requete : /observations/num_nom:#num_nom (ex : /observations/num_nom:290) ?? |
} elseif (strrpos($this->table_ressources[0], ':') !== false) { |
} else { |
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->table_ressources[0]. |
' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r); |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function traiterParametres($parametres) { |
if (isset($parametres) && !empty($parametres)) { |
$this->table_param = $parametres; |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $valeur) { |
switch ($param) { |
case 'masque' : $this->ajouterLeFiltreMasque($valeur); break; |
case 'masque_date_observation' : break; |
case 'masque_station' : $this->limite_requete['dept'] = $valeur; |
$this->ajouterUnFiltre('station', $valeur); break; |
case 'masque_determination' : $this->ajouterUnFiltre('nom_sci', $valeur); break; |
case 'masque_determination_nn' : |
$this->requete_condition[] = '`num_nom` = '.$this->getBdd()->proteger($valeur); break; |
case 'masque_observateur' : $this->ajouterLeFiltreContributeur($valeur); break; |
case 'masque_valeur' : $this->presenceChorologie = $valeur; break; |
case 'retour_format' : $this->retour_format = $valeur; break; |
case 'navigation_depart' : $this->ajouterLimiteDepart($valeur); break; |
case 'navigation_limite' : $this->limite_requete['limite'] = $valeur; break; |
case 'recherche' : break; |
default : $p = 'Erreur dans les paramètres de recherche de votre requête : '. |
'</br> Le paramètre " '.$param.' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $p); break; |
} |
} |
} |
} |
/** fonction d'ajout dans la requete SQL des conditions (WHERE ...) en fonctions des parametres demandés |
* @param $nom_champ |
* @param $valeur |
* @param $masque |
*/ |
public function ajouterUnFiltre($nom_champ, $valeur) { |
if ($nom_champ == 'station') { |
if (!preg_match('/^\s*([0-9]{2})\s*$/', $valeur, $colonne)) { // si le nom est passé |
$this->requete_condition[] = '1'; |
/* $url = $this->ajouterHrefAutreProjet('zone-geo',$key,'INSEE-D');// d'apres nom |
$dept = $this->rest_client->consulter($url); |
$entete = $this->rest_client->getReponseEntetes(); |
if (isset($entete['wrapper_data'])) { |
$colonne = json_decode($relation); |
} else { |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, |
'Le service '.$this->service.' de ce projet comporte des erreurs. url lancée : '.$url); |
}*/ |
} else { |
$this->requete_condition[] = '`'.$valeur."` != '' "; |
$this->requete_champ .= ', `'.$valeur.'` '; |
} |
} else { |
// recherche floue |
if ($this->recherche == 'floue') {//ajout_soundex |
$this->requete_condition[] = '(SOUNDEX('.$nom_champ.') = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE('.$nom_champ.')) = SOUNDEX(REVERSE(\''.$valeur.'\'))) '; |
// recherche étendue |
} elseif ($this->recherche == 'etendue') { |
$valeur = str_replace(' ','%', $valeur); |
$valeur .= '%'; |
} |
// recherche stricte |
$this->requete_condition[] = $nom_champ.' LIKE '.$this->getBdd()->proteger($valeur); |
} |
} |
/** fonction d'ajout dans la requete SQL des conditions (WHERE ...) quand le paramètre passé est masque |
* @param $valeur |
*/ |
public function ajouterLeFiltreMasque($valeur) { |
$this->ajouterUnfiltre('station', $valeur); |
$condition = '(( '.array_pop($this->requete_condition); |
$this->ajouterUnfiltre('num_nom', $valeur); |
$condition .= ' ) OR ('.array_pop($this->requete_condition); |
$condition = str_replace('( 1 ) OR', '', $condition); // si la valeur passée est une varchar supprime le filtre station |
$this->ajouterUnfiltre('nom_sci', $valeur); |
$this->requete_condition[] = $condition.' ) OR ('.array_pop($this->requete_condition).' )) '; |
} |
/** fonction d'ajout dans la requete SQL des conditions (WHERE ...) quand le paramètre passé est masque.contributeur |
* @param $valeur |
*/ |
public function ajouterLeFiltreContributeur($valeur) { |
$requete_contr = $this->creerRequeteContributeur($valeur); |
$res = $this->getBdd()->recupererTous($requete_contr); |
if ($res == '') { //cas ou la requete comporte des erreurs |
$c = 'La requête SQL formée comporte une erreur !!'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $c); |
Debug::printr($requete_contr); |
} elseif ($res) { |
unset($res[0]['id'],$res[0]['nom'],$res[0]['prenom'],$res[0]['courriel']); |
// si il y a un masque station et que le contributeur n'a pas de données dans ce dept |
if (isset($this->table_param['masque_station']) && isset($res[0][$this->table_param['masque_station']])) { |
if ($res[0][$this->table_param['masque_station']] != 1) { |
$d = "Les données recherchées sont introuvables pour l'observateur ".$valeur." dans le département " |
.$this->table_param['masque_station']; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $d); |
} |
} else { |
foreach ($res[0] as $dept=>$presence) { |
if ($presence == 1) { |
$this->ajouterUnfiltre('station', $dept); |
$requete_condition[] = array_pop($this->requete_condition); // recupere le filtre créé précédement |
} |
} |
$this->requete_condition[] = '(( '.implode(' ) OR ( ', $requete_condition).' ))'; // créé un filtre sur les dept |
} |
} else { |
$i = "Les données recherchées sont introuvables pour l'observateur ".$valeur; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $i); |
} |
} |
public function creerRequeteContributeur($valeur) { |
$condition = ''; |
if (preg_match('/(.*@[a-z]+\.[a-z]{2,3})/', $valeur, $match)) {// cherche sur le mail |
$condition = 'courriel = '.$this->getBdd()->proteger($match[1]); |
} elseif (preg_match('/^(\w+)\s+(\w+)$/', $valeur, $match)) {// cherche sur les nom prenom |
$condition = ' ((nom = '.$this->getBdd()->proteger($match[1]).' OR prenom = '.$this->getBdd()->proteger($match[1]). |
' ) AND (nom = '.$this->getBdd()->proteger($match[2]).' OR prenom = '.$this->getBdd()->proteger($match[2]).'))'. |
' OR ( nom LIKE '.$this->getBdd()->proteger($valeur.'%').')'; |
} else {// cherche si nom association |
$condition = 'nom LIKE '.$this->getBdd()->proteger($valeur.'%'); |
} |
list($table, $version) = explode('_v',$this->table); |
$requete_contr = "SELECT * FROM chorodep_contributeurs_v$version WHERE ".$condition; |
} |
public function ajouterLimiteDepart($id) { |
$d = explode(":", $id); |
$this->limite_requete['depart'] = 0; |
$this->limite_requete['dept'] = $d[1]; |
$requete_condition = (is_numeric($d[0])) ? '`num_nom` = '.$d[0] : '`nom_sci` like "'.urldecode($d[0]).'%"'; |
$requete = "SELECT id FROM $this->table WHERE ".$requete_condition; //echo $requete; |
$res = $this->getBdd()->recuperer($requete); |
if ($res == '') { //cas ou la requete comporte des erreurs |
$r = 'La requête SQL formée comporte une erreur !!'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $r); |
Debug::printr($requete); |
} elseif ($res) { |
$this->limite_requete['depart'] = $res['id'] - 1; |
} else { |
$i = "Les données recherchées sont introuvables"; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $i); |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function retournerResultatFormate($resultat) { |
$this->table_retour = array(); // stocke les données générales d'une observation et écrase les données d'un dep |
$this->chargerInfosGenerales(); |
switch ($this->format_reponse) { |
case 'observations' : $reponse = $this->formaterObservations($resultat); break; |
case 'observations/id' : $reponse = $this->formaterObservationsId($resultat[0]); break; |
case 'observations/id/champ': $reponse = $this->formaterObservationsIdChamp($resultat[0]); break; |
default : break; |
} |
return $reponse; |
} |
public function formaterObservations($resultat) { |
$num = 0; // compte le nombre d'observations pour retourner le nombre d'obs indiqué |
$depart = false; //le depart du resultat est noté ss forme #ligne:#departement $depart indique le departement est correct |
//on remplit la table $table_retour_json['resultat'] |
foreach ($resultat as $tab) { |
foreach ($tab as $key => $valeur) { |
switch ($key) { |
case 'id' : break; |
case 'catminat' : break; |
case 'rang' : break; |
case 'num_tax' : break; |
case 'freq_abs' : break; |
case 'freq_rel' : break; |
case 'rare_nat' : break; |
case 'num_nom' : ($valeur == 'nc')? $num_nom = urlencode($tab['nom_sci']) : $num_nom = $valeur ; break; |
case 'nom_sci' : $this->table_retour['determination.nom_sci'] = $valeur; break; |
default : // pour les depts |
if ($depart == true && $valeur != '') { |
if (($this->presenceChorologie != '' && $valeur == $this->presenceChorologie) || ($this->presenceChorologie == '' && $valeur != $this->presenceChorologie)) { |
$id = $num_nom.":".$key; |
if ($this->retour_format == 'max' ) { |
$this->afficherDonneesMax($key, $valeur); |
$this->table_retour['href'] = $this->ajouterHref('observations',$id); |
} else { |
$this->table_retour['station.departement.code'] = 'INSEE-D.'.$key; |
$this->table_retour['valeur.code'] = $valeur; |
} |
$resultat_json[$id] = $this->table_retour; |
$num++; |
} |
} |
if ($key == $this->limite_requete['dept']) $depart = true; |
break; |
} |
if ($num == $this->limite_requete['limite']) { |
break; |
} |
} |
if ($num == $this->limite_requete['limite']) { |
break; |
} |
$this->table_retour = array(); |
} |
//on remplit la table $table_retour_json['entete'] |
//formuler les urls precedentes et suivantes affichées dans l'entete du resultat |
$url = $this->formulerUrl($id, $num, '/observations'); |
if ($url['precedent'] != '') { $this->table_entete['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $this->table_entete['href.suivant'] = $url['suivant']; } |
$this->table_entete['total'] = $num; |
$table_retour_json['entete'] = $this->table_entete; |
$table_retour_json['resultat'] = $resultat_json; |
return $table_retour_json; |
} |
public function formaterObservationsId($resultat) { |
foreach ($resultat as $key => $valeur) { |
switch ($key) { |
case 'id' : break; |
case 'catminat' : if ($this->retour_format == 'max') $this->table_retour['determination.catminat'] = $valeur; break; |
case 'rang' : $this->table_retour['determination.rang'] = $valeur; break; |
case 'num_tax' : $this->table_retour['determination.num_tax'] = $valeur; break; |
case 'freq_abs' : break; |
case 'freq_rel' : break; |
case 'rare_nat' : $this->table_retour['determination.rarete_nationale.code'] = $valeur; break; |
case 'nom_sci' : $this->table_retour['determination.nom_sci'] = $valeur; break; |
case 'num_nom' : $this->table_retour['determination.num_nom'] = $valeur; break; |
default : if ($this->retour_format == 'max') { |
$this->afficherDonneesMax($key, $valeur, true); |
} else { |
$this->table_retour['station.departement.code'] = 'INSEE-D.'.$key; |
$this->table_retour['valeur.code'] = $valeur; |
} break; |
} |
} |
return $this->table_retour; |
} |
public function afficherDonneesMax($key, $valeur, $id = false) { |
if ($key != 20) { //à part la Corse |
$url_dep = $this->ajouterHrefAutreProjet('zone-geo','',$key, 'insee-d'); |
$dep = $this->consulterHref($url_dep); |
$this->table_retour['station.departement'] = $dep->nom; |
$this->table_retour['station.departement.code'] = 'INSEE-D.'.$key; |
$this->table_retour['station.departement.href'] = $url_dep; |
} else { |
$this->table_retour['station.departement.code'] = 'INSEE-D.'.$key; |
} |
//double encodage des paramétres contre validation de Apache |
$url_val = $this->ajouterHref('ontologies', 'presenceChorologie:'.urlencode(urlencode($valeur))); |
$val = $this->consulterHref($url_val); |
$this->table_retour['valeur'] = $val->nom; |
$this->table_retour['valeur.code'] = $valeur; |
$this->table_retour['valeur.href'] = $url_val; |
if ($this->format_reponse == 'observations/id') { // si on est |
$contr = $this->chargerContributeurs($key); |
if (isset($contr['general'])) { |
$this->table_retour['contributeur'] = $contr['general']; |
$this->table_retour['contributeur.details'] = $contr['details']; |
} |
$source = $this->chargerSources($key); |
if (isset($source['general'])) $this->table_retour['sources'] = $source['general']; |
if (isset($source['autres'])) $this->table_retour['sources.autres'] = $source['autres']; |
} |
} |
public function chargerInfosGenerales() { |
$requete = "SELECT createurs, date_creation FROM chorodep_meta WHERE version = '5.00';"; |
$resultat = $this->getBdd()->recuperer($requete); //Debug::printr($resultat); |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$r = 'La requête SQL formée comporte une erreur !!'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $r); |
Debug::printr($requete); |
} elseif ($resultat) { |
$this->table_retour['type'] = 'chorologie'; |
$this->table_retour['date_observation'] = $resultat['date_creation']; |
$this->table_retour['observateur.details'] = $this->traiterChampFormateDCSV($resultat['createurs']); |
} |
} |
public function chargerContributeurs($dept) { |
$contributeur = array(); |
list($table, $version) = explode('_v',$this->table); |
$requete = "SELECT prenom, nom, courriel FROM chorodep_contributeurs_v$version WHERE `$dept` = '1';"; |
$resultat = $this->getBdd()->recupererTous($requete); //Debug::printr($resultat); |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$r = 'La requête SQL formée comporte une erreur !!'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $r); |
Debug::printr($requete); |
} elseif ($resultat) { |
foreach ($resultat as $res) { |
$contributeur['general'] .= $res['prenom'].' '.$res['nom'].', '; |
foreach ($res as $cle => $valeur) { |
if ($valeur == "") { |
unset($res[$cle]); |
} |
} |
$type = ($res['prenom'] == '') ? 'o' : 'p'; |
$url = $this->ajouterHrefAutreProjet('ontologies', 'contactType:', $type, 'commun'); |
$val = $this->consulterHref($url); |
$res['type'] = $val->nom; |
$res['type.code'] = $type; |
$res['type.href'] = $url; |
$contributeur['details'][] = $res; |
} |
} |
return $contributeur; |
} |
// prend en paramètre un champ comme createur, contributeur... sous forme p.prenom=ygggg,p.nom=fk;p.prenom=fdfs,p.nom=ek |
//retourne un tableau |
public function creerPointDetails($resultat) { |
$organismes = explode(';', $resultat); |
$num_org = 1; |
$general = ''; |
foreach ($organismes as $organisme) { |
$infos = explode(',', $organisme); |
$t = ''; |
$type = '.'; |
foreach ($infos as $info) { |
list($key, $val) = explode('=', $info); |
list($type, $champ) = explode('.', trim($key)); |
if ($type == 'p' && $champ == 'prenom') $general .= $val.' '; |
if (($type == 'p' || $type == 'o') && $champ == 'nom') $general .= $val.' '; |
$res[$num_org][$champ] = $val; |
$res[$num_org]['type'] = $type;// à modifier |
} |
$general = rtrim($general).', '; |
$num_org ++; |
} |
$this->table_retour['observateur'] = rtrim($general, ', '); |
$this->table_retour['observateur.details'] = $res; |
} |
/** |
* Recupère à partir de la valeur du champ les différentes informations séparées par ';' (stocke ds un tableau) |
* pour éditeurs, créateurs, contributeurs,... |
* (ex : nom=Tela Botanica,guid=urn:lsid:tela-botanica.org,courriel=accueil@tela-botanica.org,... |
*/ |
public function traiterChampFormateDCSV($val) { |
$tab = array(); |
$num_entite = 0; |
$type = ''; |
// découpe chaque participant |
$tab_entites = explode(';', $val); |
foreach ($tab_entites as $entite) { |
$tab[$num_entite] = array(); |
if ($entite != '') { |
// découpe les informations du participant |
$entite_detail = explode(',', $entite); |
foreach ($entite_detail as $detail) { |
if ($detail != '') { |
if (preg_match('/^([^=]*)\.([^=]+)=([^=]*)$/', $detail, $match)) { |
$tab[$num_entite][$match[2]] = $match[3]; |
if ($match[1] != $type) $type = $match[1]; |
} else { |
$tab[$num_entite][] = $detail; |
} |
} |
} |
if ($type != '') { |
if ($this->retour_format == 'max') { |
} |
} |
} |
$num_entite++; |
} |
return $tab; |
} |
public function chargerSources($dept) { |
$contributeur = array(); |
list($table, $version) = explode('_v',$this->table); |
$requete = "SELECT biblio FROM chorodep_sources_v$version WHERE `$dept` = '1';"; |
$resultat = $this->getBdd()->recupererTous($requete); //Debug::printr($resultat); |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$r = 'La requête SQL formée comporte une erreur !!'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $r); |
Debug::printr($requete); |
} elseif ($resultat) { |
foreach ($resultat as $cle=>$res) { |
if ($cle == 0) { |
$contributeur['general'] = $res['biblio']; |
} else { |
$contributeur['autres'][] = $res['biblio']; |
} |
} |
} |
return $contributeur; |
} |
/* public function formaterObservationsIdChamp($resultat) { |
//on recupère tous les resultats possibles |
$reponse = $this->formaterObservationsId($resultat); |
$this->table_retour = array(); |
//on recupère les résultats demandés à partir du tableau de résultat complet |
$this->table_retour['id'] = $reponse['id']; |
$champs = explode(' ', $this->table_ressources[1]); |
foreach ($champs as $champ) { |
if ($this->verifierValiditeChamp($champ, $reponse)) { |
if (strrpos($champ, '.*') !== false) { |
$this->afficherPointEtoile($champ, $reponse); |
} else { |
if (isset($reponse[$champ])) { |
$this->table_retour[$champ] = $reponse[$champ]; |
} else { |
$this->table_retour[$champ] = null; |
} |
} |
} |
} |
return $this->table_retour; |
}*/ |
// +-------------------------------------------------------------------------------------------------------------------+ |
/** |
* Description : |
* Est appelée pour former l'url complete des resultats precedants ou suivants. |
* @param int : Permet de connaitre le nombre de noms obtenus par la requete |
* @return string Retourne l'url complete des resultats precedents ou suivant sous la forme d'un tableau |
*/ |
public function formulerUrl($suivant, $total, $id = null) { |
$debut_url = Config::get('url_service').$id.'?'; |
//on recrée l'url sans les parametres de navigation qui seront rajouter ci-apres. On les enlève dc de la table des parametres |
$table_bis = $this->table_param; |
if (isset($table_bis['navigation_depart'] )) { |
unset($table_bis['navigation_depart']); |
} |
if (isset($table_bis['navigation_limite'])) { |
unset($table_bis['navigation_limite']); |
} |
$parametre_url = http_build_query($table_bis); |
//on recupere les limites |
$url['suivant'] = $this->recupererLesLimitesSuivantes($suivant, $total); |
$url['precedent'] = $this->recupererLesLimitesPrecedentes($suivant); |
//on reconstitue les deux urls avec leurs limites |
foreach ($url as $key => $limite) { |
if ($limite != '') { |
if ($parametre_url == '') { |
//si il n'y a aucun parametres, seules les limites sont à ajouter.On enleve dc le signe & du début |
$limite = str_replace('&navigation.depart=', 'navigation.depart=', $limite); |
if (strpos($limite, 'navigation.depart') == false) { |
$limite = str_replace('&navigation.limite=', 'navigation.limite=', $limite); |
} |
} |
$url_complete = $debut_url.$parametre_url.$limite; |
$url[$key] = $url_complete; |
} |
} |
return $url; |
} |
/** |
* Description : |
* Permet de former les limites de la requete retournant les résultats suivants. |
* Cette url sera afficher dans l'entete de la reponse retournée en format JSON (retour.format=defaut). |
* @param int : $nb_resultat : Permet de connaitre le nombre de résultats obtenus par la requete |
* @return string : la fin de l'url decrivant les limites des resultats suivants. Si aucun résultats ne suient, |
* une chaine de caractère vide est retournée |
*/ |
public function recupererLesLimitesSuivantes($suivant, $total) { |
if ($this->limite_requete['limite'] <= $total) { |
$url_suivante = '&navigation.depart='.$suivant.'&navigation.limite='.$this->limite_requete['limite']; |
} else { |
$url_suivante = ''; |
} |
return $url_suivante; |
} |
/** |
* Description : |
* Permet de former les limites de la requete retournant les résultats precedents. |
* Cette url sera afficher dans l'entete de la taxons/105reponse retournée en format JSON (retour.format=defaut) |
* @return string : la fin de l'url decrivant les limites des resultats precedents. |
* Si aucun résultats ne precedent, une chaine de caractère vide est retournée |
*/ |
public function recupererLesLimitesPrecedentes($suivant) { |
$url_precedente = ''; |
if (isset($this->table_param['navigation_depart'])) { // si on utilise un parametre de départ |
// si l'adresse d'appel de la page est inférieur au départ |
$regex = '/http:\/\/.*\/service:eflore:0.1\/chorodep\/observations\?.*navigation.depart=(.*\:[0-9]*).*/'; |
if (isset($_SERVER['HTTP_REFERER']) && preg_match($regex, $_SERVER['HTTP_REFERER'], $match)) { |
if ($match[1] != $this->table_param['navigation_depart'] && $match[1] != $suivant) { |
$url_precedente = '&navigation.depart='.$match[1].'&navigation.limite='.$this->limite_requete['limite']; |
} |
} else { |
$url_precedente = '&navigation.limite='.$this->limite_requete['limite']; |
} |
} |
return $url_precedente; |
} |
} |
?> |
/trunk/services/modules/0.1/insee-d/ZoneGeo.php |
---|
New file |
0,0 → 1,436 |
<?php |
/** |
* Description : |
* Classe ZoneGeo.php fournit des informations sur ensemble structuré des termes et concepts représentant les éléments |
* d'un domaine de connaissances . |
* Le but étant de fournir un ensemble minimal d'information comprenant : |
* un identifiant (numérique ou alphanumérique sous forme de ChatMot si possible), un nom, une region et |
* éventuellement une relation hiérarchique avec un autre terme (=classe). |
* Si l'url finit par /zone-geo on retourne une liste de termes (seulement les 100 premières par défaut). |
* L'url peut contenir des paramètres optionnels passés après le ? : /observations?param1=val1¶m2=val2&... |
* |
* Les paramètres de requête disponibles sont : masque, masque.code, masque.nom, masque.region , recherche, |
* distinct, retour.format, navigation.depart et navigation.limite. |
* |
* Encodage en entrée : utf8 |
* Encodage en sortie : utf8 |
* @package framework-v3 |
* @author Delphine Cauquil <delphine@tela-botanica.org> |
* @author Jennifer Dhé <jennifer.dhe@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> |
* @version 1.0 |
* @copyright 1999-${year} Tela Botanica (accueil@tela-botanica.org) |
*/ |
class ZoneGeo extends Commun { |
protected $service = 'zone-geo'; |
/** |
* Permet de stocker la requete formulée : /zone-geo | /zone-geo/#id | /zone-geo/#id/champ | /zone-geo/#id/relations |
* Est remplit au cours de l'analyse des ressources (traiterRessources()), par défaut, a la valeur du service. |
* Est utilisée principalement pr déterminer le format du tableau à retourner. */ |
protected $format_reponse = 'zone-geo'; |
/** Variables constituant les parametres de la requete SQL (champ, condition, group by, limit) remplie |
* selon ressources et paramètres */ |
protected $requete_champ = ' * '; |
protected $requete_condition = ''; |
protected $limite_requete = array( |
'depart' => 0, |
'limite' => 100 |
); |
/** Stockage des ressources et paramétres */ |
protected $table_ressources = array(); |
protected $table_param = array(); |
/** |
* Precise la contenance plus ou moins précise du tableau à retourner : |
* - min = les données présentes dans la table |
* - max = les données de la table + les informations complémentaires (pour les identifiants et les codes) |
* - oss = la liste des nom_sci (uniquement pour noms et taxons) |
*/ |
protected $retour_format = 'max'; |
/** Valeur du paramètre de requete recherche : |
* - stricte : le masque est passé tel quel à l'opérateur LIKE. |
* - etendue : ajout automatique du signe % à la place des espaces et en fin de masque avec utilisation de LIKE. |
* - floue : recherche tolérante vis-à-vis d'approximations ou d'erreurs (fautes d'orthographe par exemple) */ |
protected $recherche; |
/** Permet de stocker le tableau de résultat (non encodé en json) */ |
protected $table_retour = array(); |
/** Stocke le nombre total de résultats de la requete principale. Est calculée lors de l'assemblage de la requete */ |
protected $total_resultat; |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function consulter($ressources, $parametres) { |
$this->traiterParametres($parametres); |
$this->traiterVersionProjet($ressources); |
$this->traiterRessources($ressources); |
$resultat_formate = ''; |
if ($this->corps_http == '' && $this->entete_http == '') { |
foreach ($this->table_version as $version) { |
$this->table = $version; //on stocke le nom de la table correspondant à la version du projet en cours |
$requete = $this->assemblerLaRequete(); //print_r($requete); |
$resultat = $this->getBdd()->recupererTous($requete); |
$res_version = $this->testerResultat($resultat, $requete); |
} |
if ($this->corps_http == '' && $this->entete_http == '') { |
if (isset($res_version)) { |
$resultat_formate = json_encode($res_version); |
} |
} |
} |
$this->formerReponseHTTP($resultat_formate); |
} |
public function testerResultat($resultat, $requete) { |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$s = 'La requête SQL formée comporte une erreur !!'; |
Debug::printr($requete); |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $s); |
} elseif ($resultat) { |
if (count($this->table_version) > 1) { |
$res_version[$version] = $this->retournerResultatFormate($resultat); |
} else { |
$res_version = $this->retournerResultatFormate($resultat); |
} |
} else { |
if ($this->format_reponse == 'zone-geo/id/relations') { |
//si aucune relation n'existe, la valeur null est retournée |
$res_version = null; |
} else { |
$d = 'Données recherchées introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $d); |
Debug::printr($requete); |
} |
} |
return $res_version; |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function traiterParametres($parametres) { |
if (isset($parametres) && !empty($parametres)) { |
$this->table_param = $parametres; |
// masque : filtre la liste en fonction d'un masque de recherche portant sur le code, le nom ou la region. |
// masque.code : filtre uniquement sur le code. masque.nom : filtre uniquement sur le nom. |
// masque.region : filtre uniquement sur la region. |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $valeur) { |
switch ($param) { |
case 'masque' : $this->ajouterLeFiltreMasque('masque', $valeur); break; |
case 'masque_code' : $this->ajouterLeFiltreMasque('dep', $valeur); break; |
case 'masque_nom' : $this->ajouterLeFiltreMasque('nccenr', $valeur); break; |
case 'masque_region' : $this->ajouterLeFiltreMasque('region', $valeur); break; |
case 'retour_format' : $this->retour_format = $valeur; break; |
case 'navigation_depart' : $this->limite_requete['depart'] = $valeur; break; |
case 'navigation_limite' : $this->limite_requete['limite'] = $valeur; break; |
case 'recherche' : break; |
default : $p = 'Erreur dans les paramètres de recherche de votre requête : '. |
'</br> Le paramètre " '.$param.' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $p); break; |
} |
} |
} |
} |
public function ajouterLeFiltreMasque($nom_champ, $valeur) { |
if ($nom_champ == 'dep' || $nom_champ == 'region') { |
$this->requete_condition[] = $nom_champ.' = '.$this->getBdd()->proteger($valeur); |
} else { |
if ($this->recherche == 'floue') { |
if ($nom_champ == 'masque') { |
$this->requete_condition[] = '( dep = '.$this->getBdd()->proteger($valeur) |
.' OR region = '.$this->getBdd()->proteger($valeur) |
.' OR ( SOUNDEX(nccenr) = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE(nccenr)) = SOUNDEX(REVERSE(\''.$valeur.'\')) ' |
.')) '; |
} else { |
$this->requete_condition[] = '(SOUNDEX('.$nom_champ.') = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE('.$nom_champ.')) = SOUNDEX(REVERSE(\''.$valeur.'\'))) '; |
} |
} else { |
if ($this->recherche == 'etendue') { |
$valeur = str_replace(' ','%', $valeur); |
$valeur .= '%'; |
} |
if ($nom_champ == 'masque') { |
$this->requete_condition[] = ' (dep = '.$this->getBdd()->proteger($valeur) |
.' OR nccenr LIKE '.$this->getBdd()->proteger($valeur) |
.' OR region = '.$this->getBdd()->proteger($valeur).')'; |
} else { |
$this->requete_condition[] = $nom_champ.' LIKE '.$this->getBdd()->proteger($valeur); |
} |
} |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function traiterRessources(&$ressources) { |
if (isset($ressources) && !empty($ressources)) { |
$this->table_ressources = $ressources; |
if (isset($this->table_ressources[0]) && !empty($this->table_ressources[0])) { |
//requete = /zone-geo/#id |
$this->traiterRessourceId(); |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
//dans le cas /zone-geo/#id/#champ ou /zone-geo/#id/relations |
$this->traiterRessourceChampOuRelations(); |
} |
} |
} |
} |
//requete : /zone-geo/#id (ex : /zone-geo/7) |
public function traiterRessourceId() { |
if (is_numeric($this->table_ressources[0])) { |
$this->requete_condition[] = ' dep = '.$this->getBdd()->proteger($this->table_ressources[0]); |
$this->format_reponse .= '/id'; |
} else { |
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->table_ressources[0]. |
' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r); |
} |
} |
public function traiterRessourceChampOuRelations() { |
//requete = /zone-geo/#id/relations : |
if ($this->table_ressources[1] == 'relations') { |
$this->format_reponse .= '/relations'; |
$this->requete_condition[] = 'region = (SELECT region FROM '.$this->table.' WHERE ' |
.implode(' AND ', $this->requete_condition).')'; |
//requete = /zone-geo/#id/#champ : |
} else { |
$this->format_reponse .= '/champ'; |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function assemblerLaRequete() { |
//assemblage de la requete : |
$requete = ' SELECT '.$this->requete_champ. |
' FROM '.$this->table |
.$this->formerRequeteCondition() |
.$this->formerRequeteLimite(); |
return $requete; |
} |
public function formerRequeteCondition() { |
$condition = ''; |
if ($this->requete_condition != null) { |
$condition = ' WHERE '.implode(' AND ', $this->requete_condition); |
} |
return $condition; |
} |
//ajout d'une limite seulement pour les listes (pas plus de 100 resultats retournés pr les requetes |
// suivantes : /zone-geo et /zone-geo/#id/relations) |
public function formerRequeteLimite() { |
if ($this->format_reponse != 'zone-geo' && $this->format_reponse != 'zone-geo/id/relations') { |
$this->requete_limite = ''; |
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) { |
//cas où la requete presente un navigation.depart supérieur au nb total de resultats. |
$this->limite_requete['depart'] = |
(($nb - $this->limite_requete['limite']) < 0) ? 0 : ($nb - $this->limite_requete['limite']); |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} else { |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} |
return $this->requete_limite; |
} |
public function recupererTotalResultat() { |
//on récupère le nombre total de résultats de la requete (ex : le nombre d'id contenu dans la liste /zone-geo) |
$requete = 'SELECT count(*) as nombre FROM ' |
.$this->table |
.$this->formerRequeteCondition(); |
$res = $this->getBdd()->recuperer($requete); |
if ($res) { |
$total = $res['nombre']; |
} else { |
$t = 'Fonction recupererTotalResultat() : <br/>Données introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $t); |
} |
return $total; |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
// determine en fct du service appelé (/zone-geo | /zone-geo/#id | /zone-geo/#id/champ | |
// /zone-geo/#id/relations) le format du tableau à retourner. |
public function retournerResultatFormate($resultat) { |
$this->recupererTableConfig('correspondance_champs'); |
switch ($this->format_reponse) { |
case 'zone-geo' : $reponse = $this->formaterZoneGeo($resultat); break; |
case 'zone-geo/id' : $reponse = $this->formaterZoneGeoId($resultat[0]); break; |
case 'zone-geo/id/champ' : $reponse = $this->formaterZoneGeoIdChamp($resultat[0]); break; |
case 'zone-geo/id/relations' : $reponse = $this->formaterZoneGeoIdRelations($resultat); break; |
default : break; |
} |
return $reponse; |
} |
public function formaterZoneGeo($resultat) { |
//on remplit la table $table_retour_json['entete'] |
$this->table_retour['depart'] = $this->limite_requete['depart']; |
$this->table_retour['limite'] = $this->limite_requete['limite']; |
$this->table_retour['total'] = $this->total_resultat; |
$url = $this->formulerUrl($this->total_resultat, '/zone-geo'); |
if ($url['precedent'] != '') { $this->table_retour['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $this->table_retour['href.suivant'] = $url['suivant']; } |
$table_retour_json['entete'] = $this->table_retour; |
//on remplit la table $table_retour_json['resultat'] |
$this->table_retour = array(); |
if (isset($this->table_param['masque_nom'])) $resultat = $this->trierRechercheFloue($this->table_param['masque_nom'], $resultat, 'nccenr'); |
foreach ($resultat as $tab) { |
foreach ($tab as $key => $valeur) { |
if ($valeur != '') { |
switch ($key) { |
case 'dep' : $num = $valeur; $this->table_retour['code'] = $valeur; break; |
case 'nccenr' : $this->table_retour['nom'] = $valeur; break; |
default : break; |
} |
} |
} |
if ($this->retour_format == 'max') { |
$this->table_retour['href'] = $this->ajouterHref('zone-geo', $num); |
} |
$resultat_json[$num] = $this->table_retour; |
$this->table_retour = array(); |
} |
$table_retour_json['resultat'] = $resultat_json; |
return $table_retour_json; |
} |
public function formaterZoneGeoId($resultat) { |
foreach ($resultat as $key => $valeur) { |
if ($valeur != '') { |
$this->afficherDonnees($key, $valeur); |
} |
} |
unset($this->table_retour['href']); |
return $this->table_retour; |
} |
public function formaterZoneGeoIdRelations($resultat) { |
if ($resultat == '') { |
$retour = null; |
} else { |
//on remplit la table $table_retour_json['entete'] |
$this->table_retour['depart'] = $this->limite_requete['depart']; |
$this->table_retour['limite'] = $this->limite_requete['limite']; |
$this->table_retour['total'] = $this->total_resultat; |
//formuler les urls |
$url = $this->formulerUrl(count($resultat), '/zone-geo'); |
if ($url['precedent'] != '') { $this->table_retour['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $this->table_retour['href.suivant'] = $url['suivant']; } |
$retour['entete'] = $this->table_retour; |
$this->table_retour = array(); |
//on remplit la table $table_retour_json['resultat'] |
foreach ($resultat as $tab) { |
foreach ($tab as $key => $valeur) { |
switch ($key) { |
case 'dep' : $num = $valeur; $this->table_retour['code'] = $valeur; break; |
case 'nccenr' : $this->table_retour['nom'] = $valeur; break; |
default : break; |
} |
} |
if ($this->retour_format == 'max') $this->table_retour['href'] = $this->ajouterHref('zone-geo', $num); |
$resultat_json[$num] = $this->table_retour; |
$this->table_retour = array(); |
} |
$retour['resultat'] = $resultat_json; |
} |
return $retour; |
} |
public function formaterZoneGeoIdChamp($resultat) { |
//on recupère tous les resultats possibles |
$reponse = $this->formaterZoneGeoId($resultat); |
$this->table_retour = array(); |
//on recupère les résultats demandés à partir du tableau de résultat complet |
$this->table_retour['id'] = $reponse['code']; |
$champs = explode(' ', $this->table_ressources[1]); |
foreach ($champs as $champ) { |
if ($this->verifierValiditeChamp($champ)) { |
if (strrpos($champ, '.*') !== false) { |
$this->afficherPointEtoile($champ, $reponse); |
} else { |
if (isset($reponse[$champ])) { |
$this->table_retour[$champ] = $reponse[$champ]; |
} else { |
$this->table_retour[$champ] = null; |
} |
} |
} |
} |
return $this->table_retour; |
} |
public function verifierValiditeChamp($champ) { |
preg_match('/^([^.]+)(\.([^.]+))?$/', $champ, $match); |
$champs_possibles = $this->correspondance_champs; |
$champs_possibles[] = 'nom.*'; |
if (in_array($match[1], $champs_possibles)) { |
$validite = true; |
} elseif (in_array($match[0], $champs_possibles)) { |
$validite = true; |
} else { |
$champs_possibles = implode('</li><li>', $champs_possibles); |
$c = 'Erreur dans votre requête : </br> Le champ "'.$champ_possibles.'" n\'existe pas. '. |
'Les champs disponibles sont : <li>'.$champs_possibles.'</li>'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $c); |
} |
return $validite; |
} |
public function afficherPointEtoile($champ, $reponse) { |
preg_match('/^([^.]+\.)\*$/', $champ, $match); |
foreach ($reponse as $chp => $valeur) { |
if (strrpos($chp, $match[1]) !== false) { |
if ($valeur != '') { |
$this->table_retour[$chp] = $valeur; |
} else { |
$this->table_retour[$chp] = null; |
} |
} |
} |
} |
public function afficherDonnees($champ, $valeur) { |
if ($this->retour_format == 'max') { |
if ($champ == 'region' || $champ == 'chef_lieu') { |
$projet = 'insee-'.substr($champ, 0, 1); |
$this->table_retour[$champ.'.code'] = $valeur; |
$this->table_retour[$champ.'.href'] = $this->ajouterHrefAutreProjet('zone-geo', '', $valeur, $projet); |
} elseif ($champ == 'tncc') { |
$url = $this->ajouterHref('ontologies', $valeur); |
$res = $this->consulterHref($url); |
$this->table_retour['type_nom'] = $res->nom; |
$this->table_retour['type_nom.code'] = $valeur; |
$this->table_retour['type_nom.href'] = $url; |
} else { |
$this->table_retour[$this->correspondance_champs[$champ]] = $valeur; |
} |
} else { |
$this->table_retour[$this->correspondance_champs[$champ]] = $valeur; |
} |
} |
} |
?> |
/trunk/services/modules/0.1/iso-3166-1/ZoneGeo.php |
---|
New file |
0,0 → 1,423 |
<?php |
/** |
* Description : |
* Classe ZoneGeo.php fournit des informations sur un ensemble de lieux à une échelle donnée. |
* Le but étant de fournir un ensemble minimal d'information comprenant : |
* un identifiant (numérique ou alphanumérique sous forme de ChatMot si possible), un nom, une region et |
* éventuellement une relation hiérarchique avec un autre terme (=classe). |
* Si l'url finit par /zone-geo on retourne une liste de zones (seulement les 100 premières par défaut). |
* L'url peut contenir des paramètres optionnels passés après le ? : /zone-geo?param1=val1¶m2=val2&... |
* |
* Les paramètres de requête disponibles sont : masque, masque.code, masque.nom, masque.region , recherche, |
* distinct, retour.format, navigation.depart et navigation.limite. |
* |
* Encodage en entrée : utf8 |
* Encodage en sortie : utf8 |
* @package framework-v3 |
* @author Delphine Cauquil <delphine@tela-botanica.org> |
* @author Jennifer Dhé <jennifer.dhe@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> |
* @version 1.0 |
* @copyright 1999-${year} Tela Botanica (accueil@tela-botanica.org) |
*/ |
class ZoneGeo extends Commun { |
protected $service = 'zone-geo'; |
/** |
* Permet de stocker la requete formulée : /zone-geo | /zone-geo/#id | /zone-geo/#id/champ | /zone-geo/#id/relations |
* Est remplit au cours de l'analyse des ressources (traiterRessources()), par défaut, a la valeur du service. |
* Est utilisée principalement pr déterminer le format du tableau à retourner. */ |
protected $format_reponse = 'zone-geo'; |
/** Variables constituant les parametres de la requete SQL (champ, condition, group by, limit) remplie |
* selon ressources et paramètres */ |
protected $requete_champ = ' * '; |
protected $requete_condition = ''; |
protected $limite_requete = array( |
'depart' => 0, |
'limite' => 100 |
); |
/** Stockage des ressources et paramétres */ |
protected $table_ressources = array(); |
protected $table_param = array(); |
/** |
* Precise la contenance plus ou moins précise du tableau à retourner : |
* - min = les données présentes dans la table |
* - max = les données de la table + les informations complémentaires (pour les identifiants et les codes) |
* - oss = la liste des nom_sci (uniquement pour noms et taxons) |
*/ |
protected $retour_format = 'max'; |
/** Valeur du paramètre de requete recherche : |
* - stricte : le masque est passé tel quel à l'opérateur LIKE. |
* - etendue : ajout automatique du signe % à la place des espaces et en fin de masque avec utilisation de LIKE. |
* - floue : recherche tolérante vis-à-vis d'approximations ou d'erreurs (fautes d'orthographe par exemple) */ |
protected $recherche; |
/** Permet de stocker le tableau de résultat (non encodé en json) */ |
protected $table_retour = array(); |
/** Stocke le nombre total de résultats de la requete principale. Est calculée lors de l'assemblage de la requete */ |
protected $total_resultat; |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function consulter($ressources, $parametres) { |
$this->traiterParametres($parametres); |
$this->traiterVersionProjet($ressources); |
$this->traiterRessources($ressources); |
$resultat_formate = ''; |
if ($this->corps_http == '' && $this->entete_http == '') { |
foreach ($this->table_version as $version) { |
$this->table = $version; //on stocke le nom de la table correspondant à la version du projet en cours |
$requete = $this->assemblerLaRequete(); //print_r($requete); |
$resultat = $this->getBdd()->recupererTous($requete); |
$res_version = $this->testerResultat($resultat, $requete); |
} |
if ($this->corps_http == '' && $this->entete_http == '') { |
if (isset($res_version)) { |
$resultat_formate = json_encode($res_version); |
} |
} |
} |
return $this->formerReponseHTTP($resultat_formate); |
} |
public function testerResultat($resultat, $requete) { |
if ($resultat == '') { //cas ou la requete comporte des erreurs |
$s = 'La requête SQL formée comporte une erreur !!'; |
Debug::printr($requete); |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $s); |
} elseif ($resultat) { |
if (count($this->table_version) > 1) { |
$res_version[$version] = $this->retournerResultatFormate($resultat); |
} else { |
$res_version = $this->retournerResultatFormate($resultat); |
} |
} else { |
$d = 'Données recherchées introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $d); |
Debug::printr($requete); |
} |
return $res_version; |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function traiterParametres($parametres) { |
if (isset($parametres) && !empty($parametres)) { |
$this->table_param = $parametres; |
// masque : filtre la liste en fonction d'un masque de recherche portant sur le code, le nom ou la region. |
// masque.code : filtre uniquement sur le code. masque.nom : filtre uniquement sur le nom. |
// masque.region : filtre uniquement sur la region. |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $valeur) { |
switch ($param) { |
case 'masque' : $this->ajouterLeFiltreMasque('masque', $valeur); break; |
case 'masque_code' : $this->ajouterLeFiltreMasque('codet', $valeur); break; |
case 'masque_nom' : $this->ajouterLeFiltreMasque('nom', $valeur); break; |
case 'masque_statut' : $this->ajouterLeFiltreMasque('codet_statut', $valeur); break; |
case 'retour_format' : $this->retour_format = $valeur; break; |
case 'navigation_depart' : $this->limite_requete['depart'] = $valeur; break; |
case 'navigation_limite' : $this->limite_requete['limite'] = $valeur; break; |
case 'recherche' : break; |
default : $p = 'Erreur dans les paramètres de recherche de votre requête : '. |
'</br> Le paramètre " '.$param.' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $p); break; |
} |
} |
} |
} |
public function ajouterLeFiltreMasque($nom_champ, $valeur) { |
if ($nom_champ == 'codet') { |
$this->requete_condition[] .= $nom_champ.' = '.$this->getBdd()->proteger($valeur); |
} else { |
if ($this->recherche == 'floue') { |
if ($nom_champ == 'masque') { |
$this->requete_condition[] = ' ( codet = '.$this->getBdd()->proteger($valeur) |
.' OR (SOUNDEX(nom_francais) = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE(nom_francais)) = SOUNDEX(REVERSE(\''.$valeur.'\')) OR ' |
.'SOUNDEX(nom_anglais) = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE(nom_anglais)) = SOUNDEX(REVERSE(\''.$valeur.'\'))) ' |
.' OR ( SOUNDEX(codet_statut) = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE(codet_statut)) = SOUNDEX(REVERSE(\''.$valeur.'\')) ' |
.')) '; |
} elseif ($nom_champ == 'nom') { |
$this->requete_condition[] = '(SOUNDEX(nom_francais) = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE(nom_francais)) = SOUNDEX(REVERSE(\''.$valeur.'\'))) OR |
(SOUNDEX(nom_anglais) = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE(nom_anglais)) = SOUNDEX(REVERSE(\''.$valeur.'\'))) '; |
} else { |
$this->requete_condition[] = '(SOUNDEX('.$nom_champ.') = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE('.$nom_champ.')) = SOUNDEX(REVERSE(\''.$valeur.'\'))) '; |
} |
} else { |
if ($this->recherche == 'etendue') { |
$valeur = str_replace(' ','%', $valeur); |
$valeur .= '%'; |
} |
if ($nom_champ == 'masque') { |
$this->requete_condition[] = '(codet = '.$this->getBdd()->proteger($valeur) |
.' OR nom_francais LIKE '.$this->getBdd()->proteger($valeur) |
.' OR nom_anglais LIKE '.$this->getBdd()->proteger($valeur) |
.' OR codet_statut LIKE '.$this->getBdd()->proteger($valeur).')'; |
} elseif ($nom_champ == 'nom') { |
$this->requete_condition[] = '(nom_francais LIKE '.$this->getBdd()->proteger($valeur).' OR ' |
.'nom_anglais LIKE '.$this->getBdd()->proteger($valeur).') '; |
} else { |
$this->requete_condition[] = $nom_champ.' LIKE '.$this->getBdd()->proteger($valeur); |
} |
} |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function traiterRessources(&$ressources) { |
if (isset($ressources) && !empty($ressources)) { |
$this->table_ressources = $ressources; |
if (isset($this->table_ressources[0]) && !empty($this->table_ressources[0])) { |
//requete = /zone-geo/#id |
$this->traiterRessourceId(); |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
//requete = /zone-geo/#id/#champ ou /zone-geo/#id/relations |
$this->traiterRessourceChampOuRelations(); |
} |
} |
} |
} |
public function traiterRessourceId() { |
//requete : /zone-geo/#id (ex : /zone-geo/7) |
if ($this->table_ressources[0]) { |
$this->requete_condition[] = ' codet = '.$this->getBdd()->proteger($this->table_ressources[0]); |
$this->format_reponse .= '/id'; |
} else { |
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->table_ressources[0]. |
' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r); |
} |
} |
public function traiterRessourceChampOuRelations() { |
if ($this->table_ressources[1] == 'relations') { |
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->table_ressources[1]. |
' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r); |
} else { |
$this->format_reponse .= '/champ'; |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function assemblerLaRequete() { |
//assemblage de la requete : |
$requete = ' SELECT '.$this->requete_champ. |
' FROM '.$this->table |
.$this->formerRequeteCondition() |
.$this->formerRequeteLimite(); |
return $requete; |
} |
//ajout d'une limite seulement pour les listes (pas plus de 100 resultats retournés pr les requetes |
// suivantes : /zone-geo et /zone-geo/#id/relations) |
public function formerRequeteLimite() { |
if ($this->format_reponse != 'zone-geo') { |
$this->requete_limite = ''; |
} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) { |
//cas ou la requete presente un navigation.depart supérieur au nb total de resultats. |
$this->limite_requete['depart'] = |
(($nb - $this->limite_requete['limite']) < 0) ? 0 : ($nb - $this->limite_requete['limite']); |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} else { |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} |
return $this->requete_limite; |
} |
public function formerRequeteCondition() { |
$condition = ''; |
if ($this->requete_condition != null) { |
$condition = ' WHERE '.implode(' AND ', $this->requete_condition); |
} |
return $condition; |
} |
public function recupererTotalResultat() { |
//on récupère le nombre total de résultats de la requete (ex : le nombre d'id contenu dans la liste /zone-geo) |
$requete = 'SELECT count(*) as nombre FROM ' |
.$this->table |
.$this->formerRequeteCondition(); |
$res = $this->getBdd()->recuperer($requete); |
if ($res) { |
$total = $res['nombre']; |
} else { |
$t = 'Fonction recupererTotalResultat() : <br/>Données introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $t); |
} |
return $total; |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
// determine en fct du service appelé (/zone-geo | /zone-geo/#id | /zone-geo/#id/champ | |
// /zone-geo/#id/relations) le format du tableau à retourner. Encode en json |
public function retournerResultatFormate($resultat) { |
$this->recupererTableConfig('correspondance_champs'); |
switch ($this->format_reponse) { |
case 'zone-geo' : $reponse = $this->formaterZoneGeo($resultat); break; |
case 'zone-geo/id' : $reponse = $this->formaterZoneGeoId($resultat[0]); break; |
case 'zone-geo/id/champ' : $reponse = $this->formaterZoneGeoIdChamp($resultat[0]); break; |
default : break; |
} |
return $reponse; |
} |
public function formaterZoneGeo($resultat) { |
//on remplit la table $table_retour_json['entete'] |
$this->table_retour['depart'] = $this->limite_requete['depart']; |
$this->table_retour['limite'] = $this->limite_requete['limite']; |
$this->table_retour['total'] = $this->total_resultat; |
$url = $this->formulerUrl($this->total_resultat, '/zone-geo'); |
if ($url['precedent'] != '') { $this->table_retour['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $this->table_retour['href.suivant'] = $url['suivant']; } |
$table_retour_json['entete'] = $this->table_retour; |
//on remplit la table $table_retour_json['resultat'] |
$this->table_retour = array(); |
if (isset($this->table_param['masque_nom'])) $resultat = $this->trierRechercheFloue($this->table_param['masque_nom'], $resultat, 'nom_francais'); |
foreach ($resultat as $tab) { |
foreach ($tab as $key => $valeur) { |
$valeur = rtrim($valeur); |
if ($valeur != '') { |
switch ($key) { |
case 'codet' : $num = $valeur; $this->table_retour['code'] = $valeur; break; |
case 'nom_francais' : $this->table_retour['nom'] = $valeur; break; |
case 'nom_anglais' : if ($tab['nom_francais'] == '') $this->table_retour['nom'] = $valeur; break; |
case 'codet_statut' : $this->table_retour['statut'] = $valeur; break; |
default : break; |
} |
} |
} |
if ($this->retour_format == 'max') { |
$this->table_retour['href'] = $this->ajouterHref('zone-geo', $num); |
} |
$resultat_json[$num] = $this->table_retour; |
$this->table_retour = array(); |
} |
$table_retour_json['resultat'] = $resultat_json; |
return $table_retour_json; |
} |
public function formaterZoneGeoId($resultat) { |
foreach ($resultat as $key => $valeur) { |
if ($valeur != '') { |
$this->afficherDonnees($key, $valeur); |
} |
} |
unset($this->table_retour['href']); |
return $this->table_retour; |
} |
public function formaterZoneGeoIdChamp($resultat) { |
//on recupère tous les resultats possibles |
$reponse = $this->formaterZoneGeoId($resultat); |
$this->table_retour = array(); |
//on recupère les résultats demandés à partir du tableau de résultat complet |
$this->table_retour['id'] = $reponse['code']; |
$champs = explode(' ', $this->table_ressources[1]); |
foreach ($champs as $champ) { |
if ($champ == 'nom') $champ = 'nom.fr'; |
if ($this->verifierValiditeChamp($champ)) { |
if (strrpos($champ, '.*') !== false) { |
$this->afficherPointEtoile($champ, $reponse); |
} else { |
if (isset($reponse[$champ])) { |
$this->table_retour[$champ] = $reponse[$champ]; |
} else { |
$this->table_retour[$champ] = null; |
} |
} |
} |
} |
return $this->table_retour; |
} |
public function verifierValiditeChamp($champ) { |
preg_match('/^([^.]+)(\.([^.]+))?$/', $champ, $match); |
$champs_possibles = $this->correspondance_champs; |
$champs_possibles[] = 'nom.*'; |
if (in_array($match[1], $champs_possibles)) { |
$validite = true; |
} elseif (in_array($match[0], $champs_possibles)) { |
$validite = true; |
} else { |
$champs_possibles = implode('</li><li>', $champs_possibles); |
$c = 'Erreur dans votre requête : </br> Le champ "'.$champ_possibles.'" n\'existe pas. '. |
'Les champs disponibles sont : <li>'.$champs_possibles.'</li>'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $c); |
} |
return $validite; |
} |
public function afficherPointEtoile($champ, $reponse) { |
preg_match('/^([^.]+\.)\*$/', $champ, $match); |
foreach ($reponse as $chp => $valeur) { |
if (strrpos($chp, $match[1]) !== false) { |
if ($valeur != '') { |
$this->table_retour[$chp] = $valeur; |
} else { |
$this->table_retour[$chp] = null; |
} |
} |
} |
} |
public function afficherDonnees($champ, $valeur) { |
if ($this->retour_format == 'max') { |
if ($champ == 'codet_statut') { |
$this->table_retour[$this->correspondance_champs[$champ]] = $valeur; |
$this->table_retour[$this->correspondance_champs[$champ].'.href'] = |
$this->ajouterHref('ontologies', 'masque.nom=Codet '.$valeur, '?'); |
} else { |
$this->table_retour[$this->correspondance_champs[$champ]] = $valeur; |
} |
} else { |
$this->table_retour[$this->correspondance_champs[$champ]] = $valeur; |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
/** Permet de retourner l'url http://tela-botanica.org/service:eflore:0.1/[projet]/[version_projet]/[service]/[ressource]:[valeur] |
* @param $service : correspond au nom de la ressource à laquelle on souhaite acceder |
* @param $val : correspond au paramètre de la ressource (ex : |
* @param $projet : est remplit dans les cas suivants : |
* - si le projet dans lequel se trouve l'information est différent de celui du service appelé |
* - si on souhaite rappeler le meme projet avec la meme ressource mais un parametre de ressource différent |
*/ |
public function ajouterHref($service, $val, $separation = '/') { |
$val = $this->encoderUrl($val); |
if ($this->version_projet == '+') { |
$url = Config::get('url_service_base').Config::get('nom_projet').'/'.$service.$separation.$val; |
} else { |
$url = Config::get('url_service_base').Config::get('nom_projet').'/'.$this->version_projet.'/'.$service.$separation.$val; |
} |
return $url; |
} |
public function encoderUrl($url) { |
$url = str_replace(' ', '%20', $url); |
$url = str_replace('?', urlencode('?'), $url); |
return $url; |
} |
} |
?> |
/trunk/services/modules/0.1/iso-639-1/Langues.php |
---|
New file |
0,0 → 1,357 |
<?php |
/** |
* Description : |
* Classe Langues.php fournit des informations sur ensemble structuré des termes et concepts représentant les éléments |
* d'un domaine de connaissances . |
* Le but étant de fournir un ensemble minimal d'information comprenant : |
* un identifiant (numérique ou alphanumérique sous forme de ChatMot si possible), un nom, une region et |
* éventuellement une relation hiérarchique avec un autre terme (=classe). |
* Si l'url finit par /langues on retourne une liste de termes (seulement les 100 premières par défaut). |
* L'url peut contenir des paramètres optionnels passés après le ? : /observations?param1=val1¶m2=val2&... |
* |
* Les paramètres de requête disponibles sont : masque, masque.code, masque.nom, masque.region , recherche, |
* distinct, retour.format, navigation.depart et navigation.limite. |
* |
* Encodage en entrée : utf8 |
* Encodage en sortie : utf8 |
* @package framework-v3 |
* @author Delphine Cauquil <delphine@tela-botanica.org> |
* @author Jennifer Dhé <jennifer.dhe@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> |
* @version 1.0 |
* @copyright 1999-${year} Tela Botanica (accueil@tela-botanica.org) |
*/ |
class Langues extends Commun { |
protected $service = 'langues'; |
/** |
* Permet de stocker la requete formulée : /langues | /langues/#id | /langues/#id/champ | /langues/#id/relations |
* Est remplit au cours de l'analyse des ressources (traiterRessources()), par défaut, a la valeur du service. |
* Est utilisée principalement pr déterminer le format du tableau à retourner. */ |
protected $format_reponse = 'langues'; |
/** Variables constituant les parametres de la requete SQL (champ, condition, group by, limit) remplie |
* selon ressources et paramètres */ |
protected $requete_champ = ' * '; |
protected $requete_condition = ''; |
protected $limite_requete = array( |
'depart' => 0, |
'limite' => 100 |
); |
/** Stockage des ressources et paramétres */ |
protected $table_ressources = array(); |
protected $table_param = array(); |
/** |
* Precise la contenance plus ou moins précise du tableau à retourner : |
* - min = les données présentes dans la table |
* - max = les données de la table + les informations complémentaires (pour les identifiants et les codes) |
* - oss = la liste des nom_sci (uniquement pour noms et taxons) |
*/ |
protected $retour_format = 'max'; |
protected $retour_langue = 'fr'; |
/** Valeur du paramètre de requete recherche : |
* - stricte : le masque est passé tel quel à l'opérateur LIKE. |
* - etendue : ajout automatique du signe % à la place des espaces et en fin de masque avec utilisation de LIKE. |
* - floue : recherche tolérante vis-à-vis d'approximations ou d'erreurs (fautes d'orthographe par exemple) */ |
protected $recherche; |
/** Permet de stocker le tableau de résultat (non encodé en json) */ |
protected $table_retour = array(); |
/** Stocke le nombre total de résultats de la requete principale. Est calculée lors de l'assemblage de la requete */ |
protected $total_resultat; |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function traiterParametres($parametres) { |
if (isset($parametres) && !empty($parametres)) { |
$this->table_param = $parametres; |
// masque : filtre la liste en fonction d'un masque de recherche portant sur le code, le nom ou la region. |
// masque.code : filtre uniquement sur le code. masque.nom : filtre uniquement sur le nom. |
// masque.region : filtre uniquement sur la region. |
if (isset($parametres['recherche']) && $parametres['recherche'] != '') { |
$this->recherche = $parametres['recherche']; |
} |
foreach ($parametres as $param => $valeur) { |
switch ($param) { |
case 'masque' : $this->ajouterLeFiltreMasque('masque', $valeur); break; |
case 'masque_code' : $this->ajouterLeFiltreMasque('id', $valeur); break; |
case 'masque_nom' : $this->ajouterLeFiltreMasque('nom', $valeur); break; |
case 'retour_langue' : $this->retour_langue = $valeur; break; |
case 'retour_format' : $this->retour_format = $valeur; break; |
case 'navigation_depart' : $this->limite_requete['depart'] = $valeur; break; |
case 'navigation_limite' : $this->limite_requete['limite'] = $valeur; break; |
case 'recherche' : break; |
default : $p = 'Erreur dans les paramètres de recherche de votre requête : '. |
'</br> Le paramètre " '.$param.' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $p); break; |
} |
} |
} |
} |
public function ajouterLeFiltreMasque($nom_champ, $valeur) { |
if ($nom_champ == 'id') { |
$this->requete_condition[] = $nom_champ.' = '.$this->getBdd()->proteger($valeur); |
} else { |
if ($this->recherche == 'floue') { |
if ($nom_champ == 'masque') { |
$this->requete_condition[] = '( id = '.$this->getBdd()->proteger($valeur) |
.' OR ( SOUNDEX(nom) = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE(nom)) = SOUNDEX(REVERSE(\''.$valeur.'\')) ' |
.')) '; |
} else { |
$this->requete_condition[] = '(SOUNDEX('.$nom_champ.') = SOUNDEX(\''.$valeur.'\')' |
.' OR SOUNDEX(REVERSE('.$nom_champ.')) = SOUNDEX(REVERSE(\''.$valeur.'\'))) '; |
} |
} else { |
if ($this->recherche == 'etendue') { |
$valeur = str_replace(' ','%', $valeur); |
$valeur .= '%'; |
} |
if ($nom_champ == 'masque') { |
$this->requete_condition[] = '(dep = '.$this->getBdd()->proteger($valeur) |
.' OR nccenr LIKE '.$this->getBdd()->proteger($valeur) |
.' OR region = '.$this->getBdd()->proteger($valeur).')'; |
} else { |
$this->requete_condition[] = $nom_champ.' LIKE '.$this->getBdd()->proteger($valeur); |
} |
} |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function traiterRessources(&$ressources) { |
if (isset($ressources) && !empty($ressources)) { |
$this->table_ressources = $ressources; |
if (isset($this->table_ressources[0]) && !empty($this->table_ressources[0])) { |
//requete = /langues/#id |
$this->traiterRessourceId(); |
if (isset($this->table_ressources[1]) && !empty($this->table_ressources[1])) { |
//requete = /langues/#id/#champ ou /langues/#id/relations |
$this->traiterRessourceChampOuRelations(); |
} |
} |
} |
} |
public function traiterRessourceId() { |
//requete : /langues/#id (ex : /langues/7) |
if (preg_match('/^[a-z]{2}$/', $this->table_ressources[0])) { |
$this->requete_condition[] = ' id = '.$this->getBdd()->proteger($this->table_ressources[0]); |
$this->format_reponse .= '/id'; |
} else { |
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->table_ressources[0]. |
' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r); |
} |
} |
public function traiterRessourceChampOuRelations() { |
//requete = /langues/#id/relations : |
if ($this->table_ressources[1] == 'relations') { |
$r = 'Erreur dans les ressources de votre requête : </br> La ressource " '.$this->table_ressources[1]. |
' " n\'existe pas.'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $r); |
//requete = /langues/#id/#champ : |
} else { |
$this->format_reponse .= '/champ'; |
} |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
public function assemblerLaRequete() { |
$requete = ' SELECT '.$this->requete_champ. |
' FROM '.$this->table |
.$this->formerRequeteCondition() |
.$this->formerRequeteLimite(); |
return $requete; |
} |
public function formerRequeteCondition() { |
$condition = ''; |
if ($this->requete_condition != null) { |
$condition = ' WHERE '.implode(' AND ', $this->requete_condition); |
} |
return $condition; |
} |
//ajout d'une limite seulement pour les listes (pas plus de 100 resultats retournés pr les requetes |
// suivantes : /langues et /langues/#id/relations) |
public function formerRequeteLimite() { |
if (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) { |
//cas ou la requete presente un navigation.depart supérieur au nb total de resultats. |
$this->limite_requete['depart'] = |
(($nb - $this->limite_requete['limite']) < 0) ? 0 : ($nb - $this->limite_requete['limite']); |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} else { |
$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite']; |
} |
return $this->requete_limite; |
} |
public function recupererTotalResultat() { |
//on récupère le nombre total de résultats de la requete (ex : le nombre d'id contenu dans la liste /langues) |
$requete = 'SELECT count(*) as nombre FROM ' |
.$this->table |
.$this->formerRequeteCondition(); |
$res = $this->getBdd()->recuperer($requete); |
if ($res) { |
$total = $res['nombre']; |
} else { |
$t = 'Fonction recupererTotalResultat() : <br/>Données introuvables dans la base'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $t); |
} |
return $total; |
} |
// +-------------------------------------------------------------------------------------------------------------------+ |
// determine en fct du service appelé (/langues | /langues/#id | /langues/#id/champ | |
// /langues/#id/relations) le format du tableau à retourner. Encode en json |
public function retournerResultatFormate($resultat) { |
$this->recupererTableConfig('correspondance_champs'); |
switch ($this->format_reponse) { |
case 'langues' : $reponse = $this->formaterLangues($resultat); break; |
case 'langues/id' : $reponse = $this->formaterLanguesId($resultat[0]); break; |
case 'langues/id/champ' : $reponse = $this->formaterLanguesIdChamp($resultat[0]); break; |
default : break; |
} |
return $reponse; |
} |
public function formaterLangues($resultat) { |
//on remplit la table $table_retour_json['entete'] |
$this->table_retour['depart'] = $this->limite_requete['depart']; |
$this->table_retour['limite'] = $this->limite_requete['limite']; |
$this->table_retour['total'] = $this->total_resultat; |
//formuler les urls precedentes et suivantes affichées dans l'entete du resultat |
$url = $this->formulerUrl($this->total_resultat, '/langues'); |
if ($url['precedent'] != '') { $this->table_retour['href.precedent'] = $url['precedent']; } |
if ($url['suivant'] != '') { $this->table_retour['href.suivant'] = $url['suivant']; } |
$table_retour_json['entete'] = $this->table_retour; |
$this->table_retour = array(); |
if ($this->retour_langue == 'fr') {$nom = 'nom'; } else {$nom = 'nom_'.$this->retour_langue;} |
if (isset($this->table_param['masque_nom'])) $resultat = $this->trierRechercheFloue($this->table_param['masque_nom'], $resultat, $nom); |
//on remplit la table $table_retour_json['resultat'] |
foreach ($resultat as $tab) { |
foreach ($tab as $key => $valeur) { |
if ($valeur != '') { |
if ($key == $id) { |
$num = $valeur; $this->table_retour['code'] = $valeur; break; |
} elseif ($key == 'nom_'.$this->retour_langue || ($this->retour_langue == 'fr' && $key == 'nom')) { |
$this->table_retour['nom'] = $valeur; break; |
} else { |
switch ($key) { |
case 'id' : $num = $valeur; $this->table_retour['code'] = $valeur; break; |
case 'nom' : $this->table_retour['nom'] = $valeur; break; |
default : break; |
} |
} |
} |
} |
if ($this->retour_format == 'max') { |
$this->table_retour['href'] = $this->ajouterHref('langues', $num); |
} |
$resultat_json[$num] = $this->table_retour; |
$this->table_retour = array(); |
} |
$table_retour_json['resultat'] = $resultat_json; |
return $table_retour_json; |
} |
public function formaterLanguesId($resultat) { |
foreach ($resultat as $key => $valeur) { |
if ($valeur != '') { |
$this->afficherDonnees($key, $valeur); |
} |
} |
unset($this->table_retour['href']); |
return $this->table_retour; |
} |
public function formaterLanguesIdChamp($resultat) { |
//on recupère tous les resultats possibles |
$reponse = $this->formaterLanguesId($resultat); |
$this->table_retour = array(); |
//on recupère les résultats demandés à partir du tableau de résultat complet |
$this->table_retour['id'] = $reponse['code']; |
$champs = explode(' ', $this->table_ressources[1]); |
foreach ($champs as $champ) { |
if ($champ == 'nom') $champ = 'nom.fr'; |
if ($this->verifierValiditeChamp($champ)) { |
if (strrpos($champ, '.*') !== false) { |
$this->afficherPointEtoile($champ, $reponse); |
} else { |
if (isset($reponse[$champ])) { |
$this->table_retour[$champ] = $reponse[$champ]; |
} else { |
$this->table_retour[$champ] = null; |
} |
} |
} |
} |
return $this->table_retour; |
} |
public function verifierValiditeChamp($champ) { |
preg_match('/^([^.]+)(:?\.([^.]+))?$/', $champ, $match); |
$champs_possibles = $this->correspondance_champs; |
$champs_possibles[] = 'nom'; |
$champs_possibles[] = 'iso-639-2'; |
$champs_possibles[] = 'iso-639-3'; |
if (in_array($match[1], $champs_possibles)) { |
$validite = true; |
} elseif (in_array($match[0], $champs_possibles)) { |
$validite = true; |
} else { |
$champs_possibles = implode('</li><li>', $champs_possibles); |
$c = 'Erreur dans votre requête : </br> Le champ "'.$champ_possibles.'" n\'existe pas. '. |
'Les champs disponibles sont : <li>'.$champs_possibles.'</li>'; |
$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $c); |
} |
return $validite; |
} |
public function afficherPointEtoile($champ, $reponse) { |
preg_match('/^([^.]+\.)\*$/', $champ, $match); |
foreach ($reponse as $chp => $valeur) { |
if (strrpos($chp, $match[1]) !== false) { |
if ($valeur != '') { |
$this->table_retour[$chp] = $valeur; |
} else { |
$this->table_retour[$chp] = null; |
} |
} |
} |
} |
public function afficherDonnees($champ, $valeur) { |
if ($this->retour_format == 'max') { |
if (strpos($champ, 'iso_639_') !== false) { |
$projet = substr(str_replace('_', '-', $champ),5); |
$this->table_retour[$projet.'.code'] = $valeur; |
$this->table_retour[$projet.'.href'] = $this->ajouterHrefAutreProjet('langues', '', $valeur, $projet); |
} else { |
$this->table_retour[$this->correspondance_champs[$champ]] = $valeur; |
} |
} else { |
$this->table_retour[$this->correspondance_champs[$champ]] = $valeur; |
} |
} |
} |
?> |