Document Introduction au PHP

Table des matières

De nombreux débutants ne savent pas comment faire communiquer une base de données distante MySQL avec une application cliente du type Android. Ce tutoriel tente de répondre à cette question où la réponse est bien loin d’être simple. Des réponses à des questions transverses sont nécessairesetc’estfaciledetomberdanscertainspiègesquandonnedisposepasdel’expérience requise dans le domaine.

L’expérience requise, parlons-en! Ce tutoriel se veut accessible aux plus débutants mais se concentre en grande partie sur le développement Android et légèrement sur le développement serveur. D’ailleurs, il n’est pas conseillé d’adopter les exemples de la partie serveur de ce tutoriel dans un environnement de production pour des raisons de maintenance et de qualité de code. Cette partie serveur tente simplement de vous expliquer les grandes lignes de son fonctionnement et donne un exemple fonctionnel. Les bonnes pratiques sont mentionnées et expliquées, mais elles ne sont pas enseignées. Cet enseignement demanderait un cours entier sur le sujet où d’autres ressources sur Internet les expliqueront bien mieux.

Les connaissances indispensables sont les suivantes :

— Savoir créer un projet Android et l’exécuter : ressource écrite ou .

— Savoir créer une base de données MySQL : ressource écrite.

— Savoir exécuter du code PHP : ressource écrite pour les utilisateurs Windows ou ressource écrite pour tous les utilisateurs.

Les connaissances optionnelles sont les suivantes :

— Avoir une connaissance basique des communications entre un serveur et des clients.

— Savoir faire des requêtes HTTP depuis une application Android.

— Lier un serveur applicatif en PHP avec une base de données MySQL.

Ces dernières connaissances sont optionnelles parce qu’elles seront expliquées dans ce tutoriel pourquevousnesoyezpasperdu.Sivousnedisposezpasdecesconnaissances,aucuninquiétude à avoir. Vous pourrez quand même suivre ce tutoriel et disposez des même connaissances qu’un autre lecteur disposant de ces connaissances.

Surce,neperdonsplusdetempsetlançonsnousdanscettecommunicationentreuneapplication Android et un serveur applicatif PHP/MySQL!

Unearchitectureclient/serveurestunmodedecommunicationunpeuobscurpourlesdébutants, à juste titre. En effet, à partir du moment où vos applications ont besoin d’un serveur, elles commencent à prendre de l’importance. Il faut y centraliser les données pour permettre à d’autres clients de les récupérer. Ce genre d’architecture est maintenant de plus en plus courante et donc, de plus en plus rare de fonctionner uniquement avec des bases de données locales.

Leprincipalobjectifd’unserveurestlacentralisationdesdonnéesetpermettreàplusieursclients de les récupérer et d’y contribuer. Plusieurs scénarios existent pour vous poser la question de sa nécessité :

— Développez-vous une application sur plusieurs plateformes (Android, iOS, Windows Phone, site web, etc.) avec les mêmes données? Par exemple, si l’objectif de l’application est la gestion d’une liste de tâches à faire (couramment appelée une todo list), il serait dommage de ne pas partager ces listes sur toutes les plateformes à travers les applications, mobiles ou non, que vous avez développées. Si une tâche est rajoutée sur l’application Android, elle doit être rajoutée sur le site web.

— Désirez-vous “ouvrir” certaines de vos données à des services tiers? C’est une pratique courante.Parexemple,laplateformeZestedeSavoirenregistrechaquejourdeplusenplus de données, la plupart sont des données publiques et/ou sous une licence libre. Zeste de Savoir a mit en place une API (expliquée plus loin dans ce cours) qui permet son utilisation dans des applications tierces n’ayant pas forcément un rapport avec Zeste de Savoir.

Il existe d’autant plus de scénarios quand l’on se trouve dans le cadre professionnel. Les entreprises ont des besoins et des contraintes hautement plus complexes avec des architectures précises. Elles sont souvent murement réfléchies par ses dirigeants et/ou ses employés.

Une API, ou Application Programming Interface, est, comme son nom l’indique, une interface d’un programme applicatif informatique. Elle permet d’offrir des services et des ressources sur base d’un système déjà existant. En fait, ces ressources sont des données exposées selon certaines conditions définies par vos soins. Vous restez maitre de vos données et appliquez la politique souhaitée pour définir les données publiques ou privées.

2 Pourquoi utiliser un serveur?

 Figure : Les services sur Internet sont accessibles par des inter-

faces quand vous utilisez votre ordinateur. Crédit : Eran Mendel, tukinon sur Flickr.

Cette pratique n’est pas obligatoire. Pour le projet illustrant ce tutoriel, il n’y aura pas d’utilisation d’une API, malheureusement, puisque nous resterons simple du côté serveur. Ce n’est pas l’objectif de notre cours mais c’est une pratique sur laquelle je vous encourage à vous renseigner. Sachez tout de même qu’il existe 2 grandes familles dans ce domaine :

— REST : Architecture orientée ressource, une API REST offre une interface simple et uniforme. Elle est particulièrement bien adaptée au web mais elle n’en est pas dépendante. Sa souplesse et sa mise en place rapide est une très grande force par rapport à son concurrent direct.

