Le Tutoriel de Android Service

View more categories:

1- Les types de services sur Android

Qu'est-ce que le service?
Un service est un composant qui s'exécute en arrière-plan pour effectuer des opérations de longue durée sans avoir à interagir avec l'utilisateur et il fonctionne même si l'application est détruite. Un service peut essentiellement prendre deux états.
État Description

Started

(Démarré)
Un service est started (démarre) lorsqu'un composant d'application, tel qu'une Activity, démarre en appelant startService(). Une fois démarré, un service peut s'exécuter en arrière-plan indéfiniment, même si le composant qui l'a démarré, est détruit.

Ce service est également connu sous le nom  un service illimité (Un Bounded Service).

Bound

(Relié)
Un service est bound (relié) lorsqu'un composant d'application se lie à celui- ci appelant bindService(). Un service relié offre une interface client-serveur qui permet aux composants d'interagir avec le service, d'envoyer des requêtes, d'obtenir des résultats et même de les faire dans tous des processus avec communication interprocessus (IPC).
En informatique, l' inter-processus communication  (IPC) est l'activité de partage de données sur des processus multiples et généralement spécialisés utilisant des protocoles de communication. En règle générale, les applications utilisant IPC sont classées en tant que des clients et des serveurs, où le client demande des données et le serveur répond aux demandes des clients.
Un service a des méthodes de rappel de cycle de vie (life cycle callback methods) que vous pouvez mettre en oeuvre (implement) pour surveiller les changements dans l'état du service et vous pouvez effectuer un travail au stade approprié. Le diagramme suivant à gauche montre le cycle de vie lorsque le service est créé avec startService() et le diagramme de droite montre le cycle de vie lorsque le service est créé avec bindService().
Pour créer un service, vous créez une classe Java qui étend la classe de Base de service ou l'une de ses sous-classes existantes. La classe de base du service définit diverrses méthodes de rappel et les plus importantes sont données ci-dessous. Vous n'avez pas besoin de mettre en œuvre (implements) toutes les méthodes de rappel. Cependant, il est important que vous compreniez chacun et mettez en œuvre ceux qui garantissent que votre application se comporte de la façon dont les utilisateurs attendent.
En outre, il existe un autre service appelé IntentService. IntentService est utilisé pour effectuer une tâche unique, c'est-à-dire lorsque la tâche complète le service se détruit.
Comparaison des services:
Unbound Service
(Service non relié)
Bound Service
(Relié)
Intent 
Service
Unbounded Service est utilisé pour effectuer une longue tâche répétitive. Bounded Service est utilisé pour effectuer une tâche de'n arrière- plan (background) en liaison avec un autre composant. Intent Service est utilisé pour effectuer une tâche unique, c'est-à-dire lorsque la tâche complète le service se détruit.

Unbound Service démarre en appelant startService().

Bounded Service démarre en appelant bindService().
Intent Service démarre en appelant startService().

Unbound Service est arrêté ou détruit explicitement en appelant stopService().
Bounded Service est déconnecté ou détruit en appelant unbindService(). IntentService appelle implicitement la méthode stopself() pour détruire

Unbound Service est indépendant du composant dans lequel il est démarré
Bound Service est dépendant du composant dans lequel il est démarré. Intent Service est indépendant du composant dans lequel il est démarré.
Les méthode de rappel et la description:
Callback Description
onStartCommand() The system calls this method when another component, such as an activity, requests that the service be started, by calling startService(). If you implement this method, it is your responsibility to stop the service when its work is done, by calling stopSelf() or stopService() methods.
onBind() The system calls this method when another component wants to bind with the service by calling bindService(). If you implement this method, you must provide an interface that clients use to communicate with the service, by returning an IBinder object. You must always implement this method, but if you don't want to allow binding, then you should return null.
onUnbind() The system calls this method when all clients have disconnected from a particular interface published by the service.
onRebind() The system calls this method when new clients have connected to the service, after it had previously been notified that all had disconnected in its onUnbind(Intent).
onCreate() The system calls this method when the service is first created using onStartCommand() or onBind(). This call is required to perform one-time set-up.
onDestroy() The system calls this method when the service is no longer used and is being destroyed. Your service should implement this to clean up any resources such as threads, registered listeners, receivers, etc.

2- Service illimité (Un bounded Service)

Unbound Service (ou Started Service): Dans ce cas, un composant d'application démarre le service en appelant startService (), et il continuera à s'exécuter en arrière-plan, même si le composant d'origine qui l'a déclenché est détruit. Par exemple, au démarrage, un service continuerait de jouer de la musique en arrière-plan indéfiniment.
La méthode  onStartCommand() renvoie le type  integer, et il est une des valeurs ci- dessous:
  • START_STICKY
  • START_NOT_STICKY
  • TART_REDELIVER_INTENT

