[TUTO] Connexion-Android-MySQL, JSON PHP

La connectivité aux bases de données est parfois une opération délicate pour les débutants. Il existe plusieurs procédures qui permettent,dépuis un client android, de se connecter à une base de données. Dans ce tutoriel,je choisis de vous présenter l'une des méthodes, qui consiste à l'utilisation d'un fichier PHP qui convertit les données récupérées en format JSON(Le format JSON est une réprésentation structurée de données en Objet JavaScript, les données sont maniables très facilement dans ce format qui est aussi une sorte de compression.En PHP, la fonction json_encode() permet d'encoder en JSON.C'est un format très utile, il merite que vous y jettiez un coup d'oeil ( http://www.json.org/ )) . Cette méthode est donc très  avantageuse , souple et facile à mettre en oeuvre.

Voici tout d'abord l'environnement de travail dont je dispose:

• SDK android
• eclipse
• EasyPHP/MySQL

Pour mieux comprendre la procédure, nous allons la schématiser:

A présent, pour concretiser cette procédure, je vous propose de créer une base de données qui contient les noms des écoles(INPT,EHTP,ENSIAS,INSEA) et l'exercice consistera donc à les recuperer et les afficher sur l'emulateur.(On dédie à l'INPT la tete de liste pour l'occasion).

Voici le résulat de l'affichage final:

I. Coté serveur

1.Base de données:
Notre base de données est simple et contient une table à deux colonnes comme suit:

2. Fichier PHP:

Le fichier php consiste à envoyer des réquetes sql à la base de données etablissements qui contient la table ecoles. Il récupère le résultat des réquetes, ensuite l'encode en JSON grace au simple appel de la fonction json_encode() comme dit précedemment.Son contenu ressemble à ça:

<?php
// on se connecte à notre base  pour recuperer les data
$base = mysql_connect ('localhost', 'root', ''); 
mysql_select_db ('etablissements', $base) ; 
$req =mysql_query("SELECT nom from ecoles");
while ($row=mysql_fetch_array($req)) {   
    $output[]=$row;   
}
//on encode en JSON
print(json_encode($output));
mysql_free_result ($req); 
?>

II. Coté Client

Au niveau du Client android, il s'agit de démander au serveur de nous renvoyer la liste des écoles grace aux commandes HttpClient, Ensuite, il nous appartient de décoder(récuperer les champs) ces données(puisqu'elles sont renvoyées sous forme d'objet JSON) et les afficher sous forme de liste dans notre cas.

Cela se fera en utilisant une seule classe principale qui va hériter de ListActivity pour faire simple.Voici en gros le contenu de la dite classe:

• Envoi des commandes HttpClient en indiquant le chemin du fichier PHP à interroger (attention ici nous travaillons bien en local mais l'adresse locale pour l'emulateur android c'est 10.0.2.2 et non localhost ou 127.0.0.1 comme d'habitude).
• Conversion du flux réçu en chaine de caractères
• Récuperation des données codées sous forme d'objet JSON
• Affichage suivant une liste

Je vous laisse le code complet ci-dessous de la partie client, n'hesitez pas à commenter si vous avez des erreurs/questions.

package com.mobilerie.com;
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.ArrayList;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.DefaultHttpClient;
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;
import android.app.ListActivity;
import android.net.ParseException;
import android.os.Bundle;
import android.util.Log;
import android.widget.ArrayAdapter;
import android.widget.Toast;
public class ConnexionSQLActivity extends ListActivity {
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //setContentView(R.layout.main);
        String result = null;
     InputStream is = null;
     JSONObject json_data=null;
     ArrayList<NameValuePair> nameValuePairs = new ArrayList<NameValuePair>();
     ArrayList<String> donnees = new ArrayList<String>();
   
     try{
     //commandes httpClient
     HttpClient httpclient = new DefaultHttpClient();
        HttpPost httppost = new HttpPost("http://10.0.2.2/connexion_mysql/connexion_mysql.php");
        httppost.setEntity(new UrlEncodedFormEntity(nameValuePairs));
        HttpResponse response = httpclient.execute(httppost);
        HttpEntity entity = response.getEntity();
        is = entity.getContent();
     }
     catch(Exception e){
      Log.i("taghttppost",""+e.toString());
            Toast.makeText(getBaseContext(),e.toString() ,Toast.LENGTH_LONG).show();
       }
   
      
     //conversion de la réponse en chaine de caractère
        try
        {
         BufferedReader reader = new BufferedReader(new InputStreamReader(is,"UTF-8"));
        
         StringBuilder sb  = new StringBuilder();
        
         String line = null;
        
         while ((line = reader.readLine()) != null)
         {
         sb.append(line + "\n");
         }
        
         is.close();
        
         result = sb.toString();
        }
        catch(Exception e)
        {
         Log.i("tagconvertstr",""+e.toString());
        }
        //recuperation des donnees json
        try{
          JSONArray jArray = new JSONArray(result);
           
             for(int i=0;i<jArray.length();i++)
             {
           
                   json_data = jArray.getJSONObject(i);
                   donnees.add(json_data.getString("nom"));
                   //r.add(json_data.getString("categorie"));
                  
               }
                setListAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_expandable_list_item_1, donnees));
            }
            catch(JSONException e){
             Log.i("tagjsonexp",""+e.toString());
            } catch (ParseException e) {
             Log.i("tagjsonpars",""+e.toString());
       }
           
    }
}