— SOAP : Permet la transmission de messages entre des objets distants. Il est alors possible à un objet d’appeler directement des méthodes sur un serveur. Cependant, il est bâti sur l’XML et moins sur le JSON, “nouveau” format de données particulièrement utilisé par REST.

Pour un débutant, le REST me semble tout indiqué et les ressources (française et anglaise) regorgent sur le sujet sur la Toile. Soyez curieux!

Les explications qui vont suivre sont largement simplifiées pour être accessibles aux débutants mais elles n’en restent pas moins véridiques et suffisantes pour la compréhension de ce qui va suivre dans ce tutoriel.

8

2.4 Le choix entre un serveur dédié ou une plateforme de conception

Figure : Fonctionnement d’une architecture client-serveur

Commevouspouvezleconstater,nosclients(lesordinateurs,lessmartphones,lestablettes,etc.) fontdesrequêtesHTTP(lesflèchespleines)versdesserveurenpassantparlaToile, requêtes n’ont rien de plus spécial qu’une requête HTTP que vous feriez à partir d’un navigateur web. Vous spécifiez une URL et vous vous attendez à recevoir une réponse (les flèches vides).

Unefoisquelarequêteestarrivéeàdestination,ilpassed’abordparl’API(cen’estpasobligatoire, mais soyons complets dans notre exemple). Cette API possède une procédure qui associera la forme de votre URL à une action à réaliser (gestion d’une ressource dans REST, opération métier dansSOAP).L’APIvaalorsl’exécuteretdialogueravecleserveurpourrécupérerlesdonné récupère le résultat et le formate dans un format de données comme l’XML, le JSON ou l’HTML.

Notre client reçoit alors la réponse à sa requête et peut la traiter comme bon lui semble. Si nous sommes sur un navigateur, nous obtiendrons une réponse HTML que nous pourrons afficher à l’écran (parce que nous avons spécifié dans la requête que nous désirons une réponse en HTML). Sinoussommessurdesappareilsmobiles,nouspourronsobteniruneréponseXMLouJSONpour pouvoir utiliser les données comme nous le désirons. Nous pourrions demander au serveur une réponse HTML mais cela ne serait pas forcément pertinent pour un client mobile.

Grâce à ce procédé, le serveur permet une totale abstraction de son langage, de son implémentation et n’oblige pas le client à utiliser un langage spécifique pour pouvoir dialoguer avec lui. Ce qui est le cas avec des technologies concurrentes du REST.

Ilexisteplusieurssolutionspourdéveloppersapropreapplicationserveur.Ilneserapasexpliqué comment installer et configurer un serveur. Cependant, nous verrons les composants d’un serveur qu’il faut obligatoirement installer pour posséder un serveur simple mais fonctionnel. Cela

2 Pourquoi utiliser un serveur?

grâce à différentes technologies possibles.

Toutes vos données sont contenues dans une base de données. Il existe plusieurs types de SGBD (Système de Gestion de Base de Données) et elles ont toutes leurs subtilités. Libre à vous de choisir celle que vous préférez. Vous pouvez donc utiliser SQLite, MySQL, PostgreSQL, Oracle, etc. Cependant, suivant ce que vous allez choisir pour développer votre application serveur, vous devez vous renseigner si le langage supporte le SGBD que vous avez choisi. Pour les plus connus, cela ne devrait pas poser problème mais pour les moins, il est toujours utile de vérifier.

2.4.2.1    PHP

Lesapplicationsserveurpeuventêtredéveloppéesdansdenombreuxlangages,ycomprispardes langages utilisés pour développer des sites web en temps normal comme le PHP. Dans le cadre de ce tutoriel, nous allons utiliser ce langage pour fournir une application serveur fonctionnelle rapidement et facilement compréhensible par les débutants.

LelangageabeaucoupévoluéetdesframeworkscommeSymfony2sontapparus.Aveceux,desarchitecturesplusévoluéesquisimplifientledéveloppementd’ plus d’information sur Symfony 2 et sur le développement de routes permettant de fournir une API donnant accès aux données, rendez-vous sur ce tutoriel.

2.4.2.2    Java

Lejavaestl’undeslangageslesplusutiliséspourledéveloppementd’applicationsserveurviades EJB (Entreprise JavaBeans). EJB est une architecture de composants logiciels côté serveur pour la plateforme de développement J2EE. Grâce à un serveur d’application comme JBoss, Glassfish et d’autres, il est possible de déployer des applications serveur définissant des routes pour accéder aux différentes ressources que vous désirez offrir.

Cependant,cessolutionssontplutôtlourdesetneconviennentpasauxpetitsprojets.C’estpourquoi ces différentes technologies sont très demandés en entreprise pour satisfaire leurs besoins en performance et en maintenance contrairement aux petits sites web amateurs.

2.4.2.3    Autres

Bien sûr, il existe beaucoup d’autres langages qui permettent de développer des applications serveur comme NodeJS, C#, Scala, Python, etc.

