Android遠程服務編寫和調用教程_Android

網上汗牛充棟的文章都是介紹Android遠程服務的，一個個將Binder機制、AIDL講得頭頭是道，然而沒有幾個人能夠給出清晰的範例說明如何用最快的方法學會編寫和調用一個Android遠程服務。若你僅僅是想如何編寫或者調用Android的遠程服務，而懶得去理解Binder機制是如何啟動並執行，那麼本篇文章正好適合你。畢竟現在人人都會開車，但沒有幾個人明白髮動機到底是如何運作的。

預備知識

讀者應該有基本的java知識，和Android簡單app的開發經驗。

環境

代碼運行環境：
1.ADT2014版本；
2.android:minSdkVersion=”8”；android:targetSdkVersion=”20”
3.workspace中已經產生了appcompatv7，它的版本是android-22；

遠程服務開發教程

在開始開發之前，先弄清楚幾個概念：
1. IPC:處理序間通訊，你只需要知道Android是依賴這個東西來進行遠程服務調用的就可以了。
2. Binder機制：Android發明的一種IPC機制，據說非常非常的好，你就當它是個黑盒子，通過這個黑盒子就可以進行遠程服務調用了，而且Android中的很多機制都是通過它實現的。
3. AIDL語言：一種專門用來寫遠程介面的語言，看它的名字就知道了，Android Interface Definition
Language。AIDL語言可以被android提供的編譯器編譯為Java原始碼，這個Java原始碼將會被服務的和用戶端使用，用來簡化遠程服務開發流程。如果你當初玩過CORBA，那就更能明白什麼是IDL語言了
4. IInterface介面、IBinder介面、IBinder類等等：都是用來實現Binder機制的介面和類，在本教程中，你就當它們是Binder黑盒子的一部分，不需要瞭解。
再說一點，其實Android提供的ApiDemos中就有一個遠程服務的標準範例，但是其一是它沒有將服務端和用戶端分開寫，其二是例子中摻雜了太多其他的功能，因此理解起來較為困難。這個例子是com.example.android.apis.app.RemoteService，有興趣的可以在看完本文後再去詳細研究。

第一步，建立一個普通Android應用

應用程式名稱為WxbRemoteService，這個應用可以刪掉其Activity類，但是為了簡單，我們就保留所有自動建立的代碼。

第二步，編寫AIDL

AIDL語言的文法和Java其實很像，你甚至可以先編寫一個Java介面，然後刪掉public、protected、private這些許可權限定詞即可。例子如下IWxbService.aidl：

package com.dumaisoft.wxbremoteservice;interface IWxbService { void setName(String name); String getName();}

注意幾點：
1.介面名和aidl檔案名稱相同。
2.介面和方法前不用加存取權限修飾符public,private,protected等,也不能用final,static。
3.Aidl預設支援的類型包話java基本類型（int、long、boolean等）和（String、List、Map、 CharSequence），使用這些類型時不需要import聲明。對於List和Map中的元素類型必須是Aidl支援的類型。如果使用自訂類型作 為參數或傳回值，自訂類型必須實現Parcelable介面。
4.自訂類型和AIDL產生的其它介面類型在aidl描述檔案中，應該顯式import，即便在該類和定義的包在同一個包中。
5.在aidl檔案中所有非Java基本型別參數必須加上in、out、inout標記，以指明參數是輸入參數、輸出參數還是輸入輸出參數。
6.Java原始類型預設的標記為in,不能為其它標記
IWxbService.aidl檔案的位置是在com.dumaisoft.wxbremoteservice包中，只要文法正確，則會在ADT的gen目錄下的com.dumaisoft.wxbremoteservice包中產生java檔案IWxbService.java。
IWxbService.aidl定義了一個遠程介面，它包含兩個方法getName和setName。

第三步，編寫服務類

添加一個WxbService類，它繼承了Service類，原始碼如下：

