同步操作将从 OpenHarmony-TPC/protobuf 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
# protobuf
ProtoBuf(protocol buffers) 是一种语言无关、平台无关、可扩展的序列化结构数据的方法,它可用于(数据)通信协议、数据存储等。,是一种灵活,高效,自动化机制的结构数据序列化方法比XML更小,更快,更为简单。
本项目主要是OpenHarmony系统下以protobuf.js 7.2.4为主要依赖开发,主要接口针对OpenHarmony系统进行合理的适配研发。
1.安装
ohpm install @ohos/protobufjs
OpenHarmony ohpm环境配置等更多内容,请参考 如何安装OpenHarmony ohpm包 。
2.proto文件
按照.proto文件格式定义消息体结构,如:userproto.proto文件。
syntax = "proto3";
package user;
message UserLoginResponse{
string sessionId = 1;
string userPrivilege = 2;
bool isTokenType = 3;
int64 formatTimestamp = 5;
bytes data =6;
}
3.生成js和.d.ts文件
全局安装protobufjs
npm install -g protobufjs@7.2.4
全局安装protobufjs-cli
npm install -g protobufjs-cli
在.proto文件目录下执行下列命令
pbjs -t static-module -w es6 -o user.js user.proto
pbts user.js -o user.d.ts
4.修改生成的文件
1.将生成的js文件中的 import * as $protobuf from "protobufjs/minimal";
修改为 import * as $protobuf from "@ohos/protobufjs";
2.将生成的.d.ts文件中的 import * as $protobuf from "protobufjs";
修改为 import * as $protobuf from "@ohos/protobufjs";
3.在生成的js文件中 import * as $protobuf from "@ohos/protobufjs";这行代码下方添加如下代码
import Long from 'long';
$protobuf.util.Long=Long
$protobuf.configure()
5.在entry目录下安装long
ohpm install long
6.将生成js和.d.ts文件复制到工程中
1.proto编码
import { user } from './user.js'
let msg = user.UserLoginResponse.create({
sessionId: "testSynchronouslyLoadProtoFile",
userPrivilege: "John123",
isTokenType: false,
formatTimestamp: "12342222"
});
let arrayBuffer: Uint8Array = user.UserLoginResponse.encode(msg).finish()
2.proto编码
let decodeMsg = user.UserLoginResponse.decode(arrayBuffer);
create
create(properties?: { [k: string]: any }): Message<{}>
生成Message对象
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
properties | Object | 否 | 要设置的属性。 |
返回值:
类型 | 说明 |
---|---|
Message | Message实例。 |
encode
encode(message: (Message<{}>|{ [k: string]: any }), writer?: Writer): Writer
编码消息
参数
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
message | Message<{}> | Object | 是 | Message示例或者普通对象。 |
writer | Writer | 否 | 编码的写入器。 |
返回值:
类型 | 说明 |
---|---|
Writer | 协议消息体构建器。 |
decode
decode(reader: (Reader|Uint8Array), length?: number): Message<{}>
解码消息
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
reader | Reader | Uint8Array | 是 | 解码的读取器或缓冲区。 |
length | number | 否 | 长度。 |
返回值:
类型 | 说明 |
---|---|
Message<{}> | 解码的消息。 |
verify
static verify(message: { [k: string]: any }): (string|null)
验证消息有效性
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
message | 普通对象 | 是 | 普通对象。 |
返回值:
类型 | 说明 |
---|---|
string | null | 合法返回null,否则返回具体原因。 |
fromObject
static fromObject(object: { [k: string]: any }): Message<{}>
从纯对象创建此类型的新消息。还将值转换为各自的内部类型
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
object | Object | 是 | 普通对象 |
返回值:
类型 | 说明 |
---|---|
object | 普通对象。 |
toObject
static toObject(message: Message<{}>, options?: IConversionOptions): { [k: string]: any }
将一个由键及其各自的值组成的数组转换为对象,省略未定义的值
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
message | Message | 是 | Message 休想。 |
options | IConversionOptions | 否 | 转换选项。 |
返回值:
类型 | 说明 |
---|---|
object | 普通对象。 |
在下述版本验证通过:
|---- protobuf
| |---- AppScrope # 示例代码文件夹
| |---- entry # 示例代码文件夹
| |---- library # 核心库
| |---- src/main # 模块代码
| |---- ets/ # 模块代码
| |---- dist # 打包文件
| |---- index.ets # 入口文件
| |---- .ohpmignore # ohpm发布的忽略文件
| |---- *.json5 # 配置文件
| |---- README.md # 安装使用方法
| |---- README.OpenSource # 开源说明
| |---- CHANGELOG.md # 更新日志
使用过程中发现任何问题都可以提 Issue 给我们,当然,我们也非常欢迎你给我们发 PR 。
本项目基于 BSD License ,请自由地享受和参与开源。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。