<!-- If the browser does not support frames put the first topic content here --> <div class="WordSection1"> <p class="MsoNormal" align="center" style= 'margin-top:3.0pt;text-align:center'><b><span style= 'font-size:26.0pt'>Les AsyncTask</span></b></p> <p class="MsoNormal"> </p> <p style= 'margin-top:0cm;margin-right:0cm;margin-bottom:6.0pt;margin-left:0cm'> Une <strong>AsyncTask</strong> permet de réaliser des tâches de manière asynchrone (en arrière plan). L’avantage de l’AsyncTask est sa simplicité d’utilisation et d’implémentation.<br /> Le Thread (processus) secondaire est créé automatiquement et la communication entre les différents Thread est simplifiée.</p> <p style='margin:0cm;margin-bottom:.0001pt'>Lors du développement d’une application, à fortiori sous Android car les appareils fonctionnant sous cet environnement sont souvent "légers", toutes les tâches consommatrices de ressources (requêtes http (donc consommation de webservice), calculs lourds, …) doivent se faire dans un Thread séparé. Sinon, le système affiche un message d’erreur et ferme l’application lorsque le Thread principal (appelé <strong>UI Thread</strong>) est bloqué trop longtemps.</p> <p align="center" style='text-align:center'><a href= "http://www.tutos-android.com/wp-content/uploads/2012/03/anr.png"><span style='text-decoration:none'> <img border="0" width="249" height="169" src= "2bis_Les_AsyncTask_fichiers/image001.gif" alt= "image" /></span></a></p> <h2 style= 'margin-top:9.0pt;margin-right:0cm;margin-bottom:6.0pt;margin-left: 0cm'> <a name="node0" id="node0"></a><strong>Mise en place du projet</strong></h2> <p style= 'margin-top:0cm;margin-right:0cm;margin-bottom:6.0pt;margin-left:0cm'> Illustration à partir d'un projet Android appelé <em><b>AsyncBigCalcul</b></em> qui effectue un traitement long de manière asynchrone. En fait, une énorme boucle.<br /> Premièrement, modification du layout <strong>main.xml</strong> en modifiant le contenu du TextView initial ("Progression de la tâche asynchrone" au lieu de "Hello World") et en ajoutant un Button et une ProgressBar. Le premier servira à lancer le traitement ; la seconde à afficher la progression du traitement. Voici le code XML généré, après modification :</p> <pre> <?xml version="1.0" encoding="utf-8"?> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_width="fill_parent"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_height="fill_parent"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:orientation="vertical" ></span> </pre> <pre> <span lang="EN-GB" style='font-size:5.0pt' xml:lang= "EN-GB"> </span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> <Button</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_marginTop="10dp"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:id="@+id/btnLaunch"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_width="wrap_content"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_height="wrap_content"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_gravity="center_horizontal"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> </span>android:text="Lancer la tâche" /> </pre> <pre> <span style='font-size:5.0pt'> </span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"><TextView </span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_width="wrap_content"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_height="wrap_content"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> </span>android:layout_gravity="center" </pre> <pre> android:text="Progression de la tâche asynchrone:" /> </pre> <pre> <span style='font-size:5.0pt'> </span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"><ProgressBar</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:id="@+id/pBAsync"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> style="?android:attr/progressBarStyleHorizontal"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_width="fill_parent"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_margin="10dp"</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> android:layout_height="wrap_content" /> </span> </pre> <pre> </LinearLayout> </pre> <b><span style= 'font-size:18.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <h2><a name="node1" id="node1"></a><strong>L’activité principale</strong></h2> <pre> Comme habituellement, on récupère les composants définis dans le layout puis on ajoute un écouteur (listener) sur le bouton afin qu’à chaque clic on exécute une nouvelle instance de BigCalcul qui est la classe asynchrone (exécutée en tâche de fond donc). </pre> <pre> import android.app.Activity; </pre> <pre> import android.os.AsyncTask; </pre> <pre> import android.os.Bundle; </pre> <pre> import android.view.View; </pre> <pre> import android.view.View.OnClickListener; </pre> <pre> import android.widget.Button; </pre> <pre> import android.widget.ProgressBar; </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB">import android.widget.Toast;</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB">public class AsyncBigCalculActivity extends Activity</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB">{</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> private ProgressBar mProgressBar;</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> private Button mButton;</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> </span>/** Appelé quand l'activité est créée */ </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB">@Override</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> public void onCreate(Bundle savedInstanceState)</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> {</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> super.onCreate(savedInstanceState);</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> setContentView(R.layout.main);</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> </span>// On récupère les composants du layout </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB">mProgressBar = (ProgressBar) findViewById(R.id.pBAsync);</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> mButton = (Button) findViewById(R.id.btnLaunch);</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> </span>// On met un écouteur sur le bouton </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB">mButton.setOnClickListener(new OnClickListener()</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> {</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> @Override</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> public void onClick(View arg0)</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> {</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> BigCalcul calcul=new BigCalcul();</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> calcul.execute();</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span>} </pre> <pre> }); </pre> <pre> } </pre> <pre> } </pre> <strong><span style='font-size:18.0pt'><br clear="all" style= 'page-break-before:always' /></span></strong> <h2><a name="node2" id="node2"></a><strong>La classe BigCalcul (classe asynchrone)</strong></h2> <p>La classe asynchrone BigCalcul hérite impérativement d’<i>AsyncTask</i>. Elle est ici en classe privée mais elle aurait pu être écrite à part. Seule la méthode <i>doInBackGround</i> doit être obligatoirement redéfinie :</p> <pre> <span lang="EN-GB" xml:lang= "EN-GB">private class BigCalcul extends AsyncTask<Void, Integer, Void></span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB">{</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> @Override</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> protected void onPreExecute()</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> {</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> super.onPreExecute();</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> </span>Toast.makeText(getApplicationContext(), "Début du traitement asynchrone", Toast.LENGTH_LONG).show(); </pre> <pre> } </pre> <pre> </pre> <pre> @Override </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB">protected void onProgressUpdate(Integer... values)</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> {</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> </span>super.onProgressUpdate(values); </pre> <pre> // Mise à jour de la ProgressBar </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB">mProgressBar.setProgress(values[0]);</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> }</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> @Override</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> protected Void doInBackground(Void... arg0)</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> {</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> int progress;</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> for (progress=0;progress<=100;progress++)</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span>{ </pre> <pre> for (int i=0; i<1000000; i++){} </pre> <pre> //la méthode publishProgress met à jour l'interface en invoquant la méthode onProgressUpdate </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB">publishProgress(progress);</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> progress++; </span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> } </span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> return null;</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> }</span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> </span> </pre> <pre> <span lang="EN-GB" xml:lang="EN-GB"> @Override</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> protected void onPostExecute(Void result) {</span> </pre> <pre> <span lang="EN-GB" xml:lang= "EN-GB"> </span>Toast.makeText(getApplicationContext(), "Le traitement asynchrone est terminé", Toast.LENGTH_LONG).show(); </pre> <pre> } </pre> <pre> } </pre> <p><strong><u>Explications :</u></strong><br /> Les trois paramètres attendus lors de la déclaration sont des types génériques :</p> <p class="MsoNormal" style= 'margin-right:-5.5pt;margin-left:27.0pt;text-indent: -9.0pt'> <span style='font-size:10.0pt;font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Le 1<sup>er</sup> est le type des paramètres fournis à la tâche (ici aucun paramètre transmis <span style= 'font-family:Wingdings'>è</span> Void)</p> <p class="MsoNormal" style= 'margin-right:-5.5pt;margin-left:27.0pt;text-indent: -9.0pt'> <span style='font-size:10.0pt;font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Le 2<sup>nd</sup> est le type de données transmises durant la progression du traitement (ici int)</p> <p class="MsoNormal" style= 'margin-right:-5.5pt;margin-left:27.0pt;text-indent: -9.0pt'> <span style='font-size:10.0pt;font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Enfin le troisième est le type du résultat de la tâche (ici aucun résultat transmis <span style='font-family:Wingdings'>è</span> Void)</p> <p>Une AsyncTask doit obligatoirement implémenter la méthode <strong>doInBackground</strong>. C’est elle qui réalisera le traitement de manière asynchrone dans un Thread séparé. Les méthodes <strong>onPreExecute</strong> (appelée avant le traitement), <strong>onProgressUpdate</strong> (appelée lorsque vous souhaitez afficher sa progression) et <strong>onPostExecute</strong> (appelée après le traitement) sont optionnelles. Un appel à la méthode <strong>publishProgress</strong> permet la mise à jour de la progression. On ne peut pas appeler la méthode onProgressUpdate directement.</p> <p><strong><u>NOTE</u></strong>: Attention, ces trois méthodes (onPreExecute, onProgressUpdate et onPostExecute) s’exécutent depuis l’<strong>UI Thread</strong> ! C’est d’ailleurs grâce à cela qu’elles peuvent modifier l’interface. On ne doit donc pas y effectuer de traitements lourds.</p> <p>Ce qui donnera :<br /> <a href= "http://www.tutos-android.com/wp-content/uploads/2012/03/img_start.png"> <span style='text-decoration:none'><img border="0" width="96" height="96" src="2bis_Les_AsyncTask_fichiers/image002.gif" alt= "image" /></span></a></p> <p><a href= "http://www.tutos-android.com/wp-content/uploads/2012/03/img_progress.png"> <span style='text-decoration:none'><img border="0" width="96" height="96" src="2bis_Les_AsyncTask_fichiers/image003.gif" alt= "image" /></span></a></p> <p><a href= "http://www.tutos-android.com/wp-content/uploads/2012/03/img_end.png"> <span style='text-decoration:none'><img border="0" width="96" height="96" src="2bis_Les_AsyncTask_fichiers/image004.gif" alt= "image" /></span></a></p> </div>
Table des matières
Sujets
Recherche
Mise en place du projet
L’activité principale
La classe BigCalcul (classe asynchrone)
La classe BigCalcul (classe asynchrone)
L’activité principale
Mise en place du projet
Générée avec
chmProcessor
Générée avec
chmProcessor