L exemple qui est mis à votre disposition a pour but de rechercher les données contenues dans un fichier services.xml fourni :

Transcription

1 TP n 9 Xml/Json 1) Exemple d application analysant un fichier XML L exemple qui est mis à votre disposition a pour but de rechercher les données contenues dans un fichier services.xml fourni : Ce fichier est stocké dans le répertoire raw, créé s il n y est pas encore, dans le répertoire des ressources de l application res. Une classe Service, simplifiée ici le plus possible, permet de mémoriser les données qui sont lues dans le fichier XML: Le résultat de l analyse (parsing) de ce fichier XML doit ainsi permettre d afficher les résultats dans la console LogCat : Page 1/10

2 La classe MainActivity instancie un objet xmlasync servant à l analyse du fichier, en tâche de fond, et propose une méthode permettant l affichage des données du fichier stockées dans une liste : La classe interne XmlAsync instancie (pour simplifier) un objet handler qui réalise l analyse proprement dite : Page 2/10

3 Enfin la classe XmlSaxHandler est chargée de la lecture séquentielle du fichier XML et de l instanciation à la volée des objets Service rencontrés, stockés un par un dans une collection List : Page 3/10

4 Travail à faire 1. En vous aidant de la vidéo fournie, créer un premier projet Android nommé «SIO Services» mettant en œuvre le code fourni ci-dessus. 2. Analyser le code en répondant aux questions ci-après : 1 Présentez le diagramme des classes correspondant au code fourni en indiquant les seules méthodes utiles. 2 Rédigez succinctement les réponses aux questions suivantes : Documentez les méthodes startelement, characters et endelement de la classe XmlSaxHandler en expliquant leur mécanisme d appel ; Dire si l analyseur proposé permettrait de gérer convenablement le fichier XML fourni si la balise <responsable> était décomposée en deux balises : <responsable> <prenom>patrick</prenom> <nom>piron</nom> </responsable> Les réponses à ces questions doivent être rédigées sur feuille! Page 4/10

5 2) Création du projet Créer le projet suivant : Travail à faire Application Name : SIO Livraisons Company Domain : btssio.fr Project location : C:\Users\VotreUser\AppliAndroid\SIOLivraisons Form Factors : Phone and Tablet Minimum SDK : API18 : Android 4.3 (Jelly Bean) Activity : Blank Activity 3. Modifiez l icône de l application : utilisez l image siolivraisons.png fournie. 3) Parser un fichier XML distant Il s agit ici de réaliser un traitement identique à celui présenté dans l exemple précédent mais en accédant à un fichier XML accessible sur un serveur web. Travail à faire 4. Placer le fichier fourni livraisons.xml à la racine de votre serveur web 5. Ecrire le code de l application qui va permettre de parser ce fichier stocké sur votre serveur web. L accès au fichier et le parsing sont réalisés dans la méthode doinbackground(). Il faudra : - Créer des classes métiers Livraison et Colis - Créer les packages suivants : metier (classes Livraison et Colis) activites (MainActivity) parserxml (classe XmlSaxHandler) - Accéder puis parser le fichier livraisons.xml - Afficher la liste des livraisons dans la console LogCat Résultat attendu dans la LogCat : Infos utiles Attention double n est pas Double Le type double est un type «valeur» Le type Double est un type «référence» (une instance d une classe! ) Selon celui que vous utilisez vous ne disposez pas des mêmes «outils» Parser un Double en String Double unnombre = ; String unechaine = ""; unechaine = unnombre.tostring(); / Page 5/10

