android Service之三：传递基本型数据的远程服务

让其他应用程序复用本程序的服务。这样的服务叫远程（remote）服务，实际上是进程间通信（RPC）。

如果是调用不需要数据交互的远程服务（startservice调用），跟无需数据交互的我本地服务调用是类似的

如果调用远程服务进行数据交互，这时需要使用android接口描述语言（AIDL）来定义远程服务的接口，而不是上述那样简单的java接口。扩展名为aidl而不是java。可用上面的ICountService改动而成ICountSerivde.aidl，eclipse会自动生成相关的java文件。

  
  

   
   package com.easymorse;


   
   interface
   
    ICountService {
    
   
   int
   
    getCount();
}
  
  

编写服务（Service）类，稍有差别，主要在binder是通过远程获得的，需要通过桩（Stub）来获取。桩对象是远程对象的本地代理。

ICountService.Stub继承自IBinder接口和ICountService接口

  
  

   
   package
   
    com.easymorse;


   
   import
   
    android.app.Service;

   
   import
   
    android.content.Intent;

   
   import
   
    android.os.IBinder;

   
   import
   
    android.os.RemoteException;

   
   import
   
    android.util.Log;


   
   public
   
    
   
   class
   
    CountService 
   
   extends
   
    Service {

    
   
   private
   
    
   
   boolean
   
    threadDisable;

    
   
   private
   
    
   
   int
   
    count;

    
   
   private
   
    ICountService.Stub serviceBinder 
   
   =
   
    
   
   new
   
    ICountService.Stub() {

        @Override
        
   
   public
   
    
   
   int
   
    getCount() 
   
   throws
   
    RemoteException {
            
   
   return
   
    count;
        }
    };

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

    @Override
    
   
   public
   
    
   
   void
   
    onCreate() {
        
   
   super
   
   .onCreate();
        
   
   new
   
    Thread(
   
   new
   
    Runnable() {

            @Override
            
   
   public
   
    
   
   void
   
    run() {
                
   
   while
   
    (
   
   !
   
   threadDisable) {
                    
   
   try
   
    {
                        Thread.sleep(
   
   1000
   
   );
                    } 
   
   catch
   
    (InterruptedException e) {
                    }
                    count
   
   ++
   
   ;
                    Log.v(
   
   "
   
   CountService
   
   "
   
   , 
   
   "
   
   Count is 
   
   "
   
    
   
   +
   
    count);
                }
            }
        }).start();
    }

    @Override
    
   
   public
   
    
   
   void
   
    onDestroy() {
        
   
   super
   
   .onDestroy();
        
   
   this
   
   .threadDisable 
   
   =
   
    
   
   true
   
   ;
        Log.v(
   
   "
   
   CountService
   
   "
   
   , 
   
   "
   
   on destroy
   
   "
   
   );
    }
}

  
  

配置文件AndroidManifest.xml和上面的类似， 只是ServiceConnection中返回的IBinder是代理对象，不能使用强转，改用Stub.asInterface()

在Activity中使用服务的差别不大，只需要对ServiceConnection中的调用远程服务的方法时，要捕获异常。

  
  

   
   private
   
    ServiceConnection serviceConnection 
   
   =
   
    
   
   new
   
    ServiceConnection() {

    @Override
    
   
   public
   
    
   
   void
   
    onServiceConnected(ComponentName name, IBinder service) {
        countService 
   
   =
   
    ICountService.Stub.asInterface(service); ;
        
   
   try
   
    {
            Log.v(
   
   "
   
   CountService
   
   "
   
   , 
   
   "
   
   on serivce connected, count is 
   
   "
   
   
                    
   
   +
   
    countService.getCount());
        } 
   
   catch
   
    (RemoteException e) {
            
   
   throw
   
    
   
   new
   
    RuntimeException(e);
        }
    }

    @Override
    
   
   public
   
    
   
   void
   
    onServiceDisconnected(ComponentName name) {
        countService 
   
   =
   
    
   
   null
   
   ;
    }

};
  
  

这样就可以在同一个应用程序中使用远程服务的方式和自己定义的服务交互了。

如果是另外的应用程序使用远程服务，需要做的是复制上面的aidl文件和相应的包构到应用程序中，其他调用等都一样。

下面是一个传参数的例子（string是可以作为基本数据类型传递的）：

  在AIDL中定义服务接口 
   为了展示远程服务实例，我们将编写一个股票报价服务。此服务将提供一种方法来获取股票代号并返回价格。要在Android 中编写远程服务，第一步是在 AID文件中定义服务的接口。 
   股票报价服务的 AIDL 定义 

Java代码  

1. //This file is IStockQuoteService.aidl  
2. package com.androidbook.stockquoteservice;  
3. interface IStockQuoteService  
4. {  
5.     double getQuote(String ticker);  
6. }  

在服务类中实现AIDL接口  
  上边我们为股票报价服务定义了 AIDL 文件并生成了绑定文件。现在我们将提供该服务的实现。要实现服务的接口，需要编写一个类来扩展 android.app.Service 并实现 IStockQuoteService接口。我们将编写的类 命名为 StockQuoteService。为了将服务向客户端公开，StockQuoteService 需要提供onBind()方法 的实现，我们还需要将一些配置信息添加到 AndroidManifest.xml文件中。  下面给出 我们服务类得实现。 
IStockQuoteService 服务实现。 
   

Java代码  

