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

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

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

1 Started Service介绍

Started Service，即被启动的服务。它是2种常见服务之一，另一种是Bound Service。Started Service常被用在执行进程的某个后台操作，如通过该服务来实现文件下载等功能。

实现步骤和使用方法

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

(02) 在Started Service类中实现以下接口：
onStartCommand():必须实现！在其中启动服务提供的功能。例如，若该服务是在后台下载文件，则在该函数中启动一个新的线程(Thread)，在线程中实现下载功能。当客>户端通过startService()启动函数时，系统会自动执行服务对应的onStartCommand()函数。
onBind():必须实现！返回null即可。onBind()是"Bound Service"中用到的函数，在"Started Service"服务不会执行onBind()；但必须实现它，因为onBind()是Service类
的抽象方法。
onCreate():可以不用实现，视用户需求而定。当服务被创建时，系统会自动调用该函数。一般在该函数中进行初始化工作，例如：新建线程。
onDestroy():可以不用实现，视用户需求而定。当服务被销毁时，系统会自动调用该函数。一般在该函数中进行清除工作，例如，终止并回收线程。

(03) 客户端通过startService()启动服务。

(04) 客户端通过endService()结束服务。

下面以实际例子来说明“Started Service”的实现方式。

2 Service示例

采用Service来实现“Android Service总结02 IntentService介绍及实例”中的示例，即：编写一个activity，包含2个按钮和1个进度条，2个按钮分别是开始按钮、结束按钮。点击“开始”按钮：进度条开始加载；“开始”变成“重启”按钮；显示“结束”按钮(默认情况，“结束”按钮是隐藏状态)。

BaseServiceTest包括了两个主要的类：

StartServiceImpl.java ——
Service的子类。当服务被启动时，它会并新建一个线程，每隔200ms将一个数字+2,并通过广播发送出去。

StartServiceTest.java
—— 调用StartServiceImpl的Activity。

StartServiceImpl.java的内容如下：

package com.skywang.service;

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 StartServiceImpl extends Service {
private static final String TAG = "skywang-->StartServiceImpl";

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

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

@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();
}

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
Log.d(TAG, "onStartCommand");

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

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

return START_STICKY;
}

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

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();
}
}
}
}

StartServiceTest.java的内容如下：

package com.skywang.service;

import android.os.Bundle;
import android.app.Activity;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.view.View;
import android.widget.Button;
import android.widget.ProgressBar;
import android.util.Log;

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

private static final String COUNT_ACTION = "com.skywang.service.startservice.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;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.start_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);
// 启动服务，用来更新进度
if (mServiceIntent == null)
mServiceIntent = new Intent("com.skywang.service.StartService");
startService(mServiceIntent);
}
});

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

@Override
public void onClick(View view) {
Log.d(TAG, "click stop button");
if (mServiceIntent != null) {
// 结束服务。
stopService(mServiceIntent);
mServiceIntent = null;
}
}
});
mStop.setVisibility(View.INVISIBLE);

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

// 动态注册监听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)
stopService(mIntent);

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

/**
* @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文件start_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.StartServiceTest"
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=".StartServiceImpl">
<intent-filter>
<action android:name="com.skywang.service.StartService" />
</intent-filter>
</service>
</application>

</manifest>

点击下载： 源代码

效果图：

3 补充说明

在示例中，我们自定义了onStartCommand()的返回值。Android API文档中说明它的返回值，可以有以下4种：

START_STICKY

如果service进程被kill掉，保留service的状态为开始状态，但不保留递送的intent对象。随后系统会尝试重新创建service，由于服务状态为开始状态，所以创建服务后一定会调用onStartCommand(Intent,int,int)方法。如果在此期间没有任何启动命令被传递到service，那么参数Intent将为null。

START_NOT_STICKY

“非粘性的”。使用这个返回值时，如果在执行完onStartCommand后，服务被异常kill掉，系统不会自动重启该服务。

START_REDELIVER_INTENT

重传Intent。使用这个返回值时，如果在执行完onStartCommand后，服务被异常kill掉，系统会自动重启该服务，并将Intent的值传入。

START_STICKY_COMPATIBILITY

START_STICKY的兼容版本，但不保证服务被kill后一定能重启。

更多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

参考文献：
1，Android API文档：http://developer.android.com/guide/components/services.html
2，Android Service被关闭后自动重启,解决被异常kill 服务：/article/1654944.html