一文精通FastJson(入门教程)

bactcolor

已于 2023-05-30 22:13:27 修改

阅读量2k

点赞数 2

分类专栏： java 文章标签： java json spring

于 2021-02-25 21:18:13 首次发布

本文链接：https://blog.csdn.net/bactcolor/article/details/114106687

版权

java 专栏收录该内容

1 篇文章

订阅专栏

本文以通俗易懂的方式对常用的FastJson进行入门讲解。介绍了导入坐标、普通用法，还说明了与Spring的整合方法。同时详细讲解了JSONField注解的多种配置方式，如配置位置、指定字段名称、日期格式化等，最后提及了空值处理。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

日常开发中，前后端的数据通常都使用JSON的格式进行交互，常见的相关库有Jackson,Gson,Fastjson等，本文意在以通俗易懂的方式，去除其他不相关的概念的场景下对我们最常用的FastJson进行入门讲解。

一、导入坐标

  <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.74</version>
  </dependency>

二、普通用法

//序列化
String jsonString = JSON.toJSONString(obj);
//反序列化
Group group = JSON.parseObject(jsonString, Group.class);

三、与Spring进行整合

启动类实现WebMvcConfigurer中的extendMessageConverters方法
接口直接返回对象

@ComponentScan(value = "com.color")
@SpringBootApplication
public class App implements WebMvcConfigurer {
    public static void main(String[] args) {
        SpringApplication.run(App.class,args);
    }

    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        //声明一个转换器
        FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();
        //声明一个配置
        FastJsonConfig fastJsonConfig = new FastJsonConfig();
        //设置转换器的配置信息
        fastConverter.setFastJsonConfig(fastJsonConfig);
        //设置支持UTF8,解决返回的信息中文乱码问题
        fastConverter.setSupportedMediaTypes(new ArrayList<MediaType>(){
            {
                add(MediaType.APPLICATION_JSON_UTF8);
            }
        });
        //0的意思是调整顺序
        //FastJson官网说是如果不设置0,默认使用的是jackJson
        //但实际使用情况暂未发现此问题
        converters.add(0,fastConverter);

    }
}

四注解

1. JSONField配置方式

FieldInfo可以配置在getter/setter方法或者字段上。例如：

1.1 配置在getter/setter上

public class A {
      private int id;
 
      @JSONField(name="ID")
      public int getId() {return id;}
      @JSONField(name="ID")
      public void setId(int value) {this.id = id;}
 }

1.2 配置在field上

public class A {
      @JSONField(name="ID")
      private int id;
 
      public int getId() {return id;}
      public void setId(int value) {this.id = id;}
 }

2.使用name指定字段名称

当前端传过来的字段名不一样的时候，我们可以在字段名上加上这个注解

public class A {
      @JSONField(name="ID")
      private int id;
 
      public int getId() {return id;}
      public void setId(int value) {this.id = id;}
 }

3. 使用format配置日期格式化

public class A {
      // 配置date序列化和反序列使用yyyyMMdd日期格式
      @JSONField(format="yyyyMMdd")
      public Date date;
 }

4. 使用serialize/deserialize指定字段不序列化

public class A {
      @JSONField(serialize=false)
      public Date date;
 }
 public class A {
      @JSONField(deserialize=false)
      public Date date;
 }

5. 使用ordinal指定字段的顺序

缺省fastjson序列化一个java bean，是根据fieldName的字母序进行序列化的，你可以通过ordinal指定字段的顺序。这个特性需要1.1.42以上版本。

public static class VO {
    @JSONField(ordinal = 3)
    private int f0;
    @JSONField(ordinal = 2)
    private int f1;
    @JSONField(ordinal = 1)
    private int f2;
}

6.使用serializeUsing制定属性的序列化类

在fastjson 1.2.16版本之后，JSONField支持新的定制化配置serializeUsing，可以单独对某一个类的某个属性定制序列化，比如：

public static class Model {
    @JSONField(serializeUsing = ModelValueSerializer.class)
    public int value;
}
public static class ModelValueSerializer implements ObjectSerializer {
    @Override
    public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType,
                      int features) throws IOException {
        Integer value = (Integer) object;
        String text = value + "元";
        serializer.write(text);
    }

五、空值处理

普通

	String text = JSON.toJSONString(obj, SerializerFeature.WriteMapNullValue, 
                                    SerializerFeature.WriteNullListAsEmpty);

Spring

 fastJsonConfig.setSerializerFeatures(SerializerFeature.WriteMapNullValue)

如果觉得不错的话，请不要吝啬一键三连喔。