Vous n’êtes pas obligé de partir d’une feuille blanche. Il existe des solutions qui vous permettent de démarrer à partir d’un serveur pré-configuré où toute une série de services d’un serveur sont abstraits. Des outils sont mis à la disposition des développeurs pour une meilleure gestion et une maintenance.

10

2.4 Le choix entre un serveur dédié ou une plateforme de conception

L’un des plus connus est Google App Engine. Grâce à une simple application Web en Python, Java ou Go, vous pouvez confectionner rapidement un serveur que vous pourrez utiliser en développement ou en production. Il faut tout de même savoir que ce genre de solutions sont souvent payantes, Google App Engine n’échappe pas à cette règle.

Dansunsoucidesimplicité,leserveurapplicatifseradéveloppépardesscriptsPHP;c’est-à-dire que nous ne développerons pas avec un framework ou une solution toute faite pour faciliter le développement d’une API. Cela nécessiterait l’écriture d’un tutoriel à part entière. D’autres sont déjàrédigéssurlaplateformeZestedeSavoir.Cequiseraenseignéicin’estquelestrictminimum pour pouvoir être utilisable depuis une application mobile Android.

L’exempleestextrêmementsimple.Leplusimportantneconcernepaslesdonnéesnilamanière dont elles sont envoyées mais comment les récupérer et les traiter. C’est pourquoi nous allons limiter notre applicatif à une seule URL qui délivrera une liste de produits dans un format JSON (JSON étant un concept qui sera abordé plus loin dans ce tutoriel).

Nousdevonsinstallerquelquesoutilsetsavoirutiliserquelquesconceptshorsdudéveloppement

Android. Je n’expliquerais pas comment les installer ni comment les utiliser. Il existe d’autres tutoriels qui vous expliqueront comment faire bien mieux que moi. Je vous renvoie aux chapitres des tutoriels suivants :

— LechapitrePréparersonordinateurdututorielConcevezvotresitewebavecPHPetMySQL de pour installer votre serveur PHP.

— Le chapitre Présentation des bases de données du tutoriel Concevez votre site web avec PHP et MySQL de Mateo21 si vous voulez bien comprendre comment lier une application PHP à une base de données MySQL.

— Le chapitre phpMyAdmin du tutoriel Concevez votre site web avec PHP et MySQL de Mateo21 pour utiliser correctement le gestionnaire de bases de données de MySQL.

— Le chapitre Création d’une base de données du tutoriel Administrez vos bases de données avec MySQL de Taguan pour créer une base de données dans PhpMyAdmin.

— Le chapitre Création de tables du tutoriel Administrez vos bases de données avec MySQL de Taguan pour créer facilement une table dans votre base de données.

— LechapitreInsertiondedonnéesdututorielAdministrezvosbasesdedonnéesavecMySQL de pour insérer des valeurs dans votre table.

Ne prenez pas peur! Même si cela fait beaucoup de chapitres, d’une part, je suis certain que la plupart d’entre vous connaissent déjà toutes ces notions (même vaguement) et d’autre part, il n’estpasnécessaired’êtreunexpertdanscesdomaines.Uneconnaissancebasiqueestsuffisante pour ne pas être perdu dans la suite des explications de ce tutoriel.

Vous devriez avoir tous les outils et tous les concepts pour installer et configurer correctement votre serveur PHP. Pour pouvoir suivre sereinement et efficacement les exemples qui suivent, voici la spécification de l’unique table de notre base de données :

[[information]] | Libre à vous de choisir une spécification différente mais il faudra la répercuter dans le code de votre applicatif PHP et Android par la suite.

Pourvousfaciliterlavie,lesrequêtesSQLci-dessousvouspermettrontdecréerlatable“product” et d’insérer quelques données factices que nous allons récupérer dans notre application Android dans la prochaine section.

--

-- Structure de la table `product` --

CREATE TABLE IF NOT EXISTS `product` (

`ID` int(11) NOT NULL AUTO_INCREMENT,

`NAME` varchar(50) NOT NULL,

`TYPE` varchar(50) NOT NULL,

`PRICE` double NOT NULL, PRIMARY KEY (`ID`)

);

--

-- Contenu de la table `product` --

INSERT INTO `product` (`ID`, `NAME`, `TYPE`, `PRICE`) VALUES

(1, 'Apple', 'Fruit', 1.2),

(2, 'Pear', 'Fruit', 1.3),

(3, 'Banana', 'Fruit', 1.1),

(4, 'Mushroom', 'Vegetable', 2.7),

(5, 'Pepper', 'Vegetable', 3.6);

3.2 Qu’est-ce qu’une réponse en JSON?

Comme dit précédemment, notre serveur ne sera pas développé avec une API. À la place, l’URL exposée pointera vers un script PHP qui se chargera d’effectuer la requête SQL adéquate pour récupérer les produits en base de données et de les renvoyer dans le format JSON.

Si vous ne connaissez pas le JSON, c’est une bonne occasion d’en savoir un peu plus. Si vous êtes déjà un développeur Android, vous connaissez bien l’XML puisqu’il s’agit du langage de balisage utilisé pour la confection des interfaces mais le JSON est différent dans sa syntaxe et dans sa philosophie.