START_STICKY & START_NOT_STICKY

  • Les deux valeurs ne sont pertinentes que lorsque le téléphone manque de mémoire et tue le service avant qu'il ne soit terminé.
  • START_STICKY indique au système d'exploitation de recréer le service après avoir suffisamment de mémoire et d'appeler onStartCommand() encore avec une Intent nulle.
  • START_NOT_STICKY indique à l'OS de ne plus déranger de recréer le service.
Il y a encore le troisième code  START_REDELIVER_INTENT qui indique au système d'exploitation de récréer des services et redélivrer un pareil  Intent pour  onStartCommand().
Exemple de la lecture de la musique (Exécuter en arrière- plan)
Créez un nouveau projet  "Empty Activity" baptisé  PlaySongService
Le projet est créé.
Faites glisser et déposez des 2 boutons sur l'écran.
Double-cliquez sur les boutons pour changer l' ID et le texte pour les boutons.
Button 1:
  • ID: button_play
  • Text: Play
  • Properties
    • onClick: playSong

Button 2:
  • ID: button_stop
  • Text: Stop
  • Properties
    • onClick: stopSong
activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
    android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity">

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Play"
        android:id="@+id/button_play"
        android:layout_alignParentTop="true"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="129dp"
        android:onClick="playSong" />

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Stop"
        android:id="@+id/button_stop"
        android:layout_centerVertical="true"
        android:layout_centerHorizontal="true"
        android:onClick="stopSong" />
</RelativeLayout>
Préparez le fichier mp3:
Cliquez sur le bouton droit sur le dossier  res et sélectionnez:
  • New/Android resource directory
Copier et Coller un fichier de la musique mp3 dans le dossier  'raw' que vous venez de créer.

Créer une classe de service

Cliquez sur le bouton droit sur un paquet Java, sélectionnez:
  • New/Service/Service
Saisissez le nom de la classe:
  • PlaySongService
PlaySongService.java
package org.o7planning.playsongservice;

import android.app.Service;
import android.content.Intent;
import android.media.MediaPlayer;
import android.os.IBinder;

public class PlaySongService extends Service {

   private MediaPlayer mediaPlayer;

   public PlaySongService() {
   }


   @Override
   public IBinder onBind(Intent intent){
       // This service is unbounded
       // So this method is never called.
       return null;
   }


   @Override
   public void onCreate(){
       super.onCreate();
       // Create MediaPlayer object, to play your song.
       mediaPlayer = MediaPlayer.create(getApplicationContext(), R.raw.mysong);
   }

   @Override
   public int onStartCommand(Intent intent, int flags, int startId){
       // Play song.
       mediaPlayer.start();

       return START_STICKY;
   }

   // Destroy
   @Override
   public void onDestroy() {
       // Release the resources
       mediaPlayer.release();
       super.onDestroy();
   }
}
MainActivity.java
package org.o7planning.playsongservice;

import android.content.Intent;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;

public class MainActivity extends AppCompatActivity {

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);
   }

   // This method is called when users click on the Start button.
   public void playSong(View view)  {
       // Create Intent object for PlaySongService.
       Intent myIntent = new Intent(MainActivity.this, PlaySongService.class);

       // Call startService with Intent parameter.
       this.startService(myIntent);
   }

   // This method is called when users click on the Stop button.
   public void stopSong(View view)  {

       // Create Intent object
       Intent myIntent = new Intent(MainActivity.this, PlaySongService.class);
       this.stopService(myIntent);
   }



}
C'est OK, vous pouvez exécuter votre application et profiter de la chanson.

3- Service délimité (Bounded Service)

Ci-après, je simule un service qui fournit des informations météorologiques la journée en cours, avec l'entrée géographique (Hanoi, Chicago, ...), le résultat retourné est pluvieux, ensoleillé ...
Créez un projet nommé  WeatherService.
Glissez et déplacez quelques  Widget sur l'écran.
En double-cliquant sur le widget, vous pouvez définir le texte et l' ID pour cela:
TextView 1:
  • ID: text_location
  • Text: Location
TextView 2:
  • ID: text_weather
  • Text: <Weather>
Button:
  • ID: button_weather
  • Text: How is the Weather today?
Définissez l' ID et le texte pour l'objet EditText:
EditText
  • ID: text_input_location
  • Text: Hanoi
Properties
  • layout:width: fill_parent
  • gravity
    • center: checked
Définissez l'attribut onClick pour le bouton est showWeather, celàsignifie que lorsque vous cliquez sur le bouton, la méthode showWeather sera appelée. Nous rédigerons ci-après cette méthode.
Créez Service:
Cliquez sur le bouton droit à un   java package et sélectionnez:
  • New/Service/Service
Saisissez:
  • Class name: WeatherService
