Android远程服务编写和调用教程

所属分类: 软件编程 / Android 阅读数: 1167
收藏 0 赞 0 分享

网上汗牛充栋的文章都是介绍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等接口和类来进行远程服务编写调用。

以上就是本文的全部内容,希望对大家的学习有所帮助。

更多精彩内容其他人还在看

Android控件系列之CheckBox使用介绍

CheckBox和Button一样,也是一种古老的控件,它的优点在于,不用用户去填写具体的信息,只需轻轻点击,缺点在于只有“是”和“否”两种情况,但我们往往利用它的这个特性,来获取用户的一些信息
收藏 0 赞 0 分享

Android控件系列之EditText使用方法

EditText是接受用户输入信息的最重要控件。通过前面课程的学习,您可能会猜到可以利用EditText.getText()获取它的文本,但真正的项目中,可能没那么简单,需要更多的限制,如文本长度限制,是否数字限制等等
收藏 0 赞 0 分享

Android控件系列之TextView使用介绍

TextView类似一般UI中的Label,TextBlock等控件,只是为了单纯的显示一行或多行文本,本文介绍了Android中文本控件TextView的用法和常用属性的用法
收藏 0 赞 0 分享

asynctask的用法详解

Android UI操作并不是线程安全的并且这些操作必须在UI线程中执行,本文将为您介绍asynctask的用法
收藏 0 赞 0 分享

Android开发 旋转屏幕导致Activity重建解决方法

Android开发文档上专门有一小节解释这个问题。简单来说,Activity是负责与用户交互的最主要机制,接下来为您详细介绍
收藏 0 赞 0 分享

Notification与NotificationManager详细介绍

在Android系统中,发一个状态栏通知还是很方便的。下面我们就来看一下,怎么发送状态栏通知,状态栏通知又有哪些参数可以设置
收藏 0 赞 0 分享

android LinearLayout和RelativeLayout组合实现精确布局方法介绍

用android LinearLayout和RelativeLayout实现精确布局此方法适合很适合新人看
收藏 0 赞 0 分享

android listview优化几种写法详细介绍

这篇文章只是总结下getView里面优化视图的几种写法,需要的朋友可以参考下
收藏 0 赞 0 分享

Android应用开发SharedPreferences存储数据的使用方法

SharedPreferences是Android中最容易理解的数据存储技术,实际上SharedPreferences处理的就是一个key-value(键值对)SharedPreferences常用来存储一些轻量级的数据
收藏 0 赞 0 分享

Android之PreferenceActivity应用详解

为了引入这个概率 首先从需求说起 即:现有某Activity专门用于手机属性设置 那么应该如何做呢
收藏 0 赞 0 分享
查看更多