OpenHarmony三方组件：thrift

Handpc

发布于 2023-3-16 18:31

浏览

0收藏

简介

Thrift是一个轻量级的、独立于语言的软件栈，用于点到点RPC实现。Thrift为数据传输、数据序列化和应用程序级处理提供了清晰的抽象和实现。代码生成系统使用一种简单的定义语言作为输入并生成跨编程语言的代码，这些代码使用抽象堆栈来构建可互操作的RPC客户端和服务器。

下载安装

npm install @ohos/thrift --save

OpenHarmony npm环境配置等更多内容，请参考如何安装OpenHarmony npm包

使用说明

Thrift 使用“.thrift” 模式文本文件来生成OpenHarmony 模型类。自定义工具用于生成OpenHarmony 的thrift文件的模型类。工具生成的文件要复制到客户端和服务器路径。生成的模型类用于开发客户端和服务器应用程序以进行gRPC调用。客户端根据支持的协议和传输层配置请求以进行gRPC调用。

import {Thrift} from '@ohos/thrift';
import {CalculatorClient} from '../../common/calculator/Calculator';
import {Work, Operation} from '../../common/calculator/tutorial_types';

try {
    //Example with url and without
    var transport = new Thrift.Transport("http://192.168.1.3:9090/thrift/service/tutorial/");
    //var transport = new Thrift.Transport();
    var protocol = new Thrift.Protocol(transport);
    var client = new CalculatorClient(protocol);
        
    var that = this;
    
    var workI8Add = new WorkI8()  //Generated Class Work can be any based on user requirement.
    workI8Add.num1 = 1;
    workI8Add.num2 = 15;
    workI8Add.op = Operation.ADD; //Operation can be any based on user requirement
    client.calculateI8(1, workI8Add, function (result) {
        if (result) {
            that.i8add = result;
        }
    });
 } catch (error) {
   console.info("Thrift" + error.getMessage())
 }

Thrift 编译器

如何安装Thrift 的详细信息，请点击此处

创建 .thrift 文件后，可以运行Thrift ，以便以目标语言生成代码。Thrift 命令的用法为：

thrift [options] file
thrift -r --gen language[java/js/py etc] filename.thrift

1.对于在示例应用程序中使用thrift，可以在compiler文件夹中找到编译器和工具。

2.生成的warpper工具用于在windows(powershell)和linux平台生成OpenHarmony JS文件对应的 .thrift 文件。

Linux 环境使用方法

1.将 compiler和thrift.sh放在同一个文件夹中； 2.使用input .thrift 文件执行thrift.sh； 3.在JS 和OpenHarmony文件夹找到对应生成的文件。

./thrift.sh  tutorial.thrift

Windows环境使用方法

1.打开powershell； 2.打开PowerShell ISE ( 在 powershell提示符中执行PowerShell ISE)； 3.从下方的命令行转到 thrift.ps1和thrift compiler.exe所在的文件夹； 4.使用 input.thrift 文件运行工具； 5.在JS 和OpenHarmony文件夹找到对应生成的文件。

.\thrift.ps1 eg.thrift

接口说明

new Thrift.Transport(/ Pass Server URL /) // 创建传输对象

new Thrift.TJSONProtocol(/ Pass Transport object /) // 创建协议对象。注意TJSON协议和协议相同。

new Thrift.TException().getMessage(); // 如果URL不存在，则获取在捕获块中跑出的错误信息。

兼容性

支持OpenHarmony API version 8 及以上版本

目录结构

|---- Thrift
|     |---- compiler #  Windows和Linux操作系统使用的编译器和工具
|     |---- entry # 示例代码文件夹
|     |---- server # 用于执行thrift操作的服务器代码
|     |-- thrift # thrift库文件夹
|     |-- README.md # 安装使用方法