Différences

Ci-dessous, les différences entre deux révisions de la page.

--- sio2:projet_depann_tout_2 [2025/01/12 19:18] – [Préparation du travail côté serveur : création d'un service web] dthevenot
+++ sio2:projet_depann_tout_2 [2025/02/09 18:47] (Version actuelle) – [Importation des données avec le module Volley] dthevenot
@@ Ligne 49: / Ligne 49: @@
     - rechercher l'adresse IP de votre poste de travail
     - accéder au navigateur du périphérique Android, et taper la même url que précédemment en remplaçant localhost par l'adresse IP du serveur web.
+<badge>Jalon1 : vous devez voir s'afficher les rdv du jour au format JSON</badge>
+===== Compléter l'application Android DepannTout (Travail côté Client) =====
+Afin de ne pas perdre tout le travail réalisé à cause d'une fausse manipulation, dupliquer  l'application.
+L'auto-entrepreneur va (en cliquant sur un bouton) importer automatiquement les rdv du jour en provenance du serveur. Cette importation va automatiquement mettre à jour les clients (si il y a des rdv avec de nouveaux clients) et les interventions (avec les rdv pris).
+==== Autorisations ====
+Il est nécessaire d'autoriser l'application à accéder à Internet, pour cela, ajouter les lignes suivantes au niveau du fichier **manifests/AndroidManifest.xml**, avant la balise </manifest> :
+<code>
+<!-- Internet Permissions -->
+<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+<uses-permission android:name="android.permission.INTERNET" />
+</code>
+À l'intérieur de la balise <application, avant sa fermeture, ajouter l'attribut :
+<code>
+android:usesCleartextTraffic="true" </code>
+==== Installation de la bibliothèque Volley ====
+La bibliothèque Volley facilite la gestion asynchrone des appels réseaux.https://google.github.io/volley/
+Pour l'intégrer au projet, il faut modifier le fichier **build.gradle.kts (module app)**. Il faut ajouter la  ligne suivante dans les dépendances : **implementation(libs.volley)**
+ <code>
+dependencies {
+    implementation(libs.appcompat)
+    implementation(libs.material)
+    implementation(libs.activity)
+    implementation(libs.constraintlayout)
+    testImplementation(libs.junit)
+    androidTestImplementation(libs.ext.junit)
+    androidTestImplementation(libs.espresso.core)
+    implementation(libs.volley)
+}
+</code>
+==== Création d'une classe Importation ====
+Créer **une nouvelle empty view activity appelée Importation**. Ajouter un titre et un bouton Quitter. Écrire  le code du bouton Quitter. Tester
+Cette classe nous permettra de gérer le transfert de données depuis le serveur. Mettre cette classe au même niveau que les classes xxxActivity.java
+Au niveau de l'activity Main, ajouter le bouton "Importer les rendez-vous", écrire le code correspondant (un clic sur ce bouton lancera l'activité Importation.)
+==== Importation des données avec le module Volley ====
+Reprendre l'activité Importation.
+Créer la méthode importer suivante :
+(NB : remplacer adressIPServeurWeb par l'adresse IP repérée précédemment)
+<code>
+// url de la requête au serveur
+String url = "http://adressIPServeurWeb/ReparTout/getLesRendezVous.php";
+RequestQueue queue = Volley.newRequestQueue(this);
+Log.i("volley-requete","volley1 ok");
+JSONObject jsonObject = null; // objet JSON envoyé au serveur
+//Requête envoyée au serveur
+JsonObjectRequest jsonObjectRequest = new JsonObjectRequest(
+Request.Method.GET,
+ url,
+ jsonObject,
+ new Response.Listener<JSONObject>() {
+ @Override
+ public void onResponse(JSONObject response) {
+ Toast.makeText(getApplicationContext(), "Réponse serveur :  "+response.toString(), Toast.LENGTH_LONG).show();
+ Log.i("volley-requete",response.toString());  }
+ },
+ new Response.ErrorListener() {
+ @Override
+ public void onErrorResponse(VolleyError error) {
+ Toast.makeText(getApplicationContext(), "ça a planté!",  Toast.LENGTH_SHORT).show();
+ Log.e("volley-requete","volley erreur réponse : " +  error.getMessage());
+ }
+ }
+);
+// Add the request to the RequestQueue.
+queue.add(jsonObjectRequest);
+Log.i("volley-requete","fin ok");
+</code>
+**adressIPServeurWeb** est à remplacer par l'adresse IP **10.0.2.2** car le périphérique de l'émulateur Android n'interprète pas le localhost de la machine hôte. 10.0.2.2 est un alias pour accéder à l’hôte local de votre ordinateur à partir d’un émulateur Android.
+Après envoi de la requête au serveur, 2 écouteurs sont créés, ils seront sollicités selon le succès ou l'échec de la requête.
+L'objet RequestQueue gère la file d'attente des requêtes.
+===== Exploitation(partielle) des données importées =====
+<bootnote>l'exploitation ici ne concerne que les données des clients</bootnote>
+Modifier les classes métiers Client et Intervention afin de leur ajouter l'attribut idDistant, qui  représente l'id au niveau de la base de données venant du serveur.
+Dans la classe Importation, créer une nouvelle méthode appelée **integrerLesDonnees**, qui aura  besoin d'un paramètre de type JSONObject.
+Cette méthode va récupérer le fichier json envoyé par le serveur, et recopier les données dans la  collection lesClients dans un premier temps :
+<code>
+ArrayList<Client> lesClients = new ArrayList<Client>();
+try {
+ JSONArray array = new JSONArray(jsonObject.getString("lesRendezVous"));
+ Log.i("httphab", "taille du tableau " + array.length());
+ // Chaque objet JSON devient un objet de type Client, rangé dans  la collection
+ for (int i = 0; i < array.length(); i++) {
+ // On récupère un objet JSON du tableau
+ JSONObject obj = new JSONObject(array.getString(i));
+ // On fait le lien Client - Objet JSON
+ Client unClient = new Client();
+ unClient.setIdDistant(obj.getInt("id"));
+ unClient.setNom(obj.getString("nom"));
+ unClient.setPrenom(obj.getString("prenom"));
+ unVlient.setAdresse(obj.getString("adresse"));
+ // …
+ Log.i("httphab", "unClient " + unClient.toString());
+ // On ajoute unClient à la liste
+ lesClients.add(unClient);
+ }
+} catch (JSONException e) {
+ Log.e("volley erreur", "*** JSONException, integrerLesDonnees ***" );  e.printStackTrace();
+}
+Toast.makeText(getApplicationContext(), "Nb clients transférés : " +  lesClients.size(), Toast.LENGTH_SHORT).show();
+</code>
+===== Afficher les données récupérées =====
+Afficher les données dans une listView comme la liste des articles du projet Inventaire :
+  - Ajouter une LinearLayout, avec 3 TextView pour les intitulés de colonnes (id, nom et  prénom), puis ajouter une ListView pour la liste des clients.
+  - Créer une Layout (ligne_client par exemple) avec une LinearLayout comprenant 3  TextView.
+  - Pour afficher les clients, on pourra utiliser la classe SimpleAdapter
+Extrait du constructeur
+(cf https://developer.android.com/reference/android/widget/SimpleAdapter.html )
+Les données à afficher doivent être dans une List de Maps. Il faudra donc reformater notre collection  lesClients :
+<code>
+ArrayList<HashMap<String,String>> lesClientsHM = new
+ArrayList<>();
+For (Client unClient : lesClients) {
+  HashMap<String,String> hashMap=new HashMap<>();//creation  d'une map
+  hashMap.put("id",Integer.toString(unClient.getId()));
+  hashMap.put("nom",unClient.getNom());
+  hashMap.put("prenom",unClient.getPrenom());
+  lesClientsHM.add(hashMap);//ajout dans la collection
+}
+</code>
+L'affichage se fera ensuite ainsi :
+<code>
+ListAdapter adapter = new SimpleAdapter(
+   ListeClientsActivity.this, lesClientsHM,
+   R.layout.ligne_Client, //
+   new String[] { "id", "nom" , "prenom"},
+   new int[] { R.id.tvIdC, R.id.tvNomC, R.id.tvPrenomC });
+// maj listview de activity_liste_Clients
+ListView lvHab = (ListView) findViewById(R.id.lvHab) ;
+lvHab.setAdapter(adapter);
+</code>
+Les clients seront ensuite à intégrer dans la base de données SQLite s'ils n'existaient pas déjà. Ajouter le même traitement pour les interventions.
+<badge>Fonctionnalités à développer, à montrer et projet à déposer sur gitea(commit à chaque niveau qui fonctionne) :
+  * **niveau 1**(5 points) : affichage des clients concernés par les rdv du jour
+  * **niveau 2**(10 points) : mise à jour des clients dans la base de données côté client(android) - contrôle avec l'affichage des clients
+  * **niveau 3**(15 points) : traitement des rdv avec mise à jour des interventions dans la base de données côté client(android) - contrôle avec l'affichage des interventions
+  * **niveau 4**(20 points) : exportation des interventions sur le serveur(éventuellement nouvelles ou modifiées)
+</badge>