JDONREFv4 introduction : Différence entre versions
(→API & spécifications) |
(→JDONREFv4) |
||
| (7 révisions intermédiaires par le même utilisateur non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
| − | === |
+ | === JDONREFv4 : Introduction === |
| − | NB : La documentation décrite dans ce wiki est en cours de rédaction, et |
+ | NB : La documentation décrite dans ce wiki est en cours de rédaction, et l'ensemble des services décrit n'est pas encore implémenté. |
| − | JDONREFv3ES est le service de JDONREF qui permet d'utiliser un backend ElasticSearch tout en conservant les signatures de méthode actuelles de JDONREF en SOAP. |
||
| + | == JDONREFv4v3 == |
||
| − | JDONREFv3REST est le service de JDONREF qui permet de l'utiliser sous la forme d'appels suivant la philosophie REST. |
||
| + | [[JDONREFv4v3]] est un simple proxy d'ElasticSearch qui peut être utilisé avec JDONREFv3. Il permet ainsi à un système d'information dans lequel l'usage de JDONREFv3 est répandu de profiter des fonctionnalités apportées par JDONREFv4. |
||
| − | |||
| − | Il est bien sûr possible d'utiliser JDONREFv3REST avec JDONREFv3ES. |
||
| − | |||
| − | == API & spécifications == |
||
| − | |||
| − | [[JDONREFv3ES_Specifications|Spécifications de JDONREFv3ES]] |
||
| − | |||
| − | [[JDONREFv3REST_API|JDONREFv3REST API]] |
||
| − | |||
| − | [[JDONREFv3ES_Types|Types Elastic Search]] |
||
| − | |||
| − | == Philosophie de JDONREFv3REST == |
||
| − | |||
| − | La philosophie suivie pour l'implémentation de JDONREFv3REST est d'être compatible avec l'API REST de ElasticSearch. Il s'agit plus précisément d'un sous-ensemble de l'API REST d'ElasticSearch. |
||
| − | Ainsi, une application développée pour utiliser JDONREFv3REST pourrait aussi fonctionner en utilisant ElasticSearch. |
||
| − | |||
| − | Par exemple, l'API Search d'Elastic search ([http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-uri-request.html]) propose de rechercher une adresse d'un index jdonref de cette manière : |
||
| − | |||
| − | curl -XGET 'http://localhost:9200/jdonref/adresse/_search?q=hopital' |
||
| − | |||
| − | C'est exactement cette syntaxe qui sera reprise dans JDONREFv3Rest pour la validation d'adresse. |
||
| − | L'API sera simplement étendue aux fonctions actuellement non présentes dans ElasticSearch. |
||
| − | |||
| − | == Philosophie de JDONREFv3ES == |
||
| + | A noter qu'à l'heure actuelle la couverture fonctionnelle complète de JDONREFv3 n'est pas assurée par JDONREFv4. |
||
Le périmètre de JDONREF est actuellement plus étendu que celui de ElasticSearch car il est spécialisé dans le traitement d'adresses. Il s'agit des fonctions : |
Le périmètre de JDONREF est actuellement plus étendu que celui de ElasticSearch car il est spécialisé dans le traitement d'adresses. Il s'agit des fonctions : |
||
* de normalisation ; |
* de normalisation ; |
||
| Ligne 37 : | Ligne 14 : | ||
* de géocodage (ElasticSearch proposant l'indexation géographique, mais pas le calcul de l'interpolation du tronçon) ; |
* de géocodage (ElasticSearch proposant l'indexation géographique, mais pas le calcul de l'interpolation du tronçon) ; |
||
| − | + | JDONREFv4v3 s'appuie donc sur les traitements existants de JDONREF pour ces 4 fonctions, mais utilise les fonctionnalités de ElasticSearch pour la validation et le géocodage inverse de centroïde d'adresse. |
|
| + | |||
| + | == JDONREFv4 == |
||
| + | |||
| + | Le [[JDONREFv4_Plugin|plugin JDONREFv4 pour ElasticSearch]] permet une indexation efficace des adresses permettant de les rechercher avec une pertinence accrue. |
||
| + | Il passe par la définition de [[JDONREFv4_Mappings|index]] spécifiques, et une [[JDONREFv4_Query|requête]]. |
||
Version actuelle en date du 26 février 2016 à 23:20
JDONREFv4 : Introduction
NB : La documentation décrite dans ce wiki est en cours de rédaction, et l'ensemble des services décrit n'est pas encore implémenté.
JDONREFv4v3
JDONREFv4v3 est un simple proxy d'ElasticSearch qui peut être utilisé avec JDONREFv3. Il permet ainsi à un système d'information dans lequel l'usage de JDONREFv3 est répandu de profiter des fonctionnalités apportées par JDONREFv4.
A noter qu'à l'heure actuelle la couverture fonctionnelle complète de JDONREFv3 n'est pas assurée par JDONREFv4. Le périmètre de JDONREF est actuellement plus étendu que celui de ElasticSearch car il est spécialisé dans le traitement d'adresses. Il s'agit des fonctions :
- de normalisation ;
- de restructuration ;
- de découpage ;
- de géocodage (ElasticSearch proposant l'indexation géographique, mais pas le calcul de l'interpolation du tronçon) ;
JDONREFv4v3 s'appuie donc sur les traitements existants de JDONREF pour ces 4 fonctions, mais utilise les fonctionnalités de ElasticSearch pour la validation et le géocodage inverse de centroïde d'adresse.
JDONREFv4
Le plugin JDONREFv4 pour ElasticSearch permet une indexation efficace des adresses permettant de les rechercher avec une pertinence accrue. Il passe par la définition de index spécifiques, et une requête.
