Die Anleitung zu Android Services

1- Die Services im Android

Was ist die Dienstleistung?

Eine Dienstleistung (Service) ist eine auf dem Betriebsystem implizite laufende Teil um die langfristigen Aktionen ohne die Interaktion mi dem Benutzer durchzuführen und sie funktioniert auch wenn die Applikation zerstört wird. Eine grundlegende Dienstleistung können 2 Typen haben 
Status Die Bezeichnung

Started

(gestartet)
Eine Dienstleistung wird started (gestartet) genannt wenn ein Teil von der Applikation, zum Beispiel Activity startet sie durch die Aufruf auf startService(). Bei der Aufruf kann die Dienstleistung in dem Modus von Hintergrund unbefristet laufen, sogar auch wenn der Teil, der sie gestartet hat, zerstört wird

Die Dienstleistung wird die unbegrenzte Dienstleistung  (Un Bounded Service).

Bound

(begrenzt)
Ein Diensleitung ist begrenzt (bound) wenn ein Teil der Applikation sie durch die Aufruf von bindService()  begrenzt (bound)
Eine begrenzte Dienstleistung bietet eine Interface client-server zur Interaktion mit der Dienstleistung, die Sendung der Anforderungen oder die Aufnahme des Ergebnisse und sogar Laufen durch vielen Prozessen mit Interprocess communication (IPC) 
In der Computerwissenschaft ist inter-process communication (IPC) eine Aktion zum spezifischen Daten-Austausch durch vielen Prozessen, die normaleweise die Kommunikation benutz. Gegenständlich verwendet die Applikation getrennte IPC wie clients and servers. Wenn die Clients die Daten fordert, befriedigt der Server die Anforderung vom Client.
life cycle callback methods implementieren Sie um die Änderungen der Status von Dienstleistung zu verfolgen und Sie können die Aufgabe in der angemessenen Phrase durchführen.  das linke folgende Schema zeigt dass, der Lebenkreis (life-circle) wird durch startService() erstellt und das rechte bezeichnet, der Lebenkreis der Dienstleistung wird durch   bindService() erstellt  
Um eine Dienstleitung zu erstellen sollen Sie eine Java Klasse erstellen ,die die Klasse Service oder einer der Sub-Klasse erweitern. Die Klasse  Service definiert die unterschiedlichen und meist wichtigen Methode von Callback wie folgend. Sie sollen alle Callbacks-Methode nicht implementieren. Aber es ist wichtig wenn Sie die Aufgabe jeder Methode verstehen. Und stellen Sie sicher, Ihre Applikation befriedigt den Benutzer 
Außer 2 obengemeinten Dienstleistungen gibt es eine andere, die sogenannte IntentService. Intent Service wird benutzt, eine Aufgabe nur einzige Mal durchzuführen, d.h bei der Erledigung der Aufgabe ist die Dienstleitung beendet
Der Vergleich von den Dienstleistungen:
Unbound Service
(unbegrenzt)
Bound Service
(begrenzt)
Intent 
Service
Unbounded Service wird benutzt um die Aufgabe langfristig und wiederholt durchzuführen Bounded Service wird benutzt um die Aufgabe im Hintergrund (background) und bindend mit der Element von Interface durchzuführen Intent Service wird benutzt um die Aufgabe nur einmal durchzuführen. d.h bei der Aufgabeerledigung wird die Dienstleistung selbst zerstört.
Unbound Service wird durch die Aufruf auf startService().gestartet. Bounded Service wird durch die Aufruf auf bindService().gestartet Intent Service wird durch die Aufruf auf startService().gestartet
Unbound Service wird durch die explizite Aufruf auf die Methode stopService().gestoppt oder zerstört Bounded Service wird durch die Aufruf auf unbindService() losgebindet IntentService wird durch die implizite Aufruf auf die Methode stopself() beendet
Unbound Service ist unabhängig von der Elemente, die sie gestartet hat Bound Service ist abhängig von der Elemente, die sie gestartet hat Intent Service ist unabhängig von der Elemente, die sie gestartet hat
Die Methode Callback und die Bezeichnung
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- Die unzwanghaften Dienstleistungen  (Un bounded Service)

Unbound Service (Oder Started Service sogenannt): In diesem Situation startet ein Teil der Applikation die Dienstleistung durch die Aufruf auf startService(), und die Dienstleistung wird weiter in dem Hintergrund (background) laufen, auch wenn die Erstellungselemente zerstört werden. z. B bei dem Starten wird eine Dienstleistung die Musik im Hintergrund unbefristet weiter spielen 
Die Methode  onStartCommand() gibt das Typ  integer rück und sie sind einer der folgenden Werte
  • START_STICKY
  • START_NOT_STICKY
  • TART_REDELIVER_INTENT

