鸿蒙开发通信与连接：【@ohos.rpc (RPC通信)】

于 2024-06-20 22:22:54 发布
阅读量1.1k 收藏 19
点赞数 18
分类专栏： 鸿蒙开发学习笔录 文章标签： harmonyos 鸿蒙开发 OpenHarmony 鸿蒙系统 网络协议 通信 rpc
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/139843997
版权

RPC通信

本模块提供进程间通信能力，包括设备内的进程间通信（IPC）和设备间的进程间通信（RPC），前者基于Binder驱动，后者基于软总线驱动。

icon-note.gif 说明：  本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import rpc from '@ohos.rpc';

MessageParcel

该类提供读写基础类型及数组、IPC对象、接口描述符和自定义序列化对象的方法。

create

create(): MessageParcel

静态方法，创建MessageParcel对象。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
MessageParcel返回创建的MessageParcel对象。

示例：

let data = rpc.MessageParcel.create();
console.log("RpcClient: data is " + data);

reclaim

reclaim(): void

释放不再使用的MessageParcel对象。

系统能力：SystemCapability.Communication.IPC.Core

示例：

let reply = rpc.MessageParcel.create();
reply.reclaim();

writeRemoteObject

writeRemoteObject(object: [IRemoteObject]): boolean

序列化远程对象并将其写入MessageParcel对象。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
object[IRemoteObject]是要序列化并写入MessageParcel的远程对象。

返回值：

类型说明
boolean如果操作成功，则返回true；否则返回false。

示例：

class MyDeathRecipient {
    onRemoteDied() {
        console.log("server died");
    }
}
class TestRemoteObject extends rpc.RemoteObject {
    constructor(descriptor) {
        super(descriptor);
    }
    addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    isObjectDead(): boolean {
        return false;
    }
}
let data = rpc.MessageParcel.create();
let testRemoteObject = new TestRemoteObject("testObject");
data.writeRemoteObject(testRemoteObject);

readRemoteObject

readRemoteObject(): IRemoteObject

从MessageParcel读取远程对象。此方法用于反序列化MessageParcel对象以生成IRemoteObject。远程对象按写入MessageParcel的顺序读取。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
[IRemoteObject]读取到的远程对象。

示例：

class MyDeathRecipient {
    onRemoteDied() {
        console.log("server died");
    }
}
class TestRemoteObject extends rpc.RemoteObject {
    constructor(descriptor) {
        super(descriptor);
    }
    addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    isObjectDead(): boolean {
        return false;
    }
}
let data = rpc.MessageParcel.create();
let testRemoteObject = new TestRemoteObject("testObject");
data.writeRemoteObject(testRemoteObject);
let proxy = data.readRemoteObject();

writeInterfaceToken

writeInterfaceToken(token: string): boolean

将接口描述符写入MessageParcel对象。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
tokenstring是字符串类型描述符。

返回值：

类型说明
boolean如果操作成功，则返回true；否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeInterfaceToken("aaa");
console.log("RpcServer: writeInterfaceToken is " + result);

readInterfaceToken

readInterfaceToken(): string

从MessageParcel中读取接口描述符。接口描述符按写入MessageParcel的顺序读取。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
string返回读取到的接口描述符。

示例：

class Stub extends rpc.RemoteObject {
    onRemoteRequest(code, data, reply, option) {
        let interfaceToken = data.readInterfaceToken();
        console.log("RpcServer: interfaceToken is " + interfaceToken);
        return true;
    }
}

getSize

getSize(): number

获取当前MessageParcel的数据大小。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number获取的MessageParcel的数据大小。以字节为单位。

示例：

let data = rpc.MessageParcel.create();
let size = data.getSize();
console.log("RpcClient: size is " + size);

getCapacity

getCapacity(): number

获取当前MessageParcel的容量。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number获取的MessageParcel的容量大小。以字节为单位。

示例：

let data = rpc.MessageParcel.create();
let result = data.getCapacity();
console.log("RpcClient: capacity is " + result);

setSize

setSize(size: number): boolean

设置MessageParcel实例中包含的数据大小。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
sizenumber是MessageParcel实例的数据大小。以字节为单位。

返回值：

类型说明
boolean设置成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let setSize = data.setSize(16);
console.log("RpcClient: setSize is " + setSize);

setCapacity

setCapacity(size: number): boolean

设置MessageParcel实例的存储容量。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
sizenumber是MessageParcel实例的存储容量。以字节为单位。

返回值：

类型说明
boolean设置成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.setCapacity(100);
console.log("RpcClient: setCapacity is " + result);

getWritableBytes

getWritableBytes(): number

获取MessageParcel的可写字节空间。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number获取到的MessageParcel的可写字节空间。以字节为单位。

示例：

class Stub extends rpc.RemoteObject {
    onRemoteRequest(code, data, reply, option) {
        let getWritableBytes = data.getWritableBytes();
        console.log("RpcServer: getWritableBytes is " + getWritableBytes);
        return true;
    }
}

getReadableBytes

getReadableBytes(): number

获取MessageParcel的可读字节空间。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number获取到的MessageParcel的可读字节空间。以字节为单位。

示例：

class Stub extends rpc.RemoteObject {
    onRemoteRequest(code, data, reply, option) {
        let result = data.getReadableBytes();
        console.log("RpcServer: getReadableBytes is " + result);
        return true;
    }
}

getReadPosition

getReadPosition(): number

获取MessageParcel的读位置。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回MessageParcel实例中的当前读取位置。

示例：

let data = rpc.MessageParcel.create();
let readPos = data.getReadPosition();
console.log("RpcClient: readPos is " + readPos);

getWritePosition

getWritePosition(): number

获取MessageParcel的写位置。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回MessageParcel实例中的当前写入位置。

示例：

let data = rpc.MessageParcel.create();
data.writeInt(10);
let bwPos = data.getWritePosition();
console.log("RpcClient: bwPos is " + bwPos);

rewindRead

rewindRead(pos: number): boolean

重新偏移读取位置到指定的位置。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
posnumber是开始读取数据的目标位置。

返回值：

类型说明
boolean如果读取位置发生更改，则返回true；否则返回false。

示例：

let data = rpc.MessageParcel.create();
data.writeInt(12);
data.writeString("parcel");
let number = data.readInt();
console.log("RpcClient: number is " + number);
data.rewindRead(0);
let number2 = data.readInt();
console.log("RpcClient: rewindRead is " + number2);

rewindWrite

rewindWrite(pos: number): boolean

重新偏移写位置到指定的位置。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
posnumber是开始写入数据的目标位置。

返回值：

