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等接口和类来进行远程服务编写调用。

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

时间: 2024-10-02 22:22:24

Android远程服务编写和调用教程的相关文章

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

网上汗牛充栋的文章都是介绍Android远程服务的,一个个将Binder机制.AIDL讲得头头是道,然而没有几个人能够给出清晰的范例说明如何用最快的方法学会编写和调用一个Android远程服务.若你仅仅是想如何编写或者调用Android的远程服务,而懒得去理解Binder机制是如何运行的,那么本篇文章正好适合你.毕竟现在人人都会开车,但没有几个人明白发动机到底是如何运作的. 预备知识 读者应该有基本的java知识,和Android简单app的开发经验. 环境 代码运行环境: 1.ADT2014版

代码-用java语言编写android程序,实现调用usb打印机图片功能

问题描述 用java语言编写android程序,实现调用usb打印机图片功能 用java语言编写android程序,实现调用usb打印机图片功能,打印机不能联网,只是用代码去调用usb接口的打印机.急需实现此功能,请大神们帮帮忙 解决方案 http://blog.csdn.net/kangear/article/details/18141741 解决方案二: http://www.360doc.com/content/13/0906/12/11482448_312596809.shtml

Android Activity之间相互调用与传递参数的原理与用法分析_Android

本文实例讲述了Android Activity之间的相互调用与传递参数.分享给大家供大家参考,具体如下: Activity之间是如何调用的 在javaWeb程序中,jsp与jsp之间的调用是通过重定向完成的,而在Android中,Activity与Activity之间的切换是通过Intent来完成的. 所谓Intent,它是Android中非常重要的内置组件,他可以理解为"我要干一件什么事情".在Android中有3大组件:Activity,Service.Broadcast,他们之间

Android Activity之间相互调用与传递参数的原理与用法分析

本文实例讲述了Android Activity之间的相互调用与传递参数.分享给大家供大家参考,具体如下: Activity之间是如何调用的 在javaWeb程序中,jsp与jsp之间的调用是通过重定向完成的,而在Android中,Activity与Activity之间的切换是通过Intent来完成的. 所谓Intent,它是Android中非常重要的内置组件,他可以理解为"我要干一件什么事情".在Android中有3大组件:Activity,Service.Broadcast,他们之间

我们也说说Android.mk(2) - 函数进阶教程 - 分支、循环、子程序

我们也说说Android.mk(2) 函数进阶教程 - 分支.循环.子程序 按照面向过程程序设计的标准流程,我们讲完了顺序结构,就要讲分支.循环和子程序.下面我们就开始讲用于分支.循环和子程序调用功能的函数. 分支函数 要走分支,一定是要有条件要判断. 在Makefile里,最主要的判断就是看字符串能不能找到了. 通过findstring函数来进行这个判断,然后用if函数使用findstring函数的结果. 例: .PHONY : all5 bootoatfile := out/target/p

Android WebView 应用界面开发教程_Android

WebView组件本身就是一个浏览器实现,Android5.0增强的WebView基于Chromium M37,直接支持WebRTC.WebAudio.WebGL.开发者可以直接在WebView中使用聚合(Polymer)和Material设计. 一.WebView浏览网页(加载线上URL) WebView提供了很多方法执行浏览器操作,常用方法如下: void goBack():后退 void goForward():前进. void goBackOrForward(int step):step

Android studio编写简单的手电筒APP_Android

很不错的手电筒APP,分享给大家,希望大家喜欢. 1. Java代码     package com.example.goo.gfire; import android.app.Activity; import android.hardware.Camera; import android.hardware.Camera.Parameters; import android.os.Bundle; import android.view.View; import android.widget.Bu

在Ubuntu上为Android系统编写Linux内核驱动程序

在智能手机时代,每个品牌的手机都有自己的个性特点.正是依靠这种与众不同的个性来吸引用户,营造品牌凝聚力和用户忠城度,典型的代表非iphone莫属了.据统计,截止2011年5月,AppStore的应用软件数量达381062个,位居第一,而Android Market的应用软件数量达294738,紧随AppStore后面,并有望在8月份越过AppStore.随着Android系统逐步扩大市场占有率,终端设备的多样性亟需更多的移动开发人员的参与.据业内统计,Android研发人才缺口至少30万.目前,

Android studio配置lambda表达式教程

Java 8的一个大亮点是引入Lambda表达式,使用它设计的代码会更加简洁.当开发者在编写Lambda表达式时,也会随之被编译成一个函数式接口. 但是目前的Android Studio还不支持Java8新特性,因此为了使用它只能曲线救国了:借助retrolambda 1.将你的jdk升级成1.8,然后配置好环境 2.将你的sdk更新至24 3.在项目的Project gradle文件配置retrolambda插件的地址: 如下: buildscript { repositories { jce