0
点赞
收藏
分享

微信扫一扫

Android 使用【AIDL】调用外部服务

彪悍的鼹鼠 2023-07-31 阅读 30


在Android 中有一种服务说是服务其实倒不如说是一个接口,这个接口名为:Android Interface Definition Language ,这个接口可提供跨进程访问服务,英文缩写为:AIDL。

  此种服务的好处在于,多个应用程序之间建立共同的服务机制,通过AIDL在不同应用程序之间达到数据的共享和数据相互操作,下面将通过一个DEMO 演示AIDL 是如何为应用程序之间提供服务的。

本文大纲为:

  • 1、创建AIDL 服务端。
  • 2、创建AIDL 客户端。
  • 3、客户端调用服务端提供的服务接口。
  • 4、小结。

本文要实现的功能大致如下:创建AIDL服务端,此服务端将提供一个Student 的javabean 提供客户端取得数据,因为aidl 支持的数据类型比较简单,故这里建议把常用的数据类型的数据写入服务。

AIDL的创建方法: 
AIDL语法很简单,可以用来声明一个带一个或多个方法的接口,也可以传递参数和返回值。由于远程调用的需要, 这些参数和返回值并不是任何类型.下面是些AIDL支持的数据类型:
1. 不需要import声明的简单Java编程语言类型(int,boolean等)
2. String, CharSequence不需要特殊声明

