Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“da3174634e1c928d48aaf48448ed8a70f17d2cf7”上不存在“python/paddle/git@gitcode.net:s920243400/PaddleDetection.git”
未验证 提交 32c56a8b 编写于 作者: 马 马根堂 提交者： Gitee
浏览文件
操作

update zh-cn/application-dev/reference/apis/js-apis-rpc.md. 

Signed-off-by: N18392170496 <magentang3@huawei.com>
上级 fc39f1cd
显示空白变更内容
内联 并排
Showing with 177 addition and 13 deletion
zh-cn/application-dev/reference/apis/js-apis-rpc.md
浏览文件 @ 32c56a8b
...@@ -1349,7 +1349,7 @@ readFloatArray(dataIn: number[]) : void ...@@ -1349,7 +1349,7 @@ readFloatArray(dataIn: number[]) : void
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| dataIn | number[] | 是 | 要读取的浮点数组。 | | dataIn | number[] | 是 | 要读取的浮点数组。由于系统内部对float类型的数据是按照double处理的，使用时对于数组所占的总字节数应按照double类型来计算。 |
**示例：** **示例：**
...@@ -1398,7 +1398,7 @@ writeDoubleArray(doubleArray: number[]): boolean ...@@ -1398,7 +1398,7 @@ writeDoubleArray(doubleArray: number[]): boolean
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| doubleArray | number[] | 是 | 要写入的双精度浮点数组。由于系统内部对float类型的数据是按照double处理的，使用时对于数组所占的总字节数应按照double类型来计算。 | | doubleArray | number[] | 是 | 要写入的双精度浮点数组。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1764,20 +1764,20 @@ readException(): void ...@@ -1764,20 +1764,20 @@ readException(): void
let reply = rpc.MessageParcel.create(); let reply = rpc.MessageParcel.create();
data.writeInt(1); data.writeInt(1);
data.writeString("hello"); data.writeString("hello");
proxy.sendRequest(1, data, reply, option) proxy.sendRequestAsync(1, data, reply, option)
.then(function(errCode) { .then(function(errCode) {
if (errCode === 0) { if (errCode === 0) {
console.log("sendRequest got result"); console.log("sendRequestAsync got result");
reply.readException(); reply.readException();
let msg = reply.readString(); let msg = reply.readString();
console.log("RPCTest: reply msg: " + msg); console.log("RPCTest: reply msg: " + msg);
} else { } else {
console.log("RPCTest: sendRequest failed, errCode: " + errCode); console.log("RPCTest: sendRequestAsync failed, errCode: " + errCode);
} }
}).catch(function(e) { }).catch(function(e) {
console.log("RPCTest: sendRequest got exception: " + e.message); console.log("RPCTest: sendRequestAsync got exception: " + e.message);
}).finally (() => { }).finally (() => {
console.log("RPCTest: sendRequest ends, reclaim parcel"); console.log("RPCTest: sendRequestAsync ends, reclaim parcel");
data.reclaim(); data.reclaim();
reply.reclaim(); reply.reclaim();
}); });
...@@ -2504,7 +2504,7 @@ queryLocalInterface(descriptor: string): IRemoteBroker ...@@ -2504,7 +2504,7 @@ queryLocalInterface(descriptor: string): IRemoteBroker
### sendRequest<sup>(deprecated)</sup> ### sendRequest<sup>(deprecated)</sup>
> **说明：** > **说明：**
> 从 API Version 8 开始废弃，建议使用[sendRequest<sup>8+</sup>](#sendrequest8)替代。 > 从 API Version 8 开始废弃，建议使用[sendRequestAsync<sup>9+</sup>](#sendRequestAsync9)替代。
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean
...@@ -2528,6 +2528,9 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options ...@@ -2528,6 +2528,9 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options
### sendRequest<sup>8+</sup> ### sendRequest<sup>8+</sup>
> **说明：**
> 从 API Version 9 开始废弃，建议使用[sendRequestAsync<sup>9+</sup>](#sendRequestAsync9)替代。
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt; sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequest返回时兑现，回复内容在reply报文里。 以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequest返回时兑现，回复内容在reply报文里。
...@@ -2549,6 +2552,27 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options ...@@ -2549,6 +2552,27 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options
### sendRequest<sup>8+</sup> ### sendRequest<sup>8+</sup>
### sendRequestAsync<sup>9+</sup>
sendRequestAsync(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequestAsync返回时兑现，回复内容在reply报文里。
**系统能力**：SystemCapability.Communication.IPC.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| code | number | 是 | 本次请求调用的消息码，由通信双方确定。如果接口由IDL工具生成，则消息代码由IDL自动生成。 |
| data | [MessageParcel](#messageparcel) | 是 | 保存待发送数据的&nbsp;MessageParcel对象。 |
| reply | [MessageParcel](#messageparcel) | 是 | 接收应答数据的MessageParcel对象。 |
| options | [MessageOption](#messageoption) | 是 | 本次请求的同异步模式，默认同步调用。 |
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;SendRequestResult&gt; | 返回一个期约，兑现值是sendRequestResult实例。|
sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback&lt;SendRequestResult&gt;): void sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback&lt;SendRequestResult&gt;): void
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则立即收到回调，reply报文里没有内容。如果为选项设置了同步模式，则将在sendRequest返回时收到回调，回复内容在reply报文里。 以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则立即收到回调，reply报文里没有内容。如果为选项设置了同步模式，则将在sendRequest返回时收到回调，回复内容在reply报文里。
...@@ -2653,7 +2677,7 @@ isObjectDead(): boolean ...@@ -2653,7 +2677,7 @@ isObjectDead(): boolean
### sendRequest<sup>(deprecated)</sup> ### sendRequest<sup>(deprecated)</sup>
> **说明：** > **说明：**
> 从 API Version 8 开始废弃，建议使用[sendRequest<sup>8+</sup>](#sendrequest8-2)替代。 > 从 API Version 8 开始废弃，建议使用[sendRequestAsync<sup>9+</sup>](#sendRequestAsync9)替代。
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean
...@@ -2717,6 +2741,9 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options ...@@ -2717,6 +2741,9 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options
### sendRequest<sup>8+</sup> ### sendRequest<sup>8+</sup>
> **说明：**
> 从 API Version 9 开始废弃，建议使用[sendRequestAsync<sup>9+</sup>](#sendRequestAsync9)替代。
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt; sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequest返回时兑现，回复内容在reply报文里。 以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequest返回时兑现，回复内容在reply报文里。
...@@ -2782,9 +2809,75 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options ...@@ -2782,9 +2809,75 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options
}); });
``` ```
### sendRequest<sup>8+</sup> ### sendRequest<sup>8+</sup>
### sendRequestAsync<sup>9+</sup>
sendRequestAsync(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequestAsync返回时兑现，回复内容在reply报文里。
**系统能力**：SystemCapability.Communication.IPC.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| code | number | 是 | 本次请求调用的消息码，由通信双方确定。如果接口由IDL工具生成，则消息代码由IDL自动生成。 |
| data | [MessageParcel](#messageparcel) | 是 | 保存待发送数据的&nbsp;MessageParcel对象。 |
| reply | [MessageParcel](#messageparcel) | 是 | 接收应答数据的MessageParcel对象。 |
| options | [MessageOption](#messageoption) | 是 | 本次请求的同异步模式，默认同步调用。 |
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;SendRequestResult&gt; | 返回一个期约，兑现值是sendRequestResult实例。|
**示例：**
```
import FA from "@ohos.ability.featureAbility";
let proxy;
let connect = {
onConnect: function(elementName, remoteProxy) {
console.log("RpcClient: js onConnect called.");
proxy = remoteProxy;
},
onDisconnect: function(elementName) {
console.log("RpcClient: onDisconnect");
},
onFailed: function() {
console.log("RpcClient: onFailed");
}
};
let want = {
"bundleName": "com.ohos.server",
"abilityName": "com.ohos.server.MainAbility",
};
FA.connectAbility(want, connect);
let option = new rpc.MessageOption();
let data = rpc.MessageParcel.create();
let reply = rpc.MessageParcel.create();
data.writeInt(1);
data.writeString("hello");
proxy.sendRequestAsync(1, data, reply, option)
.then(function(result) {
if (result.errCode === 0) {
console.log("sendRequestAsync got result");
result.reply.readException();
let msg = result.reply.readString();
console.log("RPCTest: reply msg: " + msg);
} else {
console.log("RPCTest: sendRequestAsync failed, errCode: " + result.errCode);
}
}).catch(function(e) {
console.log("RPCTest: sendRequestAsync got exception: " + e.message);
}).finally (() => {
console.log("RPCTest: sendRequestAsync ends, reclaim parcel");
data.reclaim();
reply.reclaim();
});
```
sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback&lt;SendRequestResult&gt;): void sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback&lt;SendRequestResult&gt;): void
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则立即收到回调，reply报文里没有内容。如果为选项设置了同步模式，则将在sendRequest返回时收到回调，回复内容在reply报文里。 以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则立即收到回调，reply报文里没有内容。如果为选项设置了同步模式，则将在sendRequest返回时收到回调，回复内容在reply报文里。
...@@ -3082,7 +3175,7 @@ isObjectDead(): boolean ...@@ -3082,7 +3175,7 @@ isObjectDead(): boolean
| -------- | -------- | -------- | | -------- | -------- | -------- |
| TF_SYNC | 0 | 同步调用。 | | TF_SYNC | 0 | 同步调用。 |
| TF_ASYNC | 1 | 异步调用。 | | TF_ASYNC | 1 | 异步调用。 |
| TF_ACCEPT_FDS | 0x10 | 指示[sendRequest](#sendrequest8)接口可以返回文件描述符。 | | TF_ACCEPT_FDS | 0x10 | 指示[sendRequestAsync](#sendrequestAsync9)接口可以返回文件描述符。 |
| TF_WAIT_TIME | 8 | 等待时间。单位秒。 | | TF_WAIT_TIME | 8 | 等待时间。单位秒。 |
...@@ -3471,7 +3564,7 @@ RemoteObject构造函数。 ...@@ -3471,7 +3564,7 @@ RemoteObject构造函数。
### sendRequest<sup>(deprecated)</sup> ### sendRequest<sup>(deprecated)</sup>
> **说明：** > **说明：**
> 从 API Version 8 开始废弃，建议使用[sendRequest<sup>8+</sup>](#sendrequest8-4)替代。 > 从 API Version 8 开始废弃，建议使用[sendRequestAsync<sup>9+</sup>](#sendRequestAsync9)替代。
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): boolean
...@@ -3537,6 +3630,9 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options ...@@ -3537,6 +3630,9 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options
### sendRequest<sup>8+</sup> ### sendRequest<sup>8+</sup>
> **说明：**
> 从 API Version 9 开始废弃，建议使用[sendRequestAsync<sup>9+</sup>](#sendRequestAsync9)替代。
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt; sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequest返回时兑现，回复内容在reply报文里。 以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequest返回时兑现，回复内容在reply报文里。
...@@ -3607,6 +3703,74 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options ...@@ -3607,6 +3703,74 @@ sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options
### sendRequest<sup>8+</sup> ### sendRequest<sup>8+</sup>
### sendRequestAsync<sup>9+</sup>
sendRequestAsync(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise&lt;SendRequestResult&gt;
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则期约立即兑现，reply报文里没有内容。如果为选项设置了同步模式，则期约将在sendRequestAsync返回时兑现，回复内容在reply报文里。
**系统能力**：SystemCapability.Communication.IPC.Core
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| code | number | 是 | 本次请求调用的消息码，由通信双方确定。如果接口由IDL工具生成，则消息代码由IDL自动生成。 |
| data | [MessageParcel](#messageparcel) | 是 | 保存待发送数据的&nbsp;MessageParcel对象。 |
| reply | [MessageParcel](#messageparcel) | 是 | 接收应答数据的MessageParcel对象。 |
| options | [MessageOption](#messageoption) | 是 | 本次请求的同异步模式，默认同步调用。 |
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;SendRequestResult&gt; | 返回一个期约，兑现值是sendRequestResult实例。|
**示例：**
```
class MyDeathRecipient {
onRemoteDied() {
console.log("server died");
}
}
class TestRemoteObject extends rpc.RemoteObject {
constructor(descriptor) {
super(descriptor);
}
addDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
return true;
}
removeDeathRecipient(recipient: MyDeathRecipient, flags: number): boolean {
return true;
}
isObjectDead(): boolean {
return false;
}
}
let testRemoteObject = new TestRemoteObject("testObject");
let option = new rpc.MessageOption();
let data = rpc.MessageParcel.create();
let reply = rpc.MessageParcel.create();
data.writeInt(1);
data.writeString("hello");
testRemoteObject.sendRequestAsync(1, data, reply, option)
.then(function(result) {
if (result.errCode === 0) {
console.log("sendRequestAsync got result");
result.reply.readException();
let msg = result.reply.readString();
console.log("RPCTest: reply msg: " + msg);
} else {
console.log("RPCTest: sendRequestAsync failed, errCode: " + result.errCode);
}
}).catch(function(e) {
console.log("RPCTest: sendRequestAsync got exception: " + e.message);
}).finally (() => {
console.log("RPCTest: sendRequestAsync ends, reclaim parcel");
data.reclaim();
reply.reclaim();
});
```
sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback&lt;SendRequestResult&gt;): void sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: MessageOption, callback: AsyncCallback&lt;SendRequestResult&gt;): void
以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则立即收到回调，reply报文里没有内容。如果为选项设置了同步模式，则将在sendRequest返回时收到回调，回复内容在reply报文里。 以同步或异步方式向对端进程发送MessageParcel消息。如果为选项设置了异步模式，则立即收到回调，reply报文里没有内容。如果为选项设置了同步模式，则将在sendRequest返回时收到回调，回复内容在reply报文里。
...@@ -3672,7 +3836,7 @@ sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: Me ...@@ -3672,7 +3836,7 @@ sendRequest(code: number, data: MessageParcel, reply: MessageParcel, options: Me
onRemoteRequest(code : number, data : MessageParcel, reply: MessageParcel, options : MessageOption): boolean onRemoteRequest(code : number, data : MessageParcel, reply: MessageParcel, options : MessageOption): boolean
sendRequest请求的响应处理函数，服务端在该函数里处理请求，回复结果。 sendRequestAsync请求的响应处理函数，服务端在该函数里处理请求，回复结果。
**系统能力**：SystemCapability.Communication.IPC.Core **系统能力**：SystemCapability.Communication.IPC.Core
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或