package com.dumaisoft.wxbremoteservice;import com.dumaisoft.wxbremoteservice.IWxbService.Stub;import android.app.Service;import android.content.Intent;import android.os.IBinder;import android.os.RemoteException;public class WxbService extends Service { private ServiceImpl serviceImpl; //繼承由IWxbService.aidl產生的com.dumaisoft.wxbremoteservice.IWxbService.Stub類 class ServiceImpl extends Stub{  private String _name;  @Override  public void setName(String name) throws RemoteException {   _name = name;  }  @Override  public String getName() throws RemoteException {   return _name;  } } //將ServiceImpl做一個簡單的單例模式 private ServiceImpl getInstance(){  if(serviceImpl == null){   serviceImpl = new ServiceImpl();  }  return serviceImpl; } @Override public IBinder onBind(Intent intent) {  return getInstance(); }}

通過研究代碼可知，和普通的服務類相比，遠程服務類最大的區別就是它擁有一個名為ServiceImpl的成員變數，這個成員變數繼承了Stub類，並實現了Stub類的getName和setName方法。這個Stub類就是由 IWxbService.aidl產生的IWxbService.java提供的。我們不用研究其原始碼，只用知道它的用法：
第一：讓Service的一個成員變數繼承Stub，並實現遠程介面的方法；
第二：在Service的onBind方法中返回一個Stub子類的執行個體。

第四步，配置AndroidManifest.xml

加上如下代碼：

  <service android:name="WxbService">   <intent-filter>    <action android:name="com.dumaisoft.wxbremoteservice.REMOTE_SREVICE"/>   </intent-filter>  </service>

注意action的name為”com.dumaisoft.wxbremoteservice.REMOTE_SREVICE”，這個由開發人員保證不重名即可。

第五步，安裝app到手機上

安裝完成後，你的遠程服務就被註冊到Binder黑盒子中了，任何用戶端只要知道你的遠程服務action名稱和介面，就可以bind服務，並調用介面。

遠程服務調用教程

第一步，建立一個android應用

應用程式名稱為WxbRemoteServiceClient，src包中自動產生了com.dumaisoft.wxbremoteserviceclient包。

第二步，引入遠程服務的AIDL檔案

在src包中建立com.dumaisoft.wxbremoteservice包（為了與服務端的包名相同），然後將上面編寫的IWxbService.aidl檔案拷貝入此目錄。顯然，在本工程的gen目錄中也產生了IWxbService.java檔案。

第三步，編寫調用遠程服務的代碼

代碼如下：

package com.dumaisoft.wxbremoteserviceclient;import com.dumaisoft.wxbremoteservice.IWxbService;import android.app.Activity;import android.app.Service;import android.content.ComponentName;import android.content.Intent;import android.content.ServiceConnection;import android.os.Bundle;import android.os.IBinder;import android.os.RemoteException;import android.view.View;import android.view.View.OnClickListener;import android.widget.Button;import android.widget.Toast;public class MainActivity extends Activity { private Button btnBind; private Button btnSetName; private Button btnGetName; private IWxbService serviceProxy; //遠程服務的代理 private ServiceConnection conn = new ServiceConnection() {  @Override  public void onServiceDisconnected(ComponentName name) {    }  @Override  public void onServiceConnected(ComponentName name, IBinder service) {   //擷取遠程服務代理   serviceProxy = IWxbService.Stub.asInterface(service);  } }; @Override protected void onCreate(Bundle savedInstanceState) {  super.onCreate(savedInstanceState);  setContentView(R.layout.activity_main);  btnBind = (Button) this.findViewById(R.id.btnBind);  btnSetName = (Button) this.findViewById(R.id.btnSetName);  btnGetName = (Button) this.findViewById(R.id.btnGetName);  btnBind.setOnClickListener(new OnClickListener() {   @Override   public void onClick(View v) {    Intent service = new Intent();    //Remote Service Action name    service.setAction("com.dumaisoft.wxbremoteservice.REMOTE_SREVICE");    bindService(service, conn, Service.BIND_AUTO_CREATE);   }  });  btnSetName.setOnClickListener(new OnClickListener() {   @Override   public void onClick(View v) {    try {     serviceProxy.setName("MyName");    } catch (RemoteException e) {     e.printStackTrace();    }   }  });  btnGetName.setOnClickListener(new OnClickListener() {   @Override   public void onClick(View v) {    try {     String name = serviceProxy.getName();     Toast.makeText(getApplicationContext(), name, Toast.LENGTH_LONG).show();    } catch (RemoteException e) {     e.printStackTrace();    }   }  });   }}

注意幾點：
一、建立一個ServiceConnection的匿名子類，在其onServiceConnected方法中擷取遠程服務代理對象serviceProxy。事實上，onServiceConnected方法會在bindService方法調用時被調用，因此能確保一定可以獲得遠程服務的代理對象；
二、IWxbService.Stub.asInterface(service)方法也是由IWxbService.java檔案提供的，其內部機制不用研究，只需要知道它會返回一個IWxbService介面的對象，該對象可以通過Binder黑盒子調用遠程服務的setName和getName方法；
三、使用Intent指定action為”com.dumaisoft.wxbremoteservice.REMOTE_SREVICE”，即可正確的bind到遠程服務。
四、bind成功後，就可以通過遠程服務的代理對象，使用遠程服務的功能了。

小結

至此，讀者應該能比較快速的開發出一個遠程服務，並能編寫用戶端輕鬆的調用它了。還有一點需要說明的是，除了使用AIDL來進行遠程服務的編寫和調用外，還可以直接使用IBinder、Binder等介面和類來進行遠程服務編寫調用。

以上就是本文的全部內容，希望對大家的學習有所協助。