Service组件应用实例

这是通过Service实现的一个计数器服务功能实例。

直接先上代码：

ICounterCallback.java

package com.example.counter;

/**
 * 火龙裸
 * */
public interface ICounterCallback {
    void count(int val);
}

　　这个文件定义了一个计数器回调接口ICounterCallback，它只有一个成员函数count，用来将CounterService服务组件的当前“计数结果”，实时地更新到对应的CounterActivity组件上，进行用户界面显示。

ICounterService.java

package com.example.counter;

/**
 * 火龙裸
 * */
public interface ICounterService {
    void strtCounter(int initVal, ICounterCallback callback);
    void stopCounter();
}

　　这个文件定义了一个计数器接口ICounterService，它有两个成员函数startCounter和stopCounter；其中，前者用来启动计数器，后者用来停止计数器。在启动计数器时，可以指定计数器的初始值，以及更新用户界面的回调接口。

CounterService.java

package com.example.counter;

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

import androidx.annotation.Nullable;

/**
 * 火龙裸
 * */
public class CounterService extends Service implements ICounterService {
    private static final String TAG = "CounterService";

    private boolean stop = false;
    private ICounterCallback counterCallback = null;

    private final CounterBinder binder = new CounterBinder();

    public class CounterBinder extends Binder{
        public CounterService getService() {
            return CounterService.this;
        }
    }

    @Override
    public void onCreate() {
        super.onCreate();
        Log.e(TAG, "onCreate: =============");
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return binder;
    }



    @Override
    public void strtCounter(int initVal, ICounterCallback callback) {
        counterCallback = callback;

        AsyncTask<Integer, Integer, Integer> task = new AsyncTask<Integer, Integer, Integer>() {
            @Override
            protected Integer doInBackground(Integer... integers) {
                Integer initCounter = integers[0];

                stop = false;

                while (!stop) {
                    publishProgress(initCounter);

                    try {
                        Thread.sleep(1000);
                    } catch (InterruptedException e) {
                        e.printStackTrace();
                    }

                    initCounter++;
                }

                return initCounter;
            }

            @Override
            protected void onProgressUpdate(Integer... values) {
                super.onProgressUpdate(values);

                int val = values[0];
                counterCallback.count(val);
            }

            @Override
            protected void onPostExecute(Integer val) {
                counterCallback.count(val);
            }
        };

        task.execute(initVal);
        Log.e(TAG, "strtCounter: 启动AsyncTask");
    }

    @Override
    public void stopCounter() {
        stop = true;
        Log.e(TAG, "stopCounter: 停止AsyncTask 任务标志位");
    }
}

　　CounterService是一个Service组件，因此，它必须要从Service类继承下来。CounterService组件同时实现了计数器接口ICounterService，用来提供计数器服务。在CounterService组件启动时，它的成员函数onCreate就会被调用；而在CounterService组件被绑定时，它的成员函数onBind就会被调用。

注意：CounterService组件有一个成员变量binder，它指向一个类型为CounterBinder的Binder本地对象。当CounterService组件被绑定时，它就会将内部的Binder本地对象binder返回给绑定着，以便绑定者可以通过这个Binder本地对象来获得它的一个计数器访问接口。

这里之所以要返回一个Binder本地对象给绑定者，是因为绑定着与CounterService组件可能是运行在两个不同的应用程序进程中的。不过本例中，启动CounterService组件的“CounterActivity组件”和“CounterService”组件是运行在同一个应用程序进程中的。

　　CounterService组件的成员函数startCounter和stopCounter分别用来启动和停止内部的计数器；其中，成员函数startCounter使用一个异步任务task来启动一个计数器，成员函数stopCounter通过将CounterService组件的成员变量stop设置为true来停止这个计数器。

当计数器被停止执行时，异步任务task的成员函数onPostExecute就会被调用，它主要是使用CounterService组件内部的一个ICounterCallback接口将计数器的最终技术结果更新到用户界面上显示出来。

注意：在异步任务task的三个成员函数中，只有成员函数doInBackground是在后台线程中执行的，其余两个成员函数onProgressUpdate和onPostExecute都是在应用程序的主线程中执行的，因此，它们可以被用来更新用户界面。

CounterActivity.java

package com.example.counter;

import androidx.appcompat.app.AppCompatActivity;

import android.content.ComponentName;
import android.content.Intent;
import android.content.ServiceConnection;
import android.os.Bundle;
import android.os.IBinder;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;

/**
 * 火龙裸
 * */
public class CounterActivity extends AppCompatActivity implements View.OnClickListener, ICounterCallback {
    private static final String TAG = "CounterActivity";

    private Button btn_start;
    private Button btn_stop;
    private TextView tv_count;

    private ICounterService counterService = null;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_counter);
        btn_start = findViewById(R.id.btn_start);
        btn_stop = findViewById(R.id.btn_stop);
        tv_count = findViewById(R.id.tv_count);
        btn_start.setOnClickListener(this);
        btn_stop.setOnClickListener(this);

        Intent serviceIntent = new Intent(CounterActivity.this, CounterService.class);
        bindService(serviceIntent, serviceConnection, BIND_AUTO_CREATE);
    }

    @Override
    public void onClick(View view) {
        switch (view.getId()){
            case R.id.btn_start:
                counterService.strtCounter(0, this);
                break;
            case R.id.btn_stop:
                counterService.stopCounter();
                break;
        }
    }

    /**
     * 计数器服务的回调
     * */
    @Override
    public void count(int val) {
        tv_count.setText("计算值为：" + val);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        unbindService(serviceConnection);
    }

    private ServiceConnection serviceConnection = new ServiceConnection() {
        @Override
        public void onServiceConnected(ComponentName componentName, IBinder iBinder) {
            counterService = ((CounterService.CounterBinder)iBinder).getService();
            Log.e(TAG, "onServiceConnected: ======================>");
        }

        @Override
        public void onServiceDisconnected(ComponentName componentName) {
            counterService = null;
            Log.e(TAG, "onServiceDisconnected: >>>>>>>>>>>>>>>");
        }
    };
}

　　CounterActivity是应用程序的根Activity组件，因此，它必须要从类Activity继承下来。CounterActivity同时实现了计数器回调接口ICounterCallback，以便可以实时地回调更新用户界面上的计数值。

　　CounterActivity组件被启动时，它的成员函数onCreate就会被调用，这时候它就会调用其父类ContextWrapper的成员函数bindService来启动CounterService组件。当CounterService组件启动起来之后，CounterActivity组件内部的ServiceConnection对象serviceConnection的成员函数onServiceConnected就会被调用，这时候CounterActivity组件就会获得CounterService服务组件中的一个Binder本地对象。由于CounterActivity组件和CounterService服务组件是运行在同一个应用程序进程中的，因此，ServiceConnection对象serviceConnection的成员函数onServiceConnected可以安全地将前面获得的一个Binder本地对象转换为一个类型为CounterBinder的对象，接着再调用它的成员函数getService来获得一个计数器接口。有了这个计数器接口之后，CounterActivity组件就相当于将CounterService服务组件绑定起来了。

　　由于CounterActivity组件在启动时绑定了CounterService组件，因此当它销毁时，即它的成员函数onDestrory被调用时，它就必须要调用父类ContextWrapper的成员函数unbindService来解绑CounterService服务组件。解绑成功后，CounterActivity组件内部的ServiceConnection对象serviceConnection的成员函数onServiceDisconnected就会被调用，用来执行清理工作。

activity_counter.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".CounterActivity">

    <Button
        android:id="@+id/btn_start"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="开始"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintHorizontal_bias="0.498"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.196" />

    <TextView
        android:id="@+id/tv_count"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="计算值为："
        android:textSize="20sp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintHorizontal_bias="0.498"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.311" />

    <Button
        android:id="@+id/btn_stop"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="停止"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintHorizontal_bias="0.498"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.409" />

</androidx.constraintlayout.widget.ConstraintLayout>

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.counter">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.Counter">
        <activity
            android:name=".CounterActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <service
            android:name=".CounterService"
            android:enabled="true" />
    </application>

</manifest>