类型说明
boolean如果写入位置更改，则返回true；否则返回false。

示例：

let data = rpc.MessageParcel.create();
data.writeInt(4);
data.rewindWrite(0);
data.writeInt(5);
let number = data.readInt();
console.log("RpcClient: rewindWrite is: " + number);

writeByte

writeByte(val: number): boolean

将字节值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valnumber是要写入的字节值。

返回值：

类型说明
boolean写入返回成功，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeByte(2);
console.log("RpcClient: writeByte is: " + result);

readByte

readByte(): number

从MessageParcel实例读取字节值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回字节值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeByte(2);
console.log("RpcClient: writeByte is: " + result);
let ret = data.readByte();
console.log("RpcClient: readByte is: " + ret);

writeShort

writeShort(val: number): boolean

将短整数值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valnumber是要写入的短整数值。

返回值：

类型说明
boolean写入返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeShort(8);
console.log("RpcClient: writeShort is: " + result);

readShort

readShort(): number

从MessageParcel实例读取短整数值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回短整数值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeShort(8);
console.log("RpcClient: writeShort is: " + result);
let ret = data.readShort();
console.log("RpcClient: readShort is: " + ret);

writeInt

writeInt(val: number): boolean

将整数值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valnumber是要写入的整数值。

返回值：

类型说明
boolean写入返回成功，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeInt(10);
console.log("RpcClient: writeInt is " + result);

readInt

readInt(): number

从MessageParcel实例读取整数值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回整数值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeInt(10);
console.log("RpcClient: writeInt is " + result);
let ret = data.readInt();
console.log("RpcClient: readInt is " + ret);

writeLong

writeLong(val: number): boolean

将长整数值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valnumber是要写入的长整数值

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeLong(10000);
console.log("RpcClient: writeLong is " + result);

readLong

readLong(): number

从MessageParcel实例中读取长整数值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回长整数值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeLong(10000);
console.log("RpcClient: writeLong is " + result);
let ret = data.readLong();
console.log("RpcClient: readLong is " + ret);

writeFloat

writeFloat(val: number): boolean

将浮点值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valnumber是要写入的浮点值。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeFloat(1.2);
console.log("RpcClient: writeFloat is " + result);

readFloat

readFloat(): number

从MessageParcel实例中读取浮点值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回浮点值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeFloat(1.2);
console.log("RpcClient: writeFloat is " + result);
let ret = data.readFloat();
console.log("RpcClient: readFloat is " + ret);

writeDouble

writeDouble(val: number): boolean

将双精度浮点值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valnumber是要写入的双精度浮点值。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeDouble(10.2);
console.log("RpcClient: writeDouble is " + result);

readDouble

readDouble(): number

从MessageParcel实例读取双精度浮点值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回双精度浮点值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeDouble(10.2);
console.log("RpcClient: writeDouble is " + result);
let ret = data.readDouble();
console.log("RpcClient: readDouble is " + ret);

writeBoolean

writeBoolean(val: boolean): boolean

将布尔值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valboolean是要写入的布尔值。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeBoolean(false);
console.log("RpcClient: writeBoolean is " + result);

readBoolean

readBoolean(): boolean

从MessageParcel实例读取布尔值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
boolean返回读取到的布尔值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeBoolean(false);
console.log("RpcClient: writeBoolean is " + result);
let ret = data.readBoolean();
console.log("RpcClient: readBoolean is " + ret);

writeChar

writeChar(val: number): boolean

将单个字符值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valnumber是要写入的单个字符值。

返回值：

类型说明
boolean写入返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeChar(97);
console.log("RpcClient: writeChar is " + result);

readChar

readChar(): number

从MessageParcel实例中读取单个字符值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回单个字符值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeChar(97);
console.log("RpcClient: writeChar is " + result);
let ret = data.readChar();
console.log("RpcClient: readChar is " + ret);

writeString

writeString(val: string): boolean

将字符串值写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
valstring是要写入的字符串值，其长度应小于40960字节。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeString('abc');
console.log("RpcClient: writeString  is " + result);

readString

readString(): string

从MessageParcel实例读取字符串值。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
string返回字符串值。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeString('abc');
console.log("RpcClient: writeString  is " + result);
let ret = data.readString();
console.log("RpcClient: readString is " + ret);

writeSequenceable

writeSequenceable(val: Sequenceable): boolean

将自定义序列化对象写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
val[Sequenceable]是要写入的可序列对象。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

class MySequenceable {
    num: number;
    str: string;
    constructor(num, str) {
        this.num = num;
        this.str = str;
    }
    marshalling(messageParcel) {
        messageParcel.writeInt(this.num);
        messageParcel.writeString(this.str);
        return true;
    }
    unmarshalling(messageParcel) {
        this.num = messageParcel.readInt();
        this.str = messageParcel.readString();
        return true;
    }
}
let sequenceable = new MySequenceable(1, "aaa");
let data = rpc.MessageParcel.create();
let result = data.writeSequenceable(sequenceable);
console.log("RpcClient: writeSequenceable is " + result);

readSequenceable

readSequenceable(dataIn: Sequenceable) : boolean

从MessageParcel实例中读取成员变量到指定的对象（dataIn）。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataIn[Sequenceable]是需要从MessageParcel读取成员变量的对象。

返回值：

类型说明
boolean如果反序列成功，则返回true；否则返回false。

示例：

class MySequenceable {
    num: number;
    str: string;
    constructor(num, str) {
        this.num = num;
        this.str = str;
    }
    marshalling(messageParcel) {
        messageParcel.writeInt(this.num);
        messageParcel.writeString(this.str);
        return true;
    }
    unmarshalling(messageParcel) {
        this.num = messageParcel.readInt();
        this.str = messageParcel.readString();
        return true;
    }
}
let sequenceable = new MySequenceable(1, "aaa");
let data = rpc.MessageParcel.create();
let result = data.writeSequenceable(sequenceable);
console.log("RpcClient: writeSequenceable is " + result);
let ret = new MySequenceable(0, "");
let result2 = data.readSequenceable(ret);
console.log("RpcClient: writeSequenceable is " + result2);

writeByteArray

writeByteArray(byteArray: number[]): boolean

将字节数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
byteArraynumber[]是要写入的字节数组。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let ByteArrayVar = [1, 2, 3, 4, 5];
let result = data.writeByteArray(ByteArrayVar);
console.log("RpcClient: writeByteArray is " + result);

readByteArray

readByteArray(dataIn: number[]) : void

从MessageParcel实例读取字节数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInnumber[]是要读取的字节数组。

示例：