VoiciunecourtedéfinitionquevousretrouvezsurlesiteofficieldeJSON(dontilexisteuneversion ) :

JSON (JavaScript Object Notation – Notation Objet issue de JavaScript) est un format légerd’échangededonnées.Ilestfacileàlireouàécrirepourdeshumains.Ilestaisémentanalysableougénérablepardesmachines.Ilestbasésurunsous-ensembledu langage de programmation JavaScript (JavaScript Programming Language, Standard ECMA-262 3rd Edition - December 1999). JSON est un format texte complètement indépendant de tout langage, mais les conventions qu’il utilise seront familières à tout programmeur habitué aux langages descendant du C, comme par exemple : C lui-même, C++, C#, Java, JavaScript, Perl, Python et bien d’autres. Ces propriétés font de JSON un langage d’échange de données idéal. Source :

Comme la définition le mentionne, le principal avantage de ce format texte est sa totale indépendance du langage. C’est pourquoi, même si notre application serveur est développée en PHP, nous pouvons sans problème développer nos clients dans un autre langage (dans notre cas, en Java puisque nous développons sur Android). Ce n’est pas le seul avantage de ce format. Nous pouvons en citer d’autres depuis cet extrait :

— Sa simplicité dans sa mise en oeuvre. Aujourd’hui, tous les langages supportent ce format et proposent des solutions pour construire et l’utiliser.

— Sa lisibilité aussi bien par les humains que par les machines puisque le langage est peu verbeux.

— Sa syntaxe est réduite et non extensible ce qui le rend facile à apprendre pour l’humain.

Les structures d’un fichier JSON sont extrêmement simples et se représentent que de 3 manières différentes :

— Objet : Fonctionne sur le principe de clé valeur qu’il est possible de déclarer plusieurs fois les uns à la suite des autres.

— Tableau : Représente un tableau de valeurs qui peuvent être aussi bien des objets, des tableaux ou des valeurs simples.

— Valeur : Représente simplement une valeur qui peut être une chaîne de caractères, un nombre,unbooléen,unevaleurnulloumêmeunobjetouuntableau.Raisonpourlaquelle un tableau peut contenir des objets et des tableaux et réciproquement pour un objet.

Ainsi, toutes ses représentations se schématisent de la manière suivante avec cette image issue du .

 Figure : Description de son langage dans son intégralité

La lecture de ce genre de représentation est enfantine, il suffit de suivre les branches. Pour vous aider à comprendre, prenons le schéma fléché ci-dessous. Les flèches mettent en évidence les branchements possibles et les arrêts à une valeur obligatoire.

 Figure : Ecriture d’un objet à partir de la représentation du JSON

1.  Nous commençons notre objet et nous sommes obligés d’écrire une accolade. C’est cette accolade qui va marquer le début d’un objet JSON.

2.  Si nous prenons cette branche et que nous la suivons, nous évitons de renseigner des clés/valeurs dans notre objet pour directement le fermer. Cela veut donc dire qu’il est possible de créer des objets vides mais que à la suite d’une déclaration d’un objet. Dès que vous aurez renseigné au moins une clé/valeur, votre objet JSON ne pourra plus être vide, chose assez logique.

3.  Nousdécidonsderenseigneruneclé/valeurdansnotreobjet.Nousrencontronsunencadré qui représentera notre clé, nous devons renseigner “ :” pour faire correspondre la clé à la valeur et nous renseignons la valeur.

4.  Nous pouvons réitérer la branche 3 autant de fois que nous le désirons. Pour ce faire, vous prenez la branche 4 qui vous oblige à renseigner une virgule avant de retourner sur la branche précédente.

5.  Dès que vous avezfini de renseigner toutes les clés/valeurs de votre objet, vous sortez avec la branche 5 en renseignant une accolade fermante.

Voyons un exemple concret avec le développement du serveur applicatif.

3.3 Développement du serveur applicatif

Vous avez toutes les cartes en main pour développer votre application serveur. Il ne vous reste plus qu’à développer votre script qui va :

— Se connecter à votre base de données, AdvancedAndroidDevelopment;

— Exécuter la requête SQL de sélection de votre choix pour récupérer les produits;

— Former un tableau d’objets pour le préparer au format JSON;

— Utiliser la méthode string json_encode ( mixed $value [, int $options = 0

] ) pour encoder votre tableau en JSON ();

— Utiliser la méthode void echo ( string $arg1 [, string $ ] ) pour envoyer le fichier JSON au client (documentation officielle).

Vous savez quoi faire et je vais vous laisser faire. Il est important que vous y parveniez seul pour pouvoir développer vos propres scripts. Notre exemple est assez simple et ne devrait pas poser problème mais si vous éprouvez des difficultés, rendez-vous sur des tutoriels PHP pour vous débloquer. Essayez de trouver la solution par vous-même avant de regarder la solution proposée.

À l’exécution du script, le JSON que vous devez obtenir est un tableau avec pour chaque indice, un objet qui représentera un produit :

