在TypeScript和JavaScript如何使用MetaMessage?

简介: MetaMessage 是一种跨语言数据交换协议,支持 TypeScript/JavaScript(通过装饰器自动类型转换)、JSONC 文本与紧凑二进制 wire 格式,兼顾可读性、精度(如 bigint 表示 int64)与性能,旨在替代 JSON、Protobuf 等传统序列化方案。

截屏2026-05-18 23.28.54.png
截屏2026-05-18 23.30.29.png

在TypeScript和JavaScript如何使用MetaMessage?

本來是不報信心的,因為ts和js天生類型缺失,作為一個動態語言,number既不是int也不是bigint,開始設計的時候想了挺長時間。

還好,確認了ts是支持裝飾器的,雖然也寫過很多前端項目,卻從來沒有用過這個裝飾器。既然有裝飾器,那就非常適合MetaMessage改造,簡單的方式就可以把值進行轉換。對於一些類型,為了不丟失精度,int/int64/uint/uint64需要用bigint來表示,這點需要注意。

看一個例子:

import {
    encodeFromJsonc, decodeToJsonc } from 'metamessage';

@mm({
    desc: '用户' })
class User {
   
  @mm({
    type: ValueType.Int64, desc: '用户ID' })
  id: bigint = 0n;

  @mm({
    desc: '昵称', nullable: false })
  name: string = '';

  @mm({
    type: ValueType.Uint8, desc: '年龄' })
  age: number = 0;
}

const u = new User();
u.id = 666n;
u.name = 'abc';
u.age = 20;

const wire = encodeFromValue(u);
console.log('wire', wire);

const decoded = decodeToValue(wire, User);
console.log('decoded', decoded);

const jsonc = `
// mm: desc="用户"
{
  // mm: type=i64; desc="用户ID"
  "id": 666,

  // mm: desc="昵称"
  "name": "abc",

  // mm: type=u8
  "age": 20
}
`;

const wire = encodeFromJsonc(jsonc);
const jsoncString = decodeToJsonc(wire);
console.log('JSONC result:\n', jsoncString);

上面用一個mm裝飾器來包裹mm的標籤,desc可以描述字段信息,用戶可以從中了解輸出的數據意義。
特殊的類型 比如ValueType.Int64是需要標注的,這樣類型極少的js也可以表示複雜的數據類型了。
nullable代表數據是否可以為空,這在請求描述上特別有用,nullable說明字讀是可選的,當然可以搭配allow_empty,效果更佳。

說下這裡的jsonc,這是一種mm可以表示的文本形式,各語言可能數據對象不一致,但如果輸出jsonc,相同語意的jsonc是一致的。所以各語言間是可以表示相同語意的,且不會出錯。

wire是一種序列化的二進制形式,佔用空間小,也方便解析,可以在網絡傳輸中直接用它。

MetaMessage目前已經支持不少語言了。不過還有很多語言支持在路上,未來作為一種各語言間理想的數據交換工具,一定會流行開來。

替代傳統的json、protobuf、messagePack等老舊協議指日可待。

目录
相关文章
|
2天前
|
存储 弹性计算 负载均衡
阿里云巨型帧是什么?云服务器ECS支持规格、开启关闭及配置步骤问题解答FAQ
阿里云巨型帧(Jumbo Frames)支持8500字节超大以太网帧,突破传统1500字节限制,可显著减少数据包数量、降低CPU负载、提升网络吞吐与大块数据传输效率,适用于HPC、大数据、SAN等高带宽场景。详细参考云服务器ECS官网解读:https://t.aliyun.com/U/AZBUsA
241 123
|
25天前
|
JavaScript 文件存储 数据安全/隐私保护
打造你的私人电子书王国:Talebook 项目全面介绍
Talebook 以其简洁的部署、优雅的界面和强大的功能,成为了这个领域不可多得的好项目。
349 127
|
2月前
|
大数据 索引 Python
5个提升Python编码效率的实用技巧
5个提升Python编码效率的实用技巧
432 130
|
2月前
|
索引 Python
三个让你代码更优雅的Python技巧
三个让你代码更优雅的Python技巧
300 141
|
2月前
|
索引 Python
5个让你惊艳的Python一行代码技巧
5个让你惊艳的Python一行代码技巧
279 142
|
Web App开发 监控 测试技术
|
分布式数据库 数据库 Hbase
双研究员带你了解数据库技术现状,及阿里云为什么要推出HBase
纵观整个排行榜,RDBMS牢牢占据了前3席,各个数据库的热度亦一览无余。然而,在这背后,大数据时代下,数据库技术究竟发生了什么样的变化和发展?2月21日,阿里巴巴中间件技术部负责人蒋江伟与阿里巴巴 ApsaraDB 负责人余锋将为你揭开!
9466 123