6 Parser un double en String double unnombre = ; String unechaine = ""; unechaine = String.valueOf(unNombre); Parser un String en Double ou en double Double unnombre; String unechaine = " "; unnombre = Double.parseDouble(uneChaine); 4) Parser la réponse XML d un Web Service Nous allons dans cette partie parser la réponse XML retournée par un Web Service et donc voir comment se réalise la connexion à un Web Service REST. protected List<Livraison> doinbackground(string... urls) { erreur = null; XmlSaxHandler xmlsaxhandler; HttpURLConnection urlconnection = null; try { // Création du parser SAX SAXParserFactory factory = SAXParserFactory.newInstance(); SAXParser saxparser = factory.newsaxparser(); XMLReader xmlreader = saxparser.getxmlreader(); // On crée une instance de notre handler xmlsaxhandler = new XmlSaxHandler(); // Instancie un objet Url à partir de la chaine passée en paramètre URL url = new URL(urls[0]); // Ouverture de la connexion urlconnection = (HttpURLConnection) url.openconnection(); // Définit un timeout de 5 secondes. Si le serveur n a pas répondu au // bout de ce laps de temps, une exception SocketTimeoutException est // générée urlconnection.setconnecttimeout(5000); // Ici, on précise les paramètres de la requête urlconnection.setrequestmethod("get"); urlconnection.setrequestproperty("content-type", "application/xml"); // On vide le cache pour être sût d avoir les données à jour urlconnection.setusecaches(false); // Connexion à l'url urlconnection.connect(); // Si le serveur nous répond avec un code OK if (urlconnection.getresponsecode() == HttpURLConnection.HTTP_OK) { // On récupère un flux en lecture vers cette url InputStream inputstream = urlconnection.getinputstream(); / // On lance le "parsing" XML xmlreader.setcontenthandler(xmlsaxhandler); xmlreader.parse(new InputSource(inputStream)); return xmlsaxhandler.getleslivraisons(); Page 6/10

7 else { erreur = "Code réponse : " + urlconnection.getresponsecode() + " - " + urlconnection.getresponsemessage(); catch (java.net.sockettimeoutexception e) { erreur = "timeout"; catch (SAXException e) { erreur = e.getmessage(); Log.e("parseXml", "Erreur durant le parsing des données - " + e.getmessage()); catch (IOException e) { erreur = e.getmessage(); Log.e("parseXml", "Problème durant la lecture des données - " + e.getmessage()); catch (Exception e) { erreur = e.getmessage(); Log.e("parseXml", "Erreur grave - " + e.getmessage()); finally { // Déconnexion if (urlconnection!= null) { urlconnection.disconnect(); Travail à faire 6. Récupérez le web service amap et placez-le à la racine de votre serveur web. Testez-le dans votre navigateur : 7. Vérifiez que vous y accéder également depuis le navigateur de votre terminal virtuel : 8. Apportez les modifications précédentes à la méthode doinbackground() de votre classe XmlAsync 9. Modifiez l url appelée dans la méthode oncreate() de l activité principale afin d utiliser le web service amap. 10. Lancez votre application Important Dans cette application de découverte, nous affichons les erreurs (exceptions ou pas) sur l écran du terminal à l aide d un Toast. Ces messages ne peuvent bien évidemment pas être affichés tels quels lors de la mise en production de l application ; notamment, il ne faut pas afficher le message de l exception (e.getmessage()) mais donner une information qui ait un sens pour l utilisateur! Page 7/10

8 5) Parser la réponse json d un Web Service Pour terminer, nous allons voir comment récupérer cette fois-ci une réponse au format json, qui je vous le rappelle, présente l intérêt d être très léger. Créer le projet suivant : Travail à faire Application Name : SIO WebServiceJson Company Domain : btssio.fr Project location : C:\Users\VotreUser\AppliAndroid\SIOWebServiceJson Form Factors : Phone and Tablet Minimum SDK : API18 : Android 4.3 (Jelly Bean) Activity : Blank Activity 11. Modifiez l icône de l application : utilisez l image siowebservicewsons.png fournie. 12. Ajoutez le package metier à votre application. 13. Copier les fichiers Colis.java et Livraison.java du projet précédent dans le package metier. 14. Copier le code de la classe interne XmlAsync dans votre classe MainActivity sans corriger les erreurs d import pour l instant. 15. Renommez la classe XmlAsync en AsyncCallWS. 16. Supprimez tout le code concernant le parsing XML de la classe AsyncCallWS. 17. Apportez les modifications suivantes à la classe MainActivity Définir un attribut leslivraisons de type List<Livraison> Ajoutez la méthode afficheleslivraisons() (copier/coller depuis le projet SIO Livraisons) Ajoutez l exécution de la tâche asynchrone dans le méthode oncreate() 18. Réalisez les imports nécessaires. Voici comment se présente votre fichier json : Une accolade «{» indique que ce qui suit est un objet json autrement dit un ensemble de couples clé / valeur, peu importe le type de la valeur. Ainsi ce fichier contient un seul objet json dont la clé est «livraison» et la valeur tout ce qui suit Un crochet «[» indique que ce qui suit est un tableau d objets json. Dans notre fichier, la clé «livraison» est associée à une valeur de type tableau d objets. Ce tableau comporte 3 objets (ici, on n en visualise que 2) Le premier de ces objets est lui-même constitué de 3 éléments : le «nom», l «adresse» et le «colis». L «adresse» est un objet Json composé de 3 éléments (rue, codepostal et ville). L objet «Colis» est un tableau dont chaque élément est un objet composé de 2 éléments (reference et montant) Page 8/10

9 Pourquoi tout ce blabla? Tout simplement parce que, pour pouvoir lire un fichier Json, il faut avoir bien compris sa structure. En effet, lorsque vous décodez le format Json, vous parcourez votre fichier élément par élément et il faut savoir quel type d élément vous analysez. 19. Adaptez le code de la méthode doinbackground() comme ci-dessous. 20. Modifiez la méthode utilisée pour l accès au web service 21. Testez [ ] // Si le serveur nous répond avec un code OK if (urlconnection.getresponsecode() == HttpURLConnection.HTTP_OK) { // Récupère la réponse InputStream inputstream = urlconnection.getinputstream(); // Cf. String reponse = new Scanner(inputStream).useDelimiter("\\A").next(); // On place le résultat reçu (une chaine json) dans un objet json // (JSONObject) JSONObject objreponse = new JSONObject(reponse); // Cet objet contient un tableau d'objets (un tableau de livraisons) : // on le récupère donc dans un JSONArray JSONArray tabliv = objreponse.getjsonarray("livraison"); // On parcourt chaque élément du JSONArray, autrement dit chaque // "livraison" for (int i = 0; i < tabliv.length(); i++) { // On place l'élément lu (soit une livraison) dans un JSONObject JSONObject objliv = tabliv.getjsonobject(i); // Chaque objet livraison contient // - un élément simple (valeur de type chaine) pour le nom // - un élément de type objet pour l'adresse // - un élément de type tableau d'objets pour les colis // On récupère directement la valeur du nom puisqu'il s'agit d'un // élément simple (dont la valeur est une chaine) Livraison livraison = new Livraison(); livraison.setclient(objliv.getstring("nom")); // L'adresse est un élément de type objet // On le place dans un JSONObject pour accéder à ses éléments JSONObject objadr = objliv.getjsonobject("adresse"); livraison.setadresse( objadr.getstring("rue") + " " + objadr.getstring("codepostal") + " " + objadr.getstring("ville") ); / // La liste des colis est un tableau d'objets. // On la stocke dans un JSONArray pour parcourir ses éléments JSONArray tabcol = objliv.getjsonarray("colis"); Page 9/10

10 / // Pour chaque colis, on récupère sa référence et son montant for (int j = 0; j < tabcol.length(); j++) { JSONObject objcol = tabcol.getjsonobject(j); Colis colis = new Colis(); colis.setreference(objcol.getstring("reference")); colis.setmontant(objcol.getdouble("montant")); livraison.ajoutecolis(colis); liste.add(livraison); return liste; else { erreur = "Code réponse : " + urlconnection.getresponsecode() + " - " + urlconnection.getresponsemessage(); [ ] Page 10/10