[

        {

                "id" : "1",

                "name" : "Apple",

                "type" : "Fruit",

                "price" : "1.2"

        } ,

        {

                "id" : "2",

                "name" : "Pear",

                "type" : "Fruit",

                "price" : "1.3"

        } ,

        {

                "id" : "3",

                "name" : "Banana",

                "type" : "Fruit",

                "price" : "1.1"

        } ,

        {

                "id" : "4",

                "name" : "Mushroom",

                "type" : "Vegetable",

                "price" : "2.7"

        } ,

        {

                "id" : "5",

                "name" : "Pepper",

                "type" : "Vegetable",

                "price" : "3.6"

        }

]

<?php try {

// connection to the database.

$pdo_options[PDO ::ATTR_ERRMODE] = PDO ::ERRMODE_EXCEPTION;

$bdd = new PDO('mysql:host=localhost;dbname=AdvancedAndroidDevelopment', 'root'

// Execute SQL request on the database.

$sql = 'SELECT id, name, type, price FROM product;';

$response = $bdd->query($sql);

$output = $response->fetchAll(PDO ::FETCH_ASSOC));

} catch (Exception $e) { die('Erreur : ' . $e->getMessage());

}

// Print JSON encode of the array. echo(json_encode($output));

?>

Parmi toutes les API Java intégrées dans le framework Android, il existe le paquetage pour effectuer des requêtes HTTP standard; c’est-à-dire sans l’intervention d’une bibliothèque externe.

L’usage des classes de ce paquetage implique la configuration totale de vos requêtes HTTP de la méthode utilisée, aux différents timeout et nécessite la conversion manuelle d’un flux de données à une chaine de caractère.

Pour résumé, si nous désirons effectuer une requête HTTP du type GET, avec une limite de 10000 millisecondes pour lire la requête et de 15000 pour se connecter au serveur, vous devez initialiser la requête de la manière suivante :

public String get(String url) throws IOException { InputStream is = null; try {

final HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection(); conn.setReadTimeout(10000 /* milliseconds */); conn.setConnectTimeout(15000 /* milliseconds */); conn.setRequestMethod("GET"); conn.setDoInput(true); // Starts the query conn.connect(); is = conn.getInputStream();

// Read the InputStream and save it in a string return readIt(is);

} finally {

// Makes sure that the InputStream is closed after the app is // finished using it.

if (is!= null) { is.close();

}

}

}

Code : Requête HTTP vers un serveur à une URL donnée en paramètre.

Àlalecturedececode,celapeutvoussemblerpasbiencomplexeàutilisermaissachezqu’ils’agit iciduminimumsyndical(etencore,iln’estpasnécessairederenseignerdes timeout).Dèslorsque vousvoudrez effectuerdesrequêtes dansunprojet sérieux,ilvous faudraréagirà descodesHTTP et traiter son contenu en fonction de ce même code. Chose qui n’est pas traitée dans cet exemple,

ni même dans ce tutoriel puisque nous verrons plus loin des usages plus courants et plus simples pour effectuer des requêtes.

Vous remarquez aussi l’usage de la méthode readIt(InputStream) qui permet de lire un InputStream et d’en sauvegarder son contenu dans une String. Cette méthode n’existe pas dans Android mais il existe plusieurs façons de mettre en oeuvre cette conversion. Voici la mienne :

private String readIt(InputStream is) throws IOException {

BufferedReader r = new BufferedReader(new InputStreamReader(is));

StringBuilder response = new StringBuilder(); String line; while ((line = r.readLine())!= null) {

response.append(line).append('\n');

} return response.toString();

}

Code : Lit un flux de données et place son contenu dans une chaine de caractères.

Cettesectionn’esticiqu’àtitreinformatifetparcequevouspourriezrencontrercegenredecode dans d’autres projets puisqu’il s’agit de la version la plus basique possible pour faire une requête.

[[attention]] | Au risque de gêler votre interface graphique ou de faire survenir un crash, il faut obligatoirement faire une requête HTTP dans un thread secondaire. Vous disposez de nombreuses possibilités pour exécuter du traitement dans des threads secondaires comme les AsyncTask, les Handler, les HandlerThread, les Loader ou les services. Ce sujet fera l’objet d’un tutoriel séparé vu la diversité des possibilités et leurs nombreux avantages/inconvénients.

Rappelez-vous, le serveur applicatif va chercher en base de données une liste de produits et renvoyer le résultat dans un fichier JSON. Il faut donc pouvoir extraire les données de ce fichier et les placer dans une classe pour pouvoir les afficher ou les manipuler dans l’application. Pour y parvenir, nous allons déléguer la responsabilité d’extraire les données à une classe Product. Cela permettra de ne plus se préoccuper de l’extraction des “objets” d’un produit dans le fichier JSON.

Avant cela, nous allons en apprendre plus sur les classes principales, à savoir JSONArray et JSONObject.

Pour extraire un tableau d’un fichier JSON, vous devez utiliser la classe JSONArray qui possède 4 constructeurs :

— public JSONArray () : Création d’un tableau JSON vide.

— public JSONArray (Collection copyFrom) : Création d’un tableau JSON en copiant toutes les valeurs de la collection donnée.

— public JSONArray (JSONTokener readFrom):Créationd’untableauJSONencopiant toutes les valeurs du tableau contenu dans le tokener.

