当前位置: 代码网 > it编程>编程语言>Java > Java中@JSONField和@JsonProperty注解的用法及区别详解

Java中@JSONField和@JsonProperty注解的用法及区别详解

2024年06月17日 Java 我要评论
前言@jsonfield注解是阿里巴巴的fastjson框架中的注解,用于指定json字符串中的属性名和java对象中的属性名之间的映射关系@jsonproperty注解是jackson框架中的注解,

前言

@jsonfield注解是阿里巴巴的fastjson框架中的注解,用于指定json字符串中的属性名和java对象中的属性名之间的映射关系

@jsonproperty注解是jackson框架中的注解,用法类似于@jsonfield,也是指定json字符串中的属性名和java对象中的属性名之间的映射关系

一、@jsonfield

@jsonfield注解是阿里巴巴的fastjson框架中的注解,用于指定json字符串中的属性名和java对象中的属性名之间的映射关系

1、name属性

通过name属性可以指定将java对象中的属性名映射为json对象中的属性名。默认情况下,json对象中的属性名与java对象中的属性名相同

import com.alibaba.fastjson.json;
import com.alibaba.fastjson.annotation.jsonfield;
import lombok.data;

public class test1controller {
    public static void main(string[] args) {
        string str = "{\"id\":11,\"name\":\"张三\"}";

        user user = json.parseobject(str, user.class);
        system.out.println("user对象:" + user.tostring());
    }
}

@data
class user {
    @jsonfield(name = "id")
    private integer userid;
    @jsonfield(name = "name")
    private string username;

    @override
    public string tostring() {
        return "user{" +
                "userid=" + userid +
                ", username='" + username + '\'' +
                '}';
    }
}

2、format属性

通过format属性可以指定日期类型属性的格式,以及将数字类型转为字符串类型的格式

public class user {
    @jsonfield(format = "yyyy-mm-dd")
    private date birthday;
    @jsonfield(format = "#,###.00")
    private double salary;
}

3、serialize属性

通过serialize属性可以控制属性是否序列化到json对象中

当serialize属性为false时,属性将不会序列化到json对象中,默认为true

public class user {
    @jsonfield(serialize = false)
    private int userid;
    private string name;
    private int age;
}

使用@jsonfield注解将userid属性从序列化中排除

4、deserialize属性

通过deserialize属性可以控制是否将json对象中的属性反序列化到java对象中

当deserialize属性为false时,该属性将不会从json对象中反序列化到java对象中,默认为true

public class user {
    private int userid;
    private string name;
    @jsonfield(deserialize = false)
    private int age;
}

使用@jsonfield注解将age属性从反序列化中排除

5、ordinal属性

通过ordinal属性可以指定属性的顺序

默认情况下,属性的顺序是按照属性在java对象中的顺序排列的

public class user {
    @jsonfield(ordinal = 2)
    private string name;
    @jsonfield(ordinal = 1)
    private int age;
}

使用@jsonfield注解指定了age属性的顺序为1,name属性的顺序为2

6、defaultvalue属性

通过defaultvalue属性可以指定属性在java对象中的默认值

public class user {
    @jsonfield(defaultvalue = "0")
    private int userid;
    @jsonfield(defaultvalue = "n/a")
    private string name;
    private int age;
}

使用@jsonfield注解指定了userid属性的默认值为0,name属性的默认值为“n/a”

7、type属性

通过type属性可以指定属性的类型

public class user {
    private int userid;
    @jsonfield(type = fieldtype.string)
    private int age;
}

使用@jsonfield注解指定了age属性的类型为字符串类型

8、jsondirect属性

通过jsondirect属性可以指定属性是否应该直接输出为json字符串

默认情况下,属性将被转化为字符串并以引号标记输出

public class user {
    private string name;
    @jsonfield(jsondirect = true)
    private string jsonmessage;
}

使用@jsonfield注解指定了jsonmessage属性应该直接输出为json字符串

9、parsefeatures属性和serializefeatures属性

通过parsefeatures属性和serializefeatures属性可以配置解析和序列化时的特性

具体可参考阿里巴巴fastjson的文档