let data = rpc.MessageParcel.create();
let ByteArrayVar = [1, 2, 3, 4, 5];
let result = data.writeByteArray(ByteArrayVar);
console.log("RpcClient: writeByteArray is " + result);
let array = new Array(5);
data.readByteArray(array);

readByteArray

readByteArray(): number[]

从MessageParcel实例中读取字节数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number[]返回字节数组。

示例：

let data = rpc.MessageParcel.create();
let ByteArrayVar = [1, 2, 3, 4, 5];
let result = data.writeByteArray(ByteArrayVar);
console.log("RpcClient: writeByteArray is " + result);
let array = data.readByteArray();
console.log("RpcClient: readByteArray is " + array);

writeShortArray

writeShortArray(shortArray: number[]): boolean

将短整数数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
shortArraynumber[]是要写入的短整数数组。

返回值：

类型说明
boolean写入返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeShortArray([11, 12, 13]);
console.log("RpcClient: writeShortArray is " + result);

readShortArray

readShortArray(dataIn: number[]) : void

从MessageParcel实例中读取短整数数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInnumber[]是要读取的短整数数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeShortArray([11, 12, 13]);
console.log("RpcClient: writeShortArray is " + result);
let array = new Array(3);
data.readShortArray(array);

readShortArray

readShortArray(): number[]

从MessageParcel实例中读取短整数数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number[]返回短整数数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeShortArray([11, 12, 13]);
console.log("RpcClient: writeShortArray is " + result);
let array = data.readShortArray();
console.log("RpcClient: readShortArray is " + array);

writeIntArray

writeIntArray(intArray: number[]): boolean

将整数数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
intArraynumber[]是要写入的整数数组。

返回值：

类型说明
boolean写入返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeIntArray([100, 111, 112]);
console.log("RpcClient: writeIntArray is " + result);

readIntArray

readIntArray(dataIn: number[]) : void

从MessageParcel实例中读取整数数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInnumber[]是要读取的整数数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeIntArray([100, 111, 112]);
console.log("RpcClient: writeIntArray is " + result);
let array = new Array(3);
data.readIntArray(array);

readIntArray

readIntArray(): number[]

从MessageParcel实例中读取整数数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number[]返回整数数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeIntArray([100, 111, 112]);
console.log("RpcClient: writeIntArray is " + result);
let array = data.readIntArray();
console.log("RpcClient: readIntArray is " + array);

writeLongArray

writeLongArray(longArray: number[]): boolean

将长整数数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
longArraynumber[]是要写入的长整数数组。

返回值：

类型说明
boolean写入返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeLongArray([1111, 1112, 1113]);
console.log("RpcClient: writeLongArray is " + result);

readLongArray

readLongArray(dataIn: number[]) : void

从MessageParcel实例读取长整数数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInnumber[]是要读取的长整数数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeLongArray([1111, 1112, 1113]);
console.log("RpcClient: writeLongArray is " + result);
let array = new Array(3);
data.readLongArray(array);

readLongArray

readLongArray(): number[]

从MessageParcel实例中读取长整数数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number[]返回长整数数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeLongArray([1111, 1112, 1113]);
console.log("RpcClient: writeLongArray is " + result);
let array = data.readLongArray();
console.log("RpcClient: readLongArray is " + array);

writeFloatArray

writeFloatArray(floatArray: number[]): boolean

将浮点数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
floatArraynumber[]是要写入的浮点数组。

返回值：

类型说明
boolean写入返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeFloatArray([1.2, 1.3, 1.4]);
console.log("RpcClient: writeFloatArray is " + result);

readFloatArray

readFloatArray(dataIn: number[]) : void

从MessageParcel实例中读取浮点数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInnumber[]是要读取的浮点数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeFloatArray([1.2, 1.3, 1.4]);
console.log("RpcClient: writeFloatArray is " + result);
let array = new Array(3);
data.readFloatArray(array);

readFloatArray

readFloatArray(): number[]

从MessageParcel实例中读取浮点数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number[]返回浮点数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeFloatArray([1.2, 1.3, 1.4]);
console.log("RpcClient: writeFloatArray is " + result);
let array = data.readFloatArray();
console.log("RpcClient: readFloatArray is " + array);

writeDoubleArray

writeDoubleArray(doubleArray: number[]): boolean

将双精度浮点数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
doubleArraynumber[]是要写入的双精度浮点数组。

返回值：

类型说明
boolean写入返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeDoubleArray([11.1, 12.2, 13.3]);
console.log("RpcClient: writeDoubleArray is " + result);

readDoubleArray

readDoubleArray(dataIn: number[]) : void

从MessageParcel实例中读取双精度浮点数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInnumber[]是要读取的双精度浮点数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeDoubleArray([11.1, 12.2, 13.3]);
console.log("RpcClient: writeDoubleArray is " + result);
let array = new Array(3);
data.readDoubleArray(array);

readDoubleArray

readDoubleArray(): number[]

从MessageParcel实例读取双精度浮点数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number[]返回双精度浮点数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeDoubleArray([11.1, 12.2, 13.3]);
console.log("RpcClient: writeDoubleArray is " + result);
let array = data.readDoubleArray();
console.log("RpcClient: readDoubleArray is " + array);

writeBooleanArray

writeBooleanArray(booleanArray: boolean[]): boolean

将布尔数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
booleanArrayboolean[]是要写入的布尔数组。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeBooleanArray([false, true, false]);
console.log("RpcClient: writeBooleanArray is " + result);

readBooleanArray

readBooleanArray(dataIn: boolean[]) : void

从MessageParcel实例中读取布尔数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInboolean[]是要读取的布尔数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeBooleanArray([false, true, false]);
console.log("RpcClient: writeBooleanArray is " + result);
let array = new Array(3);
data.readBooleanArray(array);

readBooleanArray

readBooleanArray(): boolean[]

从MessageParcel实例中读取布尔数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
boolean[]返回布尔数组。
let data = rpc.MessageParcel.create();
let result = data.writeBooleanArray([false, true, false]);
console.log("RpcClient: writeBooleanArray is " + result);
let array = data.readBooleanArray();
console.log("RpcClient: readBooleanArray is " + array);

writeCharArray

writeCharArray(charArray: number[]): boolean

将单个字符数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
charArraynumber[]是要写入的单个字符数组。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeCharArray([97, 98, 88]);
console.log("RpcClient: writeCharArray is " + result);

readCharArray

readCharArray(dataIn: number[]) : void

从MessageParcel实例中读取单个字符数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInnumber[]是要读取的单个字符数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeCharArray([97, 98, 99]);
console.log("RpcClient: writeCharArray is " + result);
let array = new Array(3);
data.readCharArray(array);