La classe WeatherService qui est étendue à partir de la classe android.app.Service a été créée.
WeatherService.java
package org.o7planning.weatherservice;

import android.app.Service;
import android.content.Intent;
import android.os.Binder;
import android.os.IBinder;
import android.util.Log;


import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;
import java.util.Random;


public class WeatherService extends Service {

   private static String LOG_TAG = "WeatherService";

   // Store the weather data.
   private static final Map<String, String> weatherData = new HashMap<String,String>();

   private final IBinder binder = new LocalWeatherBinder();

   public class LocalWeatherBinder extends Binder {

       public WeatherService getService()  {
           return WeatherService.this;
       }
   }

   public WeatherService() {
   }

   @Override
   public IBinder onBind(Intent intent) {
       Log.i(LOG_TAG,"onBind");
       return this.binder;
   }

   @Override
   public void onRebind(Intent intent) {
       Log.i(LOG_TAG, "onRebind");
       super.onRebind(intent);
   }

   @Override
   public boolean onUnbind(Intent intent) {
       Log.i(LOG_TAG, "onUnbind");
       return true;
   }

   @Override
   public void onDestroy() {
       super.onDestroy();
       Log.i(LOG_TAG, "onDestroy");
   }

   // Returns the weather information corresponding to the location of the current date.
   public String getWeatherToday(String location) {
       Date now= new Date();
       DateFormat df= new SimpleDateFormat("dd-MM-yyyy");

       String dayString = df.format(now);
       String keyLocAndDay = location + "$"+ dayString;

       String weather=  weatherData.get(keyLocAndDay);
       //
       if(weather != null)  {
           return weather;
       }

       //
       String[] weathers = new String[]{"Rainy", "Hot", "Cool", "Warm" ,"Snowy"};

       // Random value from 0 to 4
       int i= new Random().nextInt(5);

       weather =weathers[i];
       weatherData.put(keyLocAndDay, weather);
       //
       return weather;
   }



}
MainActivity.java
package org.o7planning.weatherservice;

import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.ServiceConnection;
import android.os.IBinder;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.EditText;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {


   private boolean binded=false;
   private WeatherService weatherService;

   private TextView weatherText;
   private EditText locationText;

   ServiceConnection weatherServiceConnection = new ServiceConnection() {

       @Override
       public void onServiceConnected(ComponentName name, IBinder service) {
           WeatherService.LocalWeatherBinder binder = (WeatherService.LocalWeatherBinder) service;
           weatherService = binder.getService();
           binded = true;
       }

       @Override
       public void onServiceDisconnected(ComponentName name) {
           binded = false;
       }
   };

   // When the Activity creating its interface.
   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);


       weatherText = (TextView) this.findViewById(R.id.text_weather);
       locationText = (EditText)this.findViewById(R.id.text_input_location);
   }

   // When Activity starting.
   @Override
   protected void onStart() {
       super.onStart();

       // Create Intent object for WeatherService.
       Intent intent = new Intent(this, WeatherService.class);

       // Call bindService(..) method to bind service with UI.
       this.bindService(intent, weatherServiceConnection, Context.BIND_AUTO_CREATE);
   }

   // Activity stop
   @Override
   protected void onStop() {
       super.onStop();
       if (binded) {
           // Unbind Service
           this.unbindService(weatherServiceConnection);
           binded = false;
       }
   }

   // When user click on 'see weather' button.
   public void showWeather(View view)  {
       String location = locationText.getText().toString();

       String weather= this.weatherService.getWeatherToday(location);

       weatherText.setText(weather);
   }

}
OK, maintenant vous pouvez exécuter l'application.

4- Service IntentService

Exemple IntentService:
L'image ci-dessous illustre la communication entre Client ( Activity) et IntentService. Le client démarre le service, il envoie une demande via un objet Intent, le service est exécuté et accomplit ses tâches, en même temps, il peut envoyer des informations relatives à sa situation de travail. Par exemple, combien de pourcentage fonctionne-t-il. Au client, vous pouvez utiliser ProgressBar pour afficher le pourcentage de travail.
Créez un nouveau projet  SimpleIntentService.
Faites glisser et déposez certains des composants vers l'interface utilisateur:
Double-cliquez sur ProgressBar pour changer l' ID et ses valeurs.
Définissez l' ID et le  Text pour des composants sur des interfaces.
ProgressBar:
  • ID: progressBar
  • Properties:
    • layout:width: fill_parent

TextView
  • ID: text_percel
  • Text: <Percel>

Button 1
  • ID: button_start
  • Text: Start
  • Properties
    • onClick: startButtonClicked
Button 2
  • ID: button_stop
  • Text: Stop
  • Properties
    • onClick: stopButtonClicked
