パッケージの詳細

sofa-hessian-node

alipay388MIT2.2.1

An internal improved version of Hessian powered by Ant Financial.

hessian, nodejs, sofa

readme

sofa-hessian-node

蚂蚁金服对 Hessian 序列化的定制版本

NPM version build status Test coverage David deps Known Vulnerabilities npm download

sofa-hessian-node 对应的 Java Hessian 版本是 v3.1.3。它对 hessian.js-1 模块做了进一步封装,通过预编译来提高性能。

安装

$ npm install sofa-hessian-node --save

示例

'use strict';

// classMap 是要序列化类的定义
const classMap = {
  'com.alipay.test.sub.TestObj2': {
    name: {
      type: 'java.lang.String',
    },
    transientField: {
      type: 'java.lang.String',
      isTransient: true,
    },
    finalField: {
      type: 'java.lang.String',
      defaultValue: 'xxx',
    },
    staticField: {
      type: 'java.lang.String',
      isStatic: true,
    },
  },
};

const encode = require('sofa-hessian-node').encode;

const buf = encode({
  $class: 'com.alipay.test.sub.TestObj2',
  $: { name: 'gxcsoccer' },
}, '2.0', classMap);

console.log(buf.toString('hex'));
// 4fac636f6d2e616c697061792e746573742e7375622e546573744f626a3292046e616d650a66696e616c4669656c646f9009677863736f6363657203787878

hessian 4 支持

const { v4 } = require('sofa-hessian-node');

const buf = v4.encode({
  $class: 'com.alipay.test.sub.TestObj2',
  $: { name: 'gxcsoccer' },
}, '2.0', classMap);

console.log(buf.toString('hex'));

性能数据

benchmark 看,相比于直接使用 hessian.js-1,sofa-hessian-node 性能有非常明显的提高(特别是针对复杂对象的场景)

  node version: v10.0.0, date: Wed Jun 27 2018 23:17:47 GMT+0800 (CST)
  Starting...
  4 tests completed.

  hessian old - 1.0 x  47,719 ops/sec ±2.57% (86 runs sampled)
  hessian new - 1.0 x 246,812 ops/sec ±2.76% (87 runs sampled)
  hessian old - 2.0 x  78,132 ops/sec ±2.49% (84 runs sampled)
  hessian new - 2.0 x 372,090 ops/sec ±2.99% (87 runs sampled)

如何贡献

请告知我们可以为你做些什么,不过在此之前,请检查一下是否有已经存在的Bug或者意见

如果你是一个代码贡献者,请参考代码贡献规范

开源协议

MIT

更新履歴

2.2.1 / 2023-07-28

fixes

2.2.0 / 2022-03-13

fixes

others

2.1.0 / 2020-07-01

features

2.0.0 / 2020-06-16

features

1.8.0 / 2020-05-13

features

1.7.1 / 2020-03-30

fixes

1.7.0 / 2020-02-25

features

  • [536d240] - feat: support generic param pass case with typeVar=true, should parse the real type (#24) (mansonchor.github.com <mansonchor@126.com>)

1.6.3 / 2019-10-12

fixes

1.6.2 / 2019-10-11

fixes

1.6.1 / 2019-10-10

fixes

1.6.0 / 2019-07-22

features

1.5.1 / 2019-03-22

fixes

1.5.0 / 2019-03-06

features

1.4.0 / 2019-02-19

features

1.3.0 / 2019-02-14

features

1.2.0 / 2019-01-28

fixes

1.1.2 / 2019-01-18

fixes

1.1.1 / 2019-01-11

fixes

1.1.0 / 2019-01-11

features

1.0.7 / 2019-01-02

fixes

1.0.6 / 2018-11-27

fixes

1.0.5 / 2018-11-27

fixes

1.0.4 / 2018-11-24

fixes

1.0.3 / 2018-10-19

fixes

1.0.2 / 2018-08-02

fixes

1.0.1 / 2018-07-04

fixes

1.0.0 / 2018-06-28

others ,fatal: No names found, cannot describe anything.