readCharArray

readCharArray(): number[]

从MessageParcel实例读取单个字符数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number[]返回单个字符数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeCharArray([97, 98, 99]);
console.log("RpcClient: writeCharArray is " + result);
let array = data.readCharArray();
console.log("RpcClient: readCharArray is " + array);

writeStringArray

writeStringArray(stringArray: string[]): boolean

将字符串数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
stringArraystring[]是要写入的字符串数组，数组单个元素的长度应小于40960字节。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeStringArray(["abc", "def"]);
console.log("RpcClient: writeStringArray is " + result);

readStringArray

readStringArray(dataIn: string[]) : void

从MessageParcel实例读取字符串数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataInstring[]是要读取的字符串数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeStringArray(["abc", "def"]);
console.log("RpcClient: writeStringArray is " + result);
let array = new Array(2);
data.readStringArray(array);

readStringArray

readStringArray(): string[]

从MessageParcel实例读取字符串数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
string[]返回字符串数组。

示例：

let data = rpc.MessageParcel.create();
let result = data.writeStringArray(["abc", "def"]);
console.log("RpcClient: writeStringArray is " + result);
let array = data.readStringArray();
console.log("RpcClient: readStringArray is " + array);

writeNoException8+

writeNoException(): void

向MessageParcel写入“指示未发生异常”的信息。

系统能力：SystemCapability.Communication.IPC.Core

示例：

class MyDeathRecipient {
    onRemoteDied() {
        console.log("server died");
    }
}
class TestRemoteObject extends rpc.RemoteObject {
    constructor(descriptor) {
        super(descriptor);
    }
    addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    isObjectDead(): boolean {
        return false;
    }
    onRemoteRequest(code, data, reply, option) {
        if (code === 1) {
            console.log("RpcServer: onRemoteRequest called");
            reply.writeNoException();
            return true;
        } else {
            console.log("RpcServer: unknown code: " + code);
            return false;
        }
    }
}

readException8+

readException(): void

从MessageParcel中读取异常。

系统能力：SystemCapability.Communication.IPC.Core

示例：

import FA from "@ohos.ability.featureAbility";
let proxy;
let connect = {
    onConnect: function(elementName, remoteProxy) {
        console.log("RpcClient: js onConnect called.");
        proxy = remoteProxy;
    },
    onDisconnect: function(elementName) {
        console.log("RpcClient: onDisconnect");
    },
    onFailed: function() {
        console.log("RpcClient: onFailed");
    }
};
let want = {
    "bundleName": "com.ohos.server",
    "abilityName": "com.ohos.server.MainAbility",
};
FA.connectAbility(want, connect);
let option = new rpc.MessageOption();
let data = rpc.MessageParcel.create();
let reply = rpc.MessageParcel.create();
data.writeInt(1);
data.writeString("hello");
proxy.sendRequest(1, data, reply, option)
    .then(function(errCode) {
        if (errCode === 0) {
            console.log("sendRequest got result");
            reply.readException();
            let msg = reply.readString();
            console.log("RPCTest: reply msg: " + msg);
        } else {
            console.log("RPCTest: sendRequest failed, errCode: " + errCode);
        }
    }).catch(function(e) {
        console.log("RPCTest: sendRequest got exception: " + e.message);
    }).finally (() => {
        console.log("RPCTest: sendRequest ends, reclaim parcel");
        data.reclaim();
        reply.reclaim();
    });

writeSequenceableArray

writeSequenceableArray(sequenceableArray: Sequenceable[]): boolean

将可序列化对象数组写入MessageParcel实例。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
sequenceableArraySequenceable[]是要写入的可序列化对象数组。

返回值：

类型说明
boolean写入成功返回true，否则返回false。

示例：

class MySequenceable {
    num: number;
    str: string;
    constructor(num, str) {
        this.num = num;
        this.str = str;
    }
    marshalling(messageParcel) {
        messageParcel.writeInt(this.num);
        messageParcel.writeString(this.str);
        return true;
    }
    unmarshalling(messageParcel) {
        this.num = messageParcel.readInt();
        this.str = messageParcel.readString();
        return true;
    }
}
let sequenceable = new MySequenceable(1, "aaa");
let sequenceable2 = new MySequenceable(2, "bbb");
let sequenceable3 = new MySequenceable(3, "ccc");
let a = [sequenceable, sequenceable2, sequenceable3];
let data = rpc.MessageParcel.create();
let result = data.writeSequenceableArray(a);
console.log("RpcClient: writeSequenceableArray is " + result);

readSequenceableArray8+

readSequenceableArray(sequenceableArray: Sequenceable[]): void

从MessageParcel实例读取可序列化对象数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
sequenceableArraySequenceable[]是要读取的可序列化对象数组。

示例：

class MySequenceable {
    num: number;
    str: string;
    constructor(num, str) {
        this.num = num;
        this.str = str;
    }
    marshalling(messageParcel) {
        messageParcel.writeInt(this.num);
        messageParcel.writeString(this.str);
        return true;
    }
    unmarshalling(messageParcel) {
        this.num = messageParcel.readInt();
        this.str = messageParcel.readString();
        return true;
    }
}
let sequenceable = new MySequenceable(1, "aaa");
let sequenceable2 = new MySequenceable(2, "bbb");
let sequenceable3 = new MySequenceable(3, "ccc");
let a = [sequenceable, sequenceable2, sequenceable3];
let data = rpc.MessageParcel.create();
let result = data.writeSequenceableArray(a);
console.log("RpcClient: writeSequenceableArray is " + result);
let b = [new MySequenceable(0, ""), new MySequenceable(0, ""), new MySequenceable(0, "")];
data.readSequenceableArray(b);

writeRemoteObjectArray8+

writeRemoteObjectArray(objectArray: IRemoteObject[]): boolean

将IRemoteObject对象数组写入MessageParcel。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
objectArrayIRemoteObject[]是要写入MessageParcel的IRemoteObject对象数组。

返回值：

类型说明
boolean如果IRemoteObject对象数组成功写入MessageParcel，则返回true；如果对象为null或数组写入MessageParcel失败，则返回false。

示例：

class MyDeathRecipient {
    onRemoteDied() {
        console.log("server died");
    }
}
class TestRemoteObject extends rpc.RemoteObject {
    constructor(descriptor) {
        super(descriptor);
        this.attachLocalInterface(this, descriptor);
    }
    addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    isObjectDead(): boolean {
        return false;
    }
    asObject(): rpc.IRemoteObject {
        return this;
    }
}
let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
let data = rpc.MessageParcel.create();
let result = data.writeRemoteObjectArray(a);
console.log("RpcClient: writeRemoteObjectArray is " + result);

readRemoteObjectArray8+

readRemoteObjectArray(objects: IRemoteObject[]): void

从MessageParcel读取IRemoteObject对象数组。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
objectsIRemoteObject[]是从MessageParcel读取的IRemoteObject对象数组。

示例：

class MyDeathRecipient {
    onRemoteDied() {
        console.log("server died");
    }
}
class TestRemoteObject extends rpc.RemoteObject {
    constructor(descriptor) {
        super(descriptor);
        this.attachLocalInterface(this, descriptor);
    }
    addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    isObjectDead(): boolean {
        return false;
    }
    asObject(): rpc.IRemoteObject {
        return this;
    }
}
let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
let data = rpc.MessageParcel.create();
let result = data.writeRemoteObjectArray(a);
let b = new Array(3);
data.readRemoteObjectArray(b);

readRemoteObjectArray8+

readRemoteObjectArray(): IRemoteObject[]

从MessageParcel读取IRemoteObject对象数组。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
IRemoteObject[]返回IRemoteObject对象数组。

示例：

class MyDeathRecipient {
    onRemoteDied() {
        console.log("server died");
    }
}
class TestRemoteObject extends rpc.RemoteObject {
    constructor(descriptor) {
        super(descriptor);
        this.attachLocalInterface(this, descriptor);
    }
    addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
        return true;
    }
    isObjectDead(): boolean {
        return false;
    }
    asObject(): rpc.IRemoteObject {
        return this;
    }
}
let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
let data = rpc.MessageParcel.create();
let result = data.writeRemoteObjectArray(a);
console.log("RpcClient: readRemoteObjectArray is " + result);
let b = data.readRemoteObjectArray();
console.log("RpcClient: readRemoteObjectArray is " + b);

closeFileDescriptor8+

static closeFileDescriptor(fd: number): void

关闭给定的文件描述符。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
fdnumber是要关闭的文件描述符。

示例：

import fileio from '@ohos.fileio';
let filePath = "path/to/file";
let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
rpc.MessageParcel.closeFileDescriptor(fd);

dupFileDescriptor8+

static dupFileDescriptor(fd: number) :number

复制给定的文件描述符。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
fdnumber是表示已存在的文件描述符。

返回值：

类型说明
number返回新的文件描述符。

示例：

import fileio from '@ohos.fileio';
let filePath = "path/to/file";
let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
let newFd = rpc.MessageParcel.dupFileDescriptor(fd);

containFileDescriptors8+

containFileDescriptors(): boolean

检查此MessageParcel对象是否包含文件描述符。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
boolean如果此MessageParcel对象包含文件描述符，则返回true；否则返回false。

示例：

import fileio from '@ohos.fileio';
let parcel = new rpc.MessageParcel();
let filePath = "path/to/file";
let r1 = parcel.containFileDescriptors();
let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
let writeResult = parcel.writeFileDescriptor(fd);
console.log("RpcTest: parcel writeFd result is : " + writeResult);
let containFD = parcel.containFileDescriptors();
console.log("RpcTest: parcel after write fd containFd result is : " + containFD);

writeFileDescriptor8+

writeFileDescriptor(fd: number): boolean

写入文件描述符到MessageParcel。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
fdnumber是文件描述符。

返回值：

类型说明
boolean如果操作成功，则返回true；否则返回false。

示例：

import fileio from '@ohos.fileio';
let parcel = new rpc.MessageParcel();
let filePath = "path/to/file";
let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
let writeResult = parcel.writeFileDescriptor(fd);
console.log("RpcTest: parcel writeFd result is : " + writeResult);

readFileDescriptor8+

readFileDescriptor(): number

从MessageParcel中读取文件描述符。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回文件描述符。

示例：

import fileio from '@ohos.fileio';
let parcel = new rpc.MessageParcel();
let filePath = "path/to/file";
let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
let writeResult = parcel.writeFileDescriptor(fd);
let readFD = parcel.readFileDescriptor();
console.log("RpcTest: parcel read fd is : " + readFD);

writeAshmem8+

writeAshmem(ashmem: Ashmem): boolean

将指定的匿名共享对象写入此MessageParcel。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
ashmemAshmem是要写入MessageParcel的匿名共享对象。

返回值：

类型说明
boolean如果匿名共享对象成功写入此MessageParcel，则返回true；否则返回false。

示例：

let parcel = new rpc.MessageParcel();
let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024);
let isWriteSuccess = parcel.writeAshmem(ashmem);
console.log("RpcTest: write ashmem to result is : " + isWriteSuccess);

readAshmem8+

readAshmem(): Ashmem

从MessageParcel读取匿名共享对象。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
Ashmem返回匿名共享对象。

示例：

let parcel = new rpc.MessageParcel();
let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024);
let isWriteSuccess = parcel.writeAshmem(ashmem);
console.log("RpcTest: write ashmem to result is : " + isWriteSuccess);
let readAshmem = parcel.readAshmem();
console.log("RpcTest: read ashmem to result is : " + readAshmem);

getRawDataCapacity8+

getRawDataCapacity(): number

获取MessageParcel可以容纳的最大原始数据量。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
number返回MessageParcel可以容纳的最大原始数据量，即128 Mb。

示例：

let parcel = new rpc.MessageParcel();
let result = parcel.getRawDataCapacity();
console.log("RpcTest: parcel get RawDataCapacity result is : " + result);

writeRawData8+

writeRawData(rawData: number[], size: number): boolean

将原始数据写入MessageParcel对象。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
rawDatanumber[]是要写入的原始数据。
sizenumber是发送的原始数据大小，以字节为单位。

返回值：

类型说明
boolean如果操作成功，则返回true；否则返回false。

示例：

let parcel = new rpc.MessageParcel();
let arr = [1, 2, 3, 4, 5];
let isWriteSuccess = parcel.writeRawData(arr, arr.length);
console.log("RpcTest: parcel write raw data result is : " + isWriteSuccess);

readRawData8+

readRawData(size: number): number[]

从MessageParcel读取原始数据。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
sizenumber是要读取的原始数据的大小。

返回值：

类型说明
number[]返回原始数据（以字节为单位）。

示例：

let parcel = new rpc.MessageParcel();
let arr = [1, 2, 3, 4, 5];
let isWriteSuccess = parcel.writeRawData(arr, arr.length);
console.log("RpcTest: parcel write raw data result is : " + isWriteSuccess);
let result = parcel.readRawData(5);
console.log("RpcTest: parcel read raw data result is : " + result);

Sequenceable

在进程间通信（IPC）期间，将类的对象写入MessageParcel并从MessageParcel中恢复它们。

marshalling

marshalling(dataOut: MessageParcel): boolean

将此可序列对象封送到MessageParcel中。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataOut[MessageParcel]是可序列对象将被封送到的MessageParcel对象。

返回值：

类型说明
boolean如果封送成功，则返回true；否则返回false。

示例：

class MySequenceable {
    num: number;
    str: string;
    constructor(num, str) {
        this.num = num;
        this.str = str;
    }
    marshalling(messageParcel) {
        messageParcel.writeInt(this.num);
        messageParcel.writeString(this.str);
        return true;
    }
    unmarshalling(messageParcel) {
        this.num = messageParcel.readInt();
        this.str = messageParcel.readString();
        return true;
    }
}
let sequenceable = new MySequenceable(1, "aaa");
let data = rpc.MessageParcel.create();
let result = data.writeSequenceable(sequenceable);
console.log("RpcClient: writeSequenceable is " + result);
let ret = new MySequenceable(0, "");
let result2 = data.readSequenceable(ret);
console.log("RpcClient: readSequenceable is " + result2);

unmarshalling

unmarshalling(dataIn: MessageParcel) : boolean

从MessageParcel中解封此可序列对象。

系统能力：SystemCapability.Communication.IPC.Core

参数：

参数名类型必填说明
dataIn[MessageParcel]是已将可序列对象封送到其中的MessageParcel对象。

返回值：

类型说明
boolean如果可序列化成功，则返回true；否则返回false。

示例：

class MySequenceable {
    num: number;
    str: string;
    constructor(num, str) {
        this.num = num;
        this.str = str;
    }
    marshalling(messageParcel) {
        messageParcel.writeInt(this.num);
        messageParcel.writeString(this.str);
        return true;
    }
    unmarshalling(messageParcel) {
        this.num = messageParcel.readInt();
        this.str = messageParcel.readString();
        return true;
    }
}
let sequenceable = new MySequenceable(1, "aaa");
let data = rpc.MessageParcel.create();
let result = data.writeSequenceable(sequenceable);
console.log("RpcClient: writeSequenceable is " + result);
let ret = new MySequenceable(0, "");
let result2 = data.readSequenceable(ret);
console.log("RpcClient: readSequenceable is " + result2);

IRemoteBroker

远端对象的代理持有者。用于获取代理对象。

asObject

asObject(): IRemoteObject

需派生类实现，获取代理或远端对象。

系统能力：SystemCapability.Communication.IPC.Core

返回值：

类型说明
[IRemoteObject]如果调用者是[RemoteObject]对象，则直接返回本身；如果调用者是[RemoteProxy]对象，则返回它的持有者[IRemoteObject]。

示例：

class TestAbility extends rpc.RemoteObject {
    asObject() {
        return this;
    }
}

示例：

class TestProxy {
    remote: rpc.RemoteObject;
    constructor(remote) {
        this.remote = remote;
    }
    asObject() {
        return this.remote;
    }
}

DeathRecipient

用于订阅远端对象的死亡通知。当被订阅该通知的远端对象死亡时，本端可收到消息，调用[onRemoteDied]接口。远端对象死亡可以为远端对象所在进程死亡，远端对象所在设备关机或重启，当远端对象与本端对象属于不同设备时，也可为远端对象离开组网时。

onRemoteDied

onRemoteDied(): void

在成功添加死亡通知订阅后，当远端对象死亡时，将自动调用本方法。

系统能力：SystemCapability.Communication.IPC.Core

示例：

