Apache Avro 纯 JavaScript 实现:avsc

jopen 9年前

avsc 是 Apache Avro 的纯 JavaScript 实现。

特性:

  • 完整的 Avro 架构支持,包括递归架构, sort order, 以及 schema evolution.

  • 快速!速度相当于 JSON 的两倍,同时更少的编码(varies per schema).

  • 无依赖,avsc甚至可以在浏览器运行

表现

解码吞吐率的示意图(越高越好):

Apache Avro 纯 JavaScript 实现:avsc

库比较:

  • node-avsc, this package.

  • node-json, built-in JSON serializer.

  • node-pson, an alternative to JSON.

  • node-avro-io, most popular previously existing Avro implementation.

示例:

在一个 node.js 模块,或使用 browserify:

var avsc = require('avsc');
  • 编码和解码对象:

    // We can declare a schema inline:var type = avsc.parse({    name: 'Pet',    type: 'record',    fields: [      {name: 'kind', type: {name: 'Kind', type: 'enum', symbols: ['CAT', 'DOG']}},      {name: 'name', type: 'string'}    ]  });var pet = {kind: 'CAT', name: 'Albert'};var buf = type.toBuffer(pet); // Serialized object.var obj = type.fromBuffer(buf); // {kind: 'CAT', name: 'Albert'}
  • 生成一个 schema 的随机实例:

    // We can also parse a JSON-stringified schema:  var type = avsc.parse('{"type": "fixed", "name": "Id", "size": 4}');  var id = type.random(); // E.g. Buffer([48, 152, 2, 123])
  • 检查对象是否符合给定 schema:

    // Or we can specify a path to a schema file (not in the browser):  var type = avsc.parse('./Person.avsc');  var person = {name: 'Bob', address: {city: 'Cambridge', zip: '02139'}};  var status = type.isValid(person); // Boolean status.
  • 从一个 Avro 容器文件(不在浏览器)得到解码记录的readable stream

    avsc.createFileDecoder('./records.avro')    .on('metadata', function (type) { /* `type` is the writer's type. */ })    .on('data', function (record) { /* Do something with the record. */ });

项目主页:http://www.open-open.com/lib/view/home/1445050138669