START_STICKY & START_NOT_STICKY

  • Die beiden Werte sind angemessen nur wenn der Speicher des Handy voll ist 
  • START_STICKY informiert dem Betriebssystem um die Dienstleistung nach dem genugen Speicher zu erstellen und auf onStartCommand() noch einmal mit einem Intent null aufzurufen.
  • START_NOT_STICKY informiert dem Betriebssystem um sich um die Erstellung der Dienstleistung noch einmal zu kümmern
Außerdem gibt es ein START_REDELIVER_INTENT. Das ist ein dritte Wert, die dem Betriebssystem zur Erstellung der Dienstleistung und Sendung eines ähnlichen Intent für  onStartCommand().informiert

Das Beispiel über die Dienstleistung für das Musik Spielen 

Erstellen Sie ein  "Empty Activity" Projekt mit dem Name von  PlaySongService
Das Projekt wird erstellt
Ziehen und legen Sie 2 Button in den Bildschirm ab
Doppelklicken Sie auf den Button um ID und  text für die Button zu ändern
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>

Bereiten Sie die Musik File mp3 vor:

Drücken Sie die Rechtmaustaste auf dem Ordner  res und wählen Sie:
  • New/Android resource directory
Eine Musik-File Mp3 in den Verzeichnis 'raw', den Sie erstellt haben, kopieren und aufkleben

Die Klasse Service erstellen

Drücken Sie die Rechtmaustaste auf einer Java package, und wählen Sie:
  • New/Service/Service
den Name der Klasse eingeben
  • 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);
   }



}
OK jetzt können Sie Ihre Applikation starten und das Lied hören

3- Die verbindeten Dienstleistungen (Bouned Service)

Hier emuliere ich eine Dienstleistung für die Versorgung der Wetterinformation für den momentanen Tag, der Input is die geographischen Position (Hanoi, Chicago, ...),und der Output ist der Regen, Sonnen....
Erstellen Sie ein Projekt mit dem Name von  WeatherService.
einige   Widget in dem Bildschirm ziehen und ablegen
Durch das Doppelklick auf die Widget können Sie text und  ID für die widget setzen
TextView 1:
  • ID: text_location
  • Text: Location
TextView 2:
  • ID: text_weather
  • Text: <Weather>
Button:
  • ID: button_weather
  • Text: How is the Weather today?
Setzen Sie ID und die Attribute für das Objekt  EditText:
EditText
  • ID: text_input_location
  • Text: Hanoi
Properties
  • layout:width: fill_parent
  • gravity
    • center: checked
Setzen Sie das Attribute  onClick für den Button  showWeather,d.h beim Klicken auf den Button wird die Methode showWeather aufgeruft. Diese Methode werden wir später schreiben.

Erstellen Sie eine Service:

Drücken Sie die Rechtmaustaste auf einer java package und wählen SIe:
  • New/Service/Service
Geben Sie ein:
  • Class name: WeatherService
Die Klasse WeatherService wurde erstellt. Und die wird aus der Klasse android.app.Service.erweitert
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, jetzt können Sie die Applikation starten.

4- Die Dienstleistung IntentService

Das Beipiel über IntentService:

Das folgende Bild bezeichnet die Kommunikation zwischen Client (Activity) und  IntentService. Client startet die Dienstleistung. Sie sendet ihre Anforderung nach einem Objekt I ntent.  Die Dienstleistung läuft und tut ihre Aufgaben, gleichzeitig kann sie die Information der Aufgabestatus senden, zum Beispiel wie viele Prozent hat sie erledigt. Bei dem Client kann ProgressBar zur Anzeige der % der Erledigung der Aufgabe benutzt werden
Erstellen Sie ein Projekt  SimpleIntentService.
Ziehen und Legen Sie einige Elementen in die Interface ab
Doppelklicken Sie auf ProgressBar um die  ID und deren Wert zu ändern
Setzen Sie   ID und  Text für die Elemente auf die Interface 
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
Setzen Sie, dass die Methode aufgeruft wird wenn der Benutzer auf den Button  Start.klickt
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>
Erstellen Sie ein  IntentService durch das Klicken der Rechtmaustaste auf einer Package und dann wählen
  • New/Service/IntentService
Die Klasse  SimpleIntentService wird erstellt. Sie wird mit AndroidManifest.xml registriert. Die erstellte Code ist eine Vorschlage für Sie beim Schreiben eines  IntentService, Sie können die erstellten Code löschen
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
       }
   }

}
  • Die Applikation durchführen ( die slider sehen):

Und Sie können den Funktionierungsgrundsatz des oben Beispiel nach dem folgenden Foto sehen

View more categories: