android AIDL服务

      这篇文章http://byandby.iteye.com/blog/1026110我们介绍了android的本地服务：它只能由承载它的应用程序使用。现在我们将介绍如何构建可由其他进程通过 RPC 使用服务。与许多其他基于 RPC 的解决方案一样，在Android中，需要使用 IDL来定义将向客户端公开的接口。在Android中，这个 IDL 称为 AIDL。要构建远程服务，执行以下步骤。
  （1）编写一个AIDL文件来向客户端定义接口。AIDL 文件使用 java语法，它的扩展名是点 .aidl 使用的包名称与Android项目所使用的包相同。
   （2）将AIDL 文件添加到项目的任意包下。Android Eclipse 插件将调用AIDL编译器来从 AIDL 文件生成 Java接口。
上边这2步说白了就是  你自己随便定义一个文件 扩展名是 .aidl 然后将这个文件复制到你的包下面，那个包都可以。然后 Android Eclipse 插件会自动帮你 根据这个 AIDL 文件生成 Java文件。
    （3）实现一个服务并从 onBind（）方法返回所生成的接口。
    （4）将服务配置添加到 AndroidManifest.xml文件中。
   
     在AIDL中定义服务接口
   为了展示远程服务实例，我们将编写一个股票报价服务。此服务将提供一种方法来获取股票代号并返回价格。要在Android 中编写远程服务，第一步是在 AID文件中定义服务的接口。
   股票报价服务的 AIDL 定义

//This file is IStockQuoteService.aidl
package com.androidbook.stockquoteservice;
interface IStockQuoteService
{
	double getQuote(String ticker);
}

   
    IStockQuoteService 以字符串的形式接受股票代号，并以双精度数字形式返回当前的股票价值。当创建AIDL文件时， Android Eclipse插件将运行 AIDL 编译器来处理 AIDL文件（在构建过程中）。如果AIDL文件成功编译，编译器将生成一个适合 RPC 通信的 Java接口。请注意，生成的文件将位于在 AIDL文件中指定的包中，在本例中为 com.androidbook.stockquoteservice。
  下面是为 IStockQuoteService接口生成的Java文件。生成的文件将放在Eclipse的 gen文件夹中。

/*
 * This file is auto-generated.  DO NOT MODIFY.
 * Original file: F:\\workspace\\StockQuoteService\\src\\com\\androidbook\\stockquoteservice\\IStockQuoteService.aidl
 */
package com.androidbook.stockquoteservice;
public interface IStockQuoteService extends android.os.IInterface
{
/** Local-side IPC implementation stub class. */
public static abstract class Stub extends android.os.Binder implements com.androidbook.stockquoteservice.IStockQuoteService
{
private static final java.lang.String DESCRIPTOR = "com.androidbook.stockquoteservice.IStockQuoteService";
/** Construct the stub at attach it to the interface. */
public Stub()
{
this.attachInterface(this, DESCRIPTOR);
}
/**
 * Cast an IBinder object into an com.androidbook.stockquoteservice.IStockQuoteService interface,
 * generating a proxy if needed.
 */
public static com.androidbook.stockquoteservice.IStockQuoteService asInterface(android.os.IBinder obj)
{
if ((obj==null)) {
return null;
}
android.os.IInterface iin = (android.os.IInterface)obj.queryLocalInterface(DESCRIPTOR);
if (((iin!=null)&&(iin instanceof com.androidbook.stockquoteservice.IStockQuoteService))) {
return ((com.androidbook.stockquoteservice.IStockQuoteService)iin);
}
return new com.androidbook.stockquoteservice.IStockQuoteService.Stub.Proxy(obj);
}
public android.os.IBinder asBinder()
{
return this;
}
@Override public boolean onTransact(int code, android.os.Parcel data, android.os.Parcel reply, int flags) throws android.os.RemoteException
{
switch (code)
{
case INTERFACE_TRANSACTION:
{
reply.writeString(DESCRIPTOR);
return true;
}
case TRANSACTION_getQuote:
{
data.enforceInterface(DESCRIPTOR);
java.lang.String _arg0;
_arg0 = data.readString();
double _result = this.getQuote(_arg0);
reply.writeNoException();
reply.writeDouble(_result);
return true;
}
}
return super.onTransact(code, data, reply, flags);
}
private static class Proxy implements com.androidbook.stockquoteservice.IStockQuoteService
{
private android.os.IBinder mRemote;
Proxy(android.os.IBinder remote)
{
mRemote = remote;
}
public android.os.IBinder asBinder()
{
return mRemote;
}
public java.lang.String getInterfaceDescriptor()
{
return DESCRIPTOR;
}
public double getQuote(java.lang.String ticker) throws android.os.RemoteException
{
android.os.Parcel _data = android.os.Parcel.obtain();
android.os.Parcel _reply = android.os.Parcel.obtain();
double _result;
try {
_data.writeInterfaceToken(DESCRIPTOR);
_data.writeString(ticker);
mRemote.transact(Stub.TRANSACTION_getQuote, _data, _reply, 0);
_reply.readException();
_result = _reply.readDouble();
}
finally {
_reply.recycle();
_data.recycle();
}
return _result;
}
}
static final int TRANSACTION_getQuote = (android.os.IBinder.FIRST_CALL_TRANSACTION + 0);
}
public double getQuote(java.lang.String ticker) throws android.os.RemoteException;
}

   对于所生成的类，请注意以下几点。
   在 AIDL 文件中定义的接口在生成的代码中实现为接口 （也就是说，有一个名为IStockQuoteService的接口）。
    名为Stub的 static final 抽象类扩展了 android.os.Binder并实现了 IStockQuoteService。请注意该类是一个抽象类。
     名为 Proxy的内部类实现了 IStockQuoteService, 后者是Stub类的代理。
     AIDL文件必须位于应该包含所生成文件的包中（在AIDL文件的包声明中指定）。
    
  在服务类中实现AIDL接口
  上边我们为股票报价服务定义了 AIDL 文件并生成了绑定文件。现在我们将提供该服务的实现。要实现服务的接口，需要编写一个类来扩展 android.app.Service 并实现 IStockQuoteService接口。我们将编写的类 命名为 StockQuoteService。为了将服务向客户端公开，StockQuoteService 需要提供onBind()方法 的实现，我们还需要将一些配置信息添加到 AndroidManifest.xml文件中。  下面给出 我们服务类得实现。
IStockQuoteService 服务实现。
   

package com.androidbook.stockquoteservice;

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

public class StockQuoteService extends Service {
	private static final String TAG = "StockQuoteService";

	public class StockQuoteServiceImpl extends IStockQuoteService.Stub {

		@Override
		public double getQuote(String ticker) throws RemoteException {
			Log.v(TAG, "getQuote() called for " + ticker);
			return 20.0;
		}
	}

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

	@Override
	public void onDestroy() {
		super.onDestroy();
		Log.v(TAG, "onDestory() called");
	}

	@Override
	public void onStart(Intent intent, int startId) {
		super.onStart(intent, startId);
		Log.v(TAG, "onStart() called");
	}

	@Override
	public IBinder onBind(Intent intent) {
		Log.v(TAG, "onBind() called");
		return new StockQuoteServiceImpl();
	}

}

    在这个服务类中大家可以看到我们实现了 onBind() 方法。从AIDL文件生成的 Stub类是抽象类并且它实现了 IStockQuoteService接口。在我们的服务实现中，有一个扩展了 Stub类得内部类，名为 StockQuoteServiceImpl。此类充当着远程服务实现，而且 onBind()方法会返回此类的实例。到此，我们有了一个有效的 ADIL服务，但是外部的客户端还无法连接到它。
     要将服务向客户端公开，需要在AndroidManifest.xml文件中添加服务声明，而这一次我们需要一个Intent 过滤器来公开服务，如下。



   从客户端应用程序调用服务
   当客户端与服务通信时，它们之间必须有一个协议或契约。在Android中，这个契约就是AIDL。所以，使用服务的第一步是，获取服务的 AIDL文件并将其复制到客户端项目中。当将AIDL文件复制到客户端项目时，AIDL 编译器将创建一个接口定义文件，这个文件与我们在服务端定义的文件相同。这会向客户端公开所有的方法、参数并返回服务的类型。我们创建一个新项目并复制AIDL文件。
    （1）创建一个新的Android项目， 将其命名为 StockQuoteClient。使用不同的包名称比如 com.androidbook.stockquoteclient。在Create Activity字段中使用 MainActivity注意不要把IStockQuoteService.aidl文件放到这包中，这个包只有一个MainActivity 类。
    （2）在此项目中新建一个包 com.androidbook.stockquoteservice，放在src目录下。
    （3）将IStockQuoteService.aidl文件从 StockQuoteService 项目也就是我们服务端得项目复制到新建的包中。复制过来之后，AIDL编译器会自动生成关联的java文件。
     重新生成的服务接口充当着客户端与服务之间的契约。下一步是获取服务的引用，以便调用getQuote()方法。对于远程服务，必须调用 bindService()方法，而不是 startService()方法。

    客户端布局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<Button
	android:id="@+id/bindBtn"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content"
	android:text="Bind"/>

