jackson学习之八:常用方法注解

简介: 熟悉和使用jackson常用的方法注解

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码):https://github.com/zq2599/blog_demos

系列文章汇总

名称 链接 备注
项目主页 https://github.com/zq2599/blog_demos 该项目在GitHub上的主页
git仓库地址(https) https://github.com/zq2599/blog_demos.git 该项目源码的仓库地址,https协议
git仓库地址(ssh) git@github.com:zq2599/blog_demos.git 该项目源码的仓库地址,ssh协议
  • 这个git项目中有多个文件夹,本章的应用在jacksondemo文件夹下,如下图红框所示:
    在这里插入图片描述

  • jacksondemo是父子结构的工程,本篇的代码在annotation子工程中,里面的methodannotation这个package下,如下图:
    在这里插入图片描述

JsonValue

  • 在序列化时起作用,可以用来注解get方法或者成员变量;
  • 一个类中,JsonValue只允许出现一次;
  • 如果注解的是get方法,那么该方法的返回值就是整个实例的序列化结果;
  • 如果注解的是成员变量,那么该成员变量的值就是整个实例的序列化结果;
  • 下面是用来测试的Pojo类,JsonValue注解放在getField0方法上,此方法的返回值已经写死了"abc":
    static class Test {
   
   

        private String field0;

        private String field1;

        @JsonValue
        public String getField0() {
   
    return "abc"; }

        public void setField0(String field0) {
   
    this.field0 = field0; }
        public String getField1() {
   
    return field1; }
        public void setField1(String field1) {
   
    this.field1 = field1; }
    }
  • Test类的序列化结果如下,即getField0方法的返回值:
    在这里插入图片描述

    JsonCreator

  • 在反序列化时,当出现有参构造方法时(可能是多个有参构造方法),需要通过JsonCreator注解指定反序列化时用哪个构造方法,并且在入参处还要通过JsonProperty指定字段关系:
    static class Test {
   
   

        private String field0;
        private String field1;


        public Test(String field0) {
   
   
            this.field0 = field0;
        }

        // 通过JsonCreator指定反序列化的时候使用这个构造方法
        // 通过JsonProperty指定字段关系
        @JsonCreator
        public Test(@JsonProperty("field0") String field0,
                    @JsonProperty("field1") String field1) {
   
   
            this.field0 = field0;
            this.field1 = field1;
        }

        @Override
        public String toString() {
   
   
            return "Test{" +
                    "field0='" + field0 + '\'' +
                    ", field1='" + field1 + '\'' +
                    '}';
        }
    }
  • 反序列化结果如下:
    在这里插入图片描述

    JsonSetter

  • JsonSetter注解在set方法上,被用来在反序列化时指定set方法对应json的哪个属性;
  • JsonSetter源码中,推荐使用JsonProperty来取代JsonSetter:
    在这里插入图片描述
  • 测试代码和结果如下,可见反序列化时,是按照JsonSetter的value去json中查找属性的:
    在这里插入图片描述

    JsonGetter

  • JsonGetter只能作为方法注解;
  • 在序列化时,被JsonGetter注解的get方法,对应的json字段名是JsonGetter的value;
  • JsonGetter源码中,推荐使用JsonProperty来取代JsonGetter:
    在这里插入图片描述
  • 测试代码和结果如下,可见序列化时JsonGetter的value会被作为json字段名:
    在这里插入图片描述

    JsonAnyGetter

  • JsonAnyGetter的作用有些特别:在序列化时,用Map对象的键值对转成json的字段和值;
  • 理解JsonAnyGetter最好的办法,是对比使用前后序列化结果的变化,先来看以下这段代码,是没有JsonAnyGetter注解的,Test有两个成员变量,其中map字段是HashMap类型的:
package com.bolingcavalry.jacksondemo.annotation.methodannotation;

import com.fasterxml.jackson.annotation.JsonAnyGetter;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;

import java.util.HashMap;
import java.util.Map;

public class JsonAnySetterSerialization {
   
   

    static class Test {
   
   
        private String field0;
        private Map<String, Object> map;

        public String getField0() {
   
    return field0; }
        public void setField0(String field0) {
   
    this.field0 = field0; }
        public void setMap(Map<String, Object> map) {
   
    this.map = map; }
        public Map<String, Object> getMap() {
   
    return map; }
    }

    public static void main(String[] args) throws Exception {
   
   
        ObjectMapper mapper = new ObjectMapper();
        // 美化输出
        mapper.enable(SerializationFeature.INDENT_OUTPUT);

        // 新增一个HashMap,里面放入两个元素
        Map<String, Object> map = new HashMap<>();
        map.put("aaa", "value_aaa");
        map.put("bbb", "value_bbb");

        Test test = new Test();
        test.setField0("000");

        // map赋值给test.map
        test.setMap(map);

        System.out.println(mapper.writeValueAsString(test));
    }
}
  • 上述代码的执行结果如下,其实很好理解,就是field0和map两个字段而已:
{
   
   
  "field0" : "000",
  "map" : {
   
   
    "aaa" : "value_aaa",
    "bbb" : "value_bbb"
  }
}
  • 接下来,对上述代码做一处改动,如下图红框所示,给getMap方法增加JsonAnyGetter注解:
    在这里插入图片描述
  • 修改后的执行结果如下,原来的map字段没有了,map内部的所有键值对都成了json的字段:
{
   
   
  "field0" : "000",
  "aaa" : "value_aaa",
  "bbb" : "value_bbb"
}
  • 至此,可以品味出JsonAnyGetter的作用了:序列化时,将Map中的键值对全部作为JSON的字段输出

    JsonAnySetter

  • 弄懂了前面的JsonAnyGetter,对于JsonAnySetter的作用想必您也能大致猜到:反序列化时,对json中不认识的字段,统统调用JsonAnySetter注解修饰的方法去处理;
  • 测试的代码如下,Test类的setValue方法被JsonAnySetter注解,在反序列化时,json中的aaabbb字段,都会交给setValue方法处理,也就是放入map中:
package com.bolingcavalry.jacksondemo.annotation.methodannotation;

import com.fasterxml.jackson.annotation.JsonAnySetter;
import com.fasterxml.jackson.annotation.JsonCreator;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.util.HashMap;
import java.util.Map;

public class JsonAnySetterDeserialization {
   
   

    static class Test {
   
   

        private String field0;

        private Map<String, Object> map = new HashMap<>();

        @JsonAnySetter
        public void setValue(String key, Object value) {
   
   
            map.put(key, value);
        }

        @Override
        public String toString() {
   
   
            return "Test{" +
                    "field0='" + field0 + '\'' +
                    ", map=" + map +
                    '}';
        }
    }

    public static void main(String[] args) throws Exception {
   
   
        String jsonStr = "{\n" +
                "  \"field0\" : \"000\",\n" +
                "  \"aaa\" : \"value_aaa\",\n" +
                "  \"bbb\" : \"value_bbb\"\n" +
                "}";

        System.out.println(new ObjectMapper().readValue(jsonStr, Test.class));
    }
}
  • 执行结果如下,可见aaa、bbb都被放入了map中:
Test{
   
   field0='null', map={
   
   aaa=value_aaa, field0=000, bbb=value_bbb}}
  • 另外JsonAnySetter还可以作用在成员变量上,上面的代码中,去掉setValue方法,在成员变量map上增加JsonAnySetter注解,修改后如下,执行结果也是一模一样的:
    static class Test {
   
   

        private String field0;

        @JsonAnySetter
        private Map<String, Object> map = new HashMap<>();

        @Override
        public String toString() {
   
   
            return "Test{" +
                    "field0='" + field0 + '\'' +
                    ", map=" + map +
                    '}';
        }
    }
  • 注意,JsonAnySetter作用在成员变量上时,该成员变量必须是java.util.Map的实现类

  • 至此,Jackson常用注解已全部实战完毕,希望这些丰富的注解能助您制定出各种灵活的序列化和反序列化策略;

欢迎关注博客园:程序员欣宸

学习路上,你不孤单,欣宸原创一路相伴...

相关文章
|
Linux 数据库 Nacos
Linux部署nacos启动提示No DataSource set处理办法
Linux部署nacos启动提示No DataSource set处理办法
1090 0
Linux部署nacos启动提示No DataSource set处理办法
ly~
|
11月前
|
存储 安全 数据库
密码管理器哪个比较好用?
介绍几款常用的密码管理器:Bitwarden功能全面、价格合理,适合个人用户;KeePass高度安全、免费开源,但数据同步不便;LastPass界面友好、跨平台支持好,曾有安全事件;1Password安全性高、用户体验佳,价格偏高;ProtonPass隐私保护强,功能实用,适合Proton生态用户。
ly~
1669 9
|
12月前
|
JavaScript 前端开发 数据安全/隐私保护
混淆指定js文件
【9月更文挑战第26天】JavaScript 混淆旨在保护代码知识产权、减小文件体积和提高安全性。方法包括变量名和函数名混淆、代码压缩、控制流平坦化及字符串加密。常用工具如 UglifyJS 和 JScrambler 可实现这些功能。然而,混淆可能带来兼容性和调试困难等问题,需谨慎使用并确保法律合规。
194 5
|
编解码 Dubbo NoSQL
由浅入深理解RPC架构设计
🌴🌴经常听到大家说不同项目之间调用使用HTTP方式,同一个项目内不同服务之间调用使用RPC方式。今天就来学习一下`RPC框架`,RPC框架由哪些部分组成又是如何一步一步设计出来的。
838 0
由浅入深理解RPC架构设计
|
JSON 前端开发 网络协议
【小家Spring】高性能关键技术之---体验Spring MVC的异步模式(ResponseBodyEmitter、SseEmitter、StreamingResponseBody) 高级使用篇
【小家Spring】高性能关键技术之---体验Spring MVC的异步模式(ResponseBodyEmitter、SseEmitter、StreamingResponseBody) 高级使用篇
【小家Spring】高性能关键技术之---体验Spring MVC的异步模式(ResponseBodyEmitter、SseEmitter、StreamingResponseBody) 高级使用篇
|
JavaScript 前端开发 API
Vue.js:构建现代化Web应用的灵活选择
Vue.js:构建现代化Web应用的灵活选择
372 0
|
Kubernetes Linux Shell
Linux k8s Kubernetes All-in-One 模式安装 KubeSphere 详细教程
Linux k8s Kubernetes All-in-One 模式安装 KubeSphere 详细教程
|
负载均衡 应用服务中间件 nginx
Nginx简介与Docker Compose部署指南
Nginx是一款高性能的开源Web服务器和反向代理服务器,以其卓越的性能、可伸缩性和灵活性而闻名。它在全球范围内广泛用于托管Web应用程序、负载均衡、反向代理和更多场景中。在本文中,我们将首先介绍Nginx的基本概念,然后演示如何使用Docker Compose轻松部署Nginx服务器。
1006 0
Nginx简介与Docker Compose部署指南
|
消息中间件 Java Kafka
Apache Kafka - 灵活控制Kafka消费_动态开启/关闭监听实现
Apache Kafka - 灵活控制Kafka消费_动态开启/关闭监听实现
1565 1
|
关系型数据库 数据库 PostgreSQL
flink postgresql cdc实时同步(含pg安装配置等)
flink postgresql cdc实时同步(含pg安装配置等)
994 0