class MyDeathRecipient {
    onRemoteDied() {
        console.log("server died");
    }
}
爱桥代码的程序媛
关注
  • 18
    点赞
  • 踩
  • 19
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
把接口调用打成jar包的api怎么写_良好的RPC接口设计，需要注意这些方面
weixin_39610722的博客
12-11 657
RPC 框架的讨论一直是各个技术交流群中的热点话题，阿里的 dubbo，新浪微博的 motan，谷歌的 grpc，以及不久前蚂蚁金服开源的 sofa，都是比较出名的 RPC 框架。RPC 框架，或者一部分人习惯称之为服务治理框架，更多的讨论是存在于其技术架构，比如 RPC 的实现原理，RPC 各个分层的意义，具体 RPC 框架的源码分析…但却并没有太多话题和“如何设计 RPC 接口”这样的业务架构...
鸿蒙内核源码分析(进程通讯篇) | 九种进程间通讯方式速揽
maniuT的博客
05-06 1447
鸿蒙内核默认支持 64个进程和128个任务，由进程池和任务池统一管理.内核设计尽量不去打扰它们，让各自过好各自的日子， 但大家毕竟在一口锅里吃饭， 不可能不与外界联系
HarmonyOS4.0——IPC与RPC通信
2401_83047642的博客
02-28 789
IPC/RPC的主要工作是让运行在不同进程的Proxy和Stub互相通信，包括Proxy和Stub运行在不同设备的情况。
RPC接口简介
weixin_43751710的博客
03-09 2万+
什么是RPC RPC（Remote Procedure Call Protocol）远程过程调用协议。一个通俗的描述是：客户端在不知道调用细节的情况下，调用存在于远程计算机上的某个对象，就像调用本地应用程序中的对象一样。比较正式的描述是：一种通过网络从远程计算机程序上请求服务，而不需要了解底层网络技术的协议。 RPC的特点： RPC是协议。只是协议，而非实现。RPC实现包括：Dubbo、Thri...
简单的rpc实现
axjzf的博客
06-15 799
1.什么是rpc？RPC（Remote Procedure Call）—远程过程调用，它是一种通过网络从远程计算机程序上请求服务，而不需要了解底层网络技术的协议。RPC协议假定某些传输协议的存在，如TCP或UDP，为通信程序之间携带信息数据。                               client functions：客户端，请求发送端client stub：客户端句柄，主要是获...
javax.xml.rpc:javax.xml.rpc api的存储库
05-16
:warning: 该项目现在是EE4J计划的一部分。 该仓库已被归档，因为所有活动现在都在。 有关整体EE4J过渡状态，请参见。 javax.xml.rpc javax.xml.rpc API的存储库
javax.xml.rpc
03-28
"webservice"则指的是Web服务，它是通过互联网进行通信的一种方式，XML-RPC是实现Web服务的一种技术手段。 压缩包子文件"axis-jaxrpc-1.4.jar"是Apache Axis的一个组成部分，Axis是一个开源的Web服务工具包，它支持...
com.springsource.javax.xml.rpc-1.1.0.jar
03-03
jar包，官方版本，自测可用
分布式系统中的通信方式：RPC与RMI.pdf
08-10
#资源达人分享计划#
opensub4j:与opensubtitles.org XML-RPC API通信的Java库
05-03
它通过XML-RPC opensubtitles.org API提供了一个面向对象的抽象。 徽章 分支 掌握 0.4 0.3 0.2 0.1 安装 只需将gradle / maven的依赖项添加到最新版本： dependencies { compile '...
架构设计：系统间通信（10）——RPC的基本概念
10-30 920
1、概述 经过了详细的信息格式、网络IO模型的讲解，并且通过JAVA RMI的讲解进行了预热。从这篇文章开始我们将进入这个...
从0到1实现python基于RPC协议的接口自动化测试
11-01 1166
RPC（Remote Procedure Call）远程过程调用协议是一个用于建立适当框架的协议。从本质上讲，它使一台机器上的程序能够调用另一台机器上的子程序，而不会意识到它是远程的。RPC 是一种软件通信协议，一个程序可以用来向位于网络上另一台计算机的程序请求服务，而不必了解网络的细节。RPC 被用来像本地系统一样调用远程系统上的其他进程。过程调用有时也被称为函数调用或子程序调用RPC本身是一套协议规范，遵循这一套规范实现的框架比较流行的有以下几个：grpc框架gRPC是由 google开发的一个高性能、
整理了一些常用的免费api接口，不限次数，收藏备用~（持续更新...）
热门推荐
weixin_47590344的博客
12-29 7万+
整理的一些常用免费api接口分享，不限次数，收藏备用！
【鸿蒙开发】第二十四章 IPC与RPC进程间通讯服务
最新发布
Yvan
05-13 1031
与用于实现跨进程通信，不同的是。需要跨进程通信的原因是因为每个进程都有自己独立的资源和内存空间，其他进程不能随意访问不同进程的内存和资源，IPC/RPC便是为了突破这一点。Binder设备内的跨进程通信软总线跨设备跨进程通信说明：Stage。
Flask 基于Flask-JSONRPC提供RPC接口
yutu75的博客
12-04 2494
服务端基于Flask-JSONRPC提供RPC接口 JSON-RPC是一个无状态的、轻量级的远程过程调用（RPC）协议。 所谓的RPC，Remote Procedure Call的简写，中文译作远程过程调用或者远程服务调用。 直观的理解就是，通过网络请求远程服务，获取指定接口的数据，而不用知晓底层网络协议的细节。 RPC支持的格式很多，比如XML格式，JSON格式等等。最常用的肯定是json-rpc。 JSON-RPC协议中的客户端一般是为了向远程服务器请求执行某个方法/函数。客户端向实现了JSON-RPC
互联网服务端测试之RPC接口测试
wangyueshu的博客
08-19 3902
开篇碎碎念： 18年的时候写过一篇《互联网服务端测试是个啥（入门科普）》（指路https://blog.csdn.net/wangyueshu/article/details/81944250），主要面向的是那些没有接触过服务端测试，尤其是已有端上测试经验、而面对服务端测试时急需转换测试思维的那部分读者。 3年过去了，转一圈再回来做服务端测试时，内容也有了扩展。原篇的接口更多的是指代HTTP接口，服务也更多的指代数据服务。而随着算法模型应用的逐渐深入，服务扩展到了模型、策...
鸿蒙内核源码分析(共享内存) | 进程间最快通讯方式
maniuT的博客
05-12 1036
看到这里你应该不会问共享内存的作用和为啥它是最快的进程间通讯方式了,如果还有这两个问题说明还要再看一遍 😛 ,另外细心的话会发现共享内存会有个小缺点,就是同时访问的问题,所以需要使用互斥锁来保证同时只有一个进程在使用,和在以上的四个步骤中都有出现。//互斥锁,共享内存本身并不保证操作的同步性,所以需用互斥锁#define SYSV_SHM_LOCK() (VOID)LOS_MuxLock(&g_sysvShmMux, LOS_WAIT_FOREVER) //申请永久等待锁。
【微服务篇】深入理解RPC（远程调用）原理
林木森的博客
03-30 2729
RPC是一种通信机制，它使得在网络中的不同计算机之间可以像本地调用一样简单地进行函数或过程调用。RPC隐藏了底层的网络通信细节，使得开发者可以专注于业务逻辑，而不是处理网络通信的复杂性。RPC框架通常负责打包调用的参数，通过网络传输，然后在远端解包参数，执行函数调用，再将结果返回给调用方。定义：选择或设计一种接口定义语言（IDL）来精确描述服务接口。IDL定义了服务中的方法、参数和返回类型。跨语言支持：确保IDL支持多种编程语言，以便不同语言编写的服务可以相互通信。版本控制和兼容性。
用openharmony写一段mqtt连接代码
09-19
### 回答1： 以下是 OpenHarmony 写一段 MQTT 连接代码的示例： ``` #include <oh_mqtt_client.h> // MQTT 连接配置 oh_mqtt_connect_params_t connect_params = { .client_id = "OH_MQTT_CLIENT", .username = "user", .password = "password", .host = "127.0.0.1", .port = 1883, .keepalive = 60 }; // MQTT 连接回调 oh_mqtt_conn_cb_t connect_cb = { .connect_success = on_connect_success, .connect_fail = on_connect_fail }; int main(void) { // 创建 MQTT 客户端 oh_mqtt_client_t* client = oh_mqtt_client_new(); if (client == NULL) { // 创建失败处理 } // 连接 MQTT 服务器 oh_mqtt_client_connect(client, &connect_params, &connect_cb); // 等待 MQTT 连接完成 oh_mqtt_client_wait(client); // 销毁 MQTT 客户端 oh_mqtt_client_free(client); return 0; } void on_connect_success(oh_mqtt_client_t* client) { // 连接成功处理 } void on_connect_fail(oh_mqtt_client_t* client, oh_mqtt_conn_status_t status) { // 连接失败处理 } ``` 请注意，以上代码仅是示例，您可能需要根据实际需求调整其中的参数。 ### 回答2： 使用OpenHarmony编写一个MQTT连接代码的例子如下： ```java import ohos.event.intentagent.IntentAgent; import ohos.rpc.IRemoteBroker; import ohos.rpc.MessageOption; import ohos.rpc.MessageParcel; import ohos.rpc.RemoteException; public class MqttClient implements IRemoteBroker { private static final int REQ_CODE_START_ACTIVITY = 1; private IntentAgent intentAgent; public MqttClient(IntentAgent intentAgent) { this.intentAgent = intentAgent; } public void connectMqttServer(String serverUri, String clientId, String topic) { IntentAgent myIntentAgent = IntentAgentHelper.getIntentAgent(); IntentAgent requestIntentAgent = IntentAgentHelper.getRequestIntentAgent(myIntentAgent); requestIntentAgent.setParam("serverUri", serverUri); requestIntentAgent.setParam("clientId", clientId); requestIntentAgent.setParam("topic", topic); try { myIntentAgent.startAbility(requestIntentAgent, REQ_CODE_START_ACTIVITY); } catch (RemoteException e) { e.printStackTrace(); } } @Override public IRemoteBroker queryLocalInterface(String descriptor) { return null; } @Override public boolean onRemoteRequest(int code, MessageParcel data, MessageParcel reply, MessageOption option) throws RemoteException { switch (code) { case REQ_CODE_START_ACTIVITY: String serverUri = data.readString(); String clientId = data.readString(); String topic = data.readString(); // 进行 MQTT 连接的操作 break; default: return false; } return true; } } public class IntentAgentHelper { static IntentAgent getIntentAgent() { // 创建一个 IntentAgent 对象 // ... return intentAgent; } static IntentAgent getRequestIntentAgent(IntentAgent intentAgent) { IntentAgent requestIntentAgent = new IntentAgent(); // 设置要启动的 Ability 的信息 // intentAgent 设置等... return requestIntentAgent; } } ``` 这是一个使用OpenHarmony编写的MqttClient类的示例，其中包含了连接到MQTT服务器的方法。该类通过IntentAgent与能够进行Mqtt连接的Ability进行通信。在连接Mqtt服务器的方法`connectMqttServer`中，我们创建了一个IntentAgent对象，并将要连接的服务器地址、客户端ID和订阅的主题作为参数传递给IntentAgent实例。然后，我们使用`startAbility`方法将这个IntentAgent发送给能够进行Mqtt连接的Ability。 在能够进行Mqtt连接的Ability中，我们通过重写`onRemoteRequest`方法来接收传递过来的参数。这里我们假设通过响应`REQ_CODE_START_ACTIVITY`来执行Mqtt连接的操作。在`onRemoteRequest`方法中，我们从传递过来的参数中获取到服务器地址、客户端ID和订阅的主题。然后，我们可以在这个方法中进行Mqtt连接的具体操作。 注意：以上代码仅为示例，实际上需要根据具体的OpenHarmony版本和MQTT库进行更详细的实现。 ### 回答3： 使用OpenHarmony编写MQTT连接代码示例如下： ``` import ohos.eventhandler.EventHandler; import ohos.eventhandler.EventRunner; import ohos.eventhandler.InnerEvent; import ohos.rpc.*; import java.util.UUID; import java.util.concurrent.TimeoutException; import ohos.security.SystemPermission; import ohos.security.permission.PermissionKit; import ohos.sysability.samgr.SysAbilityManager; import ohos.sysability.samgr.SystemAbilityDefinition; import ohos.utils.zson.ZSONObject; import com.huawei.hiviewtunnel.HiViewEvent; import com.huawei.hms.networkengine.aidl.NetworkAdapterAgent; import com.huawei.hms.networkengine.aidl.IDnsMultiResolver; import com.huawei.hms.networkengine.aidl.IFoundationPrx; import com.huawei.hms.networkengine.aidl.IOnConnectionStateChangeListener; import com.huawei.hms.networkengine.aidl.OnDnsResovle; import com.huawei.hms.networkengine.aidl.OnPskConfig; import com.huawei.hms.networkengine.aidl.OnTcpEvent; import com.huawei.hms.networkengine.aidl.OnUdpEvent; // 创建MQTT连接的类 public class MqttClient { private static final String TAG = "MqttClient"; private NetworkAdapterAgent mAgent; private String mBrokerUrl; private String mClientId; private String mUserName; private String mPassword; // 构造函数 public MqttClient(String brokerUrl, String clientId, String userName, String password) { mBrokerUrl = brokerUrl; mClientId = clientId; mUserName = userName; mPassword = password; // 初始化网络代理 mAgent = getNetworkAdapterAgent(); } // 连接到MQTT服务器 public void connect() { try { // 创建MQTT连接 mAgent.createConnection(mBrokerUrl, mClientId, mUserName, mPassword, mConnectionStateListener, mHandler); } catch (Exception e) { e.printStackTrace(); } } // 断开与MQTT服务器的连接 public void disconnect() { try { // 断开MQTT连接 mAgent.disconnect(mConnectionStateListener); } catch (Exception e) { e.printStackTrace(); } } // 获取网络代理 private NetworkAdapterAgent getNetworkAdapterAgent() { int result = PermissionKit.checkPermission(SystemPermission.DISTRIBUTED_DATASYNC); if (result != PermissionKit.PERMISSION_GRANTED) { return null; } try { // 获取网络代理 Optional<NetworkAdapterAgent> agentOptional = SysAbilityManager.getSystemAbility( SystemAbilityDefinition.NET_WORK_ADAPTER_ABILITY_ID, NetworkAdapterAgent.class); return agentOptional.get(); } catch (SystemAbilityException e) { e.printStackTrace(); } return null; } // 连接状态监听器 private IOnConnectionStateChangeListener mConnectionStateListener = new IOnConnectionStateChangeListener.Stub() { @Override public void onTcpConnected(OnTcpEvent event) { // 连接到TCP服务器 HiViewEvent tcpEvent = new HiViewEvent(HiViewEvent.EventId.TCP_CONNECTED); // 解析事件数据 tcpEvent.putExtra("address", event.address); tcpEvent.putExtra("port", event.port); // 发送至HiTrace通道 HiViewEvent.send(tcpEvent); } @Override public void onMqttConnected(IFoundationPrx prx) { // 连接到MQTT服务器 HiViewEvent mqttEvent = new HiViewEvent(HiViewEvent.EventId.MQTT_CONNECTED); // 解析事件数据 mqttEvent.putExtra("clientId", mClientId); mqttEvent.putExtra("serverURI", mBrokerUrl); // 发送至HiTrace通道 HiViewEvent.send(mqttEvent); } }; // 异步事件处理器 private EventHandler mHandler = new EventHandler(EventRunner.getMainEventRunner()) { @Override protected void processEvent(InnerEvent event) { // 处理事件 } }; } ``` 以上是一个使用OpenHarmony编写的MQTT连接类的示例代码。你可以根据自己的需求进行修改和扩展。注意，在实际运行之前，请确保正确配置OpenHarmony的开发环境，并在编译和运行时添加所需的依赖项。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值