— public JSONArray (String json) : Création d’un tableau JSON suivant un fichier JSON.

4.2 Extraire les données du JSON

Puisque notre requête HTTP lit un InputStream et sauvegarde son contenu dans une String, le dernier constructeur est celui qui convient le mieux à notre exemple. Concrètement, ce constructeur va créer un JSONArray et va contenir toutes les valeurs, les objets ou les tableaux contenus dans le tableau racine. Notez que si le serveur applicatif avait renvoyé non pas un tableau mais un objet, il aurait fallu utiliser un des constructeurs de JSONObject.

Une fois que vous avez votre tableau JSON, une série de méthodes existe pour en extraire les différentes valeurs. Nous avons déjà vu les différentes valeurs contenues dans un fichier JSON, il existe une méthode d’extraction pour chacun de ces types :

— public boolean getBoolean (int index) : Récupérer une valeur booléenne.

— public double getDouble (int index) : Récupérer un double.

— public int getInt (int index) : Récupérer un entier.

— public long getLong (int index) : Récupérer un long.

— public String getString (int index) : Récupérer une chaine de caractères.

— public JSONArray getJSONArray (int index) : Récupérer un tableau JSON.

— public JSONObject getJSONObject (int index) : Récupérer un objet JSON.

[[information]] | Il existe une alternative à chacune de ces méthodes. Le problème avec les méthodes get*(), il lancera une exception .JSONException si vous tentez de récupérer une valeur qui n’existe pas. Vous pouvez donc utiliser les méthodes opt*() qui renverra une valeur par défaut si la valeur n’est pas présente. Je vous encourage donc à utiliser cette version si la valeur n’est pas forcément nécessaire et qu’une valeur par défaut peut convenir.

Pour extraite un objet d’un fichier JSON, c’est similaire aux tableaux. Vous devez utiliser la classe JSONObject qui possède 5 constructeurs :

— public JSONObject () : Création d’un objet JSON vide.

— public JSONObject (Map copyFrom) : Création d’un objet JSON qui copie toutes les clés/valeurs de la map donnée.

— public JSONObject (JSONTokener readFrom) : Création d’un objet JSON qui copie toutes les clés/valeurs du prochain objet dans le tokener.

— public JSONObject (String json) : Création d’un objet JSON suivant un fichier JSON.

— public JSONObject (JSONObject copyFrom, String[] names) : Création d’un objet JSON qui copie tous les noms du tableau avec l’objet JSON.

Tout comme l’instanciation d’un tableau JSON, nous utiliserons principalement le constructeur qui prend une chaine de caractères en paramètre.

Quant aux méthodes d’extraction, elles sont strictement identiques au JSONArray. Vous n’aurez donc aucun mal à les utiliser.

La théorie est terminée, nous allons passer à la pratique. L’exemple étant assez simple, il n’y aura qu’une seule classe qui aura la responsabilité d’extraire un JSONObject et de renseigner les valeurs que contient cet objet dans les attributs de la classe, que nous appellerons une classe du domaine nommée Product.

package org.randoomz.androidnetworkingsample.models;

import .Parcel; import .Parcelable;

import .JSONObject;

public class Product implements Parcelable {

private final long id; private final String name; private final String type; private final double price;

public Product(JSONObject jObject) {

= jObject.optLong("id"); = jObject.optString("name"); = jObject.optString("type"); this.price = jObject.optDouble("price");

}

public long id() { return id; }

public String name() { return name; }

public String type() { return type; }

public double price() { return price; }

}

Code : Considérée comme une classe du modèle, elle représente un produit.

Cependant, avant d’obtenir les objets des produits, il faut itérer sur le tableau JSON qui se trouve à la racine du fichier JSON. Pour ce faire, nous allons récupérer la chaine de caractères du JSON, nous allons la placer dans un JSONArray et nous allons itérer dessus.

private List<Product> parse(final String json) {

try {

final List<Product> products = new ArrayList<>(); final JSONArray jProductArray = new JSONArray(json); for (int i = 0; i < jProductArray.length(); i++) {

(new Product(jProductArray.optJSONObject(i)));

} return products;

} catch (JSONException e) {

Log.v(TAG, "[JSONException] e : " + e.getMessage());

} return null;

}

4.3 Facilitons-nous la vie avec des bibliothèques

Code : Traduit une représentation en chaine de caractères d’un fichier JSON en une liste de produits.

Vousdisposezmaintenantdelalistedesproduitsetvouspouvezl’utilisern’importeoùdansvotre application comme dans une liste.

Vous savez quoi? Oubliez tout ce que nous venons d’apprendre dans cette section, ou plus justement ne l’utilisez plus jamais. L’une des forces d’Android se situe dans sa communauté. Elle est tellement énorme et active qu’il existe des milliers de bibliothèques pour aider les développeurs dans le développement de leurs applications Android.

Dans le cadre de ce tutoriel, nous allons en apprendre 3 qui me semblent indispensables à connaitre pour tout développeur Java. Java parce que ces bibliothèques sont adaptées au développement Android et Java standard.

