Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
671f67d6
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
671f67d6
编写于
3月 18, 2022
作者:
Y
yangguangzhao
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
js-apis-rpc.md fixed
Signed-off-by:
N
yangguangzhao
<
yangguangzhao1@huawei.com
>
上级
233a5f18
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
58 addition
and
128 deletion
+58
-128
zh-cn/application-dev/reference/apis/js-apis-rpc.md
zh-cn/application-dev/reference/apis/js-apis-rpc.md
+58
-128
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-rpc.md
浏览文件 @
671f67d6
...
...
@@ -1532,7 +1532,7 @@ writeCharArray(charArray: number[]): boolean
### readCharArray
readCharArray(dataIn:
boolean
[]) : void
readCharArray(dataIn:
number
[]) : void
从MessageParcel实例中读取单个字符数组。
...
...
@@ -1541,7 +1541,7 @@ readCharArray(dataIn: boolean[]) : void
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| dataIn |
boolean
[] | 是 | 要读取的单个字符数组。 |
| dataIn |
number
[] | 是 | 要读取的单个字符数组。 |
-
示例
...
...
@@ -1556,7 +1556,7 @@ readCharArray(dataIn: boolean[]) : void
### readCharArray
readCharArray():
boolean
[]
readCharArray():
number
[]
从MessageParcel实例读取单个字符数组。
...
...
@@ -1565,7 +1565,7 @@ readCharArray(): boolean[]
-
返回值
| 类型 | 说明 |
| -------- | -------- |
|
boolean
[] | 返回单个字符数组。 |
|
number
[] | 返回单个字符数组。 |
-
示例
...
...
@@ -2191,69 +2191,6 @@ readRawData(size: number): number[]
console.log("RpcTest: parcel read raw data result is : " + result);
```
### getDataVersion<sup>8+</sup>
getDataVersion(): number
从MessageParcel对象返回数据格式版本。
**系统能力**
:SystemCapability.Communication.IPC.Core
-
返回值
| 类型 | 说明 |
| -------- | -------- |
| number | 从MessageParcel返回数据格式版本。 |
-
示例
```
let parcel = new rpc.MessageParcel();
let version = parcel.getDataVersion();
console.log("RpcTest: parcel get data version is : " + version);
```
### updateDataVersion<sup>8+</sup>
updateDataVersion(proxy: IRemoteObject): void
将远程对象数据格式版本更新到MessageParcel对象。
**系统能力**
:SystemCapability.Communication.IPC.Core
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| proxy | IRemoteObject | 是 | 使用该MessageParcel对象发送请求的远程对象。 |
-
示例
```
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.huawei.server",
"abilityName": "com.huawei.server.MainAbility",
};
FA.connectAbility(want, connect);
let parcel = new rpc.MessageParcel();
parcel.updateDataVersion(proxy);
```
## Sequenceable
在进程间通信(IPC)期间,将类的对象写入MessageParcel并从MessageParcel中恢复它们。
...
...
@@ -2459,7 +2396,7 @@ queryLocalInterface(descriptor: string): IRemoteBroker
### sendRequest
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption):
Promise
<
number
>
;
<sup>
7
</sup>
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption):
boolean
;
<sup>
7
</sup>
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise
<
SendRequestResult
>
<sup>
8+
</sup>
...
...
@@ -2571,10 +2508,22 @@ isObjectDead(): boolean
实现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
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption):
Promise
<
number
>
;
<sup>
7
</sup>
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption):
boolean
;
<sup>
7
</sup>
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise
<
SendRequestResult
>
<sup>
8+
</sup>
...
...
@@ -2977,51 +2926,6 @@ isObjectDead(): boolean
```
### setDataVersion<sup>8+</sup>
setDataVersion(dataVersion: number): boolean
将数据格式版本设置到RemoteProxy对象。
**系统能力**
:SystemCapability.Communication.IPC.Core
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| dataVersion | number | 是 | 数据格式版本。 |
-
返回值
| 类型 | 说明 |
| -------- | -------- |
| boolean | 如果设置数据格式版本成功,则返回true;否则返回false。 |
-
示例
```
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.huawei.server",
"abilityName": "com.huawei.server.MainAbility",
};
FA.connectAbility(want, connect);
let result = proxy.setDataVersion(1);
console.log("RpcClient: set Data Version is " + result);
```
## MessageOption
公共消息选项(int标志,int等待时间),使用标志中指定的标志构造指定的MessageOption对象。
...
...
@@ -3184,6 +3088,32 @@ static getCallingUid(): number
}
```
### getCallingTokenId
static getCallingTokenId(): number;
获取调用者的TokenId,用于被调用方对调用方的身份校验。
**系统能力**
:SystemCapability.Communication.IPC.Core
*
返回值
| 类型 | 说明 |
| ------ | --------------------- |
| number | 返回调用者的TokenId。 |
*
示例
```
class Stub extends rpc.RemoteObject {
onRemoteRequest(code, data, reply, option) {
let callerTokenId = rpc.IPCSkeleton.getCallingTokenId();
console.log("RpcServer: getCallingTokenId result: " + callerTokenId);
return true;
}
}
```
### getCalligDeviceID
...
...
@@ -3375,7 +3305,7 @@ RemoteObject构造函数。
### sendRequest
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption):
Promise
<
number
>
;
<sup>
7
</sup>
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption):
boolean
;
<sup>
7
</sup>
sendRequest(code : number, data : MessageParcel, reply : MessageParcel, options : MessageOption): Promise
<
SendRequestResult
>
<sup>
8+
</sup>
...
...
@@ -3612,7 +3542,7 @@ getCallingPid(): number
### queryLocalInterface
queryLocalInterface(descriptor:
descriptor
): IRemoteBroker
queryLocalInterface(descriptor:
string
): IRemoteBroker
查询并获取当前接口描述符对应的远端对象是否已经存在。
...
...
@@ -3621,7 +3551,7 @@ queryLocalInterface(descriptor: descriptor): IRemoteBroker
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| descriptor |
descriptor
| 是 | 需要查询的接口描述符。 |
| descriptor |
string
| 是 | 需要查询的接口描述符。 |
-
返回值
| 类型 | 说明 |
...
...
@@ -3714,7 +3644,7 @@ attachLocalInterface(localInterface: IRemoteBroker, descriptor: string): void
| PROT_WRITE | 2 | 映射的内存可写 |
### createAshmem
### createAshmem
<sup>8+</sup>
static createAshmem(name: string, size: number): Ashmem
...
...
@@ -3743,7 +3673,7 @@ static createAshmem(name: string, size: number): Ashmem
```
### createAshmemFromExisting
### createAshmemFromExisting
<sup>8+</sup>
static createAshmemFromExisting(ashmem: Ashmem): Ashmem
...
...
@@ -3772,7 +3702,7 @@ static createAshmemFromExisting(ashmem: Ashmem): Ashmem
```
### closeAshmem
### closeAshmem
<sup>8+</sup>
closeAshmem(): void
...
...
@@ -3788,7 +3718,7 @@ closeAshmem(): void
```
### unmapAshmem
### unmapAshmem
<sup>8+</sup>
unmapAshmem(): void
...
...
@@ -3804,7 +3734,7 @@ unmapAshmem(): void
```
### getAshmemSize
### getAshmemSize
<sup>8+</sup>
getAshmemSize(): number
...
...
@@ -3826,7 +3756,7 @@ getAshmemSize(): number
```
### mapAshmem
### mapAshmem
<sup>8+</sup>
mapAshmem(mapType: number): boolean
...
...
@@ -3853,7 +3783,7 @@ mapAshmem(mapType: number): boolean
```
### mapReadAndWriteAshmem
### mapReadAndWriteAshmem
<sup>8+</sup>
mapReadAndWriteAshmem(): boolean
...
...
@@ -3875,7 +3805,7 @@ mapReadAndWriteAshmem(): boolean
```
### mapReadOnlyAshmem
### mapReadOnlyAshmem
<sup>8+</sup>
mapReadOnlyAshmem(): boolean
...
...
@@ -3897,7 +3827,7 @@ mapReadOnlyAshmem(): boolean
```
### setProtection
### setProtection
<sup>8+</sup>
setProtection(protectionType: number): boolean
...
...
@@ -3924,7 +3854,7 @@ setProtection(protectionType: number): boolean
```
### writeToAshmem
### writeToAshmem
<sup>8+</sup>
writeToAshmem(buf: number[], size: number, offset: number): boolean
...
...
@@ -3954,7 +3884,7 @@ writeToAshmem(buf: number[], size: number, offset: number): boolean
```
### readFromAshmem
### readFromAshmem
<sup>8+</sup>
readFromAshmem(size: number, offset: number): number[]
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录