public class user {
    private string name;
    private int age;
    @jsonfield(parsefeatures = feature.allowsinglequotes)
    private string message;
}

二、@jsonproperty

@jsonproperty注解是jackson框架中的注解,用法类似于@jsonfield,也是指定json字符串中的属性名和java对象中的属性名之间的映射关系

1、value

value属性用于指定序列化后的属性名称

如果未提供value属性,则属性名称默认与java属性名称相同

public class person {
    @jsonproperty("name")
    private string fullname;
}

将java对象中fullname属性序列化为json对象中的"name"属性

2、defaultvalue

defaultvalue属性用于指定当java对象属性值为null时,序列化为json时使用的默认值

该属性仅适用于对象属性而不适用于基本类型属性

public class person {
    @jsonproperty(defaultvalue = "john")
    private string firstname;
}

将未设置firstname的person对象序列化为含有默认值"john"的json属性

3、access

access属性用于指定java属性的访问级别

默认访问级别为public,也可以设为read_only或write_only

public class person {
    @jsonproperty(access = jsonproperty.access.write_only)
    private string password;
}

将java对象中的password属性序列化为json时忽略掉

4、required

required属性指定此属性是否为必须字段

如果为true,则当将json转换回java对象时,如果该属性不存在,则将引发异常

public class person {
    @jsonproperty(required = true)
    private string name;
}

将java对象中的name属性序列化为确保其在json对象中存在

5、defaultvalue

defaultvalue属性用于指定java属性的默认值

在将json转换回java对象时如果该属性不存在或为null,则使用默认值

public class person {
    @jsonproperty(defaultvalue = "30")
    private int age;
}

将java对象中的age属性序列化为json时,如果该属性不存在,则使用默认值30

6、index

index属性用于指定序列化的属性在json对象中的位置,数值越小,位置越靠前

public class person {
    @jsonproperty(index = 1)
    private string firstname;
    @jsonproperty(index = 0)
    private string lastname;
}

将java对象中的lastname属性序列化为json对象中的第一个属性,firstname属性序列化为json对象中的第二个属性

7、accessmode

accessmode属性用于指定序列化时使用的访问模式

如果未指定,则默认为propety模式,即访问getter方法获取属性值。另一个可用的模式是field,即直接访问java属性

public class user {
    private string firstname;
    @jsonproperty(access = jsonproperty.access.read_only, accessmode = jsonproperty.accessmode.field)
    private string lastname;
}

将java对象中lastname属性序列化为json属性,直接访问java属性值。

8、ignore

ignore属性用于指定是否忽略该属性

如果为true,则在序列化和反序列化时忽略该属性

public class user{
    private string firstname;
    @jsonproperty(ignore = true)
    private string lastname;
}

将java对象中的lastname属性忽略掉,不进行序列化和反序列化

三、@jsonfield和@jsonproperty区别

1、@jsonfield注解的使用方式更加简单,注解默认的值与属性名相同,而@jsonproperty需要手动指定属性名

2、@jsonfield注解支持更多的属性映射选项,例如序列化时的日期格式,空值的处理方式等

3、@jsonfield注解的性能较快,因为fastjson本身就是一款高性能的json处理库

4、在使用jackson框架时,只能使用@jsonproperty注解,无法使用@jsonfield注解!!!不然会导致解析失败,无法取到值,如下

import com.alibaba.fastjson.json;
import com.fasterxml.jackson.annotation.jsonproperty;
import lombok.data;

public class test1controller {
    public static void main(string[] args) {
        string str = "{\"id\":11,\"name\":\"张三\"}";

        user user = json.parseobject(str, user.class);
        system.out.println("user对象:" + user.tostring());
    }
}

@data
class user {
    @jsonproperty("id")
    private integer userid;
    @jsonproperty("name")
    private string username;

    @override
    public string tostring() {
        return "user{" +
                "userid=" + userid +
                ", username='" + username + '\'' +
                '}';
    }
}

总结 

到此这篇关于java中@jsonfield和@jsonproperty注解的用法及区别的文章就介绍到这了,更多相关java @jsonfield和@jsonproperty注解内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com