[[information]]|Danslasuitedecettesection,nousallonspartirduprincipequevousutilisezAndroid Studio et donc Gradle comme gestionnaire de dépendances. Toutes les dépendances seront à renseigner dans le fichier Gradle build.gradle.

Dans les exemples précédents, nous avons appris à utiliser les classes standards du framework

Android mais elles sont loin d’être ergonomique. Pour palier ce problème, nous allons voir deyx bibliothèques qui vont simplifier vos requêtes HTTP et la transformation d’une chaine de caractères dans des objets Java.

OkHttp est une bibliothèque qui tente de proposer une solution moderne pour effectuer des requêtes web. Son utilisation est extrèmement simple et se découpe en 3 étapes :

1.  Préparation de la requête HTTP grâce au design pattern Builder.

2.  Exécution de la requête HTTP précédemment préparée.

3.  Récupère le résultat de la requête.

private final OkHttpClient client = new OkHttpClient();

public String get(String url) throws IOException { // Prepare the request.

Request request = new Request.Builder().url(url).build(); // Execute the request.

Response response = client.newCall(request).execute(); // Get the result.

return ().string();

}

Code : Requête HTTP vers un serveur avec la bibliothèque OkHttp.

C’est tout … Exit la dizaine de ligne de code pour préparer la requête HTTP ou la manipulation des InputStream pour récupérer les résultats. Toutes ces choses sont gérées par la bibliothèque.

VouspouvezvousconcentreruniquementsurvosrequêtesHTTP.Malheureusement,toutelagestion des codes HTTP restent de votre ressort, mais l’API est bien mieux pensée pour la gérer.

Pour toutes les informations à propos de cette bibliothèque, rendez-vous sur sa officielle et pour l’utiliser, il suffit de renseigner la dépendance dans le fichier build.gradle de votre projet.

compile 'com.squareup.okhttp3:okhttp:3.3.1'

Code : Dépendance Gradle pour OkHttp.

Gson peut être utilisé pour convertir des objets Java dans une représentation JSON ou inversement,d’unechainedecaractèresJSONversdesobjetsJava.L’idéeestdesepasserd’uneAPIpour placermanuellementlesvaleursd’unJSONversdesobjetsJava,laisserlabibliothèquegérercette tâche.

Son usage est déconcertant de simplicité. Il vous suffit d’instancier un objet Gson et d’utiliser les méthodes toJson( ) pour passer d’un objet à une représentation JSON ou aux méthodes fromJson( ) pour transformer un fichier JSON en des objets Java.

Par exemple, si le fichier JSON représente directement un objet, vous pouvez placer les valeurs du fichier JSON dans un objet grâce à la ligne suivante :

Product p = new Gson().fromJson(json, Product.class);

Code : Traduit une représentation en chaine de caractères d’un fichier JSON en un objet produit avec Gson.

Dansnotretutoriel,nousavonsunfichierJSONquireprésenteunelistedeproduits.Nousdevons informer Gson et lui fournir le type adéquat de la manière suivante :

