# tson

**Repository Path**: xsdiewl/tson

## Basic Information

- **Project Name**: tson
- **Description**: TSON - a Typed data format like jSON. 一种带类型的 "json"，主要用于解决 json 反序列化类型丢失问题；Java 对象的持久化方案的另
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/tson
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2020-03-30
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TSON - a Typed data format like jSON.
一种带类型的"json"，主要用于解决json反序列化类型丢失问题;
Java对象的持久化方案的另一种选择，对象持久化成人类可读文本字符串。

### 和其他持久化方案的对比
>#### json
> > tson无论是命名还是文本数据格式的组织都是从json发展而来，json的主要问题是类型丢失，
反序列化后所有的类型考推断，这往往会产生与预期不一致的行为。

>#### 其他注如 hessian, protobuf等二进制方案
> > 二进制方案的执行效率本身比文本方案要高，但是牺牲了数据可读性，可调试性，
以及在某些场景下的显示，传输和存储问题。

### 使用方法举例
> 简单的例子，持久化int
```
int a = 123;
String s = Tsons.encode(a);
// i32@123
Integer b = (Integer)Tsons.decode(s);
Assert.notNull(b);
Assert.assertEquals(b, a);
```

> 稍微复杂的例子，持久化Map
```
Map<String, Object> map = new HashMap<String, Object>();
map.put("intValue", 123);
map.put("doubleValue", 123.456);
map.put("floatValue", 1.24f);
map.put("dateValue", new Date());
List<Object> list = new ArrayList<Object>();
list.add("hello");
list.add(123);
list.add(true);
map.put("myList", list);
String s = Tsons.encode(map);
// {dateValue:date@"2020-01-08 17:46:12.908",intValue:i32@123,myList:[str@"hello",i32@123,bool@true],floatValue:f32@1.24,doubleValue:f64@123.456}
Object map2 = Tsons.decode(s);
Assert.assertEquals(map, map2);
```

### tson特性
> #### 持久化支持的类型
> >类似于json，支持所有JavaBeans，基本类型及其包装类，各种容器类，及其他们的数组，支持多维数组，支持二进制
> #### 支持循环引用检测


### 相关性能指标测试对比
> > 原始数据: {"n1":"hello world这是一个简单的测试数据123456789"}

| 方案 |  持久化后数据 | 相对原数据大小 | 线程数 |100万次序列化总耗时(ms) | 100万次反序列化总耗时(ms)|
|:------- | :-------------- | :-------------- | :--------- | :-------------| :-------------|
| tson | 64 | 110% | 1 | 1697 | 1445 |
| fastjson | 62 | 107% | 1 | 213 | 247 |
| java | 143 | 247% | 1 | 1025 | 2859 |
| hassian | 66 | 113% | 1 | 388 | 350 |


> > 以上所有测试的平台均为: MacBook Pro/i5 2.4GHz/8G/JVM version 1.8.0_20