【Tars-go】腾讯微服务框架学习使用03-- TarsUp协议

2024-04-13 23:44

本文主要是介绍【Tars-go】腾讯微服务框架学习使用03-- TarsUp协议,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

3 TarsUP协议

统一通信协议 TarsTup | TarsDocs (tarscloud.github.io)

TarsDocs/base at master · TarsCloud/TarsDocs (github.com) : 有关于tars的所有介绍

每一个rpc调用双方都约定一套数据序列化协议,gprc用的是protobuff,tarsgo是统一通信协议 TarsTup。

tup语法:TarsDocs/base/tars-protocol.md at master · TarsCloud/TarsDocs (github.com)

基本用法

既然是协议,就有一套成熟的标准,不断迭代、向前向后兼容–这就是大厂的硬实力,淦(但文档确实一般般):

  1. 基本数据

    支持的数据类型:

    • bool
    • byte: 8位
    • short: 最高支持到16位
    • int: 32位
    • long: 64位
    • float: 32位,float 在大多数现代编程语言和协议中通常都是指 IEEE 754 标准的单精度浮点数,占用 4 个字节。
    • double:64位,double 类型遵循 IEEE 754 标准的双精度浮点数格式,通常占用 8 个字节。
    • string:不定长,string 类型用于表示字符串数据。在 Tars 中,字符串是动态大小的,可以根据实际存储的内容变化其长度。存储时通常会先存储一个长度字段(可能是 32 位整数),然后是字符串本身的字节。
    • unsigned byte:8位,unsigned byte 表示无符号字节,范围从 0 到 255。这相当于在 C++ 或 Java 中的 unsigned char 和go 的byte
    • unsigned short:32位,unsigned short 是一个无符号的短整型数据,范围从 0 到 65535,占用 2 个字节。
    • unsigned int:64位,unsigned int 表示一个无符号的整型数据,范围从 0 到约 4.29 亿(2^32 - 1),占用 4 个字节。

    以上数据类型,在各种语言大部分都有相对应的实现,这也可以使用tars作为多语言间通信的数据协议。

  2. 复杂数据类型: 自己可以定义的数据类型

    有 枚举、常量、结构体、 序列 、 字典 具体可看TarsDocs/base/tars-protocol.md at master · TarsCloud/TarsDocs (github.com)

    一个例子:

    // 命名空间
    module AiGo{ // 枚举enum TE{E1 = 1,E2,E3};// 常量const int a = 1;const string s = "abc";// 结构体  + vector + mapstruct Test{0  require  string s;1  optional int  i = 23;2  require vector<int> vi;3  require map<int, string> m;};// 具体的接口--》可以调用的服务interface MathService{// 具体可以调用的方法。void add(int a, int b, out int c);   int Test1(int a, Test test, out int c); //};//嵌套struct demo1{0 require Test test; // 嵌套结构体1 require map<int , map<int, string>>  doubleMap;  // 双重Map2 require vector<vector<vector<int>>> triVector; // 三重Vector};};
    

    转化成go语言版本: tars2go -outdir=tars-protocol -module="github.com/ajwlforever/AiGo" .\demo.tars

    请添加图片描述

    生成这俩文件demo.goMathService.tars.go 就可以直接用了,当然这俩文件全是抽象的实现,底层数据的实现。–》具体方法内逻辑实现要初始化并绑定具体的实现

    // 具体的实现 初始化
    imp := new(InterfaceImp)
    err := imp.Init()
    ....
    // New servant
    app := new(AiGo.Demo1)
    // servant 绑定具体的实现
    app.AddServantWithContext(imp, cfg.App+"."+cfg.Server+".InterfaceObj")
    

协议对比

既然是数据序列化协议,那就要做一个对比,为什么腾讯自己造了一个自己的。

常见的数据序列协议有 xml、json、protobuf

首先最大的区别是 xml、json都是文本格式的,空间占比大,但由于其良好的可读性,也是广泛应用于restful风格的接口返回中。

protobuf和tarsup都是基于二进制直接定义的,数据的编码与解码都是更高效的,但是这种编码解码都需要额外的支持,而restful适用于几乎一切平台。

​ 尽管Protobuf和Tars在技术性能上有优势,JSON在易用性、灵活性和广泛支持等方面的优势使其成为大多数HTTP接口首选的数据格式。对于需要高性能和高效数据编码的内部系统或微服务间通信,Protobuf和Tars仍然是非常合适的选择

总的来说,为什么http接口首选json:

  1. 可读、性能好像也没那么不好,只是相对于二进制的会慢一点,who care,现代的Web服务架构和硬件已经能够很好地处理大量的JSON数据,性能损失可以通过其他手段(如缓存、数据压缩)来缓解。
  2. 复杂性:使用JSON作为数据格式,开发者可以利用标准的HTTP工具和库来处理数据,而无需依赖于特定的序列化和反序列化工具。
  3. 易用性:JSON作为一种文本格式,很容易处理各种编码和字符集的问题,这使得它在不同平台和编程环境之间具有很好的兼容性。而二进制格式可能需要处理字节顺序、对齐方式等底层细节,这在跨平台交互时可能导致问题。
  4. 开放性:JSON作为一种开放标准,在Web开发中有广泛的文档和最佳实践指导。而Protobuf、Tars虽然也有文档,但相对较少,且通常与特定实现或框架相关,这在一定程度上限制了它们的通用性。

这篇关于【Tars-go】腾讯微服务框架学习使用03-- TarsUp协议的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/901548

相关文章

Java String字符串的常用使用方法

《JavaString字符串的常用使用方法》String是JDK提供的一个类,是引用类型,并不是基本的数据类型,String用于字符串操作,在之前学习c语言的时候,对于一些字符串,会初始化字符数组表... 目录一、什么是String二、如何定义一个String1. 用双引号定义2. 通过构造函数定义三、St

Pydantic中Optional 和Union类型的使用

《Pydantic中Optional和Union类型的使用》本文主要介绍了Pydantic中Optional和Union类型的使用,这两者在处理可选字段和多类型字段时尤为重要,文中通过示例代码介绍的... 目录简介Optional 类型Union 类型Optional 和 Union 的组合总结简介Pyd

Nginx中配置HTTP/2协议的详细指南

《Nginx中配置HTTP/2协议的详细指南》HTTP/2是HTTP协议的下一代版本,旨在提高性能、减少延迟并优化现代网络环境中的通信效率,本文将为大家介绍Nginx配置HTTP/2协议想详细步骤,需... 目录一、HTTP/2 协议概述1.HTTP/22. HTTP/2 的核心特性3. HTTP/2 的优

Vue3使用router,params传参为空问题

《Vue3使用router,params传参为空问题》:本文主要介绍Vue3使用router,params传参为空问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐... 目录vue3使用China编程router,params传参为空1.使用query方式传参2.使用 Histo

使用Python自建轻量级的HTTP调试工具

《使用Python自建轻量级的HTTP调试工具》这篇文章主要为大家详细介绍了如何使用Python自建一个轻量级的HTTP调试工具,文中的示例代码讲解详细,感兴趣的小伙伴可以参考一下... 目录一、为什么需要自建工具二、核心功能设计三、技术选型四、分步实现五、进阶优化技巧六、使用示例七、性能对比八、扩展方向建

使用Python实现一键隐藏屏幕并锁定输入

《使用Python实现一键隐藏屏幕并锁定输入》本文主要介绍了使用Python编写一个一键隐藏屏幕并锁定输入的黑科技程序,能够在指定热键触发后立即遮挡屏幕,并禁止一切键盘鼠标输入,这样就再也不用担心自己... 目录1. 概述2. 功能亮点3.代码实现4.使用方法5. 展示效果6. 代码优化与拓展7. 总结1.

使用Python开发一个简单的本地图片服务器

《使用Python开发一个简单的本地图片服务器》本文介绍了如何结合wxPython构建的图形用户界面GUI和Python内建的Web服务器功能,在本地网络中搭建一个私人的,即开即用的网页相册,文中的示... 目录项目目标核心技术栈代码深度解析完整代码工作流程主要功能与优势潜在改进与思考运行结果总结你是否曾经

关于WebSocket协议状态码解析

《关于WebSocket协议状态码解析》:本文主要介绍关于WebSocket协议状态码的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录WebSocket协议状态码解析1. 引言2. WebSocket协议状态码概述3. WebSocket协议状态码详解3

Linux中的计划任务(crontab)使用方式

《Linux中的计划任务(crontab)使用方式》:本文主要介绍Linux中的计划任务(crontab)使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、前言1、linux的起源与发展2、什么是计划任务(crontab)二、crontab基础1、cro

kotlin中const 和val的区别及使用场景分析

《kotlin中const和val的区别及使用场景分析》在Kotlin中,const和val都是用来声明常量的,但它们的使用场景和功能有所不同,下面给大家介绍kotlin中const和val的区别,... 目录kotlin中const 和val的区别1. val:2. const:二 代码示例1 Java