Définissez la méthode qui sera appelée lorsque l'utilisateur clique sur le bouton  Start.
activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
   android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity">

   <ProgressBar
       style="?android:attr/progressBarStyleHorizontal"
       android:layout_width="fill_parent"
       android:layout_height="wrap_content"
       android:id="@+id/progressBar"
       android:layout_alignParentTop="true"
       android:layout_centerHorizontal="true"
       android:layout_marginTop="66dp"
       android:indeterminate="false"
       android:max="100"
       android:progress="0" />

   <TextView
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:textAppearance="?android:attr/textAppearanceLarge"
       android:text="&lt;Percel>"
       android:id="@+id/text_percel"
       android:layout_below="@+id/progressBar"
       android:layout_centerHorizontal="true"
       android:layout_marginTop="40dp" />

   <Button
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:text="Start"
       android:id="@+id/button_start"
       android:layout_centerVertical="true"
       android:layout_centerHorizontal="true"
       android:onClick="startButtonClicked" />

   <Button
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:text="Stop"
       android:id="@+id/button_stop"
       android:layout_below="@+id/button_start"
       android:layout_centerHorizontal="true"
       android:layout_marginTop="47dp"
       android:onClick="stopButtonClicked" />
   
</RelativeLayout>
Créez un IntentService en cliquant sur le bouton droit d' un package et sélectionnez:
  • New/Service/IntentService
La classe SimpleIntentService a été créée, elle est également enregistrée avec AndroidManifest.xml, le code généré est une suggestion pour que vous puissiez écrire un IntentService, vous pouvez effacer le code généré.
SimpleIntentService.java
package org.o7planning.simpleintentservice;

import android.app.IntentService;
import android.content.Intent;
import android.os.SystemClock;


public class SimpleIntentService extends IntentService {

   public static final String ACTION_1 ="MY_ACTION_1";

   public SimpleIntentService() {
       super("SimpleIntentService");
   }

   @Override
   protected void onHandleIntent(Intent intent) {

       // Create Intent object (to broadcast).
       Intent broadcastIntent = new Intent();

       // Set Action name for this Intent.
       // A Intent can perform many different actions.
       broadcastIntent.setAction(SimpleIntentService.ACTION_1);

       // Loop 100 times broadcast of Intent.
       for (int i = 0; i <= 100; i++) {

           // Set data
           // (Percent of work)
           broadcastIntent.putExtra("percel", i);

           // Send broadcast
           sendBroadcast(broadcastIntent);

           // Sleep 100 Milliseconds.
           SystemClock.sleep(100);
       }

   }
}
MainActivity.java
package org.o7planning.simpleintentservice;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.os.AsyncTask;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.ProgressBar;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

   private Button startButton;
   private Button stopButton;
   private TextView percelText;

   private ProgressBar progressBar;

   private Intent serviceIntent;

   private ResponseReceiver receiver = new ResponseReceiver();


   // Broadcast component
   public class ResponseReceiver extends BroadcastReceiver {

       // on broadcast received
       @Override
       public void onReceive(Context context, Intent intent) {

           // Check action name.
           if(intent.getAction().equals(SimpleIntentService.ACTION_1)) {
               int value = intent.getIntExtra("percel", -1);

               new ShowProgressBarTask().execute(value);
           }
       }
   }

   // Display value for the ProgressBar.
   class ShowProgressBarTask extends AsyncTask<Integer, Integer, Integer> {

       @Override
       protected Integer doInBackground(Integer... args) {

           return args[0];
       }

       @Override
       protected void onPostExecute(Integer result) {
           super.onPostExecute(result);

           progressBar.setProgress(result);

           percelText.setText(result + " % Loaded");

           if (result == 100) {
               percelText.setText("Completed");
               startButton.setEnabled(true);
           }

       }
   }

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);

       this.startButton= (Button) this.findViewById(R.id.button_start);
       this.stopButton = (Button)this.findViewById(R.id.button_stop);
       this.percelText = (TextView) this.findViewById(R.id.text_percel);
       this.progressBar = (ProgressBar) this.findViewById(R.id.progressBar);
   }


   @Override
   protected void onResume() {
       super.onResume();

       // Register receiver with Activity.
       registerReceiver(receiver, new IntentFilter(
               SimpleIntentService.ACTION_1));
   }

   @Override
   protected void onStop() {
       super.onStop();

       // Unregister receiver with Activity.
       unregisterReceiver(receiver);
   }

   // Method is called when the user clicks on the Start button.
   public void startButtonClicked(View view)  {
       startButton.setEnabled(false);
 
       serviceIntent = new Intent(this, SimpleIntentService.class);

       startService(serviceIntent);
   }


   public void stopButtonClicked(View view)  {
       if(serviceIntent!= null)  {
           // serviceIntent.get
       }
   }

}
  • Exécutez l'application (Voir slider):
Et vous pouvez voir le principe de fonctionnement de cet exemple selon l'illustration ci-dessous:

View more categories: