进程间通信能力

2024-01-23 17:01 更新

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

说明
  • 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

  • 本模块从API version 9开始支持异常返回功能。

导入模块

  1. import rpc from '@ohos.rpc';

ErrorCode9+

从API version 9起,IPC支持异常返回功能。错误码对应数值及含义如下。

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

名称

说明

CHECK_PARAM_ERROR

401

检查参数失败。

OS_MMAP_ERROR

1900001

执行系统调用mmap失败。

OS_IOCTL_ERROR

1900002

在共享内存文件描述符上执行系统调用ioctl失败。

WRITE_TO_ASHMEM_ERROR

1900003

向共享内存写数据失败。

READ_FROM_ASHMEM_ERROR

1900004

从共享内存读数据失败。

ONLY_PROXY_OBJECT_PERMITTED_ERROR

1900005

只有proxy对象允许该操作。

ONLY_REMOTE_OBJECT_PERMITTED_ERROR

1900006

只有remote对象允许该操作。

COMMUNICATION_ERROR

1900007

和远端对象进行进程间通信失败。

PROXY_OR_REMOTE_OBJECT_INVALID_ERROR

1900008

非法的代理对象或者远端对象。

WRITE_DATA_TO_MESSAGE_SEQUENCE_ERROR

1900009

向MessageSequence写数据失败。

READ_DATA_FROM_MESSAGE_SEQUENCE_ERROR

1900010

读取MessageSequence数据失败。

PARCEL_MEMORY_ALLOC_ERROR

1900011

序列化过程中内存分配失败。

CALL_JS_METHOD_ERROR

1900012

执行JS回调方法失败。

OS_DUP_ERROR

1900013

执行系统调用dup失败。

MessageSequence9+

在RPC或IPC过程中,发送方可以使用MessageSequence提供的写方法,将待发送的数据以特定格式写入该对象。接收方可以使用MessageSequence提供的读方法从该对象中读取特定格式的数据。数据格式包括:基础类型及数组、IPC对象、接口描述符和自定义序列化对象。

create

static create(): MessageSequence

静态方法,创建MessageSequence对象。

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

返回值:

类型

说明

MessageSequence

返回创建的MessageSequence对象。

示例:

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

reclaim

reclaim(): void

释放不再使用的MessageSequence对象。

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

示例:

  1. let reply = rpc.MessageSequence.create();
  2. reply.reclaim();

writeRemoteObject

writeRemoteObject(object: IRemoteObject): void

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

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

参数:

参数名

类型

必填

说明

object

IRemoteObject

要序列化并写入MessageSequence的远程对象。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

1900009

write data to message sequence failed

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. }
  6. let data = rpc.MessageSequence.create();
  7. let testRemoteObject = new TestRemoteObject("testObject");
  8. try {
  9. data.writeRemoteObject(testRemoteObject);
  10. } catch(error) {
  11. console.info("Rpc write remote object fail, errorCode " + error.code);
  12. console.info("Rpc write remote object fail, errorMessage " + error.message);
  13. }

readRemoteObject

readRemoteObject(): IRemoteObject

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

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

返回值:

类型

说明

IRemoteObject

读取到的远程对象。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

1900010

read data from message sequence failed

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. }
  6. let data = rpc.MessageSequence.create();
  7. let testRemoteObject = new TestRemoteObject("testObject");
  8. try {
  9. data.writeRemoteObject(testRemoteObject);
  10. let proxy = data.readRemoteObject();
  11. } catch(error) {
  12. console.info("Rpc write remote object fail, errorCode " + error.code);
  13. console.info("Rpc write remote object fail, errorMessage " + error.message);
  14. }

writeInterfaceToken

writeInterfaceToken(token: string): void

将接口描述符写入MessageSequence对象,远端对象可使用该信息校验本次通信。

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

参数:

参数名

类型

必填

说明

token

string

字符串类型描述符。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeInterfaceToken("aaa");
  4. } catch(error) {
  5. console.info("rpc write interface fail, errorCode " + error.code);
  6. console.info("rpc write interface fail, errorMessage " + error.message);
  7. }

readInterfaceToken

readInterfaceToken(): string

从MessageSequence对象中读取接口描述符,接口描述符按写入MessageSequence的顺序读取,本地对象可使用该信息检验本次通信。

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

返回值:

类型

说明

string

返回读取到的接口描述符。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteRequest(code, data, reply, option) {
  3. try {
  4. let interfaceToken = data.readInterfaceToken();
  5. console.log("RpcServer: interfaceToken is " + interfaceToken);
  6. } catch(error) {
  7. console.info("RpcServer: read interfaceToken failed, errorCode " + error.code);
  8. console.info("RpcServer: read interfaceToken failed, errorMessage " + error.message);
  9. }
  10. return true;
  11. }
  12. }

getSize

getSize(): number

获取当前创建的MessageSequence对象的数据大小。

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

返回值:

类型

说明

number

获取的MessageSequence实例的数据大小。以字节为单位。

示例:

  1. let data = rpc.MessageSequence.create();
  2. let size = data.getSize();
  3. console.log("RpcClient: size is " + size);

getCapacity

getCapacity(): number

获取当前MessageSequence对象的容量大小。

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

返回值:

类型

说明

number

获取的MessageSequence实例的容量大小。以字节为单位。

示例:

  1. let data = rpc.MessageSequence.create();
  2. let result = data.getCapacity();
  3. console.log("RpcClient: capacity is " + result);

setSize

setSize(size: number): void

设置MessageSequence对象中包含的数据大小。

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

参数:

参数名

类型

必填

说明

size

number

MessageSequence实例的数据大小。以字节为单位。

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.setSize(16);
  4. console.log("RpcClient: setSize is " + data.getSize());
  5. } catch(error) {
  6. console.info("rpc set size of MessageSequence fail, errorCode " + error.code);
  7. console.info("rpc set size of MessageSequence fail, errorMessage " + error.message);
  8. }

setCapacity

setCapacity(size: number): void

设置MessageSequence对象的存储容量。

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

参数:

参数名

类型

必填

说明

size

number

MessageSequence实例的存储容量。以字节为单位。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900011

parcel memory alloc failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.setCapacity(100);
  4. console.log("RpcClient: setCapacity is " + data.getCapacity());
  5. } catch(error) {
  6. console.info("rpc memory alloc fail, errorCode " + error.code);
  7. console.info("rpc memory alloc fail, errorMessage " + error.message);
  8. }

getWritableBytes

getWritableBytes(): number

获取MessageSequence的可写字节空间大小。

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

返回值:

类型

说明

number

获取到的MessageSequence实例的可写字节空间。以字节为单位。

示例:

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

getReadableBytes

getReadableBytes(): number

获取MessageSequence的可读字节空间。

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

返回值:

类型

说明

number

获取到的MessageSequence实例的可读字节空间。以字节为单位。

示例:

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

getReadPosition

getReadPosition(): number

获取MessageSequence的读位置。

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

返回值:

类型

说明

number

返回MessageSequence实例中的当前读取位置。

示例:

  1. let data = rpc.MessageSequence.create();
  2. let readPos = data.getReadPosition();
  3. console.log("RpcClient: readPos is " + readPos);

getWritePosition

getWritePosition(): number

获取MessageSequence的写位置。

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

返回值:

类型

说明

number

返回MessageSequence实例中的当前写入位置。

示例:

  1. let data = rpc.MessageSequence.create();
  2. data.writeInt(10);
  3. let bwPos = data.getWritePosition();
  4. console.log("RpcClient: bwPos is " + bwPos);

rewindRead

rewindRead(pos: number): void

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

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

参数:

参数名

类型

必填

说明

pos

number

开始读取数据的目标位置。

示例:

  1. let data = rpc.MessageSequence.create();
  2. data.writeInt(12);
  3. data.writeString("sequence");
  4. let number = data.readInt();
  5. console.log("RpcClient: number is " + number);
  6. try {
  7. data.rewindRead(0);
  8. } catch(error) {
  9. console.info("rpc rewind read data fail, errorCode " + error.code);
  10. console.info("rpc rewind read data fail, errorMessage " + error.message);
  11. }
  12. let number2 = data.readInt();
  13. console.log("RpcClient: rewindRead is " + number2);

rewindWrite

rewindWrite(pos: number): void

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

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

参数:

参数名

类型

必填

说明

pos

number

开始写入数据的目标位置。

示例:

  1. let data = rpc.MessageSequence.create();
  2. data.writeInt(4);
  3. try {
  4. data.rewindWrite(0);
  5. } catch(error) {
  6. console.info("rpc rewind read data fail, errorCode " + error.code);
  7. console.info("rpc rewind read data fail, errorMessage " + error.message);
  8. }
  9. data.writeInt(5);
  10. let number = data.readInt();
  11. console.log("RpcClient: rewindWrite is: " + number);

writeByte

writeByte(val: number): void

将字节值写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的字节值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeByte(2);
  4. } catch(error) {
  5. console.info("rpc write byte fail, errorCode " + error.code);
  6. console.info("rpc write byte fail, errorMessage" + error.message);
  7. }

readByte

readByte(): number

从MessageSequence实例读取字节值。

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

返回值:

类型

说明

number

返回字节值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeByte(2);
  4. } catch(error) {
  5. console.info("rpc write byte fail, errorCode " + error.code);
  6. console.info("rpc write byte fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readByte();
  10. console.log("RpcClient: readByte is: " + ret);
  11. } catch(error) {
  12. console.info("rpc write byte fail, errorCode " + error.code);
  13. console.info("rpc write byte fail, errorMessage" + error.message);
  14. }

writeShort

writeShort(val: number): void

将短整数值写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的短整数值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeShort(8);
  4. } catch(error) {
  5. console.info("rpc write short fail, errorCode " + error.code);
  6. console.info("rpc write short fail, errorMessage" + error.message);
  7. }

readShort

readShort(): number

从MessageSequence实例读取短整数值。

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

返回值:

类型

说明

number

返回短整数值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeShort(8);
  4. } catch(error) {
  5. console.info("rpc write short fail, errorCode " + error.code);
  6. console.info("rpc write short fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readShort();
  10. console.log("RpcClient: readByte is: " + ret);
  11. } catch(error) {
  12. console.info("rpc read short fail, errorCode " + error.code);
  13. console.info("rpc read short fail, errorMessage" + error.message);
  14. }

writeInt

writeInt(val: number): void

将整数值写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的整数值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeInt(10);
  4. } catch(error) {
  5. console.info("rpc write int fail, errorCode " + error.code);
  6. console.info("rpc write int fail, errorMessage" + error.message);
  7. }

readInt

readInt(): number

从MessageSequence实例读取整数值。

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

返回值:

类型

说明

number

返回整数值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeInt(10);
  4. } catch(error) {
  5. console.info("rpc write int fail, errorCode " + error.code);
  6. console.info("rpc write int fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readInt();
  10. console.log("RpcClient: readInt is " + ret);
  11. } catch(error) {
  12. console.info("rpc read int fail, errorCode " + error.code);
  13. console.info("rpc read int fail, errorMessage" + error.message);
  14. }

writeLong

writeLong(val: number): void

将长整数值写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的长整数值

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeLong(10000);
  4. } catch(error) {
  5. console.info("rpc write long fail, errorCode " + error.code);
  6. console.info("rpc write long fail, errorMessage" + error.message);
  7. }

readLong

readLong(): number

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

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

返回值:

类型

说明

number

返回长整数值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeLong(10000);
  4. } catch(error) {
  5. console.info("rpc write long fail, errorCode " + error.code);
  6. console.info("rpc write long fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readLong();
  10. console.log("RpcClient: readLong is " + ret);
  11. } catch(error) {
  12. console.info("rpc read long fail, errorCode " + error.code);
  13. console.info("rpc read long fail, errorMessage" + error.message);
  14. }

writeFloat

writeFloat(val: number): void

将浮点值写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的浮点值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeFloat(1.2);
  4. } catch(error) {
  5. console.info("rpc write float fail, errorCode " + error.code);
  6. console.info("rpc write float fail, errorMessage" + error.message);
  7. }

readFloat

readFloat(): number

从MessageSequence实例中读取浮点值。

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

返回值:

类型

说明

number

返回浮点值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeFloat(1.2);
  4. } catch(error) {
  5. console.info("rpc write float fail, errorCode " + error.code);
  6. console.info("rpc write float fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readFloat();
  10. console.log("RpcClient: readFloat is " + ret);
  11. } catch(error) {
  12. console.info("rpc read float fail, errorCode " + error.code);
  13. console.info("rpc read float fail, errorMessage" + error.message);
  14. }

writeDouble

writeDouble(val: number): void

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

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

参数:

参数名

类型

必填

说明

val

number

要写入的双精度浮点值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeDouble(10.2);
  4. } catch(error) {
  5. console.info("rpc read float fail, errorCode " + error.code);
  6. console.info("rpc read float fail, errorMessage" + error.message);
  7. }

readDouble

readDouble(): number

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

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

返回值:

类型

说明

number

返回双精度浮点值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeDouble(10.2);
  4. } catch(error) {
  5. console.info("rpc write double fail, errorCode " + error.code);
  6. console.info("rpc write double fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readDouble();
  10. console.log("RpcClient: readDouble is " + ret);
  11. } catch(error) {
  12. console.info("rpc read double fail, errorCode " + error.code);
  13. console.info("rpc read double fail, errorMessage" + error.message);
  14. }

writeBoolean

writeBoolean(val: boolean): void

将布尔值写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

val

boolean

要写入的布尔值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeBoolean(false);
  4. } catch(error) {
  5. console.info("rpc write boolean fail, errorCode " + error.code);
  6. console.info("rpc write boolean fail, errorMessage" + error.message);
  7. }

readBoolean

readBoolean(): boolean

从MessageSequence实例读取布尔值。

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

返回值:

类型

说明

boolean

返回读取到的布尔值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeBoolean(false);
  4. } catch(error) {
  5. console.info("rpc write boolean fail, errorCode " + error.code);
  6. console.info("rpc write boolean fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readBoolean();
  10. console.log("RpcClient: readBoolean is " + ret);
  11. } catch(error) {
  12. console.info("rpc read boolean fail, errorCode " + error.code);
  13. console.info("rpc read boolean fail, errorMessage" + error.message);
  14. }

writeChar

writeChar(val: number): void

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

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

参数:

参数名

类型

必填

说明

val

number

要写入的单个字符值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeChar(97);
  4. } catch(error) {
  5. console.info("rpc write char fail, errorCode " + error.code);
  6. console.info("rpc write char fail, errorMessage" + error.message);
  7. }

readChar

readChar(): number

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

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

返回值:

类型

说明

number

返回单个字符值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeChar(97);
  4. } catch(error) {
  5. console.info("rpc write char fail, errorCode " + error.code);
  6. console.info("rpc write char fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readChar();
  10. console.log("RpcClient: readChar is " + ret);
  11. } catch(error) {
  12. console.info("rpc read char fail, errorCode " + error.code);
  13. console.info("rpc read char fail, errorMessage" + error.message);
  14. }

writeString

writeString(val: string): void

将字符串值写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

val

string

要写入的字符串值,其长度应小于40960字节。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeString('abc');
  4. } catch(error) {
  5. console.info("rpc write string fail, errorCode " + error.code);
  6. console.info("rpc write string fail, errorMessage" + error.message);
  7. }

readString

readString(): string

从MessageSequence实例读取字符串值。

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

返回值:

类型

说明

string

返回字符串值。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeString('abc');
  4. } catch(error) {
  5. console.info("rpc write string fail, errorCode " + error.code);
  6. console.info("rpc write string fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let ret = data.readString();
  10. console.log("RpcClient: readString is " + ret);
  11. } catch(error) {
  12. console.info("rpc read string fail, errorCode " + error.code);
  13. console.info("rpc read string fail, errorMessage" + error.message);
  14. }

writeParcelable

writeParcelable(val: Parcelable): void

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

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

参数:

参数名

类型

必填

说明

val

Parcelable

要写入的可序列对象。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. class MySequenceable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageSequence) {
  9. messageSequence.writeInt(this.num);
  10. messageSequence.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageSequence) {
  14. this.num = messageSequence.readInt();
  15. this.str = messageSequence.readString();
  16. return true;
  17. }
  18. }
  19. let parcelable = new MySequenceable(1, "aaa");
  20. let data = rpc.MessageSequence.create();
  21. try {
  22. data.writeParcelable(parcelable);
  23. } catch(error) {
  24. console.info("rpc write parcelable fail, errorCode " + error.code);
  25. console.info("rpc write parcelable fail, errorMessage" + error.message);
  26. }

readParcelable

readParcelable(dataIn: Parcelable): void

从MessageSequence实例中读取成员变量到指定的对象(dataIn)。

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

参数:

参数名

类型

必填

说明

dataIn

Parcelable

需要从MessageSequence读取成员变量的对象。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

1900012

call js callback function failed

示例:

  1. class MySequenceable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageSequence) {
  9. messageSequence.writeInt(this.num);
  10. messageSequence.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageSequence) {
  14. this.num = messageSequence.readInt();
  15. this.str = messageSequence.readString();
  16. return true;
  17. }
  18. }
  19. let parcelable = new MySequenceable(1, "aaa");
  20. let data = rpc.MessageSequence.create();
  21. data.writeParcelable(parcelable);
  22. let ret = new MySequenceable(0, "");
  23. try {
  24. data.readParcelable(ret);
  25. }catch(error) {
  26. console.info("rpc read parcelable fail, errorCode " + error.code);
  27. console.info("rpc read parcelable fail, errorMessage" + error.message);
  28. }

writeByteArray

writeByteArray(byteArray: number[]): void

将字节数组写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

byteArray

number[]

要写入的字节数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. let ByteArrayVar = [1, 2, 3, 4, 5];
  3. try {
  4. data.writeByteArray(ByteArrayVar);
  5. } catch(error) {
  6. console.info("rpc write byteArray fail, errorCode " + error.code);
  7. console.info("rpc write byteArray fail, errorMessage" + error.message);
  8. }

readByteArray

readByteArray(dataIn: number[]): void

从MessageSequence实例读取字节数组。

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的字节数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. let ByteArrayVar = [1, 2, 3, 4, 5];
  3. try {
  4. data.writeByteArray(ByteArrayVar);
  5. } catch(error) {
  6. console.info("rpc write byteArray fail, errorCode " + error.code);
  7. console.info("rpc write byteArray fail, errorMessage" + error.message);
  8. }
  9. try {
  10. let array = new Array(5);
  11. data.readByteArray(array);
  12. } catch(error) {
  13. console.info("rpc write byteArray fail, errorCode " + error.code);
  14. console.info("rpc write byteArray fail, errorMessage" + error.message);
  15. }

readByteArray

readByteArray(): number[]

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

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

返回值:

类型

说明

number[]

返回字节数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. let byteArrayVar = [1, 2, 3, 4, 5];
  3. try {
  4. data.writeByteArray(byteArrayVar);
  5. } catch(error) {
  6. console.info("rpc write byteArray fail, errorCode " + error.code);
  7. console.info("rpc write byteArray fail, errorMessage" + error.message);
  8. }
  9. try {
  10. let array = data.readByteArray();
  11. console.log("RpcClient: readByteArray is " + array);
  12. } catch(error) {
  13. console.info("rpc read byteArray fail, errorCode " + error.code);
  14. console.info("rpc read byteArray fail, errorMessage" + error.message);
  15. }

writeShortArray

writeShortArray(shortArray: number[]): void

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

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

参数:

参数名

类型

必填

说明

shortArray

number[]

要写入的短整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeShortArray([11, 12, 13]);
  4. } catch(error) {
  5. console.info("rpc read byteArray fail, errorCode " + error.code);
  6. console.info("rpc read byteArray fail, errorMessage" + error.message);
  7. }

readShortArray

readShortArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的短整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeShortArray([11, 12, 13]);
  4. } catch(error) {
  5. console.info("rpc write shortArray fail, errorCode " + error.code);
  6. console.info("rpc write shortArray fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let array = new Array(3);
  10. data.readShortArray(array);
  11. } catch(error) {
  12. console.info("rpc read shortArray fail, errorCode " + error.code);
  13. console.info("rpc read shortArray fail, errorMessage" + error.message);
  14. }

readShortArray

readShortArray(): number[]

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

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

返回值:

类型

说明

number[]

返回短整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeShortArray([11, 12, 13]);
  4. } catch(error) {
  5. console.info("rpc write shortArray fail, errorCode " + error.code);
  6. console.info("rpc write shortArray fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let array = data.readShortArray();
  10. console.log("RpcClient: readShortArray is " + array);
  11. } catch(error) {
  12. console.info("rpc read shortArray fail, errorCode " + error.code);
  13. console.info("rpc read shortArray fail, errorMessage" + error.message);
  14. }

writeIntArray

writeIntArray(intArray: number[]): void

将整数数组写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

intArray

number[]

要写入的整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeIntArray([100, 111, 112]);
  4. } catch(error) {
  5. console.info("rpc write intArray fail, errorCode " + error.code);
  6. console.info("rpc write intArray fail, errorMessage" + error.message);
  7. }

readIntArray

readIntArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeIntArray([100, 111, 112]);
  4. } catch(error) {
  5. console.info("rpc write intArray fail, errorCode " + error.code);
  6. console.info("rpc write intArray fail, errorMessage" + error.message);
  7. }
  8. let array = new Array(3);
  9. try {
  10. data.readIntArray(array);
  11. } catch(error) {
  12. console.info("rpc read intArray fail, errorCode " + error.code);
  13. console.info("rpc read intArray fail, errorMessage" + error.message);
  14. }

readIntArray

readIntArray(): number[]

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

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

返回值:

类型

说明

number[]

返回整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeIntArray([100, 111, 112]);
  4. } catch(error) {
  5. console.info("rpc write intArray fail, errorCode " + error.code);
  6. console.info("rpc write intArray fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let array = data.readIntArray();
  10. console.log("RpcClient: readIntArray is " + array);
  11. } catch(error) {
  12. console.info("rpc read intArray fail, errorCode " + error.code);
  13. console.info("rpc read intArray fail, errorMessage" + error.message);
  14. }

writeLongArray

writeLongArray(longArray: number[]): void

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

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

参数:

参数名

类型

必填

说明

longArray

number[]

要写入的长整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeLongArray([1111, 1112, 1113]);
  4. }catch(error){
  5. console.info("rpc write longArray fail, errorCode " + error.code);
  6. console.info("rpc write longArray fail, errorMessage" + error.message);
  7. }

readLongArray

readLongArray(dataIn: number[]): void

从MessageSequence实例读取的长整数数组。

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的长整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeLongArray([1111, 1112, 1113]);
  4. } catch(error) {
  5. console.info("rpc write longArray fail, errorCode " + error.code);
  6. console.info("rpc write longArray fail, errorMessage" + error.message);
  7. }
  8. let array = new Array(3);
  9. try {
  10. data.readLongArray(array);
  11. } catch(error) {
  12. console.info("rpc read longArray fail, errorCode " + error.code);
  13. console.info("rpc read longArray fail, errorMessage" + error.message);
  14. }

readLongArray

readLongArray(): number[]

从MessageSequence实例中读取所有的长整数数组。

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

返回值:

类型

说明

number[]

返回长整数数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeLongArray([1111, 1112, 1113]);
  4. } catch(error) {
  5. console.info("rpc write longArray fail, errorCode " + error.code);
  6. console.info("rpc write longArray fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let array = data.readLongArray();
  10. console.log("RpcClient: readLongArray is " + array);
  11. } catch(error) {
  12. console.info("rpc read longArray fail, errorCode " + error.code);
  13. console.info("rpc read longArray fail, errorMessage" + error.message);
  14. }

writeFloatArray

writeFloatArray(floatArray: number[]): void

将浮点数组写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

floatArray

number[]

要写入的浮点数组。由于系统内部对float类型的数据是按照double处理的,使用时对于数组所占的总字节数应按照double类型来计算。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeFloatArray([1.2, 1.3, 1.4]);
  4. } catch(error) {
  5. console.info("rpc write floatArray fail, errorCode " + error.code);
  6. console.info("rpc write floatArray fail, errorMessage" + error.message);
  7. }

readFloatArray

readFloatArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的浮点数组。由于系统内部对float类型的数据是按照double处理的,使用时对于数组所占的总字节数应按照double类型来计算。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeFloatArray([1.2, 1.3, 1.4]);
  4. }catch(error){
  5. console.info("rpc write floatArray fail, errorCode " + error.code);
  6. console.info("rpc write floatArray fail, errorMessage" + error.message);
  7. }
  8. let array = new Array(3);
  9. try {
  10. data.readFloatArray(array);
  11. } catch(error) {
  12. console.info("rpc read floatArray fail, errorCode " + error.code);
  13. console.info("rpc read floatArray fail, errorMessage" + error.message);
  14. }

readFloatArray

readFloatArray(): number[]

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

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

返回值:

类型

说明

number[]

返回浮点数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeFloatArray([1.2, 1.3, 1.4]);
  4. } catch(error) {
  5. console.info("rpc write floatArray fail, errorCode " + error.code);
  6. console.info("rpc write floatArray fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let array = data.readFloatArray();
  10. console.log("RpcClient: readFloatArray is " + array);
  11. } catch(error) {
  12. console.info("rpc read floatArray fail, errorCode " + error.code);
  13. console.info("rpc read floatArray fail, errorMessage" + error.message);
  14. }

writeDoubleArray

writeDoubleArray(doubleArray: number[]): void

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

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

参数:

参数名

类型

必填

说明

doubleArray

number[]

要写入的双精度浮点数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeDoubleArray([11.1, 12.2, 13.3]);
  4. } catch(error) {
  5. console.info("rpc write doubleArray fail, errorCode " + error.code);
  6. console.info("rpc write doubleArray fail, errorMessage" + error.message);
  7. }

readDoubleArray

readDoubleArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的双精度浮点数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeDoubleArray([11.1, 12.2, 13.3]);
  4. } catch(error) {
  5. console.info("rpc write doubleArray fail, errorCode " + error.code);
  6. console.info("rpc write doubleArray fail, errorMessage" + error.message);
  7. }
  8. let array = new Array(3);
  9. try {
  10. data.readDoubleArray(array);
  11. } catch(error) {
  12. console.info("rpc read doubleArray fail, errorCode " + error.code);
  13. console.info("rpc read doubleArray fail, errorMessage" + error.message);
  14. }

readDoubleArray

readDoubleArray(): number[]

从MessageSequence实例读取所有双精度浮点数组。

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

返回值:

类型

说明

number[]

返回双精度浮点数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeDoubleArray([11.1, 12.2, 13.3]);
  4. } catch(error) {
  5. console.info("rpc write doubleArray fail, errorCode " + error.code);
  6. console.info("rpc write doubleArray fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let array = data.readDoubleArray();
  10. console.log("RpcClient: readDoubleArray is " + array);
  11. } catch(error) {
  12. console.info("rpc read doubleArray fail, errorCode " + error.code);
  13. console.info("rpc read doubleArray fail, errorMessage" + error.message);
  14. }

writeBooleanArray

writeBooleanArray(booleanArray: boolean[]): void

将布尔数组写入MessageSequence实例。

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

参数:

参数名

类型

必填

说明

booleanArray

boolean[]

要写入的布尔数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeBooleanArray([false, true, false]);
  4. } catch(error) {
  5. console.info("rpc write booleanArray fail, errorCode " + error.code);
  6. console.info("rpc write booleanArray fail, errorMessage" + error.message);
  7. }

readBooleanArray

readBooleanArray(dataIn: boolean[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

boolean[]

要读取的布尔数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeBooleanArray([false, true, false]);
  4. } catch(error) {
  5. console.info("rpc write booleanArray fail, errorCode " + error.code);
  6. console.info("rpc write booleanArray fail, errorMessage" + error.message);
  7. }
  8. let array = new Array(3);
  9. try {
  10. data.readBooleanArray(array);
  11. } catch(error) {
  12. console.info("rpc read booleanArray fail, errorCode " + error.code);
  13. console.info("rpc read booleanArray fail, errorMessage" + error.message);
  14. }

readBooleanArray

readBooleanArray(): boolean[]

从MessageSequence实例中读取所有布尔数组。

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

返回值:

类型

说明

boolean[]

返回布尔数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeBooleanArray([false, true, false]);
  4. } catch(error) {
  5. console.info("rpc write booleanArray fail, errorCode " + error.code);
  6. console.info("rpc write booleanArray fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let array = data.readBooleanArray();
  10. console.log("RpcClient: readBooleanArray is " + array);
  11. } catch(error) {
  12. console.info("rpc read booleanArray fail, errorCode " + error.code);
  13. console.info("rpc read booleanArray fail, errorMessage" + error.message);
  14. }

writeCharArray

writeCharArray(charArray: number[]): void

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

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

参数:

参数名

类型

必填

说明

charArray

number[]

要写入的单个字符数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeCharArray([97, 98, 88]);
  4. } catch(error) {
  5. console.info("rpc write charArray fail, errorCode " + error.code);
  6. console.info("rpc write charArray fail, errorMessage" + error.message);
  7. }

readCharArray

readCharArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的单个字符数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeCharArray([97, 98, 88]);
  4. } catch(error) {
  5. console.info("rpc write charArray fail, errorCode " + error.code);
  6. console.info("rpc write charArray fail, errorMessage" + error.message);
  7. }
  8. let array = new Array(3);
  9. try {
  10. data.readCharArray(array);
  11. } catch(error) {
  12. console.info("rpc read charArray fail, errorCode " + error.code);
  13. console.info("rpc read charArray fail, errorMessage" + error.message);
  14. }

readCharArray

readCharArray(): number[]

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

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

返回值:

类型

说明

number[]

返回单个字符数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeCharArray([97, 98, 88]);
  4. } catch(error) {
  5. console.info("rpc write charArray fail, errorCode " + error.code);
  6. console.info("rpc write charArray fail, errorMessage" + error.message);
  7. }
  8. let array = new Array(3);
  9. try {
  10. let array = data.readCharArray();
  11. console.log("RpcClient: readCharArray is " + array);
  12. } catch(error) {
  13. console.info("rpc read charArray fail, errorCode " + error.code);
  14. console.info("rpc read charArray fail, errorMessage" + error.message);
  15. }

writeStringArray

writeStringArray(stringArray: string[]): void

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

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

参数:

参数名

类型

必填

说明

stringArray

string[]

要写入的字符串数组,数组单个元素的长度应小于40960字节。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeStringArray(["abc", "def"]);
  4. } catch(error) {
  5. console.info("rpc write stringArray fail, errorCode " + error.code);
  6. console.info("rpc write stringArray fail, errorMessage" + error.message);
  7. }

readStringArray

readStringArray(dataIn: string[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

string[]

要读取的字符串数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeStringArray(["abc", "def"]);
  4. } catch(error) {
  5. console.info("rpc write stringArray fail, errorCode " + error.code);
  6. console.info("rpc write stringArray fail, errorMessage" + error.message);
  7. }
  8. let array = new Array(2);
  9. try {
  10. data.readStringArray(array);
  11. } catch(error) {
  12. console.info("rpc read stringArray fail, errorCode " + error.code);
  13. console.info("rpc read stringArray fail, errorMessage" + error.message);
  14. }

readStringArray

readStringArray(): string[]

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

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

返回值:

类型

说明

string[]

返回字符串数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let data = rpc.MessageSequence.create();
  2. try {
  3. data.writeStringArray(["abc", "def"]);
  4. } catch(error) {
  5. console.info("rpc write stringArray fail, errorCode " + error.code);
  6. console.info("rpc write stringArray fail, errorMessage" + error.message);
  7. }
  8. try {
  9. let array = data.readStringArray();
  10. console.log("RpcClient: readStringArray is " + array);
  11. } catch(error) {
  12. console.info("rpc read stringArray fail, errorCode " + error.code);
  13. console.info("rpc read stringArray fail, errorMessage" + error.message);
  14. }

writeNoException

writeNoException(): void

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

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

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. onRemoteRequest(code, data, reply, option) {
  6. if (code === 1) {
  7. console.log("RpcServer: onRemoteRequest called");
  8. try {
  9. reply.writeNoException();
  10. } catch(error) {
  11. console.info("rpc write no exception fail, errorCode " + error.code);
  12. console.info("rpc write no exception fail, errorMessage" + error.message);
  13. }
  14. return true;
  15. } else {
  16. console.log("RpcServer: unknown code: " + code);
  17. return false;
  18. }
  19. }
  20. }

readException

readException(): void

从MessageSequence中读取异常。

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

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的sendMessageRequest接口方法发送消息

  1. let option = new rpc.MessageOption();
  2. let data = rpc.MessageSequence.create();
  3. let reply = rpc.MessageSequence.create();
  4. data.writeInt(1);
  5. data.writeString("hello");
  6. proxy.sendMessageRequest(1, data, reply, option)
  7. .then(function(errCode) {
  8. if (errCode === 0) {
  9. console.log("sendMessageRequest got result");
  10. try {
  11. reply.readException();
  12. } catch(error) {
  13. console.info("rpc read exception fail, errorCode " + error.code);
  14. console.info("rpc read no exception fail, errorMessage" + error.message);
  15. }
  16. let msg = reply.readString();
  17. console.log("RPCTest: reply msg: " + msg);
  18. } else {
  19. console.log("RPCTest: sendMessageRequest failed, errCode: " + errCode);
  20. }
  21. }).catch(function(e) {
  22. console.log("RPCTest: sendMessageRequest got exception: " + e.message);
  23. }).finally (() => {
  24. console.log("RPCTest: sendMessageRequest ends, reclaim parcel");
  25. data.reclaim();
  26. reply.reclaim();
  27. });

writeParcelableArray

writeParcelableArray(parcelableArray: Parcelable[]): void

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

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

参数:

参数名

类型

必填

说明

parcelableArray

Parcelable[]

要写入的可序列化对象数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. class MyParcelable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageSequence) {
  9. messageSequence.writeInt(this.num);
  10. messageSequence.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageSequence) {
  14. this.num = messageSequence.readInt();
  15. this.str = messageSequence.readString();
  16. return true;
  17. }
  18. }
  19. let parcelable = new MyParcelable(1, "aaa");
  20. let parcelable2 = new MyParcelable(2, "bbb");
  21. let parcelable3 = new MyParcelable(3, "ccc");
  22. let a = [parcelable, parcelable2, parcelable3];
  23. let data = rpc.MessageSequence.create();
  24. try {
  25. data.writeParcelableArray(a);
  26. } catch(error) {
  27. console.info("rpc write parcelable array fail, errorCode " + error.code);
  28. console.info("rpc write parcelable array fail, errorMessage" + error.message);
  29. }

readParcelableArray

readParcelableArray(parcelableArray: Parcelable[]): void

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

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

参数:

参数名

类型

必填

说明

parcelableArray

Parcelable[]

要读取的可序列化对象数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

1900012

call js callback function failed

示例:

  1. class MyParcelable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageSequence) {
  9. messageSequence.writeInt(this.num);
  10. messageSequence.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageSequence) {
  14. this.num = messageSequence.readInt();
  15. this.str = messageSequence.readString();
  16. return true;
  17. }
  18. }
  19. let parcelable = new MyParcelable(1, "aaa");
  20. let parcelable2 = new MyParcelable(2, "bbb");
  21. let parcelable3 = new MyParcelable(3, "ccc");
  22. let a = [parcelable, parcelable2, parcelable3];
  23. let data = rpc.MessageSequence.create();
  24. let result = data.writeParcelableArray(a);
  25. console.log("RpcClient: writeParcelableArray is " + result);
  26. let b = [new MyParcelable(0, ""), new MyParcelable(0, ""), new MyParcelable(0, "")];
  27. try {
  28. data.readParcelableArray(b);
  29. } catch(error) {
  30. console.info("rpc read parcelable array fail, errorCode " + error.code);
  31. console.info("rpc read parcelable array fail, errorMessage" + error.message);
  32. }
  33. data.readParcelableArray(b);

writeRemoteObjectArray

writeRemoteObjectArray(objectArray: IRemoteObject[]): void

将IRemoteObject对象数组写入MessageSequence。

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

参数:

参数名

类型

必填

说明

objectArray

IRemoteObject[]

要写入MessageSequence的IRemoteObject对象数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. this.modifyLocalInterface(this, descriptor);
  5. }
  6. asObject(): rpc.IRemoteObject {
  7. return this;
  8. }
  9. }
  10. let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
  11. let data = rpc.MessageSequence.create();
  12. let result = data.writeRemoteObjectArray(a);
  13. try {
  14. data.writeRemoteObjectArray(a);
  15. } catch(error) {
  16. console.info("rpc write remote object array fail, errorCode " + error.code);
  17. console.info("rpc write remote object array fail, errorMessage" + error.message);
  18. }
  19. console.log("RpcClient: writeRemoteObjectArray is " + result);

readRemoteObjectArray

readRemoteObjectArray(objects: IRemoteObject[]): void

从MessageSequence读取IRemoteObject对象数组。

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

参数:

参数名

类型

必填

说明

objects

IRemoteObject[]

从MessageSequence读取的IRemoteObject对象数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. this.modifyLocalInterface(this, descriptor);
  10. }
  11. asObject(): rpc.IRemoteObject {
  12. return this;
  13. }
  14. }
  15. let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
  16. let data = rpc.MessageSequence.create();
  17. data.writeRemoteObjectArray(a);
  18. let b = new Array(3);
  19. try {
  20. data.readRemoteObjectArray(b);
  21. } catch(error) {
  22. console.info("rpc read remote object array fail, errorCode " + error.code);
  23. console.info("rpc read remote object array fail, errorMessage" + error.message);
  24. }
  25. data.readRemoteObjectArray(b);

readRemoteObjectArray

readRemoteObjectArray(): IRemoteObject[]

从MessageSequence读取IRemoteObject对象数组。

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

返回值:

类型

说明

IRemoteObject[]

返回IRemoteObject对象数组。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. this.modifyLocalInterface(this, descriptor);
  5. }
  6. asObject(): rpc.IRemoteObject {
  7. return this;
  8. }
  9. }
  10. let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
  11. let data = rpc.MessageSequence.create();
  12. data.writeRemoteObjectArray(a);
  13. try {
  14. let b = data.readRemoteObjectArray();
  15. console.log("RpcClient: readRemoteObjectArray is " + b);
  16. } catch(error) {
  17. console.info("rpc read remote object array fail, errorCode " + error.code);
  18. console.info("rpc read remote object array fail, errorMessage" + error.message);
  19. }

closeFileDescriptor9+

static closeFileDescriptor(fd: number): void

静态方法,关闭给定的文件描述符。

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

参数:

参数名

类型

必填

说明

fd

number

要关闭的文件描述符。

示例:

  1. import fileio from '@ohos.fileio';
  2. let filePath = "path/to/file";
  3. let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
  4. try {
  5. rpc.MessageSequence.closeFileDescriptor(fd);
  6. } catch(error) {
  7. console.info("rpc close file descriptor fail, errorCode " + error.code);
  8. console.info("rpc close file descriptor fail, errorMessage" + error.message);
  9. }

dupFileDescriptor

static dupFileDescriptor(fd: number) :number

静态方法,复制给定的文件描述符。

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

参数:

参数名

类型

必填

说明

fd

number

表示已存在的文件描述符。

返回值:

类型

说明

number

返回新的文件描述符。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900013

call os dup function failed

示例:

  1. import fileio from '@ohos.fileio';
  2. let filePath = "path/to/file";
  3. let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
  4. try {
  5. let newFd = rpc.MessageSequence.dupFileDescriptor(fd);
  6. } catch(error) {
  7. console.info("rpc dup file descriptor fail, errorCode " + error.code);
  8. console.info("rpc dup file descriptor fail, errorMessage" + error.message);
  9. }

containFileDescriptors

containFileDescriptors(): boolean

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

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

返回值:

类型

说明

boolean

true:包含文件描述符,false:不包含文件描述符。

示例:

  1. import fileio from '@ohos.fileio';
  2. let sequence = new rpc.MessageSequence();
  3. let filePath = "path/to/file";
  4. let r1 = sequence.containFileDescriptors();
  5. let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
  6. try {
  7. sequence.writeFileDescriptor(fd);
  8. } catch(error) {
  9. console.info("rpc write file descriptor fail, errorCode " + error.code);
  10. console.info("rpc write file descriptor fail, errorMessage" + error.message);
  11. }
  12. try {
  13. let containFD = sequence.containFileDescriptors();
  14. console.log("RpcTest: sequence after write fd containFd result is : " + containFD);
  15. } catch(error) {
  16. console.info("rpc contain file descriptor fail, errorCode " + error.code);
  17. console.info("rpc contain file descriptor fail, errorMessage" + error.message);
  18. }

writeFileDescriptor

writeFileDescriptor(fd: number): void

写入文件描述符到MessageSequence。

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

参数:

参数名

类型

必填

说明

fd

number

文件描述符。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. import fileio from '@ohos.fileio';
  2. let sequence = new rpc.MessageSequence();
  3. let filePath = "path/to/file";
  4. let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
  5. try {
  6. sequence.writeFileDescriptor(fd);
  7. } catch(error) {
  8. console.info("rpc write file descriptor fail, errorCode " + error.code);
  9. console.info("rpc write file descriptor fail, errorMessage" + error.message);
  10. }

readFileDescriptor

readFileDescriptor(): number

从MessageSequence中读取文件描述符。

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

返回值:

类型

说明

number

返回文件描述符。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. import fileio from '@ohos.fileio';
  2. let sequence = new rpc.MessageSequence();
  3. let filePath = "path/to/file";
  4. let fd = fileio.openSync(filePath, 0o2| 0o100, 0o666);
  5. try {
  6. sequence.writeFileDescriptor(fd);
  7. } catch(error) {
  8. console.info("rpc write file descriptor fail, errorCode " + error.code);
  9. console.info("rpc write file descriptor fail, errorMessage" + error.message);
  10. }
  11. try {
  12. let readFD = sequence.readFileDescriptor();
  13. } catch(error) {
  14. console.info("rpc read file descriptor fail, errorCode " + error.code);
  15. console.info("rpc read file descriptor fail, errorMessage" + error.message);
  16. }

writeAshmem

writeAshmem(ashmem: Ashmem): void

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

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

参数:

参数名

类型

必填

说明

ashmem

Ashmem

要写入MessageSequence的匿名共享对象。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900003

write to ashmem failed

示例:

  1. let sequence = new rpc.MessageSequence();
  2. let ashmem;
  3. try {
  4. ashmem = rpc.Ashmem.create("ashmem", 1024);
  5. } catch(error) {
  6. console.info("rpc create ashmem fail, errorCode " + error.code);
  7. console.info("rpc creat ashmem fail, errorMessage" + error.message);
  8. }
  9. try {
  10. sequence.writeAshmem(ashmem);
  11. } catch(error) {
  12. console.info("rpc write ashmem fail, errorCode " + error.code);
  13. console.info("rpc write ashmem fail, errorMessage" + error.message);
  14. }

readAshmem

readAshmem(): Ashmem

从MessageSequence读取匿名共享对象。

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

返回值:

类型

说明

Ashmem

返回匿名共享对象。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900004

read from ashmem failed

示例:

  1. let sequence = new rpc.MessageSequence();
  2. let ashmem;
  3. try {
  4. ashmem = rpc.Ashmem.create("ashmem", 1024);
  5. } catch(error) {
  6. console.info("rpc create ashmem fail, errorCode " + error.code);
  7. console.info("rpc creat ashmem fail, errorMessage" + error.message);
  8. }
  9. try {
  10. sequence.writeAshmem(ashmem);
  11. } catch(error) {
  12. console.info("rpc write ashmem fail, errorCode " + error.code);
  13. console.info("rpc write ashmem fail, errorMessage" + error.message);
  14. }
  15. try {
  16. let readAshmem = sequence.readAshmem();
  17. console.log("RpcTest: read ashmem to result is : " + readAshmem);
  18. } catch(error) {
  19. console.info("rpc read ashmem fail, errorCode " + error.code);
  20. console.info("rpc read ashmem fail, errorMessage" + error.message);
  21. }

getRawDataCapacity

getRawDataCapacity(): number

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

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

返回值:

类型

说明

number

返回MessageSequence可以容纳的最大原始数据量,即128 Mb。

示例:

  1. let sequence = new rpc.MessageSequence();
  2. let result = sequence.getRawDataCapacity();
  3. console.log("RpcTest: sequence get RawDataCapacity result is : " + result);

writeRawData

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

将原始数据写入MessageSequence对象。

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

参数:

参数名

类型

必填

说明

rawData

number[]

要写入的原始数据。

size

number

发送的原始数据大小,以字节为单位。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900009

write data to message sequence failed

示例:

  1. let sequence = new rpc.MessageSequence();
  2. let arr = [1, 2, 3, 4, 5];
  3. try {
  4. sequence.writeRawData(arr, arr.length);
  5. } catch(error) {
  6. console.info("rpc write rawdata fail, errorCode " + error.code);
  7. console.info("rpc write rawdata fail, errorMessage" + error.message);
  8. }

readRawData

readRawData(size: number): number[]

从MessageSequence读取原始数据。

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

参数:

参数名

类型

必填

说明

size

number

要读取的原始数据的大小。

返回值:

类型

说明

number[]

返回原始数据(以字节为单位)。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900010

read data from message sequence failed

示例:

  1. let sequence = new rpc.MessageSequence();
  2. let arr = [1, 2, 3, 4, 5];
  3. try {
  4. sequence.writeRawData(arr, arr.length);
  5. } catch(error) {
  6. console.info("rpc write rawdata fail, errorCode " + error.code);
  7. console.info("rpc write rawdata fail, errorMessage" + error.message);
  8. }
  9. try {
  10. let result = sequence.readRawData(5);
  11. console.log("RpcTest: sequence read raw data result is : " + result);
  12. } catch(error) {
  13. console.info("rpc read rawdata fail, errorCode " + error.code);
  14. console.info("rpc read rawdata fail, errorMessage" + error.message);
  15. }

MessageParcel(deprecated)

从API version 9 开始不再维护,建议使用MessageSequence类替代。

在RPC过程中,发送方可以使用MessageParcel提供的写方法,将待发送的数据以特定格式写入该对象。接收方可以使用MessageParcel提供的读方法从该对象中读取特定格式的数据。数据格式包括:基础类型及数组、IPC对象、接口描述符和自定义序列化对象。

create

static create(): MessageParcel

静态方法,创建MessageParcel对象。

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

返回值:

类型

说明

MessageParcel

返回创建的MessageParcel对象。

示例:

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

reclaim

reclaim(): void

释放不再使用的MessageParcel对象。

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

示例:

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

writeRemoteObject

writeRemoteObject(object: IRemoteObject): boolean

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

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

参数:

参数名

类型

必填

说明

object

IRemoteObject

要序列化并写入MessageParcel的远程对象。

返回值:

类型

说明

boolean

true:操作成功,false:操作失败。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let data = rpc.MessageParcel.create();
  21. let testRemoteObject = new TestRemoteObject("testObject");
  22. data.writeRemoteObject(testRemoteObject);

readRemoteObject

readRemoteObject(): IRemoteObject

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

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

返回值:

类型

说明

IRemoteObject

读取到的远程对象。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let data = rpc.MessageParcel.create();
  21. let testRemoteObject = new TestRemoteObject("testObject");
  22. data.writeRemoteObject(testRemoteObject);
  23. let proxy = data.readRemoteObject();

writeInterfaceToken

writeInterfaceToken(token: string): boolean

将接口描述符写入MessageParcel对象,远端对象可使用该信息校验本次通信。

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

参数:

参数名

类型

必填

说明

token

string

字符串类型描述符。

返回值:

类型

说明

boolean

true:操作成功,false:操作失败。

示例:

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

readInterfaceToken

readInterfaceToken(): string

从MessageParcel中读取接口描述符,接口描述符按写入MessageParcel的顺序读取,本地对象可使用该信息检验本次通信。

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

返回值:

类型

说明

string

返回读取到的接口描述符。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let interfaceToken = data.readInterfaceToken();
  4. console.log("RpcServer: interfaceToken is " + interfaceToken);
  5. return true;
  6. }
  7. }

getSize

getSize(): number

获取当前MessageParcel的数据大小。

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

返回值:

类型

说明

number

获取的MessageParcel的数据大小。以字节为单位。

示例:

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

getCapacity

getCapacity(): number

获取当前MessageParcel的容量。

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

返回值:

类型

说明

number

获取的MessageParcel的容量大小。以字节为单位。

示例:

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

setSize

setSize(size: number): boolean

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

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

参数:

参数名

类型

必填

说明

size

number

MessageParcel实例的数据大小。以字节为单位。

返回值:

类型

说明

boolean

true:设置成功,false:设置失败。

示例:

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

setCapacity

setCapacity(size: number): boolean

设置MessageParcel实例的存储容量。

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

参数:

参数名

类型

必填

说明

size

number

MessageParcel实例的存储容量。以字节为单位。

返回值:

类型

说明

boolean

true:设置成功,false:设置失败。

示例:

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

getWritableBytes

getWritableBytes(): number

获取MessageParcel的可写字节空间。

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

返回值:

类型

说明

number

获取到的MessageParcel的可写字节空间。以字节为单位。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let getWritableBytes = data.getWritableBytes();
  4. console.log("RpcServer: getWritableBytes is " + getWritableBytes);
  5. return true;
  6. }
  7. }

getReadableBytes

getReadableBytes(): number

获取MessageParcel的可读字节空间。

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

返回值:

类型

说明

number

获取到的MessageParcel的可读字节空间。以字节为单位。

示例:

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

getReadPosition

getReadPosition(): number

获取MessageParcel的读位置。

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

返回值:

类型

说明

number

返回MessageParcel实例中的当前读取位置。

示例:

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

getWritePosition

getWritePosition(): number

获取MessageParcel的写位置。

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

返回值:

类型

说明

number

返回MessageParcel实例中的当前写入位置。

示例:

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

rewindRead

rewindRead(pos: number): boolean

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

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

参数:

参数名

类型

必填

说明

pos

number

开始读取数据的目标位置。

返回值:

类型

说明

boolean

true:读取位置发生更改,false:读取位置未发生更改。

示例:

  1. let data = rpc.MessageParcel.create();
  2. data.writeInt(12);
  3. data.writeString("parcel");
  4. let number = data.readInt();
  5. console.log("RpcClient: number is " + number);
  6. data.rewindRead(0);
  7. let number2 = data.readInt();
  8. console.log("RpcClient: rewindRead is " + number2);

rewindWrite

rewindWrite(pos: number): boolean

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

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

参数:

参数名

类型

必填

说明

pos

number

开始写入数据的目标位置。

返回值:

类型

说明

boolean

true:写入位置发生更改,false:写入位置未发生更改。

示例:

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

writeByte

writeByte(val: number): boolean

将字节值写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的字节值。

返回值:

类型

说明

boolean

写入返回成功,否则返回false。

示例:

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

readByte

readByte(): number

从MessageParcel实例读取字节值。

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

返回值:

类型

说明

number

返回字节值。

示例:

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

writeShort

writeShort(val: number): boolean

将短整数值写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的短整数值。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readShort

readShort(): number

从MessageParcel实例读取短整数值。

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

返回值:

类型

说明

number

返回短整数值。

示例:

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

writeInt

writeInt(val: number): boolean

将整数值写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的整数值。

返回值:

类型

说明

boolean

写入返回成功,否则返回false。

示例:

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

readInt

readInt(): number

从MessageParcel实例读取整数值。

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

返回值:

类型

说明

number

返回整数值。

示例:

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

writeLong

writeLong(val: number): boolean

将长整数值写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的长整数值

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readLong

readLong(): number

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

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

返回值:

类型

说明

number

返回长整数值。

示例:

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

writeFloat

writeFloat(val: number): boolean

将浮点值写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

val

number

要写入的浮点值。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readFloat

readFloat(): number

从MessageParcel实例中读取浮点值。

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

返回值:

类型

说明

number

返回浮点值。

示例:

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

writeDouble

writeDouble(val: number): boolean

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

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

参数:

参数名

类型

必填

说明

val

number

要写入的双精度浮点值。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readDouble

readDouble(): number

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

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

返回值:

类型

说明

number

返回双精度浮点值。

示例:

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

writeBoolean

writeBoolean(val: boolean): boolean

将布尔值写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

val

boolean

要写入的布尔值。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readBoolean

readBoolean(): boolean

从MessageParcel实例读取布尔值。

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

返回值:

类型

说明

boolean

返回读取到的布尔值。

示例:

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

writeChar

writeChar(val: number): boolean

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

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

参数:

参数名

类型

必填

说明

val

number

要写入的单个字符值。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readChar

readChar(): number

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

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

返回值:

类型

说明

number

返回单个字符值。

示例:

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

writeString

writeString(val: string): boolean

将字符串值写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

val

string

要写入的字符串值,其长度应小于40960字节。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readString

readString(): string

从MessageParcel实例读取字符串值。

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

返回值:

类型

说明

string

返回字符串值。

示例:

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

writeSequenceable

writeSequenceable(val: Sequenceable): boolean

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

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

参数:

参数名

类型

必填

说明

val

Sequenceable

要写入的可序列对象。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

  1. class MySequenceable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageParcel) {
  9. messageParcel.writeInt(this.num);
  10. messageParcel.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageParcel) {
  14. this.num = messageParcel.readInt();
  15. this.str = messageParcel.readString();
  16. return true;
  17. }
  18. }
  19. let sequenceable = new MySequenceable(1, "aaa");
  20. let data = rpc.MessageParcel.create();
  21. let result = data.writeSequenceable(sequenceable);
  22. console.log("RpcClient: writeSequenceable is " + result);

readSequenceable

readSequenceable(dataIn: Sequenceable): boolean

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

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

参数:

参数名

类型

必填

说明

dataIn

Sequenceable

需要从MessageParcel读取成员变量的对象。

返回值:

类型

说明

boolean

true:反序列化成功,false:反序列化失败。

示例:

  1. class MySequenceable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageParcel) {
  9. messageParcel.writeInt(this.num);
  10. messageParcel.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageParcel) {
  14. this.num = messageParcel.readInt();
  15. this.str = messageParcel.readString();
  16. return true;
  17. }
  18. }
  19. let sequenceable = new MySequenceable(1, "aaa");
  20. let data = rpc.MessageParcel.create();
  21. let result = data.writeSequenceable(sequenceable);
  22. console.log("RpcClient: writeSequenceable is " + result);
  23. let ret = new MySequenceable(0, "");
  24. let result2 = data.readSequenceable(ret);
  25. console.log("RpcClient: writeSequenceable is " + result2);

writeByteArray

writeByteArray(byteArray: number[]): boolean

将字节数组写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

byteArray

number[]

要写入的字节数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readByteArray

readByteArray(dataIn: number[]): void

从MessageParcel实例读取字节数组。

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的字节数组。

示例:

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

readByteArray

readByteArray(): number[]

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

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

返回值:

类型

说明

number[]

返回字节数组。

示例:

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

writeShortArray

writeShortArray(shortArray: number[]): boolean

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

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

参数:

参数名

类型

必填

说明

shortArray

number[]

要写入的短整数数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readShortArray

readShortArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的短整数数组。

示例:

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

readShortArray

readShortArray(): number[]

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

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

返回值:

类型

说明

number[]

返回短整数数组。

示例:

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

writeIntArray

writeIntArray(intArray: number[]): boolean

将整数数组写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

intArray

number[]

要写入的整数数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readIntArray

readIntArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的整数数组。

示例:

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

readIntArray

readIntArray(): number[]

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

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

返回值:

类型

说明

number[]

返回整数数组。

示例:

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

writeLongArray

writeLongArray(longArray: number[]): boolean

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

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

参数:

参数名

类型

必填

说明

longArray

number[]

要写入的长整数数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readLongArray

readLongArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的长整数数组。

示例:

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

readLongArray

readLongArray(): number[]

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

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

返回值:

类型

说明

number[]

返回长整数数组。

示例:

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

writeFloatArray

writeFloatArray(floatArray: number[]): boolean

将浮点数组写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

floatArray

number[]

要写入的浮点数组。由于系统内部对float类型的数据是按照double处理的,使用时对于数组所占的总字节数应按照double类型来计算。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readFloatArray

readFloatArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的浮点数组。由于系统内部对float类型的数据是按照double处理的,使用时对于数组所占的总字节数应按照double类型来计算。

示例:

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

readFloatArray

readFloatArray(): number[]

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

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

返回值:

类型

说明

number[]

返回浮点数组。

示例:

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

writeDoubleArray

writeDoubleArray(doubleArray: number[]): boolean

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

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

参数:

参数名

类型

必填

说明

doubleArray

number[]

要写入的双精度浮点数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readDoubleArray

readDoubleArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的双精度浮点数组。

示例:

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

readDoubleArray

readDoubleArray(): number[]

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

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

返回值:

类型

说明

number[]

返回双精度浮点数组。

示例:

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

writeBooleanArray

writeBooleanArray(booleanArray: boolean[]): boolean

将布尔数组写入MessageParcel实例。

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

参数:

参数名

类型

必填

说明

booleanArray

boolean[]

要写入的布尔数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readBooleanArray

readBooleanArray(dataIn: boolean[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

boolean[]

要读取的布尔数组。

示例:

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

readBooleanArray

readBooleanArray(): boolean[]

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

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

返回值:

类型

说明

boolean[]

返回布尔数组。

示例:

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

writeCharArray

writeCharArray(charArray: number[]): boolean

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

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

参数:

参数名

类型

必填

说明

charArray

number[]

要写入的单个字符数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readCharArray

readCharArray(dataIn: number[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

number[]

要读取的单个字符数组。

示例:

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

readCharArray

readCharArray(): number[]

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

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

返回值:

类型

说明

number[]

返回单个字符数组。

示例:

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

writeStringArray

writeStringArray(stringArray: string[]): boolean

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

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

参数:

参数名

类型

必填

说明

stringArray

string[]

要写入的字符串数组,数组单个元素的长度应小于40960字节。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readStringArray

readStringArray(dataIn: string[]): void

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

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

参数:

参数名

类型

必填

说明

dataIn

string[]

要读取的字符串数组。

示例:

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

readStringArray

readStringArray(): string[]

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

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

返回值:

类型

说明

string[]

返回字符串数组。

示例:

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

writeNoException8+

writeNoException(): void

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

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

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. onRemoteRequest(code, data, reply, option) {
  20. if (code === 1) {
  21. console.log("RpcServer: onRemoteRequest called");
  22. reply.writeNoException();
  23. return true;
  24. } else {
  25. console.log("RpcServer: unknown code: " + code);
  26. return false;
  27. }
  28. }
  29. }

readException8+

readException(): void

从MessageParcel中读取异常。

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

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的sendMessageRequest接口方法发送消息

  1. let option = new rpc.MessageOption();
  2. let data = rpc.MessageParcel.create();
  3. let reply = rpc.MessageParcel.create();
  4. data.writeInt(1);
  5. data.writeString("hello");
  6. proxy.sendMessageRequest(1, data, reply, option)
  7. .then(function(errCode) {
  8. if (errCode === 0) {
  9. console.log("sendMessageRequest got result");
  10. reply.readException();
  11. let msg = reply.readString();
  12. console.log("RPCTest: reply msg: " + msg);
  13. } else {
  14. console.log("RPCTest: sendMessageRequest failed, errCode: " + errCode);
  15. }
  16. }).catch(function(e) {
  17. console.log("RPCTest: sendMessageRequest got exception: " + e.message);
  18. }).finally (() => {
  19. console.log("RPCTest: sendMessageRequest ends, reclaim parcel");
  20. data.reclaim();
  21. reply.reclaim();
  22. });

writeSequenceableArray

writeSequenceableArray(sequenceableArray: Sequenceable[]): boolean

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

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

参数:

参数名

类型

必填

说明

sequenceableArray

Sequenceable[]

要写入的可序列化对象数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

  1. class MySequenceable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageParcel) {
  9. messageParcel.writeInt(this.num);
  10. messageParcel.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageParcel) {
  14. this.num = messageParcel.readInt();
  15. this.str = messageParcel.readString();
  16. return true;
  17. }
  18. }
  19. let sequenceable = new MySequenceable(1, "aaa");
  20. let sequenceable2 = new MySequenceable(2, "bbb");
  21. let sequenceable3 = new MySequenceable(3, "ccc");
  22. let a = [sequenceable, sequenceable2, sequenceable3];
  23. let data = rpc.MessageParcel.create();
  24. let result = data.writeSequenceableArray(a);
  25. console.log("RpcClient: writeSequenceableArray is " + result);

readSequenceableArray8+

readSequenceableArray(sequenceableArray: Sequenceable[]): void

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

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

参数:

参数名

类型

必填

说明

sequenceableArray

Sequenceable[]

要读取的可序列化对象数组。

示例:

  1. class MySequenceable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageParcel) {
  9. messageParcel.writeInt(this.num);
  10. messageParcel.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageParcel) {
  14. this.num = messageParcel.readInt();
  15. this.str = messageParcel.readString();
  16. return true;
  17. }
  18. }
  19. let sequenceable = new MySequenceable(1, "aaa");
  20. let sequenceable2 = new MySequenceable(2, "bbb");
  21. let sequenceable3 = new MySequenceable(3, "ccc");
  22. let a = [sequenceable, sequenceable2, sequenceable3];
  23. let data = rpc.MessageParcel.create();
  24. let result = data.writeSequenceableArray(a);
  25. console.log("RpcClient: writeSequenceableArray is " + result);
  26. let b = [new MySequenceable(0, ""), new MySequenceable(0, ""), new MySequenceable(0, "")];
  27. data.readSequenceableArray(b);

writeRemoteObjectArray8+

writeRemoteObjectArray(objectArray: IRemoteObject[]): boolean

将IRemoteObject对象数组写入MessageParcel。

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

参数:

参数名

类型

必填

说明

objectArray

IRemoteObject[]

要写入MessageParcel的IRemoteObject对象数组。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. this.attachLocalInterface(this, descriptor);
  10. }
  11. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  12. return true;
  13. }
  14. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  15. return true;
  16. }
  17. isObjectDead(): boolean {
  18. return false;
  19. }
  20. asObject(): rpc.IRemoteObject {
  21. return this;
  22. }
  23. }
  24. let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
  25. let data = rpc.MessageParcel.create();
  26. let result = data.writeRemoteObjectArray(a);
  27. console.log("RpcClient: writeRemoteObjectArray is " + result);

readRemoteObjectArray8+

readRemoteObjectArray(objects: IRemoteObject[]): void

从MessageParcel读取IRemoteObject对象数组。

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

参数:

参数名

类型

必填

说明

objects

IRemoteObject[]

从MessageParcel读取的IRemoteObject对象数组。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. this.attachLocalInterface(this, descriptor);
  10. }
  11. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  12. return true;
  13. }
  14. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  15. return true;
  16. }
  17. isObjectDead(): boolean {
  18. return false;
  19. }
  20. asObject(): rpc.IRemoteObject {
  21. return this;
  22. }
  23. }
  24. let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
  25. let data = rpc.MessageParcel.create();
  26. let result = data.writeRemoteObjectArray(a);
  27. let b = new Array(3);
  28. data.readRemoteObjectArray(b);

readRemoteObjectArray8+

readRemoteObjectArray(): IRemoteObject[]

从MessageParcel读取IRemoteObject对象数组。

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

返回值:

类型

说明

IRemoteObject[]

返回IRemoteObject对象数组。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. this.attachLocalInterface(this, descriptor);
  10. }
  11. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  12. return true;
  13. }
  14. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  15. return true;
  16. }
  17. isObjectDead(): boolean {
  18. return false;
  19. }
  20. asObject(): rpc.IRemoteObject {
  21. return this;
  22. }
  23. }
  24. let a = [new TestRemoteObject("testObject1"), new TestRemoteObject("testObject2"), new TestRemoteObject("testObject3")];
  25. let data = rpc.MessageParcel.create();
  26. let result = data.writeRemoteObjectArray(a);
  27. console.log("RpcClient: readRemoteObjectArray is " + result);
  28. let b = data.readRemoteObjectArray();
  29. console.log("RpcClient: readRemoteObjectArray is " + b);

closeFileDescriptor8+

static closeFileDescriptor(fd: number): void

静态方法,关闭给定的文件描述符。

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

参数:

参数名

类型

必填

说明

fd

number

要关闭的文件描述符。

示例:

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

dupFileDescriptor8+

static dupFileDescriptor(fd: number) :number

静态方法,复制给定的文件描述符。

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

参数:

参数名

类型

必填

说明

fd

number

表示已存在的文件描述符。

返回值:

类型

说明

number

返回新的文件描述符。

示例:

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

containFileDescriptors8+

containFileDescriptors(): boolean

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

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

返回值:

类型

说明

boolean

true:包含文件描述符,false:未包含文件描述符。

示例:

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

writeFileDescriptor8+

writeFileDescriptor(fd: number): boolean

写入文件描述符到MessageParcel。

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

参数:

参数名

类型

必填

说明

fd

number

文件描述符。

返回值:

类型

说明

boolean

true:操作成功,false:操作失败。

示例:

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

readFileDescriptor8+

readFileDescriptor(): number

从MessageParcel中读取文件描述符。

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

返回值:

类型

说明

number

返回文件描述符。

示例:

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

writeAshmem8+

writeAshmem(ashmem: Ashmem): boolean

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

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

参数:

参数名

类型

必填

说明

ashmem

Ashmem

要写入MessageParcel的匿名共享对象。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readAshmem8+

readAshmem(): Ashmem

从MessageParcel读取匿名共享对象。

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

返回值:

类型

说明

Ashmem

返回匿名共享对象。

示例:

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

getRawDataCapacity8+

getRawDataCapacity(): number

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

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

返回值:

类型

说明

number

返回MessageParcel可以容纳的最大原始数据量,即128 Mb。

示例:

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

writeRawData8+

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

将原始数据写入MessageParcel对象。

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

参数:

参数名

类型

必填

说明

rawData

number[]

要写入的原始数据。

size

number

发送的原始数据大小,以字节为单位。

返回值:

类型

说明

boolean

true:写入成功,false:写入失败。

示例:

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

readRawData8+

readRawData(size: number): number[]

从MessageParcel读取原始数据。

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

参数:

参数名

类型

必填

说明

size

number

要读取的原始数据的大小。

返回值:

类型

说明

number[]

返回原始数据(以字节为单位)。

示例:

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

Parcelable9+

在进程间通信(IPC)期间,将类的对象写入MessageSequence并从MessageSequence中恢复它们。

marshalling

marshalling(dataOut: MessageSequence): boolean

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

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

参数:

参数名

类型

必填

说明

dataOut

MessageSequence

可序列对象将被封送到的MessageSequence对象。

返回值:

类型

说明

boolean

true:封送成功,false:封送失败。

示例:

 
  1. class MyParcelable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageSequence) {
  9. messageSequence.writeInt(this.num);
  10. messageSequence.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageSequence) {
  14. this.num = messageSequence.readInt();
  15. this.str = messageSequence.readString();
  16. return true;
  17. }
  18. }
  19. let parcelable = new MyParcelable(1, "aaa");
  20. let data = rpc.MessageSequence.create();
  21. let result = data.writeParcelable(parcelable);
  22. console.log("RpcClient: writeParcelable is " + result);
  23. let ret = new MyParcelable(0, "");
  24. let result2 = data.readParcelable(ret);
  25. console.log("RpcClient: readParcelable is " + result2);

unmarshalling

unmarshalling(dataIn: MessageSequence): boolean

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

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

参数:

参数名

类型

必填

说明

dataIn

MessageSequence

已将可序列对象封送到其中的MessageSequence对象。

返回值:

类型

说明

boolean

true:反序列化成功,false:反序列化失败。

示例:

  1. class MyParcelable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageSequence) {
  9. messageSequence.writeInt(this.num);
  10. messageSequence.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageSequence) {
  14. this.num = messageSequence.readInt();
  15. this.str = messageSequence.readString();
  16. return true;
  17. }
  18. }
  19. let parcelable = new MyParcelable(1, "aaa");
  20. let data = rpc.MessageSequence.create();
  21. let result = data.writeParcelable(parcelable);
  22. console.log("RpcClient: writeParcelable is " + result);
  23. let ret = new MyParcelable(0, "");
  24. let result2 = data.readParcelable(ret);
  25. console.log("RpcClient: readParcelable is " + result2);

Sequenceable(deprecated)

从API version 9 开始不再维护,建议使用Parcelable类替代。

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

marshalling

marshalling(dataOut: MessageParcel): boolean

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

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

参数:

参数名

类型

必填

说明

dataOut

MessageParcel

可序列对象将被封送到的MessageParcel对象。

返回值:

类型

说明

boolean

true:封送成功,false:封送失败。

示例:

 
  1. class MySequenceable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageParcel) {
  9. messageParcel.writeInt(this.num);
  10. messageParcel.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageParcel) {
  14. this.num = messageParcel.readInt();
  15. this.str = messageParcel.readString();
  16. return true;
  17. }
  18. }
  19. let sequenceable = new MySequenceable(1, "aaa");
  20. let data = rpc.MessageParcel.create();
  21. let result = data.writeSequenceable(sequenceable);
  22. console.log("RpcClient: writeSequenceable is " + result);
  23. let ret = new MySequenceable(0, "");
  24. let result2 = data.readSequenceable(ret);
  25. console.log("RpcClient: readSequenceable is " + result2);

unmarshalling

unmarshalling(dataIn: MessageParcel): boolean

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

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

参数:

参数名

类型

必填

说明

dataIn

MessageParcel

已将可序列对象封送到其中的MessageParcel对象。

返回值:

类型

说明

boolean

true:反序列化成功,false:反序列化失败。

示例:

  1. class MySequenceable {
  2. num: number;
  3. str: string;
  4. constructor(num, str) {
  5. this.num = num;
  6. this.str = str;
  7. }
  8. marshalling(messageParcel) {
  9. messageParcel.writeInt(this.num);
  10. messageParcel.writeString(this.str);
  11. return true;
  12. }
  13. unmarshalling(messageParcel) {
  14. this.num = messageParcel.readInt();
  15. this.str = messageParcel.readString();
  16. return true;
  17. }
  18. }
  19. let sequenceable = new MySequenceable(1, "aaa");
  20. let data = rpc.MessageParcel.create();
  21. let result = data.writeSequenceable(sequenceable);
  22. console.log("RpcClient: writeSequenceable is " + result);
  23. let ret = new MySequenceable(0, "");
  24. let result2 = data.readSequenceable(ret);
  25. console.log("RpcClient: readSequenceable is " + result2);

IRemoteBroker

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

asObject

asObject(): IRemoteObject

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

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

返回值:

类型

说明

IRemoteObject

如果调用者是RemoteObject对象,则直接返回本身;如果调用者是RemoteProxy对象,则返回它的持有者IRemoteObject

示例:

  1. class TestAbility extends rpc.RemoteObject {
  2. asObject() {
  3. return this;
  4. }
  5. }
  6. let remoteObject = new TestAbility("testObject").asObject();

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function (elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function (elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function () {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的asObject接口方法获取代理或远端对象

  1. class TestProxy {
  2. remote: rpc.RemoteObject;
  3. constructor(remote) {
  4. this.remote = remote;
  5. }
  6. asObject() {
  7. return this.remote;
  8. }
  9. }
  10. let iRemoteObject = new TestProxy(proxy).asObject();

DeathRecipient

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

onRemoteDied

onRemoteDied(): void

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

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

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }

RequestResult9+

发送请求的响应结果。

系统能力:以下各项对应的系统能力均为SystemCapability.Communication.IPC.Core。

名称

类型

可读

可写

说明

errCode

number

错误码。

code

number

消息代码。

data

MessageSequence

发送给对端进程的MessageSequence对象。

reply

MessageSequence

对端进程返回的MessageSequence对象。

SendRequestResult8+(deprecated)

从API version 9 开始不再维护,建议使用RequestResult类替代。

发送请求的响应结果。

系统能力:以下各项对应的系统能力均为SystemCapability.Communication.IPC.Core。

名称

类型

可读

可写

说明

errCode

number

错误码。

code

number

消息代码。

data

MessageParcel

发送给对端进程的MessageParcel对象。

reply

MessageParcel

对端进程返回的MessageParcel对象。

IRemoteObject

该接口可用于查询或获取接口描述符、添加或删除死亡通知、转储对象状态到特定文件、发送消息。

getLocalInterface9+

getLocalInterface(descriptor: string): IRemoteBroker

查询接口描述符的字符串。

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

参数:

参数名

类型

必填

说明

descriptor

string

接口描述符的字符串。

返回值:

类型

说明

IRemoteBroker

返回绑定到指定接口描述符的IRemoteBroker对象。

queryLocalInterface(deprecated)

从API version 9 开始不再维护,建议使用getLocalInterface类替代。

queryLocalInterface(descriptor: string): IRemoteBroker

查询接口描述符的字符串。

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

参数:

参数名

类型

必填

说明

descriptor

string

接口描述符的字符串。

返回值:

类型

说明

IRemoteBroker

返回绑定到指定接口描述符的IRemoteBroker对象。

sendRequest(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption): boolean

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容。如果为选项设置了同步模式,则期约将在sendRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

boolean

true:发送成功,false:发送失败。

sendRequest8+(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption): Promise<SendRequestResult>

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则期约将在sendRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

Promise<SendRequestResult>

返回一个期约,兑现值是sendRequestResult实例。

sendMessageRequest9+

sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption): Promise<RequestResult>

以同步或异步方式向对端进程发送MessageSequence消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则期约将在sendMessageRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageSequence

保存待发送数据的 MessageSequence对象。

reply

MessageSequence

接收应答数据的MessageSequence对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

Promise<RequestResult>

返回一个期约,兑现值是requestResult实例。

sendMessageRequest9+

sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption, callback: AsyncCallback<RequestResult>): void

以同步或异步方式向对端进程发送MessageSequence消息。如果为选项设置了异步模式,则立即收到回调,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则将在sendRequest返回时收到回调,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageSequence

保存待发送数据的 MessageSequence对象。

reply

MessageSequence

接收应答数据的MessageSequence对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

callback

AsyncCallback<RequestResult>

接收发送结果的回调。

sendRequest8+(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback<SendRequestResult>): void

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则立即收到回调,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则将在sendRequest返回时收到回调,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

callback

AsyncCallback<SendRequestResult>

接收发送结果的回调。

registerDeathRecipient9+

registerDeathRecipient(recipient: DeathRecipient, flags: number): void

注册用于接收远程对象死亡通知的回调。如果与RemoteProxy对象匹配的远程对象进程死亡,则调用此方法。

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

参数:

参数名

类型

必填

说明

recipient

DeathRecipient

要注册的回调。

flags

number

死亡通知标志。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

addDeathrecipient(deprecated)

从API version 9 开始不再维护,建议使用registerDeathRecipient类替代。

addDeathRecipient(recipient: DeathRecipient, flags: number): boolean

注册用于接收远程对象死亡通知的回调。如果与RemoteProxy对象匹配的远程对象进程死亡,则调用此方法。

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

参数:

参数名

类型

必填

说明

recipient

DeathRecipient

要注册的回调。

flags

number

死亡通知标志。

返回值:

类型

说明

boolean

true:回调注册成功,false:回调注册失败。

unregisterDeathRecipient9+

unregisterDeathRecipient(recipient: DeathRecipient, flags: number): void

注销用于接收远程对象死亡通知的回调。

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

参数:

参数名

类型

必填

说明

recipient

DeathRecipient

要注销的回调。

flags

number

死亡通知标志。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

removeDeathRecipient(deprecated)

从API version 9 开始不再维护,建议使用unregisterDeathRecipient类替代。

removeDeathRecipient(recipient: DeathRecipient, flags: number): boolean

注销用于接收远程对象死亡通知的回调。

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

参数:

参数名

类型

必填

说明

recipient

DeathRecipient

要注销的回调。

flags

number

死亡通知标志。

返回值:

类型

说明

boolean

true:回调注销成功,false:回调注销失败。

getDescriptor9+

getDescriptor(): string

获取对象的接口描述符,接口描述符为字符串。

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

返回值:

类型

说明

string

返回接口描述符。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

getInterfaceDescriptor(deprecated)

从API version 9 开始不再维护,建议使用getDescriptor类替代。

getInterfaceDescriptor(): string

获取对象的接口描述符,接口描述符为字符串。

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

返回值:

类型

说明

string

返回接口描述符。

isObjectDead

isObjectDead(): boolean

检查当前对象是否死亡。

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

返回值:

类型

说明

boolean

true:对象死亡,false:对象未死亡。

RemoteProxy

实现IRemoteObject代理对象。

系统能力:以下各项对应的系统能力均为SystemCapability.Communication.IPC.Core。

名称

说明

PING_TRANSACTION

1599098439 (0x5f504e47)

内部指令码,用于测试IPC服务正常。

DUMP_TRANSACTION

1598311760 (0x5f444d50)

内部指令码,获取Binder内部状态。

INTERFACE_TRANSACTION

1598968902 (0x5f4e5446)

内部指令码,获取对端接口描述符。

MIN_TRANSACTION_ID

1 (0x00000001)

最小有效指令码。

MAX_TRANSACTION_ID

16777215 (0x00FFFFFF)

最大有效指令码。

sendRequest(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption): boolean

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则期约将在sendRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

boolean

true:发送成功,false:发送失败。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的sendRequest接口方法发送消息

  1. let option = new rpc.MessageOption();
  2. let data = rpc.MessageParcel.create();
  3. let reply = rpc.MessageParcel.create();
  4. data.writeInt(1);
  5. data.writeString("hello");
  6. let ret: boolean = proxy.sendRequest(1, data, reply, option);
  7. if (ret) {
  8. console.log("sendRequest got result");
  9. let msg = reply.readString();
  10. console.log("RPCTest: reply msg: " + msg);
  11. } else {
  12. console.log("RPCTest: sendRequest failed");
  13. }
  14. console.log("RPCTest: sendRequest ends, reclaim parcel");
  15. data.reclaim();
  16. reply.reclaim();

sendMessageRequest9+

sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption): Promise<RequestResult>

以同步或异步方式向对端进程发送MessageSequence消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则期约将在sendMessageRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageSequence

保存待发送数据的 MessageSequence对象。

reply

MessageSequence

接收应答数据的MessageSequence对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

Promise<RequestResult>

返回一个期约,兑现值是requestResult实例。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的sendMessageRequest接口方法发送消息

  1. let option = new rpc.MessageOption();
  2. let data = rpc.MessageSequence.create();
  3. let reply = rpc.MessageSequence.create();
  4. data.writeInt(1);
  5. data.writeString("hello");
  6. proxy.sendMessageRequest(1, data, reply, option)
  7. .then(function(result) {
  8. if (result.errCode === 0) {
  9. console.log("sendMessageRequest got result");
  10. result.reply.readException();
  11. let msg = result.reply.readString();
  12. console.log("RPCTest: reply msg: " + msg);
  13. } else {
  14. console.log("RPCTest: sendMessageRequest failed, errCode: " + result.errCode);
  15. }
  16. }).catch(function(e) {
  17. console.log("RPCTest: sendMessageRequest got exception: " + e.message);
  18. }).finally (() => {
  19. console.log("RPCTest: sendMessageRequest ends, reclaim parcel");
  20. data.reclaim();
  21. reply.reclaim();
  22. });

sendRequest8+(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption): Promise<SendRequestResult>

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则期约将在sendRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

Promise<SendRequestResult>

返回一个期约,兑现值是sendRequestResult实例。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的sendRequest接口方法发送消息

  1. let option = new rpc.MessageOption();
  2. let data = rpc.MessageParcel.create();
  3. let reply = rpc.MessageParcel.create();
  4. data.writeInt(1);
  5. data.writeString("hello");
  6. proxy.sendRequest(1, data, reply, option)
  7. .then(function(result) {
  8. if (result.errCode === 0) {
  9. console.log("sendRequest got result");
  10. result.reply.readException();
  11. let msg = result.reply.readString();
  12. console.log("RPCTest: reply msg: " + msg);
  13. } else {
  14. console.log("RPCTest: sendRequest failed, errCode: " + result.errCode);
  15. }
  16. }).catch(function(e) {
  17. console.log("RPCTest: sendRequest got exception: " + e.message);
  18. }).finally (() => {
  19. console.log("RPCTest: sendRequest ends, reclaim parcel");
  20. data.reclaim();
  21. reply.reclaim();
  22. });

sendMessageRequest9+

sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption, callback: AsyncCallback<RequestResult>): void

以同步或异步方式向对端进程发送MessageSequence消息。如果为选项设置了异步模式,则立即收到回调,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则将在sendMessageRequest返回后的某个时机执行回调,回复内容在RequestResult的reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageSequence

保存待发送数据的 MessageSequence对象。

reply

MessageSequence

接收应答数据的MessageSequence对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

callback

AsyncCallback<RequestResult>

接收发送结果的回调。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. function sendRequestCallback(result) {
  20. if (result.errCode === 0) {
  21. console.log("sendRequest got result");
  22. result.reply.readException();
  23. let msg = result.reply.readString();
  24. console.log("RPCTest: reply msg: " + msg);
  25. } else {
  26. console.log("RPCTest: sendRequest failed, errCode: " + result.errCode);
  27. }
  28. console.log("RPCTest: sendRequest ends, reclaim parcel");
  29. result.data.reclaim();
  30. result.reply.reclaim();
  31. }
  32. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的sendMessageRequest接口方法发送消息

  1. let option = new rpc.MessageOption();
  2. let data = rpc.MessageSequence.create();
  3. let reply = rpc.MessageSequence.create();
  4. data.writeInt(1);
  5. data.writeString("hello");
  6. try {
  7. proxy.sendRequest(1, data, reply, option, sendRequestCallback);
  8. } catch(error) {
  9. console.info("rpc send sequence request fail, errorCode " + error.code);
  10. console.info("rpc send sequence request fail, errorMessage " + error.message);
  11. }

sendRequest8+(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback<SendRequestResult>): void

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则立即收到回调,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则将在sendRequest返回时收到回调,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

callback

AsyncCallback<SendRequestResult>

接收发送结果的回调。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. function sendRequestCallback(result) {
  20. if (result.errCode === 0) {
  21. console.log("sendRequest got result");
  22. result.reply.readException();
  23. let msg = result.reply.readString();
  24. console.log("RPCTest: reply msg: " + msg);
  25. } else {
  26. console.log("RPCTest: sendRequest failed, errCode: " + result.errCode);
  27. }
  28. console.log("RPCTest: sendRequest ends, reclaim parcel");
  29. result.data.reclaim();
  30. result.reply.reclaim();
  31. }
  32. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的sendRequest接口方法发送消息

  1. let option = new rpc.MessageOption();
  2. let data = rpc.MessageParcel.create();
  3. let reply = rpc.MessageParcel.create();
  4. data.writeInt(1);
  5. data.writeString("hello");
  6. proxy.sendRequest(1, data, reply, option, sendRequestCallback);

getLocalInterface9+

getLocalInterface(interface: string): IRemoteBroker

查询并获取当前接口描述符对应的本地接口对象。

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

参数:

参数名

类型

必填

说明

interface

string

需要查询的接口描述符。

返回值:

类型

说明

IRemoteBroker

默认返回Null,标识该接口是一个代理侧接口。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900006

only remote object permitted

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function (elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName":"com.ohos.server",
  17. "abilityName":"com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的getLocalInterface接口方法查询接口对象

  1. try {
  2. let broker = proxy.getLocalInterface("testObject");
  3. console.log("RpcClient: getLocalInterface is " + broker);
  4. } catch(error) {
  5. console.info("rpc get local interface fail, errorCode " + error.code);
  6. console.info("rpc get local interface fail, errorMessage " + error.message);
  7. }

queryLocalInterface(deprecated)

从API version 9 开始不再维护,建议使用getLocalInterface类替代。

queryLocalInterface(interface: string): IRemoteBroker

查询并获取当前接口描述符对应的本地接口对象。

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

参数:

参数名

类型

必填

说明

interface

string

需要查询的接口描述符。

返回值:

类型

说明

IRemoteBroker

默认返回Null,标识该接口是一个代理侧接口。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function (elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName":"com.ohos.server",
  17. "abilityName":"com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的queryLocalInterface接口获取接口对象

  1. let broker = proxy.queryLocalInterface("testObject");
  2. console.log("RpcClient: queryLocalInterface is " + broker);

registerDeathRecipient9+

registerDeathRecipient(recipient: DeathRecipient, flags: number): void

注册用于接收远程对象死亡通知的回调。如果与RemoteProxy对象匹配的远程对象进程死亡,则调用此方法。

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

参数:

参数名

类型

必填

说明

recipient

DeathRecipient

要注册的回调。

flags

number

死亡通知标志。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的registerDeathRecipient接口注册死亡回调

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. let deathRecipient = new MyDeathRecipient();
  7. try {
  8. proxy.registerDeathRecipient(deathRecipient, 0);
  9. } catch(error) {
  10. console.info("proxy register deathRecipient fail, errorCode " + error.code);
  11. console.info("proxy register deathRecipient fail, errorMessage " + error.message);
  12. }

addDeathRecipient(deprecated)

从API version 9 开始不再维护,建议使用registerDeathRecipient类替代。

addDeathRecipient(recipient: DeathRecipient, flags: number): boolean

注册用于接收远程对象死亡通知的回调,增加proxy对象上的死亡通知。

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

参数:

参数名

类型

必填

说明

recipient

DeathRecipient

收件人表示要注册的回调。

flags

number

死亡通知标志。保留参数。设置为0。

返回值:

类型

说明

boolean

true:回调注册成功,false:回调注册失败。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的addDeathRecipient接口方法新增死亡回调

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. let deathRecipient = new MyDeathRecipient();
  7. proxy.addDeathRecipient(deathRecipient, 0);

unregisterDeathRecipient9+

unregisterDeathRecipient(recipient: DeathRecipient, flags: number): void

注销用于接收远程对象死亡通知的回调。

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

参数:

参数名

类型

必填

说明

recipient

DeathRecipient

要注销的回调。

flags

number

死亡通知标志。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的unregisterDeathRecipient接口方法注销死亡回调

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. let deathRecipient = new MyDeathRecipient();
  7. try {
  8. proxy.registerDeathRecipient(deathRecipient, 0);
  9. proxy.unregisterDeathRecipient(deathRecipient, 0);
  10. } catch(error) {
  11. console.info("proxy register deathRecipient fail, errorCode " + error.code);
  12. console.info("proxy register deathRecipient fail, errorMessage " + error.message);
  13. }

removeDeathRecipient(deprecated)

从API version 9 开始不再维护,建议使用unregisterDeathRecipient类替代。

removeDeathRecipient(recipient: DeathRecipient, flags: number): boolean

注销用于接收远程对象死亡通知的回调。

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

参数:

参数名

类型

必填

说明

recipient

DeathRecipient

要注销的死亡回调。

flags

number

死亡通知标志。保留参数。设置为0。

返回值:

类型

说明

boolean

true:回调注销成功,false:回调注销失败。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的removeDeathRecipient接口方法去注册死亡回调

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. let deathRecipient = new MyDeathRecipient();
  7. proxy.addDeathRecipient(deathRecipient, 0);
  8. proxy.removeDeathRecipient(deathRecipient, 0);

getDescriptor9+

getDescriptor(): string

获取对象的接口描述符,接口描述符为字符串。

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

返回值:

类型

说明

string

返回接口描述符。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

1900007

communication failed

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的getDescriptor接口方法获取对象的接口描述符

  1. try {
  2. let descriptor = proxy.getDescriptor();
  3. console.log("RpcClient: descriptor is " + descriptor);
  4. } catch(error) {
  5. console.info("rpc get interface descriptor fail, errorCode " + error.code);
  6. console.info("rpc get interface descriptor fail, errorMessage " + error.message);
  7. }

getInterfaceDescriptor(deprecated)

从API version 9 开始不再维护,建议使用getDescriptor类替代。

getInterfaceDescriptor(): string

查询当前代理对象接口的描述符。

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

返回值:

类型

说明

string

当前的接口描述符。

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);
  20. ```
  21. 上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的isObjectDead接口方法判断当前对象是否已经死亡
  22. ```ts
  23. let descriptor = proxy.getInterfaceDescriptor();
  24. console.log("RpcClient: descriptor is " + descriptor);

isObjectDead

isObjectDead(): boolean

指示对应的RemoteObject是否死亡。

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

返回值:

类型

说明

boolean

true:对应的对象已经死亡,false:对应的对象未死亡

示例:

获取服务

  1. import FA from "@ohos.ability.featureAbility";
  2. let proxy;
  3. let connect = {
  4. onConnect: function(elementName, remoteProxy) {
  5. console.log("RpcClient: js onConnect called.");
  6. proxy = remoteProxy;
  7. },
  8. onDisconnect: function(elementName) {
  9. console.log("RpcClient: onDisconnect");
  10. },
  11. onFailed: function() {
  12. console.log("RpcClient: onFailed");
  13. }
  14. };
  15. let want = {
  16. "bundleName": "com.ohos.server",
  17. "abilityName": "com.ohos.server.MainAbility",
  18. };
  19. FA.connectAbility(want, connect);

上述onConnect回调函数中的proxy对象需要等ability异步连接成功后才会被赋值,然后才可调用proxy对象的isObjectDead接口方法判断当前对象是否已经死亡

  1. let isDead = proxy.isObjectDead();
  2. console.log("RpcClient: isObjectDead is " + isDead);

MessageOption

公共消息选项(int标志,int等待时间),使用标志中指定的标志构造指定的MessageOption对象。

系统能力:以下各项对应的系统能力均为SystemCapability.Communication.IPC.Core。

名称

说明

TF_SYNC

0

同步调用标识。

TF_ASYNC

1

异步调用标识。

TF_ACCEPT_FDS

0x10

指示sendMessageRequest9+接口可以返回文件描述符。

TF_WAIT_TIME

8

默认等待时间(单位/秒)。

constructor9+

constructor(async?: boolean);

MessageOption构造函数。

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

参数:

参数名

类型

必填

说明

syncFlags

number

同步调用或异步调用标志。默认同步调用。

示例:

  1. class TestRemoteObject extends rpc.MessageOption {
  2. constructor(async) {
  3. super(async);
  4. }
  5. }

constructor

constructor(syncFlags?: number, waitTime?: number)

MessageOption构造函数。

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

参数:

参数名

类型

必填

说明

syncFlags

number

同步调用或异步调用标志。默认同步调用。

waitTime

number

调用rpc最长等待时间。默认 TF_WAIT_TIME。

示例:

  1. class TestRemoteObject extends rpc.MessageOption {
  2. constructor(syncFlags,waitTime) {
  3. super(syncFlags,waitTime);
  4. }
  5. }

isAsync9+

isAsync(): boolean;

获取SendMessageRequest调用中确定同步或是异步的标志。

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

返回值:

类型

说明

boolean

true:同步调用成功,false:异步调用成功。

示例:

  1. let option = new rpc.MessageOption();
  2. let isAsync = option.isAsync();

setAsync9+

setAsync(async: boolean): void;

设置SendMessageRequest调用中确定同步或是异步的标志。

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

示例:

  1. let option = new rpc.MessageOption();
  2. let setAsync = option.setAsync(true);
  3. console.log("Set synchronization flag");

getFlags

getFlags(): number

获取同步调用或异步调用标志。

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

返回值:

类型

说明

number

调用成功返回同步调用或异步调用标志。

示例:

  1. try {
  2. let option = new rpc.MessageOption();
  3. console.info("create object successfully.");
  4. let flog = option.getFlags();
  5. console.info("run getFlags success, flog is " + flog);
  6. option.setFlags(1)
  7. console.info("run setFlags success");
  8. let flog2 = option.getFlags();
  9. console.info("run getFlags success, flog2 is " + flog2);
  10. } catch (error) {
  11. console.info("error " + error);
  12. }

setFlags

setFlags(flags: number): void

设置同步调用或异步调用标志。

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

参数:

参数名

类型

必填

说明

flags

number

同步调用或异步调用标志。

示例:

  1. try {
  2. let option = new rpc.MessageOption();
  3. option.setFlags(1)
  4. console.info("run setFlags success");
  5. let flog = option.getFlags();
  6. console.info("run getFlags success, flog is " + flog);
  7. } catch (error) {
  8. console.info("error " + error);
  9. }

getWaitTime

getWaitTime(): number

获取rpc调用的最长等待时间。

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

返回值:

类型

说明

number

rpc最长等待时间。

示例:

  1. try {
  2. let option = new rpc.MessageOption();
  3. let time = option.getWaitTime();
  4. console.info("run getWaitTime success");
  5. option.setWaitTime(16);
  6. let time2 = option.getWaitTime();
  7. console.info("run getWaitTime success, time is " + time);
  8. } catch (error) {
  9. console.info("error " + error);
  10. }

setWaitTime

setWaitTime(waitTime: number): void

设置rpc调用最长等待时间。

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

参数:

参数名

类型

必填

说明

waitTime

number

rpc调用最长等待时间。

示例:

  1. try {
  2. let option = new rpc.MessageOption();
  3. option.setWaitTime(16);
  4. let time = option.getWaitTime();
  5. console.info("run getWaitTime success, time is " + time);
  6. } catch (error) {
  7. console.info("error " + error);
  8. }

IPCSkeleton

用于获取IPC上下文信息,包括获取UID和PID、获取本端和对端设备ID、检查接口调用是否在同一设备上。

getContextObject

static getContextObject(): IRemoteObject

静态方法,获取系统能力的管理者。

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

返回值:

类型

说明

IRemoteObject

返回系统能力管理者。

示例:

  1. let samgr = rpc.IPCSkeleton.getContextObject();
  2. console.log("RpcServer: getContextObject result: " + samgr);

getCallingPid

static getCallingPid(): number

静态方法,获取调用者的PID。此方法由RemoteObject对象在onRemoteRequest方法中调用,不在IPC上下文环境(onRemoteRequest)中调用则返回本进程的PID。

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

返回值:

类型

说明

number

返回调用者的PID。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let callerPid = rpc.IPCSkeleton.getCallingPid();
  4. console.log("RpcServer: getCallingPid result: " + callerPid);
  5. return true;
  6. }
  7. }

getCallingUid

static getCallingUid(): number

静态方法,获取调用者的UID。此方法由RemoteObject对象在onRemoteRequest方法中调用,不在IPC上下文环境(onRemoteRequest)中调用则返回本进程的UID。

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

返回值:

类型

说明

number

返回调用者的UID。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let callerUid = rpc.IPCSkeleton.getCallingUid();
  4. console.log("RpcServer: getCallingUid result: " + callerUid);
  5. return true;
  6. }
  7. }

getCallingTokenId8+

static getCallingTokenId(): number;

静态方法,获取调用者的TokenId,用于被调用方对调用方的身份校验。

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

返回值:

类型

说明

number

返回调用者的TokenId。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let callerTokenId = rpc.IPCSkeleton.getCallingTokenId();
  4. console.log("RpcServer: getCallingTokenId result: " + callerTokenId);
  5. return true;
  6. }
  7. }

getCallingDeviceID

static getCallingDeviceID(): string

静态方法,获取调用者进程所在的设备ID。

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

返回值:

类型

说明

string

返回调用者进程所在的设备ID。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let callerDeviceID = rpc.IPCSkeleton.getCallingDeviceID();
  4. console.log("RpcServer: callerDeviceID is: " + callerDeviceID);
  5. return true;
  6. }
  7. }

getLocalDeviceID

static getLocalDeviceID(): string

静态方法,获取本端设备ID。

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

返回值:

类型

说明

string

返回本地设备的ID。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let localDeviceID = rpc.IPCSkeleton.getLocalDeviceID();
  4. console.log("RpcServer: localDeviceID is: " + localDeviceID);
  5. return true;
  6. }
  7. }

isLocalCalling

static isLocalCalling(): boolean

静态方法,检查当前通信对端是否是本设备的进程。

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

返回值:

类型

说明

boolean

true:调用在同一台设备,false:调用未在同一台设备。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let isLocalCalling = rpc.IPCSkeleton.isLocalCalling();
  4. console.log("RpcServer: isLocalCalling is: " + isLocalCalling);
  5. return true;
  6. }
  7. }

flushCmdBuffer9+

static flushCmdBuffer(object: IRemoteObject): void

静态方法,将所有挂起的命令从指定的RemoteProxy刷新到相应的RemoteObject。建议在执行任何时间敏感操作之前调用此方法。

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

参数:

参数名

类型

必填

说明

object

IRemoteObject

指定的RemoteProxy。

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. }
  6. let remoteObject = new TestRemoteObject("aaa");
  7. try {
  8. rpc.IPCSkeleton.flushCmdBuffer(remoteObject);
  9. } catch(error) {
  10. console.info("proxy set calling identity fail, errorCode " + error.code);
  11. console.info("proxy set calling identity fail, errorMessage " + error.message);
  12. }

flushCommands(deprecated)

从API version 9 开始不再维护,建议使用flushCmdBuffer类替代。

static flushCommands(object: IRemoteObject): number

静态方法,将所有挂起的命令从指定的RemoteProxy刷新到相应的RemoteObject。建议在执行任何时间敏感操作之前调用此方法。

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

参数:

参数名

类型

必填

说明

object

IRemoteObject

指定的RemoteProxy。

返回值:

类型

说明

number

如果操作成功,返回0;如果输入对象为空或RemoteObject,或者操作失败,返回错误代码。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let remoteObject = new TestRemoteObject("aaa");
  21. let ret = rpc.IPCSkeleton.flushCommands(remoteObject);
  22. console.log("RpcServer: flushCommands result: " + ret);

resetCallingIdentity

static resetCallingIdentity(): string

静态方法,将远程用户的UID和PID替换为本地用户的UID和PID。它可以用于身份验证等场景。

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

返回值:

类型

说明

string

返回包含远程用户的UID和PID的字符串。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let callingIdentity = rpc.IPCSkeleton.resetCallingIdentity();
  4. console.log("RpcServer: callingIdentity is: " + callingIdentity);
  5. return true;
  6. }
  7. }

restoreCallingIdentity9+

static restoreCallingIdentity(identity: string): void

静态方法,将远程用户的UID和PID替换为本地用户的UID和PID。它可以用于身份验证等场景。

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

参数:

参数名

类型

必填

说明

identity

string

标识表示包含远程用户UID和PID的字符串。由resetCallingIdentity返回。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let callingIdentity = null;
  4. try {
  5. callingIdentity = rpc.IPCSkeleton.resetCallingIdentity();
  6. console.log("RpcServer: callingIdentity is: " + callingIdentity);
  7. } finally {
  8. rpc.IPCSkeleton.restoreCallingIdentity("callingIdentity ");
  9. }
  10. return true;
  11. }
  12. }

setCallingIdentity(deprecated)

从API version 9 开始不再维护,建议使用restoreCallingIdentity类替代。

static setCallingIdentity(identity: string): boolean

静态方法,将UID和PID恢复为远程用户的UID和PID。它通常在使用resetCallingIdentity后调用,需要resetCallingIdentity返回的远程用户的UID和PID。

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

参数:

参数名

类型

必填

说明

identity

string

标识表示包含远程用户UID和PID的字符串。由resetCallingIdentity返回。

返回值:

类型

说明

boolean

true:设置成功,false:设置失败。

示例:

  1. class Stub extends rpc.RemoteObject {
  2. onRemoteMessageRequest(code, data, reply, option) {
  3. let callingIdentity = null;
  4. try {
  5. callingIdentity = rpc.IPCSkeleton.resetCallingIdentity();
  6. console.log("RpcServer: callingIdentity is: " + callingIdentity);
  7. } finally {
  8. let ret = rpc.IPCSkeleton.setCallingIdentity("callingIdentity ");
  9. console.log("RpcServer: setCallingIdentity is: " + ret);
  10. }
  11. return true;
  12. }
  13. }

RemoteObject

实现远程对象。服务提供者必须继承此类。

constructor

constructor(descriptor: string)

RemoteObject构造函数。

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

参数:

参数名

类型

必填

说明

descriptor

string

接口描述符。

sendRequest(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption): boolean

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则期约将在sendRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

boolean

true:发送成功,false:发送失败。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let testRemoteObject = new TestRemoteObject("testObject");
  21. let option = new rpc.MessageOption();
  22. let data = rpc.MessageParcel.create();
  23. let reply = rpc.MessageParcel.create();
  24. data.writeInt(1);
  25. data.writeString("hello");
  26. let ret: boolean = testRemoteObject.sendRequest(1, data, reply, option);
  27. if (ret) {
  28. console.log("sendRequest got result");
  29. let msg = reply.readString();
  30. console.log("RPCTest: reply msg: " + msg);
  31. } else {
  32. console.log("RPCTest: sendRequest failed");
  33. }
  34. console.log("RPCTest: sendRequest ends, reclaim parcel");
  35. data.reclaim();
  36. reply.reclaim();

sendRequest8+(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption): Promise<SendRequestResult>

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则期约将在sendRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

Promise<SendRequestResult>

返回一个期约,兑现值是sendRequestResult实例。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let testRemoteObject = new TestRemoteObject("testObject");
  21. let option = new rpc.MessageOption();
  22. let data = rpc.MessageParcel.create();
  23. let reply = rpc.MessageParcel.create();
  24. data.writeInt(1);
  25. data.writeString("hello");
  26. testRemoteObject.sendRequest(1, data, reply, option)
  27. .then(function(result) {
  28. if (result.errCode === 0) {
  29. console.log("sendRequest got result");
  30. result.reply.readException();
  31. let msg = result.reply.readString();
  32. console.log("RPCTest: reply msg: " + msg);
  33. } else {
  34. console.log("RPCTest: sendRequest failed, errCode: " + result.errCode);
  35. }
  36. }).catch(function(e) {
  37. console.log("RPCTest: sendRequest got exception: " + e.message);
  38. }).finally (() => {
  39. console.log("RPCTest: sendRequest ends, reclaim parcel");
  40. data.reclaim();
  41. reply.reclaim();
  42. });

sendMessageRequest9+

sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption): Promise<RequestResult>

以同步或异步方式向对端进程发送MessageSequence消息。如果为选项设置了异步模式,则期约立即兑现,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则期约将在sendMessageRequest返回时兑现,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageSequence

保存待发送数据的 MessageSequence对象。

reply

MessageSequence

接收应答数据的MessageSequence对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

返回值:

类型

说明

Promise<RequestResult>

返回一个期约,兑现值是sendRequestResult实例。

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. }
  6. let testRemoteObject = new TestRemoteObject("testObject");
  7. let option = new rpc.MessageOption();
  8. let data = rpc.MessageSequence.create();
  9. let reply = rpc.MessageSequence.create();
  10. data.writeInt(1);
  11. data.writeString("hello");
  12. testRemoteObject.sendMessageRequest(1, data, reply, option)
  13. .then(function(result) {
  14. if (result.errCode === 0) {
  15. console.log("sendMessageRequest got result");
  16. result.reply.readException();
  17. let msg = result.reply.readString();
  18. console.log("RPCTest: reply msg: " + msg);
  19. } else {
  20. console.log("RPCTest: sendMessageRequest failed, errCode: " + result.errCode);
  21. }
  22. }).catch(function(e) {
  23. console.log("RPCTest: sendMessageRequest got exception: " + e.message);
  24. }).finally (() => {
  25. console.log("RPCTest: sendMessageRequest ends, reclaim parcel");
  26. data.reclaim();
  27. reply.reclaim();
  28. });

sendMessageRequest9+

sendMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption, callback: AsyncCallback<RequestResult>): void

以同步或异步方式向对端进程发送MessageSequence消息。如果为选项设置了异步模式,则立即收到回调,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则将在sendMessageRequest返回时收到回调,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageSequence

保存待发送数据的 MessageSequence对象。

reply

MessageSequence

接收应答数据的MessageSequence对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

AsyncCallback

AsyncCallback<RequestResult>

接收发送结果的回调。

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. }
  6. function sendRequestCallback(result) {
  7. if (result.errCode === 0) {
  8. console.log("sendRequest got result");
  9. result.reply.readException();
  10. let msg = result.reply.readString();
  11. console.log("RPCTest: reply msg: " + msg);
  12. } else {
  13. console.log("RPCTest: sendRequest failed, errCode: " + result.errCode);
  14. }
  15. console.log("RPCTest: sendRequest ends, reclaim parcel");
  16. result.data.reclaim();
  17. result.reply.reclaim();
  18. }
  19. let testRemoteObject = new TestRemoteObject("testObject");
  20. let option = new rpc.MessageOption();
  21. let data = rpc.MessageSequence.create();
  22. let reply = rpc.MessageSequence.create();
  23. data.writeInt(1);
  24. data.writeString("hello");
  25. testRemoteObject.sendMessageRequest(1, data, reply, option, sendRequestCallback);

sendRequest8+(deprecated)

从API version 9 开始不再维护,建议使用sendMessageRequest类替代。

sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback<SendRequestResult>): void

以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式,则立即收到回调,reply报文里没有内容,具体回复需要在业务侧的回调中获取。如果为选项设置了同步模式,则将在sendRequest返回时收到回调,回复内容在reply报文里。

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

参数:

参数名

类型

必填

说明

code

number

本次请求调用的消息码,由通信双方确定。如果接口由IDL工具生成,则消息代码由IDL自动生成。

data

MessageParcel

保存待发送数据的 MessageParcel对象。

reply

MessageParcel

接收应答数据的MessageParcel对象。

options

MessageOption

本次请求的同异步模式,默认同步调用。

AsyncCallback

AsyncCallback<SendRequestResult>

接收发送结果的回调。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. function sendRequestCallback(result) {
  21. if (result.errCode === 0) {
  22. console.log("sendRequest got result");
  23. result.reply.readException();
  24. let msg = result.reply.readString();
  25. console.log("RPCTest: reply msg: " + msg);
  26. } else {
  27. console.log("RPCTest: sendRequest failed, errCode: " + result.errCode);
  28. }
  29. console.log("RPCTest: sendRequest ends, reclaim parcel");
  30. result.data.reclaim();
  31. result.reply.reclaim();
  32. }
  33. let testRemoteObject = new TestRemoteObject("testObject");
  34. let option = new rpc.MessageOption();
  35. let data = rpc.MessageParcel.create();
  36. let reply = rpc.MessageParcel.create();
  37. data.writeInt(1);
  38. data.writeString("hello");
  39. testRemoteObject.sendRequest(1, data, reply, option, sendRequestCallback);

onRemoteRequest8+(deprecated)

从API version 9 开始不再维护,建议使用onRemoteMessageRequest类替代。

onRemoteRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption): boolean

sendMessageRequest请求的响应处理函数,服务端在该函数里处理请求,回复结果。

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

参数:

参数名

类型

必填

说明

code

number

对端发送的服务请求码。

data

MessageParcel

携带客户端调用参数的MessageParcel对象。

reply

MessageParcel

写入结果的MessageParcel对象。

option

MessageOption

指示操作是同步还是异步。

返回值:

类型

说明

boolean

true:操作成功,false:操作失败。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. onRemoteRequest(code, data, reply, option) {
  20. if (code === 1) {
  21. console.log("RpcServer: onRemoteRequest called");
  22. return true;
  23. } else {
  24. console.log("RpcServer: unknown code: " + code);
  25. return false;
  26. }
  27. }
  28. }

onRemoteMessageRequest9+

onRemoteMessageRequest(code: number, data: MessageSequence, reply: MessageSequence, options: MessageOption): boolean | Promise<boolean>

说明
  • 开发者应优先选择重载onRemoteMessageRequest方法,其中可以自由实现同步和异步的消息处理。
  • 开发者同时重载onRemoteRequest和onRemoteMessageRequest方法时,仅onRemoteMessageRequest方法生效。

sendMessageRequest请求的响应处理函数,服务端在该函数里同步或异步地处理请求,回复结果。

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

参数:

参数名

类型

必填

说明

code

number

对端发送的服务请求码。

data

MessageSequence

携带客户端调用参数的MessageSequence对象。

reply

MessageSequence

写入结果的MessageSequence对象。

option

MessageOption

指示操作是同步还是异步。

返回值:

类型

说明

boolean

若在onRemoteMessageRequest中同步地处理请求,则返回一个布尔值:true:操作成功,false:操作失败。

Promise<boolean>

若在onRemoteMessageRequest中异步地处理请求,则返回一个Promise对象。

重载onRemoteMessageRequest方法同步处理请求示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. onRemoteMessageRequest(code, data, reply, option) {
  6. if (code === 1) {
  7. console.log("RpcServer: sync onRemoteMessageRequest is called");
  8. return true;
  9. } else {
  10. console.log("RpcServer: unknown code: " + code);
  11. return false;
  12. }
  13. }
  14. }

重载onRemoteMessageRequest方法异步处理请求示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. async onRemoteMessageRequest(code, data, reply, option) {
  6. if (code === 1) {
  7. console.log("RpcServer: async onRemoteMessageRequest is called");
  8. } else {
  9. console.log("RpcServer: unknown code: " + code);
  10. return false;
  11. }
  12. await new Promise((resolve) => {
  13. setTimeout(resolve, 100);
  14. })
  15. return true;
  16. }
  17. }

同时重载onRemoteMessageRequest和onRemoteRequest方法同步处理请求示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. onRemoteRequest(code, data, reply, option) {
  6. if (code === 1) {
  7. console.log("RpcServer: sync onRemoteMessageRequest is called");
  8. return true;
  9. } else {
  10. console.log("RpcServer: unknown code: " + code);
  11. return false;
  12. }
  13. }
  14. // 同时调用仅会执行onRemoteMessageRequest
  15. onRemoteMessageRequest(code, data, reply, option) {
  16. if (code === 1) {
  17. console.log("RpcServer: async onRemoteMessageRequest is called");
  18. } else {
  19. console.log("RpcServer: unknown code: " + code);
  20. return false;
  21. }
  22. return true;
  23. }
  24. }

同时重载onRemoteMessageRequest和onRemoteRequest方法异步处理请求示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. onRemoteRequest(code, data, reply, option) {
  6. if (code === 1) {
  7. console.log("RpcServer: sync onRemoteRequest is called");
  8. return true;
  9. } else {
  10. console.log("RpcServer: unknown code: " + code);
  11. return false;
  12. }
  13. }
  14. // 同时调用仅会执行onRemoteMessageRequest
  15. async onRemoteMessageRequest(code, data, reply, option) {
  16. if (code === 1) {
  17. console.log("RpcServer: async onRemoteMessageRequest is called");
  18. } else {
  19. console.log("RpcServer: unknown code: " + code);
  20. return false;
  21. }
  22. await new Promise((resolve) => {
  23. setTimeout(resolve, 100);
  24. })
  25. return true;
  26. }
  27. }

getCallingUid

getCallingUid(): number

获取通信对端的进程Uid。

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

返回值:

类型

说明

number

返回通信对端的进程Uid。

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. }
  6. let testRemoteObject = new TestRemoteObject("testObject");
  7. console.log("RpcServer: getCallingUid: " + testRemoteObject.getCallingUid());

getCallingPid

getCallingPid(): number

获取通信对端的进程Pid。

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

返回值:

类型

说明

number

返回通信对端的进程Pid。

示例:

  1. class TestRemoteObject extends rpc.RemoteObject {
  2. constructor(descriptor) {
  3. super(descriptor);
  4. }
  5. }
  6. let testRemoteObject = new TestRemoteObject("testObject");
  7. console.log("RpcServer: getCallingPid: " + testRemoteObject.getCallingPid());

getLocalInterface9+

getLocalInterface(descriptor: string): IRemoteBroker

查询接口描述符的字符串。

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

参数:

参数名

类型

必填

说明

descriptor

string

接口描述符的字符串。

返回值:

类型

说明

IRemoteBroker