1. package com.androidbook.stockquoteservice;  
2.   
3. import android.app.Service;  
4. import android.content.Intent;  
5. import android.os.IBinder;  
6. import android.os.RemoteException;  
7. import android.util.Log;  
8.   
9. public class StockQuoteService extends Service {  
10.     private static final String TAG = "StockQuoteService";  
11.   
12.     public class StockQuoteServiceImpl extends IStockQuoteService.Stub {  
13.   
14.         @Override  
15.         public double getQuote(String ticker) throws RemoteException {  
16.             Log.v(TAG, "getQuote() called for " + ticker);  
17.             return 20.0;  
18.         }  
19.     }  
20.   
21.     @Override  
22.     public void onCreate() {  
23.         super.onCreate();  
24.         Log.v(TAG, "onCreate called");  
25.     }  
26.   
27.     @Override  
28.     public void onDestroy() {  
29.         super.onDestroy();  
30.         Log.v(TAG, "onDestory() called");  
31.     }  
32.   
33.     @Override  
34.     public void onStart(Intent intent, int startId) {  
35.         super.onStart(intent, startId);  
36.         Log.v(TAG, "onStart() called");  
37.     }  
38.   
39.     @Override  
40.     public IBinder onBind(Intent intent) {  
41.         Log.v(TAG, "onBind() called");  
42.         return new StockQuoteServiceImpl();  
43.     }  
44.   
45. }  

    在这个服务类中大家可以看到我们实现了 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代码  

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:orientation="vertical"  
4.     android:layout_width="fill_parent"  
5.     android:layout_height="fill_parent"  
6.     >  
7. <Button  
8.     android:id="@+id/bindBtn"  
9.     android:layout_width="wrap_content"  
10.     android:layout_height="wrap_content"  
11.     android:text="Bind"/>  
12.   
13. <Button  
14.     android:id="@+id/callBtn"  
15.     android:layout_height="wrap_content"  
16.     android:layout_width="wrap_content"  
17.     android:text="Call Again"/>  
18.   
19. <Button  
20.     android:id="@+id/unbindBtn"  
21.     android:layout_width="wrap_content"  
22.     android:layout_height="wrap_content"  
23.     android:text="UnBind"/>  
24. </LinearLayout>  

  MainActivity类 
 

Java代码  

1. package com.androidbook.stockquoteclient;  
2.   
3. import com.androidbook.stockquoteservice.IStockQuoteService;  
4. import android.app.Activity;  
5. import android.content.ComponentName;  
6. import android.content.Context;  
7. import android.content.Intent;  
8. import android.content.ServiceConnection;  
9. import android.os.Bundle;  
10. import android.os.IBinder;  
11. import android.os.RemoteException;  
12. import android.util.Log;  
13. import android.view.View;  
14. import android.view.View.OnClickListener;  
15. import android.widget.Button;  
16. import android.widget.Toast;  
17.   
18. public class MainActivity extends Activity {  
19.     protected static final String TAG = "StockQuoteClient";  
20.     private IStockQuoteService stockService = null;  
21.   
22.     private Button bindBtn;  
23.     private Button callBtn;  
24.     private Button unbindBtn;  
25.   
26.     @Override  
27.     public void onCreate(Bundle savedInstanceState) {  
28.         super.onCreate(savedInstanceState);  
29.         setContentView(R.layout.main);  
30.         bindBtn = (Button) findViewById(R.id.bindBtn);  
31.         bindBtn.setOnClickListener(new OnClickListener() {  
32.             @Override  
33.             public void onClick(View v) {  
34.                 bindService(new Intent(IStockQuoteService.class.getName()),  
35.                         serConn, Context.BIND_AUTO_CREATE);  
36.                 bindBtn.setEnabled(false);  
37.                 callBtn.setEnabled(true);  
38.                 unbindBtn.setEnabled(true);  
39.             }  
40.         });  
41.   
42.         callBtn = (Button) findViewById(R.id.callBtn);  
43.         callBtn.setOnClickListener(new OnClickListener() {  
44.             @Override  
45.             public void onClick(View v) {  
46.                 callService();  
47.             }  
48.         });  
49.         callBtn.setEnabled(false);  
50.   
51.         unbindBtn = (Button) findViewById(R.id.unbindBtn);  
52.         unbindBtn.setOnClickListener(new OnClickListener() {  
53.             @Override  
54.             public void onClick(View v) {  
55.                 unbindService(serConn);  
56.                 bindBtn.setEnabled(true);  
57.                 callBtn.setEnabled(false);  
58.                 unbindBtn.setEnabled(false);  
59.             }  
60.         });  
61.     }  
62.   
63.     private void callService() {  
64.         try {  
65.             double val = stockService.getQuote("SYH");  
66.             Toast.makeText(this, "Value from service is " + val,  
67.                     Toast.LENGTH_LONG).show();  
68.         } catch (RemoteException e) {  
69.             Log.e("MainActivity", e.getMessage(), e);  
70.         }  
71.     }  
72.   
73.     private ServiceConnection serConn = new ServiceConnection() {  
74.         // 此方法在系统建立服务连接时调用  
75.         @Override  
76.         public void onServiceConnected(ComponentName name, IBinder service) {  
77.             Log.v(TAG, "onServiceConnected() called");  
78.             stockService = IStockQuoteService.Stub.asInterface(service);  
79.             callService();  
80.         }  
81.   
82.         // 此方法在销毁服务连接时调用  
83.         @Override  
84.         public void onServiceDisconnected(ComponentName name) {  
85.             Log.v(TAG, "onServiceDisconnected()");  
86.             stockService = null;  
87.         }  
88.     };  
89. }  

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