Skip to content

Latest commit

 

History

History
102 lines (76 loc) · 2.67 KB

README.md

File metadata and controls

102 lines (76 loc) · 2.67 KB
Raw

wson

parcel binary object nation, which is schema less without symbol table support. aim to be fastest serializable binary protocol.

fast tiny binary object format. inspired by bson and message pack and android binary and protobuf.

faster than normal json library with half data size.less. you can embed in your application with super speed and reduce trafic

currently is in development.

wson data format example

type signature format
number int 'i' signature + varint
number double 'd' signature + 8 byte (big endian)
number float 'F' signature + 4 byte (big endian)
string 's' signature + var length + bytes( unicoder utf-8)
null '0' signature
boolean 't' or 'f' signature
array '[' signature + var length + elements
object '{' signature + var size + key, value, key, value

more type please seem Protocol.java define

string length, map size ar store used usigned varint.

here is an example, data in json as follows:

{
  "name" : "hello world"
}

in wson

wson

1 quick start c++

1.1 include header file

  #include "wson/wson_parser.h"

1.2 read object map example

  const char* data = readFile("data.wson"); // binary wson data from some where
  wson_parser parser(data);
  int type = parser.nextType();
  if(parser.isMap(type)){
      int size = parser.nextMapSize();
      for(int i=0; i<size; i++){
          std::string key = parser.nextMapKeyUTF8();
          uint8_t  valueType = parser.nextType();
          std::string value = parser.nextStringUTF8(valueType);
          printf("map %s == %s \n", key.c_str(), value.c_str());
      }
  }

1.3 read object array example

 const char* data = readFile("data.wson"); // binary wson data from some where
  wson_parser parser(data);
  int type = parser.nextType();
  if(parser.isArray(type)){
    int size = parser.nextArraySize();
    for(int i=0; i<size; i++){
        uint8_t  valueType = parser.nextType();
        std::string value = parser.nextStringUTF8(valueType);
        printf("array %d == %s \n", i, value.c_str());
    }
  }

2 quick start java

2.1 convert java object to wson binary

Person person = new Person();
byte[] bts = Wson.toWson(person);

2.2 convert wson java object

byte[] bts = readFile("person.wson");
Map map = (Map)Wson.parse(bts);

if you want more details; please see source and api

reference

https://amzn.github.io/ion-docs/docs/binary.html#5-decimal

https://github.com/protocolbuffers/protobuf