Android Service总结04 之被绑定的服务 -- Bound Service

Android Service总结04 之被绑定的服务 -- Bound Service

版本	版本说明	发布时间	发布人
V1.0	添加了Service的介绍和示例	2013-03-17	Skywang

---

1 Bound Service说明

Bound Service，即被绑定的服务，和Started Service一样，它也是2种常见服务之一。它常被用在执行进程的某个后台操作或进程间通讯(IPC)。

 实现步骤和使用方法

(01) 创建一个Bound Service类，该类要继承于Service。

(02) 在Bound Service类中实现以下接口：
  onCreate():可以不用实现，视用户需求而定。当服务被创建时，系统会自动调用该函数。一般在该函数中进行初始化工作，例如：新建线程。
  onDestroy():可以不用实现，视用户需求而定。当服务被销毁时，系统会自动调用该函数。一般在该函数中进行清除工作，例如，终止并回收线程。
  onBind():必须实现！在onBind()中要返回IBinder对象。IBinder对象的作用是让客户端通过IBinder获取该service的对象，从而调用服务提供相关的功能。Anroid传递数据的机制是基于IBinder的，我们不能直接传递service的对象。总之，我们需要记住的是onBind()中需要返回IBinder对象。下面说说IBinder对象怎么获取。
       通常，我们通过在"Bound Service"中创建一个继承于Binder的内部类。在该内部类中添加一个方法，比如getService()，返回“Bound Service”的对象。然后在onBind()中返回该内部类的对象即可。

(03) 客户端通过bindService()来绑定服务。bindService()中传递的参数包含一个ServiceConnection对象，下面说说怎么获取该对象。
       在客户端中创建一个继承于ServiceConnection的内部类；实现ServiceConnection中的两个抽象函数:onServiceConnected() 和 onServiceDisconnected()。 onServiceConnected()在绑定服务成功时会被系统调用，在onServiceConnected()的输入参数包含“onBinder()中返回的IBinder对象”，根据该对象，我们就能获取到service的对象，之后就可调用service提供的服务。 onServiceDisconnected()在解除绑定时会被系统调用。
       在bindService()中传入该内部类的对象即可。

(04) 调用Bound Service提供的服务函数接口，以执行相关操作。
       在onServiceConnected()中已经获取到service对象；现在，在我们客户端的任何地方都可以调用到该service提供的服务了。

(05) 客户端通过unbindService()结束服务。

---

2 Service示例

采用Bound Service来实现“ndroid Service总结03 之被启动的服务 -- Started Service”中的示例，即：编写一个activity，包含2个按钮和1个进度条，2个按钮分别是开始按钮、结束按钮。点击“开始”按钮：进度条开始加载；“开始”变成“重启”按钮；显示“结束”按钮(默认情况，“结束”按钮是隐藏状态)。

BinderServiceImpl.java的内容：

package com.skywang.service;

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

import java.lang.Thread;
/**
 * @desc 服务：每隔200ms将一个数字+2并通过广播发送出去
 * @author skywang
 *
 */
public class BinderServiceImpl extends Service {
    private static final String TAG = "skywang-->BinderServiceImpl";

    // 发送的广播对应的action
    private static final String COUNT_ACTION = "com.skywang.service.binderservice.COUNT_ACTION";

    // 线程：用来实现每隔200ms发送广播
    private static CountThread mCountThread = null;
    // 数字的索引
    private static int index = 0;

    // 创建IBinder对象
    private final IBinder mBinder = new LocalBinder();

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

    @Override
    public void onDestroy() {
        Log.d(TAG, "onDestroy");

        // 终止服务
        if ( mCountThread != null) {
            mCountThread.interrupt();
            mCountThread = null;
        }
        super.onDestroy();
    }

    public void startCount() {
        Log.d(TAG, "startCount");

        // 非首次运行服务时，执行下面操作
        // 目的是将index设为0
        if ( mCountThread != null) {
            Log.d(TAG, "mCountThread != null");
            index = 0;
            return ;
        }

        Log.d(TAG, "start thread");
        // 首次运行时，创建并启动线程
        mCountThread = new CountThread();
        mCountThread.start();
    }

    public void endCount() {
        // 终止服务
        if ( mCountThread != null) {
            mCountThread.interrupt();
            mCountThread = null;
        }
    }

    @Override
    public IBinder onBind(Intent intent) {
        Log.d(TAG, "onBind");
        return mBinder;
    }

    public class LocalBinder extends Binder {
        public BinderServiceImpl getService() {
            // Return this instance of LocalService so clients can call public methods
            return BinderServiceImpl.this;
        }
    }

    private class CountThread extends Thread {
        @Override
        public void run() {
            index = 0;
            try {
                while (true) {
                    // 将数字+2,
                    index += 2;                    

                    // 将index通过广播发送出去
                    Intent intent = new Intent(COUNT_ACTION);
                    intent.putExtra("count", index);
                    sendBroadcast(intent);
//                    Log.d(TAG, "CountThread index:"+index);

                    // 若数字>=100 则退出
                    if (index >= 100) {
                        if ( mCountThread != null) {
                            mCountThread = null;
                        }
                        return ;
                    }

                    // 修改200ms
                    this.sleep(100);
                }
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
        }
    }
}

BinderServiceTest.java的内容：

package com.skywang.service;

import com.skywang.service.BinderServiceImpl.LocalBinder;
import android.os.Bundle;
import android.os.IBinder;
import android.app.Activity;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.content.ServiceConnection;
import android.content.ComponentName;
import android.util.Log;
import android.view.Menu;
import android.view.View;
import android.widget.Button;
import android.widget.ProgressBar;

public class BinderServiceTest extends Activity {
    private static final String TAG = "skywang-->BinderServiceTest";

    private static final String COUNT_ACTION = "com.skywang.service.binderservice.COUNT_ACTION";
    private CurrentReceiver mReceiver;
    private Button mStart = null;
    private Button mStop = null;
    private Intent mIntent = null;
    private Intent mServiceIntent = null;
    private ProgressBar mProgressBar = null;

    private BinderServiceImpl mService;
    private boolean mBound = false;

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

        mStart = (Button) findViewById(R.id.start);
        mStart.setOnClickListener(new View.OnClickListener() {

            @Override
            public void onClick(View arg0) {
                Log.d(TAG, "click start button");
                // 显示“结束”按钮
                mStop.setVisibility(View.VISIBLE);
                // 将“开始”按钮更名为“重启”按钮
                mStart.setText(R.string.text_restart);
                // 启动计数
                mService.startCount();
            }
        });

        mStop = (Button) findViewById(R.id.stop);
        mStop.setOnClickListener(new View.OnClickListener() {

            @Override
            public void onClick(View view) {
                Log.d(TAG, "click stop button");
                // 结束计数
                mService.endCount();
            }
        });
        mStop.setVisibility(View.INVISIBLE);

        mProgressBar = (ProgressBar) findViewById(R.id.pbar_def);
        // 隐藏进度条
        mProgressBar.setVisibility(View.INVISIBLE);

        // 启动服务，用来更新进度
        mServiceIntent = new Intent("com.skywang.service.BinderService");
        bindService(mServiceIntent, mConnection, Context.BIND_AUTO_CREATE);

        // 动态注册监听COUNT_ACTION广播
        mReceiver = new CurrentReceiver();
        IntentFilter filter = new IntentFilter();
        filter.addAction(COUNT_ACTION);
        this.registerReceiver(mReceiver, filter);
    }

    @Override
    public void onDestroy(){
        super.onDestroy();  

        if(mIntent != null) {
            // 结束服务。
            unbindService(mConnection);
            mServiceIntent = null;
            mBound = false;
        }

        if(mReceiver != null)
            this.unregisterReceiver(mReceiver);
    }

    private ServiceConnection mConnection = new ServiceConnection() {

        /**
         * 绑定服务成功的回调函数
         */
        @Override
        public void onServiceConnected(ComponentName className,
                IBinder service) {
            Log.d(TAG, "onServiceConnected");
            // 获取IBinder服务对象
            LocalBinder binder = (LocalBinder) service;
            mService = binder.getService();
            mBound = true;
        }

        /**
         * 解除绑定的回调函数
         */
        @Override
        public void onServiceDisconnected(ComponentName arg0) {
            Log.d(TAG, "onServiceDisconnected");
            mBound = false;
        }
    };    

    /**
     * @desc 更新进度条
     * @param index
     */
    private void updateProgressBar(int index) {
        int max = mProgressBar.getMax();

        if (index < max) {
            mProgressBar.setProgress(index);
            mProgressBar.setVisibility(View.VISIBLE);
        } else {
            // 隐藏进度条
            mProgressBar.setVisibility(View.INVISIBLE);
            // 隐藏“结束”按钮
            mStop.setVisibility(View.INVISIBLE);
            // 将“重启”按钮更名为“开始”按钮
            mStart.setText(R.string.text_start);
        }
//        Log.d(TAG, "progress : "+mProgressBar.getProgress()+" , max : "+max);
    }

    /**
     * @desc 广播：监听COUNT_ACTION，获取索引值，并根据索引值来更新进度条
     * @author skywang
     *
     */
    private class CurrentReceiver extends BroadcastReceiver {
        @Override
        public void onReceive(Context context, Intent intent) {
            String action  = intent.getAction();
            if (COUNT_ACTION.equals(action)) {
                int index = intent.getIntExtra("count", 0);
                updateProgressBar(index);
            }
        }
    }
}

layout文件binder_service_test.xml的内容：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    >

    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        >
        <Button
            android:id="@+id/start"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/text_start"
            />
        <Button
            android:id="@+id/stop"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/text_stop"
            />

    </LinearLayout>

    <ProgressBar
        android:id="@+id/pbar_def"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        style="@android:style/Widget.ProgressBar.Horizontal"
        android:max="100"
        android:progress="0"
        />
</LinearLayout>

manifest的内容：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.skywang.service"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="11"
        android:targetSdkVersion="17" />

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.skywang.service.BinderServiceTest"
            android:screenOrientation="portrait"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <service android:name=".BinderServiceImpl">
            <intent-filter>
                <action android:name="com.skywang.service.BinderService" />
            </intent-filter>
        </service>
    </application>

</manifest>

点击下载：源代码

效果图：

更多service内容：

1 Android Service总结01 目录

2 Android Service总结02 service介绍

3 Android Service总结03 之被启动的服务 -- Started Service

4 Android Service总结04 之被绑定的服务 -- Bound Service

5 Android Service总结05 之IntentService

6 Android Service总结06 之AIDL

---