博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
nullnullAndroid Interface Definition Language (AIDL) 接口描述语言
阅读量:6115 次
发布时间:2019-06-21

本文共 24161 字,大约阅读时间需要 80 分钟。

上班之余抽点时间出来写写博文,希望对新接触的朋友有帮助。今天在这里和大家一起学习一下nullnull

    AIDL (Android Interface Definition Language) is similar to other IDLs you might have worked with. It allows you to define the programming interface that both the client and service agree upon in order to communicate with each other using interprocess communication (IPC). On Android, one process cannot normally access the memory of another process. So to talk, they need to decompose their objects into primitives that the operating system can understand, and marshall the objects across that boundary for you. The code to do that marshalling is tedious to write, so Android handles it for you with AIDL.

    Note: Using AIDL is necessary only if you allow clients from different applications to access your service for IPC and want to handle multithreading in your service. If you do not need to perform concurrent IPC across different applications, you should create your interface by or, if you want to perform IPC, but donot need to handle multithreading, implement your interface . Regardless, be sure that you understand before implementing an AIDL.

    Before you begin designing your AIDL interface, be aware that calls to an AIDL interface are direct function calls. You should not make assumptions about the thread in which the call occurs. What happens is different depending on whether the call is from a thread in the local process or a remote process. Specifically:

    

  • Calls made from the local process are executed in the same thread that is making the call. If this is your main UI thread, that thread continues to execute in the AIDL interface. If it is another thread, that is the one that executes your code in the service. Thus, if only local threads are accessing the service, you can completely control which threads are executing in it (but if that is the case, then you shouldn't be using AIDL at all, but should instead create the interface by).
  • Calls from a remote process are dispatched from a thread pool the platform maintains inside of your own process. You must be prepared for incoming calls from unknown threads, with multiple calls happening at the same time. In other words, an implementation of an AIDL interface must be completely thread-safe.
  • The oneway keyword modifies the behavior of remote calls. When used, a remote call does not block; it simply sends the transaction data and immediately returns. The implementation of the interface eventually receives this as a regular call from the thread pool as a normal remote call. Ifoneway is used with a local call, there is no impact and the call is still synchronous.

    

Defining an AIDL Interface

    You must define your AIDL interface in an .aidl file using the Java programming language syntax, then save it in the source code (in thesrc/ directory) of both the application hosting the service and any other application that binds to the service.

    When you build each application that contains the .aidl file, the Android SDK tools generate an interface based on the .aidl file and save it in the project'sgen/ directory. The service must implement the interface as appropriate. The client applications can then bind to the service and call methods from the to perform IPC.

    To create a bounded service using AIDL, follow these steps:

    

  1. This file defines the programming interface with method signatures.

  2. The Android SDK tools generate an interface in the Java programming language, based on your.aidl file. This interface has an inner abstract class named Stub that extends and implements methods from your AIDL interface. You must extend theStub class and implement the methods.

  3. Implement a and override to return your implementation of theStub class.

    Caution: Any changes that you make to your AIDL interface after your first release must remain backward compatible in order to avoid breaking other applications that use your service. That is, because your.aidl file must be copied to other applications in order for them to access your service's interface, you must maintain support for the original interface.

    

1. Create the .aidl file

    AIDL uses a simple syntax that lets you declare an interface with one or more methods that can take parameters and return values. The parameters and return values can be of any type, even other AIDL-generated interfaces.

    You must construct the .aidl file using the Java programming language. Each.aidl file must define a single interface and requires only the interface declaration and method signatures.

    By default, AIDL supports the following data types:

    

  • All primitive types in the Java programming language (such as int,long, char, boolean, and so on)
  • All elements in the must be one of the supported data types in this list or one of the other AIDL-generated interfaces or parcelables you've declared. A may optionally be used as a "generic" class (for example,List<String>). The actual concrete class that the other side receives is always an, although the method is generated to use the interface.

  • All elements in the must be one of the supported data types in this list or one of the other AIDL-generated interfaces or parcelables you've declared. Generic maps, (such as those of the formMap<String,Integer> are not supported. The actual concrete class that the other side receives is always a, although the method is generated to use the interface.

    You must include an import statement for each additional type not listed above, even if they are defined in the same package as your interface.

    When defining your service interface, be aware that:

    

  • Methods can take zero or more parameters, and return a value or void.
  • All non-primitive parameters require a directional tag indicating which way the data goes. Eitherin, out, or inout (see the example below).

    Primitives are in by default, and cannot be otherwise.

    Caution: You should limit the direction to what is truly needed, because marshalling parameters is expensive.

  • All code comments included in the .aidl file are included in the generated interface (except for comments before the import and package statements).
  • Only methods are supported; you cannot expose static fields in AIDL.

    Here is an example .aidl file:

// IRemoteService.aidlpackage com.example.android;// Declare any non-default types here with import statements/** Example service interface */interface IRemoteService {    /** Request the process ID of this service, to do evil things with it. */    int getPid();    /** Demonstrates some basic types that you can use as parameters     * and return values in AIDL.     */    void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat,            double aDouble, String aString);}

    Simply save your .aidl file in your project's src/ directory and when you build your application, the SDK tools generate the interface file in your project's gen/ directory. The generated file name matches the.aidl file name, but with a .java extension (for example,IRemoteService.aidl results in IRemoteService.java).

    If you use Eclipse, the incremental build generates the binder class almost immediately. If you do not use Eclipse, then the Ant tool generates the binder class next time you build your application—you should build your project withant debug (or ant release) as soon as you're finished writing the.aidl file, so that your code can link against the generated class.

    

2. Implement the interface

    When you build your application, the Android SDK tools generate a .java interface file named after your.aidl file. The generated interface includes a subclass named Stub that is an abstract implementation of its parent interface (for example,YourInterface.Stub) and declares all the methods from the .aidl file.

    Note: Stub also defines a few helper methods, most notablyasInterface(), which takes an (usually the one passed to a client's callback method) and returns an instance of the stub interface. See the section for more details on how to make this cast.

    To implement the interface generated from the .aidl, extend the generated interface (for example, YourInterface.Stub) and implement the methods inherited from the.aidl file.

    Here is an example implementation of an interface called IRemoteService (defined by theIRemoteService.aidl example, above) using an anonymous instance:

private final IRemoteService.Stub mBinder = new IRemoteService.Stub() {    public int getPid(){        return Process.myPid();    }    public void basicTypes(int anInt, long aLong, boolean aBoolean,        float aFloat, double aDouble, String aString) {        // Does nothing    }};

    Now the mBinder is an instance of the Stub class (a ), which defines the RPC interface for the service. In the next step, this instance is exposed to clients so they can interact with the service.

    There are a few rules you should be aware of when implementing your AIDL interface:

    

  • Incoming calls are not guaranteed to be executed on the main thread, so you need to think about multithreading from the start and properly build your service to be thread-safe.
  • By default, RPC calls are synchronous. If you know that the service takes more than a few milliseconds to complete a request, you should not call it from the activity's main thread, because it might hang the application (Android might display an "Application is Not Responding" dialog)—you should usually call them from a separate thread in the client.
  • No exceptions that you throw are sent back to the caller.

    

3. Expose the interface to clients

    Once you've implemented the interface for your service, you need to expose it to clients so they can bind to it. To expose the interface for your service, extend and implement to return an instance of your class that implements the generatedStub (as discussed in the previous section). Here's an example service that exposes theIRemoteService example interface to clients.

public class RemoteService extends Service {    @Override    public void onCreate() {        super.onCreate();    }    @Override    public IBinder onBind(Intent intent) {        // Return the interface        return mBinder;    }    private final IRemoteService.Stub mBinder = new IRemoteService.Stub() {        public int getPid(){            return Process.myPid();        }        public void basicTypes(int anInt, long aLong, boolean aBoolean,            float aFloat, double aDouble, String aString) {            // Does nothing        }    };}

    Now, when a client (such as an activity) calls to connect to this service, the client's callback receives the mBinder instance returned by the service's method.

    The client must also have access to the interface class, so if the client and service are in separate applications, then the client's application must have a copy of the.aidl file in its src/ directory (which generates the android.os.Binder interface—providing the client access to the AIDL methods).

    When the client receives the in the callback, it must call YourServiceInterface.Stub.asInterface(service) to cast the returned parameter toYourServiceInterface type. For example:

IRemoteService mIRemoteService;private ServiceConnection mConnection = new ServiceConnection() {    // Called when the connection with the service is established    public void onServiceConnected(ComponentName className, IBinder service) {        // Following the example above for an AIDL interface,        // this gets an instance of the IRemoteInterface, which we can use to call on the service        mIRemoteService = IRemoteService.Stub.asInterface(service);    }    // Called when the connection with the service disconnects unexpectedly    public void onServiceDisconnected(ComponentName className) {        Log.e(TAG, "Service has unexpectedly disconnected");        mIRemoteService = null;    }};
    每日一道理
在每个人心中,都曾停留过那些值得怀念的人,也许还在,也许早已消逝,在茫茫人海中丢失,于是,那份怀念便得凄凉,因为模糊的记忆中只剩下一个“空壳”,没有什么,甚至连自己的心都装不下,时间把一切抹平,也把当日的泪水封锁,因为已经没有,怀念只是悲凉!

    For more sample code, see the class in.

    

Passing Objects over IPC

    If you have a class that you would like to send from one process to another through an IPC interface, you can do that. However, you must ensure that the code for your class is available to the other side of the IPC channel and your class must support the interface. Supporting the interface is important because it allows the Android system to decompose objects into primitives that can be marshalled across processes.

    To create a class that supports the protocol, you must do the following:

    

  1. Make your class implement the interface.
  2. Implement , which takes the current state of the object and writes it to a.
  3. Add a static field called CREATOR to your class which is an object implementing the interface.
  4. Finally, create an .aidl file that declares your parcelable class (as shown for theRect.aidl file, below).

    If you are using a custom build process, do not add the .aidl file to your build. Similar to a header file in the C language, this.aidl file isn't compiled.

    AIDL uses these methods and fields in the code it generates to marshall and unmarshall your objects.

    For example, here is a Rect.aidl file to create a Rect class that's parcelable:

package android.graphics;// Declare Rect so AIDL can find it and knows that it implements// the parcelable protocol.parcelable Rect;

    And here is an example of how the class implements the protocol.

import android.os.Parcel;import android.os.Parcelable;public final class Rect implements Parcelable {    public int left;    public int top;    public int right;    public int bottom;    public static final Parcelable.Creator
CREATOR = newParcelable.Creator
() { public Rect createFromParcel(Parcel in) { return new Rect(in); } public Rect[] newArray(int size) { return new Rect[size]; } }; public Rect() { } private Rect(Parcel in) { readFromParcel(in); } public void writeToParcel(Parcel out) { out.writeInt(left); out.writeInt(top); out.writeInt(right); out.writeInt(bottom); } public void readFromParcel(Parcel in) { left = in.readInt(); top = in.readInt(); right = in.readInt(); bottom = in.readInt(); }}

    The marshalling in the Rect class is pretty simple. Take a look at the other methods on to see the other kinds of values you can write to a Parcel.

    Warning: Don't forget the security implications of receiving data from other processes. In this case, theRect reads four numbers from the , but it is up to you to ensure that these are within the acceptable range of values for whatever the caller is trying to do. See for more information about how to keep your application secure from malware.

    

Calling an IPC Method

    Here are the steps a calling class must take to call a remote interface defined with AIDL:

    

  1. Include the .aidl file in the project src/ directory.
  2. Declare an instance of the interface (generated based on the AIDL).
  3. Implement .
  4. Call , passing in your implementation.
  5. In your implementation of , you will receive an instance (called service). Call YourInterfaceName.Stub.asInterface((IBinder)service) to cast the returned parameter toYourInterface type.
  6. Call the methods that you defined on your interface. You should always trap exceptions, which are thrown when the connection has broken; this will be the only exception thrown by remote methods.
  7. To disconnect, call with the instance of your interface.

    A few comments on calling an IPC service:

    

  • Objects are reference counted across processes.
  • You can send anonymous objects as method arguments.

    For more information about binding to a service, read the document.

    Here is some sample code demonstrating calling an AIDL-created service, taken from the Remote Service sample in the ApiDemos project.

public static class Binding extends Activity {    /** The primary interface we will be calling on the service. */    IRemoteService mService = null;    /** Another interface we use on the service. */    ISecondary mSecondaryService = null;    Button mKillButton;    TextView mCallbackText;    private boolean mIsBound;    /**     * Standard initialization of this activity.  Set up the UI, then wait     * for the user to poke it before doing anything.     */    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.remote_service_binding);        // Watch for button clicks.        Button button = (Button)findViewById(R.id.bind);        button.setOnClickListener(mBindListener);        button = (Button)findViewById(R.id.unbind);        button.setOnClickListener(mUnbindListener);        mKillButton = (Button)findViewById(R.id.kill);        mKillButton.setOnClickListener(mKillListener);        mKillButton.setEnabled(false);        mCallbackText = (TextView)findViewById(R.id.callback);        mCallbackText.setText("Not attached.");    }    /**     * Class for interacting with the main interface of the service.     */    private ServiceConnection mConnection = new ServiceConnection() {        public void onServiceConnected(ComponentName className,                IBinder service) {            // This is called when the connection with the service has been            // established, giving us the service object we can use to            // interact with the service.  We are communicating with our            // service through an IDL interface, so get a client-side            // representation of that from the raw service object.            mService = IRemoteService.Stub.asInterface(service);            mKillButton.setEnabled(true);            mCallbackText.setText("Attached.");            // We want to monitor the service for as long as we are            // connected to it.            try {                mService.registerCallback(mCallback);            } catch (RemoteException e) {                // In this case the service has crashed before we could even                // do anything with it; we can count on soon being                // disconnected (and then reconnected if it can be restarted)                // so there is no need to do anything here.            }            // As part of the sample, tell the user what happened.            Toast.makeText(Binding.this, R.string.remote_service_connected,                    Toast.LENGTH_SHORT).show();        }        public void onServiceDisconnected(ComponentName className) {            // This is called when the connection with the service has been            // unexpectedly disconnected -- that is, its process crashed.            mService = null;            mKillButton.setEnabled(false);            mCallbackText.setText("Disconnected.");            // As part of the sample, tell the user what happened.            Toast.makeText(Binding.this, R.string.remote_service_disconnected,                    Toast.LENGTH_SHORT).show();        }    };    /**     * Class for interacting with the secondary interface of the service.     */    private ServiceConnection mSecondaryConnection = new ServiceConnection() {        public void onServiceConnected(ComponentName className,                IBinder service) {            // Connecting to a secondary interface is the same as any            // other interface.            mSecondaryService = ISecondary.Stub.asInterface(service);            mKillButton.setEnabled(true);        }        public void onServiceDisconnected(ComponentName className) {            mSecondaryService = null;            mKillButton.setEnabled(false);        }    };    private OnClickListener mBindListener = new OnClickListener() {        public void onClick(View v) {            // Establish a couple connections with the service, binding            // by interface names.  This allows other applications to be            // installed that replace the remote service by implementing            // the same interface.            bindService(new Intent(IRemoteService.class.getName()),                    mConnection, Context.BIND_AUTO_CREATE);            bindService(new Intent(ISecondary.class.getName()),                    mSecondaryConnection, Context.BIND_AUTO_CREATE);            mIsBound = true;            mCallbackText.setText("Binding.");        }    };    private OnClickListener mUnbindListener = new OnClickListener() {        public void onClick(View v) {            if (mIsBound) {                // If we have received the service, and hence registered with                // it, then now is the time to unregister.                if (mService != null) {                    try {                        mService.unregisterCallback(mCallback);                    } catch (RemoteException e) {                        // There is nothing special we need to do if the service                        // has crashed.                    }                }                // Detach our existing connection.                unbindService(mConnection);                unbindService(mSecondaryConnection);                mKillButton.setEnabled(false);                mIsBound = false;                mCallbackText.setText("Unbinding.");            }        }    };    private OnClickListener mKillListener = new OnClickListener() {        public void onClick(View v) {            // To kill the process hosting our service, we need to know its            // PID.  Conveniently our service has a call that will return            // to us that information.            if (mSecondaryService != null) {                try {                    int pid = mSecondaryService.getPid();                    // Note that, though this API allows us to request to                    // kill any process based on its PID, the kernel will                    // still impose standard restrictions on which PIDs you                    // are actually able to kill.  Typically this means only                    // the process running your application and any additional                    // processes created by that app as shown here; packages                    // sharing a common UID will also be able to kill each                    // other's processes.                    Process.killProcess(pid);                    mCallbackText.setText("Killed service process.");                } catch (RemoteException ex) {                    // Recover gracefully from the process hosting the                    // server dying.                    // Just for purposes of the sample, put up a notification.                    Toast.makeText(Binding.this,                            R.string.remote_call_failed,                            Toast.LENGTH_SHORT).show();                }            }        }    };    // ----------------------------------------------------------------------    // Code showing how to deal with callbacks.    // ----------------------------------------------------------------------    /**     * This implementation is used to receive callbacks from the remote     * service.     */    private IRemoteServiceCallback mCallback = new IRemoteServiceCallback.Stub() {        /**         * This is called by the remote service regularly to tell us about         * new values.  Note that IPC calls are dispatched through a thread         * pool running in each process, so the code executing here will         * NOT be running in our main thread like most other things -- so,         * to update the UI, we need to use a Handler to hop over there.         */        public void valueChanged(int value) {            mHandler.sendMessage(mHandler.obtainMessage(BUMP_MSG, value, 0));        }    };    private static final int BUMP_MSG = 1;    private Handler mHandler = new Handler() {        @Override public void handleMessage(Message msg) {            switch (msg.what) {                case BUMP_MSG:                    mCallbackText.setText("Received from service: " + msg.arg1);                    break;                default:                    super.handleMessage(msg);            }        }    };}

文章结束给大家分享下程序员的一些笑话语录: 人脑与电脑的相同点和不同点,人脑会记忆数字,电脑也会记忆数字;人脑会记忆程序,电脑也会记忆程序,但是人脑具有感知能力,这种能力电脑无法模仿,人的记忆会影响到人做任何事情,但是电脑只有程序软件。比尔还表示,人脑与电脑之间最重要的一个差别就是潜意识。对于人脑存储记忆的特别之处,比尔表示,人脑并不大,但是人脑重要的功能是联络,人脑会把同样的记忆存储在不同的地方,因此记忆读取的速度就不相同,而这种速度取决于使用的频率和知识的重要性。人脑的记忆存储能力会随着年龄增长而退化,同时记忆的质量也会随着年龄退化。经典语录网

转载地址:http://fqcka.baihongyu.com/

你可能感兴趣的文章
Data Wrangling文摘:Non-tidy-data
查看>>
加解密算法、消息摘要、消息认证技术、数字签名与公钥证书
查看>>
while()
查看>>
常用限制input的方法
查看>>
Ext Js简单事件处理和对象作用域
查看>>
IIS7下使用urlrewriter.dll配置
查看>>
12.通过微信小程序端访问企查查(采集工商信息)
查看>>
WinXp 开机登录密码
查看>>
POJ 1001 Exponentiation
查看>>
HDU 4377 Sub Sequence[串构造]
查看>>
云时代架构阅读笔记之四
查看>>
WEB请求处理一:浏览器请求发起处理
查看>>
Lua学习笔记(8): 元表
查看>>
PHP经典算法题
查看>>
LeetCode 404 Sum of Left Leaves
查看>>
醋泡大蒜有什么功效
查看>>
hdu 5115(2014北京—dp)
查看>>
数据结构中常见的树(BST二叉搜索树、AVL平衡二叉树、RBT红黑树、B-树、B+树、B*树)...
查看>>
PHP读取日志里数据方法理解
查看>>
第五十七篇、AVAssetReader和AVAssetWrite 对视频进行编码
查看>>