返回绑定到指定接口描述符的IRemoteBroker对象。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. registerDeathRecipient(recipient: MyDeathRecipient, flags: number) {
  11. // 方法逻辑需开发者根据业务需要实现
  12. }
  13. unregisterDeathRecipient(recipient: MyDeathRecipient, flags: number) {
  14. // 方法逻辑需开发者根据业务需要实现
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let testRemoteObject = new TestRemoteObject("testObject");
  21. try {
  22. let broker = testRemoteObject.getLocalInterface("testObject");
  23. } catch(error) {
  24. console.info("rpc get local interface fail, errorCode " + error.code);
  25. console.info("rpc get local interface fail, errorMessage " + error.message);
  26. }

queryLocalInterface(deprecated)

从API version 9 开始不再维护,建议使用getLocalInterface类替代。

queryLocalInterface(descriptor: string): IRemoteBroker

查询并获取当前接口描述符对应的远端对象是否已经存在。

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

参数:

参数名

类型

必填

说明

descriptor

string

需要查询的接口描述符。

返回值:

类型

说明

IRemoteBroker

如果接口描述符对应的远端对象存在,则返回该远端对象,否则返回Null。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let testRemoteObject = new TestRemoteObject("testObject");
  21. let broker = testRemoteObject.queryLocalInterface("testObject");

getDescriptor9+

getDescriptor(): string

获取对象的接口描述符。接口描述符为字符串。

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

返回值:

类型

说明

string

返回接口描述符。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900008

proxy or remote object is invalid

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. registerDeathRecipient(recipient: MyDeathRecipient, flags: number) {
  11. // 方法逻辑需开发者根据业务需要实现
  12. }
  13. unregisterDeathRecipient(recipient: MyDeathRecipient, flags: number) {
  14. // 方法逻辑需开发者根据业务需要实现
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let testRemoteObject = new TestRemoteObject("testObject");
  21. console.log("RpcServer: descriptor is: " + descriptor);
  22. try {
  23. let descriptor = testRemoteObject.getDescriptor();
  24. } catch(error) {
  25. console.info("rpc get local interface fail, errorCode " + error.code);
  26. console.info("rpc get local interface fail, errorMessage " + error.message);
  27. }

getInterfaceDescriptor(deprecated)

从API version 9 开始不再维护,建议使用getDescriptor类替代。

getInterfaceDescriptor(): string

查询接口描述符。

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

返回值:

类型

说明

string

返回接口描述符。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. }
  10. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  11. return true;
  12. }
  13. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  14. return true;
  15. }
  16. isObjectDead(): boolean {
  17. return false;
  18. }
  19. }
  20. let testRemoteObject = new TestRemoteObject("testObject");
  21. let descriptor = testRemoteObject.getInterfaceDescriptor();
  22. console.log("RpcServer: descriptor is: " + descriptor);

modifyLocalInterface9+

modifyLocalInterface(localInterface: IRemoteBroker, descriptor: string): void

此接口用于把接口描述符和IRemoteBroker对象绑定。

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

参数:

参数名

类型

必填

说明

localInterface

IRemoteBroker

将与描述符绑定的IRemoteBroker对象。

descriptor

string

用于与IRemoteBroker对象绑定的描述符。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. try {
  10. this.modifyLocalInterface(this, descriptor);
  11. } catch(error) {
  12. console.info(" rpc attach local interface fail, errorCode " + error.code);
  13. console.info(" rpc attach local interface fail, errorMessage " + error.message);
  14. }
  15. }
  16. registerDeathRecipient(recipient: MyDeathRecipient, flags: number) {
  17. // 方法逻辑需开发者根据业务需要实现
  18. }
  19. unregisterDeathRecipient(recipient: MyDeathRecipient, flags: number) {
  20. // 方法逻辑需开发者根据业务需要实现
  21. }
  22. isObjectDead(): boolean {
  23. return false;
  24. }
  25. asObject(): rpc.IRemoteObject {
  26. return this;
  27. }
  28. }
  29. let testRemoteObject = new TestRemoteObject("testObject");

attachLocalInterface(deprecated)

从API version 9 开始不再维护,建议使用modifyLocalInterface类替代。

attachLocalInterface(localInterface: IRemoteBroker, descriptor: string): void

此接口用于把接口描述符和IRemoteBroker对象绑定。

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

参数:

参数名

类型

必填

说明

localInterface

IRemoteBroker

将与描述符绑定的IRemoteBroker对象。

descriptor

string

用于与IRemoteBroker对象绑定的描述符。

示例:

  1. class MyDeathRecipient {
  2. onRemoteDied() {
  3. console.log("server died");
  4. }
  5. }
  6. class TestRemoteObject extends rpc.RemoteObject {
  7. constructor(descriptor) {
  8. super(descriptor);
  9. this.attachLocalInterface(this, descriptor);
  10. }
  11. addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  12. return true;
  13. }
  14. removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
  15. return true;
  16. }
  17. isObjectDead(): boolean {
  18. return false;
  19. }
  20. asObject(): rpc.IRemoteObject {
  21. return this;
  22. }
  23. }
  24. let testRemoteObject = new TestRemoteObject("testObject");

Ashmem8+

提供与匿名共享内存对象相关的方法,包括创建、关闭、映射和取消映射Ashmem、从Ashmem读取数据和写入数据、获取Ashmem大小、设置Ashmem保护。

系统能力:以下各项对应的系统能力均为SystemCapability.Communication.IPC.Core。

映射内存保护类型:

名称

说明

PROT_EXEC

4

映射的内存可执行

PROT_NONE

0

映射的内存不可访问

PROT_READ

1

映射的内存可读

PROT_WRITE

2

映射的内存可写

create9+

static create(name: string, size: number): Ashmem

静态方法,根据指定的名称和大小创建Ashmem对象。

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

参数:

参数名

类型

必填

说明

name

string

名称,用于查询Ashmem信息。

size

number

Ashmem的大小,以字节为单位。

返回值:

类型

说明

Ashmem

返回创建的Ashmem对象;如果创建失败,返回null。

示例:

  1. let ashmem;
  2. try {
  3. ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  4. } catch(error) {
  5. console.info("Rpc creat ashmem fail, errorCode " + error.code);
  6. console.info("Rpc creat ashmem fail, errorMessage " + error.message);
  7. }
  8. let size = ashmem.getAshmemSize();
  9. console.log("RpcTest: get ashemm by create : " + ashmem + " size is : " + size);

createAshmem8+(deprecated)

从API version 9 开始不再维护,建议使用create类替代。

static createAshmem(name: string, size: number): Ashmem

静态方法,根据指定的名称和大小创建Ashmem对象。

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

参数:

参数名

类型

必填

说明

name

string

名称,用于查询Ashmem信息。

size

number

Ashmem的大小,以字节为单位。

返回值:

类型

说明

Ashmem

返回创建的Ashmem对象;如果创建失败,返回null。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let size = ashmem.getAshmemSize();
  3. console.log("RpcTest: get ashemm by createAshmem : " + ashmem + " size is : " + size);

create9+

static create(ashmem: Ashmem): Ashmem

静态方法,通过复制现有Ashmem对象的文件描述符(fd)来创建Ashmem对象。两个Ashmem对象指向同一个共享内存区域。

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

参数:

参数名

类型

必填

说明

ashmem

Ashmem

已存在的Ashmem对象。

返回值:

类型

说明

Ashmem

返回创建的Ashmem对象。

示例:

  1. let ashmem2;
  2. try {
  3. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  4. let ashmem2 = rpc.Ashmem.create(ashmem);
  5. } catch(error) {
  6. console.info("Rpc creat ashmem from existing fail, errorCode " + error.code);
  7. console.info("Rpc creat ashmem from existing fail, errorMessage " + error.message);
  8. }
  9. let size = ashmem2.getAshmemSize();
  10. console.log("RpcTest: get ashemm by create : " + ashmem2 + " size is : " + size);

createAshmemFromExisting8+(deprecated)

从API version 9 开始不再维护,建议使用create类替代。

static createAshmemFromExisting(ashmem: Ashmem): Ashmem

静态方法,通过复制现有Ashmem对象的文件描述符(fd)来创建Ashmem对象。两个Ashmem对象指向同一个共享内存区域。

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

参数:

参数名

类型

必填

说明

ashmem

Ashmem

已存在的Ashmem对象。

返回值:

类型

说明

Ashmem

返回创建的Ashmem对象。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let ashmem2 = rpc.Ashmem.createAshmemFromExisting(ashmem);
  3. let size = ashmem2.getAshmemSize();
  4. console.log("RpcTest: get ashemm by createAshmemFromExisting : " + ashmem2 + " size is : " + size);

closeAshmem8+

closeAshmem(): void

关闭这个Ashmem。

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

示例:

  1. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  2. ashmem.closeAshmem();

unmapAshmem8+

unmapAshmem(): void

删除该Ashmem对象的地址映射。

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

示例:

  1. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  2. ashmem.unmapAshmem();

getAshmemSize8+

getAshmemSize(): number

获取Ashmem对象的内存大小。

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

返回值:

类型

说明

number

返回Ashmem对象的内存大小。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let size = ashmem.getAshmemSize();
  3. console.log("RpcTest: get ashmem is " + ashmem + " size is : " + size);

mapTypedAshmem9+

mapTypedAshmem(mapType: number): void

在此进程的虚拟地址空间上创建共享文件映射,映射区域大小由此Ashmem对象指定。

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

参数:

参数名

类型

必填

说明

mapType

number

指定映射的内存区域的保护等级。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900001

call mmap function failed

示例:

  1. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  2. try {
  3. ashmem.mapTypedAshmem(ashmem.PROT_READ | ashmem.PROT_WRITE);
  4. } catch(error) {
  5. console.info("Rpc map ashmem fail, errorCode " + error.code);
  6. console.info("Rpc map ashmem fail, errorMessage " + error.message);
  7. }

mapAshmem8+(deprecated)

从API version 9 开始不再维护,建议使用mapTypedAshmem类替代。

mapAshmem(mapType: number): boolean

在此进程的虚拟地址空间上创建共享文件映射,映射区域大小由此Ashmem对象指定。

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

参数:

参数名

类型

必填

说明

mapType

number

指定映射的内存区域的保护等级。

返回值:

类型

说明

boolean

true:映射成功,false:映射失败。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let mapReadAndWrite = ashmem.mapAshmem(ashmem.PROT_READ | ashmem.PROT_WRITE);
  3. console.log("RpcTest: map ashmem result is : " + mapReadAndWrite);

mapReadWriteAshmem9+

mapReadWriteAshmem(): void

在此进程虚拟地址空间上创建可读写的共享文件映射。

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

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900001

call mmap function failed

示例:

  1. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  2. try {
  3. ashmem.mapReadWriteAshmem();
  4. } catch(error) {
  5. console.info("Rpc map read and write ashmem fail, errorCode " + error.code);
  6. console.info("Rpc map read and write ashmem fail, errorMessage " + error.message);
  7. }

mapReadAndWriteAshmem8+(deprecated)

从API version 9 开始不再维护,建议使用mapReadWriteAshmem类替代。

mapReadAndWriteAshmem(): boolean

在此进程虚拟地址空间上创建可读写的共享文件映射。

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

返回值:

类型

说明

boolean

true:映射成功,false:映射失败。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let mapResult = ashmem.mapReadAndWriteAshmem();
  3. console.log("RpcTest: map ashmem result is : " + mapResult);

mapReadonlyAshmem9+

mapReadonlyAshmem(): void

在此进程虚拟地址空间上创建只读的共享文件映射。

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

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900001

call mmap function failed

示例:

  1. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  2. try {
  3. ashmem.mapReadonlyAshmem();
  4. } catch(error) {
  5. console.info("Rpc map read and write ashmem fail, errorCode " + error.code);
  6. console.info("Rpc map read and write ashmem fail, errorMessage " + error.message);
  7. }

mapReadOnlyAshmem8+(deprecated)

从API version 9 开始不再维护,建议使用mapReadonlyAshmem类替代。

mapReadOnlyAshmem(): boolean

在此进程虚拟地址空间上创建只读的共享文件映射。

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

返回值:

类型

说明

boolean

true:映射成功,false:映射失败。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let mapResult = ashmem.mapReadOnlyAshmem();
  3. console.log("RpcTest: Ashmem mapReadOnlyAshmem result is : " + mapResult);

setProtectionType9+

setProtectionType(protectionType: number): void

设置映射内存区域的保护等级。

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

参数:

参数名

类型

必填

说明

protectionType

number

要设置的保护类型。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900002

call os ioctl function failed

示例:

  1. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  2. try {
  3. ashmem.setProtection(ashmem.PROT_READ);
  4. } catch(error) {
  5. console.info("Rpc set protection type fail, errorCode " + error.code);
  6. console.info("Rpc set protection type fail, errorMessage " + error.message);
  7. }

setProtection8+(deprecated)

从API version 9 开始不再维护,建议使用setProtectionType类替代。

setProtection(protectionType: number): boolean

设置映射内存区域的保护等级。

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

参数:

参数名

类型

必填

说明

protectionType

number

要设置的保护类型。

返回值:

类型

说明

boolean

true:设置成功,false:设置失败。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let result = ashmem.setProtection(ashmem.PROT_READ);
  3. console.log("RpcTest: Ashmem setProtection result is : " + result);

writeAshmem9+

writeAshmem(buf: number[], size: number, offset: number): void

将数据写入此Ashmem对象关联的共享文件。

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

参数:

参数名

类型

必填

说明

buf

number[]

写入Ashmem对象的数据。

size

number

要写入的数据大小。

offset

number

要写入的数据在此Ashmem对象关联的内存区间的起始位置

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900003

write to ashmem failed

示例:

  1. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  2. ashmem.mapReadWriteAshmem();
  3. var ByteArrayVar = [1, 2, 3, 4, 5];
  4. try {
  5. ashmem.writeAshmem(ByteArrayVar, 5, 0);
  6. } catch(error) {
  7. console.info("Rpc write to ashmem fail, errorCode " + error.code);
  8. console.info("Rpc write to ashmem fail, errorMessage " + error.message);
  9. }

writeToAshmem8+(deprecated)

从API version 9 开始不再维护,建议使用writeAshmem类替代。

writeToAshmem(buf: number[], size: number, offset: number): boolean

将数据写入此Ashmem对象关联的共享文件。

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

参数:

参数名

类型

必填

说明

buf

number[]

写入Ashmem对象的数据。

size

number

要写入的数据大小。

offset

number

要写入的数据在此Ashmem对象关联的内存区间的起始位置

返回值:

类型

说明

boolean

true:如果数据写入成功,false:在其他情况下,如数据写入越界或未获得写入权限。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let mapResult = ashmem.mapReadAndWriteAshmem();
  3. console.info("RpcTest map ashmem result is " + mapResult);
  4. var ByteArrayVar = [1, 2, 3, 4, 5];
  5. let writeResult = ashmem.writeToAshmem(ByteArrayVar, 5, 0);
  6. console.log("RpcTest: write to Ashmem result is : " + writeResult);

readAshmem9+

readAshmem(size: number, offset: number): number[]

从此Ashmem对象关联的共享文件中读取数据。

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

参数:

参数名

类型

必填

说明

size

number

要读取的数据的大小。

offset

number

要读取的数据在此Ashmem对象关联的内存区间的起始位置

返回值:

类型

说明

number[]

返回读取的数据。

错误码:

以下错误码的详细介绍请参见ohos.rpc错误码

错误码ID

错误信息

1900004

read from ashmem failed

示例:

  1. let ashmem = rpc.Ashmem.create("ashmem", 1024*1024);
  2. ashmem.mapReadWriteAshmem();
  3. var ByteArrayVar = [1, 2, 3, 4, 5];
  4. ashmem.writeAshmem(ByteArrayVar, 5, 0);
  5. try {
  6. let readResult = ashmem.readAshmem(5, 0);
  7. console.log("RpcTest: read from Ashmem result is : " + readResult);
  8. } catch(error) {
  9. console.info("Rpc read from ashmem fail, errorCode " + error.code);
  10. console.info("Rpc read from ashmem fail, errorMessage " + error.message);
  11. }

readFromAshmem8+(deprecated)

从API version 9 开始不再维护,建议使用readAshmem类替代。

readFromAshmem(size: number, offset: number): number[]

从此Ashmem对象关联的共享文件中读取数据。

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

参数:

参数名

类型

必填

说明

size

number

要读取的数据的大小。

offset

number

要读取的数据在此Ashmem对象关联的内存区间的起始位置

返回值:

类型

说明

number[]

返回读取的数据。

示例:

  1. let ashmem = rpc.Ashmem.createAshmem("ashmem", 1024*1024);
  2. let mapResult = ashmem.mapReadAndWriteAshmem();
  3. console.info("RpcTest map ashmem result is " + mapResult);
  4. var ByteArrayVar = [1, 2, 3, 4, 5];
  5. let writeResult = ashmem.writeToAshmem(ByteArrayVar, 5, 0);
  6. console.log("RpcTest: write to Ashmem result is : " + writeResult);
  7. let readResult = ashmem.readFromAshmem(5, 0);
  8. console.log("RpcTest: read to Ashmem result is : " + readResult);
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号