List<Product> list = new Gson().fromJson(json, new TypeToken<List<Product>>() {}.getTyp

Code : Traduit une représentation en chaine de caractères d’un fichier JSON en une liste de produits avec Gson.

Grâce au type générique spécifié dans TypeToken, Gson est au courant du type attendu et peut convertir le fichier JSON dans une liste appropriée.

[[attention]] | Tout ne fonctionne pas par magie non plus. Il existe une limitation à Gson. Pour que Gson puisse placer les valeurs dans un objet JSON, vous devez avoir des attributs dans votre classe qui correspondent aux clés spécifiées dans le fichier JSON. Dans le cas contraire, placez l’annotation @SerializedName sur l’attribut qui ne possède pas le bon nom avec comme paramètre à l’annotation, la valeur de la clé dans le fichier JSON. Par exemple, pour un attribut qui se nomme “nom” mais avec une clé “name” dans le fichier JSON, vous devez annoter l’attribut de la manière suivante : | ‘java | @SerializedName("name") private String nom; |

Pour toutes les informations à propos de cette bibliothèque, rendez-vous sur sa officielle et pour l’utiliser, il suffit de renseigner la dépendance dans le fichier build.gradle de votre projet.

compile ':gson:2.6.2'

Code : Dépendance Gradle pour Gson.

4.3 Facilitons-nous la vie avec des bibliothèques

Vous êtes déjà impressionné par OkHttp et Gson? Alors vous ne connaissez pas encore Retrofit. CettebibliothèquepermetdefairedesrequêtesHTTPavecuneplusgrandesimplicitéqueOkHttp, s’occupe tout seul de convertir vos JSON dans des objets Java et vous propose une architecture adaptée pour réagir en conséquence aux codes HTTP. Par contre, elle est un poil plus complexe à utiliser. Il faudrait un tutoriel entier pour couvrir toutes les possibilités. Dans le cadre de ce tutoriel ci-présent, nous verrons que les strictes bases. En attendant un tutoriel français sur le sujet, rendez-vous sur la de la bibliothèque.

Pour utiliser Retrofit, vous devez disposer d’une instance de Retrofit (si possible unique dans votre projet), d’une ou plusieurs interfaces Java pour exécuter des requêtes vers votre serveur et d’une instance vers cette interface. Vous vous retrouvez avec le code suivante :

Une interface ProductService avec une seule méthode list() pour récupérer la liste des produits. Cette méthode est annotée par @Get("list") pour informer Retrofit que la requête HTTP doit se faire en GET et que l’URL se termine par “list”. La méthode doit retourner Call<List<Product>>. Call est une interface de Retrofit qui permet d’exécuter en synchrone ou asynchrone la requête et le type générique à l’intérieur informe Retrofit du type de retour souhaité.

public interface ProductService {

@GET("list") Call<List<Product>> list();

}

Code : Interface Retrofit pour faire des requêtes HTTP.

Maintenantquenousavonsl’interface,ilsuffitdel’utiliseravecuneinstance.Pourrécupérerune instancedecetteinterface,ilfautpasserparuneinstancedeRetrofit.Cetteinstances’initialise grâce à un Builder. Dans ce builder, vous spécifiez l’URL de base de votre serveur (dans notre exemple “http ”).

Retrofit retrofit = new Retrofit.Builder()

.baseUrl(";)

.build();

Code : Construction d’un objet Retrofit pour récupérer des instances d’un service et faire des requêtes HTTP.

L’instance Retrofit à disposition, vous pouvez construire une instance de votre service grâce à la méthode create(Class<?>). Cette instance n’est pas réellement instanciée par l’interface puisque le langage Java ne le permet pas. Néanmoins, vous n’avez pas à vous soucier de l’implémentation de l’interface. Vous pouvez utiliser les méthodes déclarées dans l’interface et Retrofit se chargera de faire vos requêtes HTTP! final ProductService service = retrofit.create(ProductService.class);

Code : Récupération d’une instance d’un service pour faire des requêtes HTTP.

Pour exécuter une requête HTTP, vous avez 2 solutions :

— Exécuter la requête en synchrone ().execute(). Il en sera de votre responsabilité d’exécuter la requête dans un thread secondaire.

— Exécuter la requête en asynchrone ().enqueue(Callback). Vous n’êtes pas obligé de vous soucier d’exécuter la requête dans un thread secondaire, Retrofit le fait pour vous!

Ainsi, récupérer la liste des produits en asynchrone se fera de la manière suivante :

().enqueue(new Callback<List<Product>>() {

@Override public void onResponse(Call<List<Product>> call, Response<List<Product>> re // Request ok. Get the result.

}

@Override public void onFailure(Call<List<Product>> call, Throwable t) { // Request failed. Check why.

}

});

Code : Requête HTTP vers un serveur avec la bibliothèque Retrofit.

Retrofit s’occupe tout seul de faire la requête HTTP, il vous fournit automatiquement la conversion JSON vers vos classes Java. Concernant les cas d’erreur, évitez de vous faire avoir. Comme vous le voyez dans l’exemple, vous disposez de la méthode onFailure(Call, Throwable) mais elle sera appelée uniquement s’il y a eu un problème avec la requête HTTP comme une perte de la connexion internet. Si vous voulez gérer les codes d’erreur HTTP, vous devez le faire dans la méthode onResponse(Call, Response) grâce à la vérification response.isSuccessful() sur la réponse de la requête. Si isSuccessful() renvoie faux, vous pouvez récupérer le code HTTP et son message d’erreur.

Commed’habitude,cesexplicationsnesontquedesintroductions.Rendez-vousàladocumenta pour connaitre toutes les possibilités de cette bibliothèque. Quant à la dépendance Gradle, il suffit de spécifier cette ligne dans le bloc dependencies de votre fichier build.gradle. compile 'com.squareup.retrofit2:retrofit:2.0.2'

Code : Dépendance Gradle pour Retrofit.

A la lecture de ce tutoriel, une architecture client/serveur devrait avoir moins de secret pour vous et vous devriez être capable d’effectuer des requêtes HTTP à partir d’une application Android. D’ailleurs, si vous voulez vous entrainer sur ce dernier point, sachez que Zeste de Savoir met à la disposition des développeurs une API pour récupérer des informations comme les membres et vos conversations privées. Rien ne vous empêche de développer une application Android qui interroge cette API pour vous entrainer, voire même pour proposer votre propre vue pour consulter cesinformations.Toutdépenddevous,devotremotivationetdevotreimaginationpourproposer des alternatives!

Merci à artragis, Arius et aux membres de la communauté de Zeste de Savoir pour leurs retours sur ce tutoriel.

[[information]] | Ce tutoriel dans sa version écrite ne vous suffit pas? Sachez que des tutoriels vidéosserontrajoutésdanslessemainesàvenirpourvousproposerunealternativepourapprendre tous les concepts enseignés dans ce tutoriel! Pour être tenu au courant, il vous suffit de suivre ce contenu grâce au bouton “Suivre ce contenu”. Je me chargerais personnellement de poster un message dans les commentaires pour vous notifier d’une nouvelle vidéo qui sera intégrée directement dans ce contenu. Vous aurez alors une notification dans votre centre de notifications sur Zeste de Savoir!

L’icône est le logo officiel du projet PHP For Android et disponible en sur le site du projet.

---