Connexion et récupération de donnée en liaison HTTP avec conversion en chaine de caractère

Il est souvent nécessaire de récupérer les nouvelles données pour son application sur le réséau Internet. En développement Android, il existe de nombreuses classes pour gérer et utiliser des connexions HTTP. Nous allons apprendre à tester la connectivité de l'appareil et récupérer des données par connexion HTTP pour les convertir en un String.

Manifest

Tout d'abord il faut ajouter deux permissions à notre application :

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.androiddev.listviewjson" android:versionCode="1" android:versionName="1.0" > ... <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> ... </manifest>

Ses deux permissions sont à ajouter au fichier manifest.xml.

Tester la connectivité

Il est important de tester si le smartphone ou la tablette est connecté au réseau Internet, soit par réseau Wifi ou réseau 3G. Pour cela il faut utiliser l'objet ConnectivityManager :

ConnectivityManager connMgr = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE); NetworkInfo networkInfo = connMgr.getActiveNetworkInfo(); if (networkInfo != null && networkInfo.isConnected()) { // fetch data } else { // display error }

Ce test peut être réaliser depuis le Thread principal de notre application. Dans l'exemple précédent, on récupère l'objet ConnectivityManager par rapport au Context actuelle. Ensuite on récupère l'objet NetworkInfo via la fonction getActiveNetworkInfo().

Avec cette objet on peut testé si le smarpthone est connecté via la fonction isConnected() de notre objet NetworkInfo. Ensuite, deux possibilités :

1. Si la connexion existe : on appel la tâche asynchrone qui sert à la connexion HTTP avec comme paramètre l'url pour récupèrer les données.
2. Sinon on affiche le message comme quoi la connexion n'existe pas.

La connexion et la récupération de donnée

private String downloadUrl(String myurl) throws IOException { InputStream is = null; try { URL url = new URL(myurl); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setReadTimeout(10000 /* milliseconds */); conn.setConnectTimeout(15000 /* milliseconds */); conn.setRequestMethod("GET"); conn.setDoInput(true); // Starts the query conn.connect(); int response = conn.getResponseCode(); Log.d(DEBUG_TAG, "The response is: " + response); is = conn.getInputStream(); // Convert the InputStream into a string String contentAsString = readIt(is); return contentAsString; // Makes sure that the InputStream is closed after the app is // finished using it. } finally { if (is != null) { is.close(); conn.disconnect(); } } }

• La connexion se réalise donc par un objet URL, qui retourne ensuite un objet de type HttpURLConnection via la fonction openConnection()
• Ensuite on peut paramètrer notre connexion (optionnelle), de nombreux paramètres existent. Une fois paramètrer on peut lancer la connexion  avec la fonction connect() de HttpURLConnection.
• On peut récupérer le code de réponse avec la fonction getResponseCode() de HttpURLConnection.
• On récupère ensuite le flux de donnée avec la fonction getInputStream().
• On prévoit qu'a la fin ou en cas d'erreur, de déconnecter l'application et de fermer l'InputStream.

Conversion de l'InputStream en String

La fonction readIt aura pour but de convertir l'InputStream en String :

public String readIt(InputStream stream) throws IOException, UnsupportedEncodingException { StringBuilder builder = new StringBuilder(); BufferedReader reader = new BufferedReader(new InputStreamReader(stream)); String line; while ((line = reader.readLine()) != null) { builder.append(line + "\n"); } return builder.toString(); }

• On récupère notre InputStream pour le convertir en InputStreamReader
• Puis on convertie notre InputStreamReader en BufferedReader
• Ensuite on lit chaque ligne retourné pour les insérer dans notre StringBuilder avec un '\n' pour bien prendre en compte le retour à la ligne.
• Et enfin on retourne notre StringBuilder convertie en String

Pour aller plus loin

Lancer la connexion dans le thread principal

Cette pratique, fortement déconseillée est tout de même réalisable :

StrictMode.ThreadPolicy policy = new StrictMode. ThreadPolicy.Builder().permitAll().build(); StrictMode.setThreadPolicy(policy);

Ecrire des données

Il est aussi possible d'écrire des données via une connexion HTTP :

HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection(); try { urlConnection.setDoOutput(true); urlConnection.setChunkedStreamingMode(0); OutputStream out = new BufferedOutputStream(urlConnection.getOutputStream()); writeStream(out); InputStream in = new BufferedInputStream(urlConnection.getInputStream()); readStream(in); finally { urlConnection.disconnect(); }

L'authentification HTTP

On peut aussi s'authentifier :

Authenticator.setDefault(new Authenticator() { protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(username, password.toCharArray()); });

Et tout le reste

Il faut savoir que l'on peut aussi :

• Utiliser les Cookies
• Utiliser d'autre méthode que GET
• Utiliser le cache pour les réponses HTTP
• Utiliser des Proxies

Tout ceci est expliqué sur la documentation officielle d'Android : lien