# fastjson-replacement

**Repository Path**: yuhw__gte/fastjson-replacement

## Basic Information

- **Project Name**: fastjson-replacement
- **Description**: No description available
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: java_impl
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-10
- **Last Updated**: 2025-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[中文文档](./README_CN.md) | [English Document](./README.md)        

# Fastjson-replacement
[![codecov](https://codecov.io/gh/qingmo/fastjson-replacement/branch/main/graph/badge.svg?token=OZQG1NVXDX)](https://codecov.io/gh/qingmo/fastjson-replacement) [![License](https://img.shields.io/badge/License-MIT-brightgreen)](https://mit-license.org/) [![quality gate](https://sonarcloud.io/api/project_badges/measure?project=qingmo_fastjson-replacement&metric=alert_status)](https://sonarcloud.io/dashboard?id=qingmo_fastjson-replacement) [![Codacy Security Scan](https://github.com/qingmo/fastjson-replacement/actions/workflows/codacy-analysis.yml/badge.svg)](https://github.com/qingmo/fastjson-replacement/actions/workflows/codacy-analysis.yml) [![build](https://github.com/qingmo/fastjson-replacement/actions/workflows/build.yml/badge.svg)](https://github.com/qingmo/fastjson-replacement/actions/workflows/build.yml)

目前版本`1.0.2`具备支持生产环境使用能力。
## `Fastjson-replacement`是什么    
`Fastjson-replacement` 是一个用于替换`Fastjson`实现替换为`Jackson`实现的桥接模式工具，这让习惯于`Fastjson`用法的开发者或者已经大批量使用`Fastjson`的遗留工程代码可以轻松的做出改变，而无需改变现有的使用习惯与人体工程学体验。

## 特性
* 支持`java.util.Date`, `java 8 jsr310 time packages`(`LocalDate`,`LocalDateTime`,`LocalTime`)        
* 支持多种时间格式反序列化（目前：`yyyy-MM-dd HH:mm:ss`,`yyyy-MM-dd`)

## 开发原因

为什么要替换`fastjson`? 因为其漏洞多，修复速度慢。

为什么重造轮子？测试完备度不够，没有自动发布和及时更新版本。

## 使用方法

**步骤1**:添加依赖

使用默认的`jackson`版本（当前`1.12.3`) 

`maven`

```xml
<dependency>
    <groupId>io.github.qingmo</groupId>
    <artifact>fastjson-replacement</artifact>
    <version>1.0.2</version>
</dependency>
```

`gradle`

```kotlin
implementation("io.github.qingmo:fastjson-replacement:1.0.2")
```



使用自定义版本的`jackson`版本

`maven`

```xml
<dependency>
    <groupId>io.github.qingmo</groupId>
    <artifactId>fastjson-replacement</artifactId>
    <version>1.0.2</version>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-annotations</artifactId>
        </exclusion>
        <exclusion>
            <groupId>com.fasterxml.jackson</groupId>
            <artifactId>jackson-bom</artifactId>
        </exclusion>
    </exclusions>
</dependency>
```

`gradle`

```kotlin
implementation("io.github.qingmo:fastjson-replacement:1.0.2") {
    exclude(group = "com.fasterxml.jackson.core")
    exclude(group = "com.fasterxml.jackson")
}
```

**步骤2**:替换fastjson的包

**替换方法**

```shell
import com.alibaba.fastjson.JSON
替换为
import io.github.qingmo.json.JSON

import com.alibaba.fastjson.JSONArray
替换为
import io.github.qingmo.json.JSONArray

import com.alibaba.fastjson.JSONObject
替换为
import io.github.qingmo.json.JSONObject
```



## 对于生产环境来说开源库最重要的是什么呢？

* **可靠性**

  这个系统或库必须正确的工作。 `Fastjson-replacement`提供了100%的代码覆盖率来保障。

* **性能**

  这个系统或库必须在一个可预期的性能表现。

  如果这个库是目前问题的唯一解决方案，那么性能表现应该在可容忍的范围内；

  如果这个库是目前问题的另外一个可选解决方案，那么它的性能表现应该等于或优于目前的解决方案性能平均水平。

  `Fastjson-replacement` 的性能测试成绩如下(基于 [json-comparsion](https://github.com/zysrxx/json-comparison)):

  ![serialize_benchmark](/Users/Chaos/workspace/fastjson-replacement/docs/serialize_benchmark.png)

  ![deserialize_benchmark](/Users/Chaos/workspace/fastjson-replacement/docs/deserialize_benchmark.png)

## 已知问题

* 不支持`kotin data class`

  `kotlin data class` 需要 `jackson-module-kotlin` ，这个模块目前是基于kotlin反射，其在反序列化过程中性能表现极差。
  我在等待新的一个PR合并 https://github.com/FasterXML/jackson-module-kotlin/pull/439

## 参考

[jackson-datatype-fastjson](https://github.com/larva-zhang/jackson-datatype-fastjson/blob/master/src/test/java/com/github/larva/zhang/jackson/datatype/fastjson/SimpleReadTest.java)

[Jackson替换fastjson](https://www.cnblogs.com/larva-zhh/p/11544317.html)

[如何让jackson与kotlin友好相处](https://cloud.tencent.com/developer/article/1372442)

[jackson-replace-fastjson](https://github.com/zjb-it/jackson-replace-fastjson)

[Designing Data Intensive Applications](https://cloud.tencent.com/developer/article/1372442)