3. List, Map和Parcelables类型, 这些类型内所包含的数据成员也只能是简单数据类型, String等其他比支持的类型.
(
(另外: 我没尝试Parcelables, 在Eclipse+ADT下编译不过, 或许以后会有所支持).
下面是AIDL语法:
// 文件名: SomeClass.aidl // 文件可以有注释, 跟java的一样 // 在package以前的注释, 将会被忽略. // 函数和变量以前的注释, 都会被加入到生产java代码中. package com.cmcc.demo;
// import 引入语句 import com.cmcc.demo.ITaskCallback;

interface ITaskBinder {
//函数跟java一样, 可以有0到多个参数 ,可以有一个返回值 boolean isTaskRunning();
void stopRunningTask(); //参数可以是另外的一个aidl定义的接口 void registerCallback(ITaskCallback cb);
void unregisterCallback(ITaskCallback cb);
//参数可以是String, 可以用in表入输入类型, out表示输出类型.
int getCustomerList(in String branch, out String customerList);
}

1、创建AIDL 服务端

在Android 的src 文件夹下的任意包里面新建文件,后缀名为*.aidl,如下图

Android 使用【AIDL】调用外部服务_java

输入如下代码:


package com.aidl.test;
 import com.aidl.test.Student;//Parcelables, 在Eclipse+ADT下编译不过, 或许以后会有所支持).interface IMyService
 {
         Map getMap(in String test_class,in Student student);
          Student getStudent();
 }

Student 类是一个序列化的类,这里使用Parcelable 接口来序列化是Google 提供的一个比Serializable 效率更高的序列化类。Student 



package 
   com.aidl.test;

 
   import 
   android.os.Parcel;
 
   import 
   android.os.Parcelable;

 
   public 
    
   class 
   Student  
   implements 
   Parcelable {

      
   private 
    
   int 
   age;
      
   private 
   String name;

      
   public 
    
   int 
   getAge() {
          
   return 
   age;
     }

      
   public 
    
   void 
   setAge( 
   int 
   age) {
          
   this 
   .age  
   = 
   age;
     }

      
   public 
   String getName() {
          
   return 
   name;
     }

      
   public 
    
   void 
   setName(String name) {
          
   this 
   .name  
   = 
   name;
     }

      
   public 
    
   static 
    
   final 
   Parcelable.Creator 
   < 
   Student 
   > 
   CREATOR  
   = 
    
   new 
   Creator 
   < 
   Student 
   > 
   () {

         @Override
          
   public 
   Student[] newArray( 
   int 
   size) {
              
   // 
   TODO Auto-generated method stub 
   
 
               
   return 
    
   new 
   Student[size];
         }

         @Override
          
   public 
   Student createFromParcel(Parcel source) {
              
   // 
   TODO Auto-generated method stub 
   
 
               
   return 
    
   new 
   Student(source);
         }
     };

      
   public 
   Student() {
     }

      
   public 
   Student(Parcel pl) {
         age  
   = 
   pl.readInt();
         name  
   = 
   pl.readString();
     }

     @Override
      
   public 
    
   int 
   describeContents() {
          
   // 
   TODO Auto-generated method stub 
   
 
           
   return 
    
   0 
   ;
     }

     @Override
      
   public 
    
   void 
   writeToParcel(Parcel dest,  
   int 
   flags) {
          
   // 
   TODO Auto-generated method stub 
   
 
          dest.writeInt(age);
         dest.writeString(name);
     }

 }

在这里必须注意,编写javabean时必须注意如下三点:

  • 在Student 类中必须有一个静态常量,常量名必须是CREATOR,而且CREATOR 常量的数据类型必须是 Parcelable.Creator
  • 在writeToParcel 方法中需要将要序列化的值写入到 Parcel对象中。
  • 编写完Student 为时,必须再新建一个Student.aidl 文件,此文件输入以下内容:
    parcelable Student; 这里的书写是供上面我们说过的接口  

如果上面的步骤顺利通过的话,Android 将会自动在gen 目录下R文件的相同目录生成一个以*.aidl 文件命名的*.java 文件,如下图:

Android 使用【AIDL】调用外部服务_ide_02

顺利生成成功后,我们再来编写一个AIDL 服务类,代码如下:



如上代码,MyService 服务类有一个子类并继承自我们上面生成的*.java 文件重写其中我们在*.aidl 中声明的两个接口方法,实现了其功能。上面IBinder 必须返回此服务类的子类对象,否则客户端将无法获得服务对象。

package 
   com.aidl.test;

 
   import 
   java.util.HashMap;
 
   import 
   java.util.Map;

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

 
   public 
    
   class 
   MyService  
   extends 
   Service {

     @Override
      
   public 
   IBinder onBind(Intent intent) {
          
   // 
   TODO Auto-generated method stub 
   
 
           
   return 
    
   new 
   MyServiceimpl();
     }

      
   public 
    
   class 
   MyServiceimpl  
   extends 
   IMyService.Stub {

         @Override
          
   public 
   Student getStudent()  
   throws 
   RemoteException {
              
   // 
   TODO Auto-generated method stub 
   
 
              Student st  
   = 
    
   new 
   Student();
             st.setAge( 
   18 
   );
             st.setName( 
   " 
   terry 
   " 
   );

              
   return 
   st;
         }

         @Override
          
   public 
   Map getMap(String testClass, Student student)
                  
   throws 
   RemoteException {
              
   // 
   TODO Auto-generated method stub 
   
 
              Map 
   < 
   String, Object 
   > 
   map  
   = 
    
   new 
   HashMap 
   < 
   String, Object 
   > 
   ();
             map.put( 
   " 
   class 
   " 
   ,  
   " 
   五年级 
   " 
   );
             map.put( 
   " 
   age 
   " 
   , student.getAge());
             map.put( 
   " 
   name 
   " 
   , student.getName());
              
   return 
   map;
         }

     }

 }

最后,即然有服务的操作,那么就得在manifest文件中注册服务类,代码如下:



< 
   service  
   android:name 
   =".MyService" 
   > 
   
      
   < 
   intent-filter 
   > 
   
          
   < 
   action  
   android:name 
   ="com.aidl.test.IMyService" 
   ></ 
   action 
   > 
   
      
   </ 
   intent-filter 
   > 
   
 
   </ 
   service 
   >




至此,服务端就己经开发完成了,下面接着开发客启端。

2、创建AIDL 客户端

同样是新建一个项目,这里要注意,需要将服务端生成成功后的gen 目录下的包复制过来,放到我们新建项目的src 文件夹下,如下图:

Android 使用【AIDL】调用外部服务_ide_03

因为IMyService 这个生成类,引用到了Student 这个javabean 所以这里一并将javabean也复制过来。

至此,客户端的创建己经完毕,下面我们就要利用创建的客户端去调用服务端的方法。


3、客户端调用服务端提供的服务接口

先看一下运行效果:

Android 使用【AIDL】调用外部服务_ide_02

细心的朋友会发现,上面的数据不是我们在上面客户端为Student 设置的数据吗?怎么在这个程序里面也同样得到了?没错。这就是aidl 的魅力,下面来看看如何调用 吧,图中有两个按钮,一个按钮为绑定AIDL 服务,即通过Activity 的 bindService 绑定 AIDL 外部服务,全部代码如下:



package 
   com.aidl.client;

 
   import 
   com.aidl.test.IMyService;

 
   import 
   android.app.Activity;
 
   import 
   android.app.AlertDialog;
 
   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.view.View;
 
   import 
   android.view.View.OnClickListener;
 
   import 
   android.widget.Button;

 
   public 
    
   class 
   aidlActivity  
   extends 
   Activity  
   implements 
   OnClickListener {
     Button btn1, btn2;

      
   private 
   IMyService myService  
   = 
    
   null 
   ;
      
   private 
   ServiceConnection serviceConnection  
   = 
    
   new 
   ServiceConnection() {

         @Override
          
   public 
    
   void 
   onServiceDisconnected(ComponentName name) {
              
   // 
   TODO Auto-generated method stub 
   
 
   
         }

         @Override
          
   public 
    
   void 
   onServiceConnected(ComponentName name, IBinder service) {
              
   // 
   TODO Auto-generated method stub 
   
 
              myService  
   = 
   IMyService.Stub.asInterface(service);
             btn2.setEnabled( 
   true 
   );

         }
     };

      
   
     @Override
      
   public 
    
   void 
   onCreate(Bundle savedInstanceState) {
          
   super 
   .onCreate(savedInstanceState);
         setContentView(R.layout.main);

         btn1  
   = 
   (Button) findViewById(R.id.Button01);
         btn2  
   = 
   (Button) findViewById(R.id.Button02);
         btn2.setEnabled( 
   false 
   );

         btn1.setOnClickListener( 
   this 
   );
         btn2.setOnClickListener( 
   this 
   );
     }

     @Override
      
   public 
    
   void 
   onClick(View v) {
          
   // 
   TODO Auto-generated method stub 
   
 
           
   switch 
   (v.getId()) {
          
   case 
   R.id.Button01:
             bindService( 
   new 
   Intent( 
   " 
   com.aidl.test.IMyService 
   " 
   ),
                     serviceConnection, Context.BIND_AUTO_CREATE);
              
   break 
   ;
          
   case 
   R.id.Button02:
             StringBuilder sb  
   = 
    
   new 
   StringBuilder();
              
   try 
   {
                 sb.append( 
   " 
   学生名称为: 
   " 
    
   + 
   myService.getStudent().getName()  
   + 
    
   " 
   \n 
   " 
   );
                 sb.append( 
   " 
   年龄为: 
   " 
    
   + 
   myService.getStudent().getAge()  
   + 
    
   " 
   \n 
   " 
   );
                 sb.append( 
   " 
   map 对象内容为如下: 
   " 
   
                          
   + 
   myService.getMap( 
   " 
   中国 
   " 
   , myService.getStudent())
                                 .toString());
             }  
   catch 
   (RemoteException e) {
                  
   // 
   TODO Auto-generated catch block 
   
 
                  e.printStackTrace();
             }

              
   new 
   AlertDialog.Builder(aidlActivity. 
   this 
   ).setTitle( 
   " 
   调用外部服务 
   " 
   )
                     .setMessage(sb.toString()).setPositiveButton(
                             android.R.string.ok,  
   null 
   ).show();
              
   break 
   ;
          
   default 
   :
              
   break 
   ;
         }
     }
 }




在ServiceConnetction里面对IMyService 进行初始化,即可操作该对象,该对象就可以得到我们所有要处理的数据。


4、小结

  • aidl 文件调用javabean 的aidl文件必须导包;
  • javabean 必须序列化,如果没有用javabean可以用简单的变量代替,如返回一个整型,返回一个字符串等。
  • 使用aidl 必须同时存在客户端和服务端,即客户端在本机上,服务端也在本机上,要使用客户端必须服务端事先在本机上注册过服务。
举报

相关推荐

0 条评论