Introduction
Je ne m'attarderai donc pas sur les détails concernant la créations des services web RESTfull, ce qui constituerai d'ailleurs un autre tutoriel à part.
Mais pour faciliter la compréhension, je vais utiliser une des techniques les plus simples (peut-être même la plus simple) pour générer du JSON à partir des données contenues dans une base de données Mysql.Cette technique pédagogique utilise le PHP et particulièrement la fonction JsonEncode qui permet de façon on ne peut plus simple de générer du JSON à partir du résultat d'une requête SQL.
Si vous souhaitez ensuite approfondir les notions de services web, n'hésitez pas à consulter la documentation spécialisée, je vous le recommande vivement.
Mais si vous avez déjà cette connaissance et vous souhaitez juste savoir comment consommer du JSON sous Android, ce tutoriel est fait pour vous aussi.
Dans cette première partie nous allons créer notre partie serveur avec Php et Mysql.
Personnellement je ne suis pas développeur PHP, mais j'ai été touché un jour par sa souplesse et sa simplicité que j'en suis devenu fan, surtout lorsqu'il s'agit d'illustrer certains concepts sans trop perdre les apprentis dans des spécifications trop rigides telles qu'existantes dans le java entreprise par exemple.
Nous allons faire simple, et ça devrait marcher; ensuite vous pourriez approfondir sans craintes ces notions.
Nous allons utiliser une petite application pour illustrer, il s'agit d'une petite bibliothèque en ligne : bookdroid.
Cette application aura donc 3 couches ( on dit aussi trois tiers) :
1. La couche base de données : se résumant en notre bd Mysql nommée "bookdroid" et n'ayant qu'une seule table: la table "livre".
2.La couche service : écrite en PHP , elle va se résumer en un script qui lit la liste de livres depuis la BD et nous l'encode en JSON.
La couche 1 et 2 constituent la couche serveur de notre application.
3.La couche client mobile : C'est notre application mobile qui sera chargée de recuperer la liste de livres encodée en JSON, la "parser" et enfin de l'afficher dans une ListView.
1. La couche base de données : se résumant en notre bd Mysql nommée "bookdroid" et n'ayant qu'une seule table: la table "livre".
2.La couche service : écrite en PHP , elle va se résumer en un script qui lit la liste de livres depuis la BD et nous l'encode en JSON.
La couche 1 et 2 constituent la couche serveur de notre application.
3.La couche client mobile : C'est notre application mobile qui sera chargée de recuperer la liste de livres encodée en JSON, la "parser" et enfin de l'afficher dans une ListView.
1. La base de données bookdroid.
Elle se résume tout simplement à notre petite table livre au sein de la base "bookdroid".
CREATE TABLE IF NOT EXISTS `livre` ( `idLivre` int(11) NOT NULL AUTO_INCREMENT, `titreLivre` varchar(50) NOT NULL, `auteurLivre` varchar(50) NOT NULL, PRIMARY KEY (`idLivre`) )
2. Le service booklist
Le but de cette partie est de générer du contenu JSON à partir de la connexion à notre base des données.
Allons-y étape par étape :
- Créez un répertoire au sein de votre serveur web ( pour XAMP sur windows 7, par exemple, il s'agit du dossier C:\xampp\htdocs ) appelé "bookdroid";Il s'agit de notre application web qui aura de fait comme URL: http://localhost/bookdroid/
- Dans ce dossier, ajoutez les fichiers bd.php, jsonEncoder.php et booklist.php
- bd.php s’occupe uniquement de la connexion à la base des données :
- jsonEncoder.php contient la fonction qui encordera nos données sous format JSON.
- booklist.php retourne la liste de livres sous format JSON :
Ensuite, ouvrez votre navigateur et tapez ce lien : http://localhost/bookdroid/booklist.php; le resultat est sensé être sous cette forme :
Allons-y étape par étape :
- Créez un répertoire au sein de votre serveur web ( pour XAMP sur windows 7, par exemple, il s'agit du dossier C:\xampp\htdocs ) appelé "bookdroid";Il s'agit de notre application web qui aura de fait comme URL: http://localhost/bookdroid/
- Dans ce dossier, ajoutez les fichiers bd.php, jsonEncoder.php et booklist.php
- bd.php s’occupe uniquement de la connexion à la base des données :
$BD_serveur = "localhost";
$BD_utilisateur = "root";
$BD_motDePasse = "";
$BD_base = "bookdroid";
@mysql_pconnect($BD_serveur, $BD_utilisateur, $BD_motDePasse)
or die("Server Error : Access refusé");
@mysql_select_db($BD_base)
or die("Server Error : DB Select:". mysql_error());
- jsonEncoder.php contient la fonction qui encordera nos données sous format JSON.
include ('bd.php');
function to_json($query) {
$res=mysql_query($query);
$result = array();
while($row = mysql_fetch_assoc($res)){
$result[] =array_map('utf8_encode', $row);
}
return json_encode($result);
}
- booklist.php retourne la liste de livres sous format JSON :
require 'jsonEncoder.php'; $sql="SELECT * FROM livre"; echo to_json($sql);Comme je l'ai dit, c'est très simple ! Afin de tester que tout marche bien avant de passer à la deuxième partie de ce tutoriel, insérons quelques données dans la table livre.
INSERT INTO `bookdroid`.`livre` ( `idLivre` , `titreLivre` , `auteurLivre` ) VALUES ( NULL , 'Techniques de hacking', 'John Ericson' ), ( NULL , 'Le Livre d''Android 4 pour smartphones', 'Henri Lilien'
Ensuite, ouvrez votre navigateur et tapez ce lien : http://localhost/bookdroid/booklist.php; le resultat est sensé être sous cette forme :
[{"idLivre":"1","titreLivre":"Techniques de hacking","auteurLivre":"John Ericson"},{"idLivre":"2","titreLivre":"Le Livre d'Android 4 pour smartphones","auteurLivre":"Henri Lilien"},{"idLivre":"3","titreLivre":"Techniques de hacking","auteurLivre":"John Ericson"},{"idLivre":"4","titreLivre":"Le Livre d'Android 4 pour smartphones","auteurLivre":"Henri Lilien"}]
C'est le résultat attendu: notre liste de livres encodée dans le format JSON.
La suite de tutoriel sera consacré à la partie mobile Android, nous verrons comment parser ce JSON et l'afficher dans une ListView.
