接口描述语言 AIDL 中 in、out、inout 用法指南

AIDL 简介

AIDL（Android Interface Definition Language）是 Android 系统中用于跨进程通信接口的一种语言。AIDL 文件定义了服务端和客户端之间可以调用的方法，以及这些方法的参数和返回值类型。AIDL 文件的语法类似于 Java，但它只支持有限的一组数据类型。

AIDL 文件在编译时会生成一个 Java 接口和一个 Binder 实现类。服务端和客户端可以使用这个 Java 接口来进行通信。Binder 是 Android 系统中用于跨进程通信的机制。它负责在不同的进程之间传递消息和数据。

AIDL 中的 in、out、inout 参数

AIDL 中的方法参数可以是 in、out 或 inout 类型。这三个参数类型决定了数据在服务端和客户端之间是如何传递的。

in 参数

in 参数表示数据只能从客户端传递到服务端。服务端对该参数的修改不会影响到客户端。in 参数必须实现 Parcelable 接口。Parcelable 接口是一个序列化接口，它允许对象被写入和读取到 Parcel 对象中。Parcel 对象是 Android 系统中用于在进程之间传递数据的一种数据结构。

out 参数

out 参数表示数据只能从服务端传递到客户端。客户端对该参数的修改不会影响到服务端。out 参数不需要实现 Parcelable 接口。

inout 参数

inout 参数表示数据可以从客户端传递到服务端，也可以从服务端传递到客户端。服务端和客户端都可以修改该参数。inout 参数必须实现 Parcelable 接口。

in、out、inout 参数的使用示例

以下是一个使用 AIDL 进行跨进程通信的示例代码：

// AIDL 文件
package com.example.aidldemo;

interface IMyAidlInterface {
    int add(int a, int b);
    void setStringValue(String value);
    String getStringValue();
}

// 服务端实现
package com.example.aidldemo;

public class MyAidlServiceImpl extends IMyAidlInterface.Stub {
    @Override
    public int add(int a, int b) {
        return a + b;
    }

    @Override
    public void setStringValue(String value) {
        // ...
    }

    @Override
    public String getStringValue() {
        // ...
        return "";
    }
}

// 客户端使用
package com.example.aidldemo;

public class MyAidlClient {
    private IMyAidlInterface mService;

    public MyAidlClient() {
        // ...
        mService = IMyAidlInterface.Stub.asInterface(binder);
    }

    public int add(int a, int b) {
        return mService.add(a, b);
    }

    public void setStringValue(String value) {
        mService.setStringValue(value);
    }

    public String getStringValue() {
        return mService.getStringValue();
    }
}

在这个示例中，IMyAidlInterface 接口定义了三个方法：add()、setStringValue() 和 getStringValue()。add() 方法的两个参数都是 in 类型，表示这两个参数只能从客户端传递到服务端。setStringValue() 方法的参数是 out 类型，表示该参数只能从服务端传递到客户端。getStringValue() 方法没有参数，返回值类型是 String。

在服务端实现中，MyAidlServiceImpl 类实现了 IMyAidlInterface 接口。add() 方法简单地返回两个参数的和。setStringValue() 方法将参数值存储到一个成员变量中。getStringValue() 方法返回成员变量的值。

在客户端使用中，MyAidlClient 类通过 Binder 对象获取 IMyAidlInterface 接口的 Stub 对象。然后，客户端就可以使用这个 Stub 对象来调用服务端的方法。

总结

AIDL 中的 in、out、inout 参数决定了数据在服务端和客户端之间是如何传递的。in 参数只能从客户端传递到服务端，服务端对该参数的修改不会影响到客户端。out 参数只能从服务端传递到客户端，客户端对该参数的修改不会影响到服务端。inout 参数可以从客户端传递到服务端，也可以从服务端传递到客户端，服务端和客户端都可以修改该参数。

在使用 AIDL 进行跨进程通信时，需要根据具体的需求选择合适的参数类型。如果数据只需要从客户端传递到服务端，则可以使用 in 参数。如果数据只需要从服务端传递到客户端，则可以使用 out 参数。如果数据需要在服务端和客户端之间传递，则可以使用 inout 参数。