<Button
	android:id="@+id/callBtn"
	android:layout_height="wrap_content"
	android:layout_width="wrap_content"
	android:text="Call Again"/>

<Button
	android:id="@+id/unbindBtn"
	android:layout_width="wrap_content"
	android:layout_height="wrap_content"
	android:text="UnBind"/>
</LinearLayout>

  MainActivity类
 

package com.androidbook.stockquoteclient;

import com.androidbook.stockquoteservice.IStockQuoteService;
import android.app.Activity;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.ServiceConnection;
import android.os.Bundle;
import android.os.IBinder;
import android.os.RemoteException;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;

public class MainActivity extends Activity {
	protected static final String TAG = "StockQuoteClient";
	private IStockQuoteService stockService = null;

	private Button bindBtn;
	private Button callBtn;
	private Button unbindBtn;

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);
		bindBtn = (Button) findViewById(R.id.bindBtn);
		bindBtn.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				bindService(new Intent(IStockQuoteService.class.getName()),
						serConn, Context.BIND_AUTO_CREATE);
				bindBtn.setEnabled(false);
				callBtn.setEnabled(true);
				unbindBtn.setEnabled(true);
			}
		});

		callBtn = (Button) findViewById(R.id.callBtn);
		callBtn.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				callService();
			}
		});
		callBtn.setEnabled(false);

		unbindBtn = (Button) findViewById(R.id.unbindBtn);
		unbindBtn.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				unbindService(serConn);
				bindBtn.setEnabled(true);
				callBtn.setEnabled(false);
				unbindBtn.setEnabled(false);
			}
		});
	}

	private void callService() {
		try {
			double val = stockService.getQuote("SYH");
			Toast.makeText(this, "Value from service is " + val,
					Toast.LENGTH_LONG).show();
		} catch (RemoteException e) {
			Log.e("MainActivity", e.getMessage(), e);
		}
	}

	private ServiceConnection serConn = new ServiceConnection() {
		// 此方法在系统建立服务连接时调用
		@Override
		public void onServiceConnected(ComponentName name, IBinder service) {
			Log.v(TAG, "onServiceConnected() called");
			stockService = IStockQuoteService.Stub.asInterface(service);
			callService();
		}

		// 此方法在销毁服务连接时调用
		@Override
		public void onServiceDisconnected(ComponentName name) {
			Log.v(TAG, "onServiceDisconnected()");
			stockService = null;
		}
	};
}

    MainActivity里边我们定义了三个按钮 分别是 Bind、Call Again 和 UnBind。当用户单击 Bind 按钮时，活动调用bindService（）方法。类似地，当用户点击 UnBind 时，活动调用unbindService()方法。请注意传递给 bindService()方法 的3个参数：AIDL 服务的名称、ServiceConnection 实例和自动创建服务的标志。
    我们在程序了打印了日志，我们可以看到当我们点击 Bind按钮的时候 服务端 方法的一个执行顺序。
   


  程序的运行效果如下



    对于AIDL 服务，需要提供ServiceConnection接口的实现。此接口定义了两个方法：一个供系统建立服务连接时调用，另一个在销毁服务连接时调用。

    最后我们在总结一下android中 本地服务和 AIDL服务的区别吧。
     本地服务不支持onBind(),它从onBind()返回null，这种类型的服务只能由承载服务的应用程序组件访问。可以调用 startService（）来调用本地服务。AIDL服务可以同时供 同一进程内的组件和其他应用程序的组件使用。这种类型的服务在AIDL 文件中为自身与其客户端定义一个契约。服务实现 AIDL契约，而客户端绑定到 AIDL定义。服务通过从 onBind()方法 返回AIDL接口的实现，来实现契约。客户端通过调用 bindService()来绑定到AIDL服务，并调用 unBindService()来从服务断开。 

   为了避免大家把aidl文件放错位置，来2张我们 程序结构的截图吧，一个是 客户端的，一个是服务端得。
客户端。。。。


服务端。。。



    源码附件

评论

7 楼 xumen 2014-07-01  

我想问下你这个服务端是怎么运行的啊？

6 楼 luwies 2013-09-23  

不错，很详细。

5 楼 jkzhao 2012-10-24  

讲得很清晰，赞！

4 楼 penglao4 2012-10-10  

讲解很犀利，顶一个

3 楼 lvning10086 2012-09-26  

写的很不错、谢谢分享！

2 楼 tangqifa 2012-03-16  

恩 很受益 。。。深入浅出...

1 楼 hawk081 2011-09-27  

写得很好 嘿嘿 谢谢分享哈