首先介绍三个注解:
@JsonAutoDetect (method/field):作用于方法或字段,用来表明,当生成json的时候忽略有该annotation的方法或字段
@JsonIgnore 过滤不需要转成json的属性
@JsonIgnoreProperties 主要用于过滤掉一些不需要的属性
以上三个注解需要放在get方法前面才有效.
package com.sw.entity.base;import static javax.persistence.GenerationType.IDENTITY;import java.util.HashSet;import java.util.Set;import javax.persistence.CascadeType;import javax.persistence.Column;import javax.persistence.Entity;import javax.persistence.FetchType;import javax.persistence.GeneratedValue;import javax.persistence.Id;import javax.persistence.JoinColumn;import javax.persistence.ManyToOne;import javax.persistence.OneToMany;import javax.persistence.Table;import javax.persistence.Transient;import org.codehaus.jackson.annotate.JsonAutoDetect;import org.codehaus.jackson.annotate.JsonIgnore;/*** Menu entity. @author MyEclipse Persistence Tools*/@Entity@Table(name = "menu", catalog = "zhong")@JsonAutoDetectpublic class Menu implements java.io.Serializable {// Fields/*** */private static final long serialVersionUID = 1L;private Integer id;private Menu menu;private String icon;private String name;private Short seq;private String url;private String prem;private Set<Menu> menus = new HashSet<Menu>(0);// Constructors/**用于json输出的属性,不需要持久化;*/private String state = "open";/*********************************//** default constructor */public Menu() {}/** minimal constructor */public Menu(Integer id) {this.id = id;}/** full constructor *///省略构造器// Property accessors/**省略了一下不需要处理的get/set方法*/@JsonIgnore //标记该属性不需要转为 json@ManyToOne(fetch = FetchType.LAZY)@JoinColumn(name = "pid")public Menu getMenu() {return this.menu;}public void setMenu(Menu menu) {this.menu = menu;}@JsonIgnore //标记该属性不需要转为 json@OneToMany(cascade = CascadeType.ALL, fetch = FetchType.LAZY, mappedBy = "menu")public Set<Menu> getMenus() {return this.menus;}public void setMenus(Set<Menu> menus) {this.menus = menus;}/*jackson就是根据get方法来获取属性值的,如果持久化的属性值不符合你的要求,可以通过更改get方法来实现。比如说你的实体里有个set<xxx> xxx;的属性,如果按照jackson原本的计划,集合类型会被转为json数组,但你想把这个集合的内容转成字符串,那么就可以通过get方法返回字符。或者说按照你的要求返回任何东西。*///这个是为了树形结构菜单标记字段,加上此注解表示该字段不需要持久化实体到数据库@Transientpublic String getState() {if(this.getMenus()==null){state = "open";}else{state = "closed";}return state;}public void setState(String state) {this.state = state;}}
以下是转化代码:
List<Menu> menus = menuManager.getChildrenById(aid,"pid","seq",true); //从数据库取出listObjectMapper map = new ObjectMapper();//这是jackson的类库map.writeValue(Struts2Utils.getResponse().getWriter(),menus); //输出json 这样就把json
数据输出到浏览器客户端了。
以下是值:
[{"name":"dfdsf","id":1,"state":"closed","seq":999,"prem":"fsfsd","icon":"fff","url":"gfdsfds"},{"name":"fdsfds","id":2,"state":"closed","seq":999,"prem":"fsdf","icon":"fff","url":"efdsfsd"}]
jackson常用转化形式:writeValueAsString(value) 转化为StringwriteValueAsBytes(value) 转化为bytewriteValue(objec0,bean) 此方法用于直接输出json数据,objec0代表输出环境,可以是Response.getWriter()也可以是Outputstream.bean是要输出的数据,集合和单个bean都可以
Jackson快速入门
Java生态圈中有很多处理JSON和XML格式化的类库,Jackson是其中比较著名的一个。虽然JDK自带了XML处理类库,但是相对来说比较低级,使用本文介绍的Jackson等高级类库处理起来会方便很多。
引入类库
由于Jackson相关类库按照功能分为几个相对独立的,所以需要同时引入多个类库,为了方便我将版本号单独提取出来设置,相关Gradle配置如下。
ext {jacksonVersion = '2.9.5'}dependencies {compile group: 'com.fasterxml.jackson.core', name: 'jackson-core', version: jacksonVersioncompile group: 'com.fasterxml.jackson.core', name: 'jackson-databind', version: jacksonVersioncompile group: 'com.fasterxml.jackson.core', name: 'jackson-annotations', version: jacksonVersion// 引入XML功能compile group: 'com.fasterxml.jackson.dataformat', name: 'jackson-dataformat-xml', version: jacksonVersion// 比JDK自带XML实现更高效的类库compile group: 'com.fasterxml.woodstox', name: 'woodstox-core', version: '5.1.0'// Java 8 新功能compile group: 'com.fasterxml.jackson.datatype', name: 'jackson-datatype-jsr310', version: jacksonVersioncompile group: 'com.fasterxml.jackson.module', name: 'jackson-module-parameter-names', version: jacksonVersioncompile group: 'com.fasterxml.jackson.datatype', name: 'jackson-datatype-jdk8', version: jacksonVersioncompileOnly group: 'org.projectlombok', name: 'lombok', version: '1.16.22'}
Maven配置请去mvnrepository搜索。
Jackson注解
Jackson类库包含了很多注解,可以让我们快速建立Java类与JSON之间的关系。详细文档可以参考Jackson-Annotations。下面介绍一下常用的。
属性命名
@JsonProperty
注解指定一个属性用于JSON映射,默认情况下映射的JSON属性与注解的属性名称相同,不过可以使用该注解的value
值修改JSON属性名,该注解还有一个index
属性指定生成JSON属性的顺序,如果有必要的话。
属性包含
还有一些注解可以管理在映射JSON的时候包含或排除某些属性,下面介绍一下常用的几个。
@JsonIgnore
注解用于排除某个属性,这样该属性就不会被Jackson序列化和反序列化。
@JsonIgnoreProperties
注解是类注解。在序列化为JSON的时候,@JsonIgnoreProperties({"prop1", "prop2"})
会忽略pro1和pro2两个属性。在从JSON反序列化为Java类的时候,@JsonIgnoreProperties(ignoreUnknown=true)
会忽略所有没有Getter和Setter的属性。该注解在Java类和JSON不完全匹配的时候很有用。
@JsonIgnoreType
也是类注解,会排除所有指定类型的属性。
序列化相关
@JsonPropertyOrder
和@JsonProperty
的index
属性类似,指定属性序列化时的顺序。
@JsonRootName
注解用于指定JSON根属性的名称。
处理JSON
简单映射
我们用Lombok设置一个简单的Java类。
@Data@AllArgsConstructor@NoArgsConstructorpublic class Friend {private String nickname;private int age;}
然后就可以处理JSON数据了。首先需要一个ObjectMapper对象,序列化和反序列化都需要它。
ObjectMapper mapper = new ObjectMapper();Friend friend = new Friend("yitian", 25);// 写为字符串String text = mapper.writeValueAsString(friend);// 写为文件mapper.writeValue(new File("friend.json"), friend);// 写为字节流byte[] bytes = mapper.writeValueAsBytes(friend);System.out.println(text);// 从字符串中读取Friend newFriend = mapper.readValue(text, Friend.class);// 从字节流中读取newFriend = mapper.readValue(bytes, Friend.class);// 从文件中读取newFriend = mapper.readValue(new File("friend.json"), Friend.class);System.out.println(newFriend);
程序结果如下。可以看到生成的JSON属性和Java类中定义的一致。
{"nickname":"yitian","age":25}Friend(nickname=yitian, age=25)
集合的映射
除了使用Java类进行映射之外,我们还可以直接使用Map和List等Java集合组织JSON数据,在需要的时候可以使用readTree方法直接读取JSON中的某个属性值。需要注意的是从JSON转换为Map对象的时候,由于Java的类型擦除,所以类型需要我们手动用new TypeReference
给出。
ObjectMapper mapper = new ObjectMapper();Map<String, Object> map = new HashMap<>();map.put("age", 25);map.put("name", "yitian");map.put("interests", new String[]{"pc games", "music"});String text = mapper.writeValueAsString(map);System.out.println(text);Map<String, Object> map2 = mapper.readValue(text, new TypeReference<Map<String, Object>>() {});System.out.println(map2);JsonNode root = mapper.readTree(text);String name = root.get("name").asText();int age = root.get("age").asInt();System.out.println("name:" + name + " age:" + age);
程序结果如下。
{"name":"yitian","interests":["pc games","music"],"age":25}{name=yitian, interests=[pc games, music], age=25}name:yitian age:25
Jackson配置
Jackson预定义了一些配置,我们通过启用和禁用某些属性可以修改Jackson运行的某些行为。详细文档参考JacksonFeatures。下面我简单翻译一下Jackson README上列出的一些属性。
// 美化输出mapper.enable(SerializationFeature.INDENT_OUTPUT);// 允许序列化空的POJO类// (否则会抛出异常)mapper.disable(SerializationFeature.FAIL_ON_EMPTY_BEANS);// 把java.util.Date, Calendar输出为数字(时间戳)mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);// 在遇到未知属性的时候不抛出异常mapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);// 强制JSON 空字符串("")转换为null对象值:mapper.enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT);// 在JSON中允许C/C++ 样式的注释(非标准,默认禁用)mapper.configure(JsonParser.Feature.ALLOW_COMMENTS, true);// 允许没有引号的字段名(非标准)mapper.configure(JsonParser.Feature.ALLOW_UNQUOTED_FIELD_NAMES, true);// 允许单引号(非标准)mapper.configure(JsonParser.Feature.ALLOW_SINGLE_QUOTES, true);// 强制转义非ASCII字符mapper.configure(JsonGenerator.Feature.ESCAPE_NON_ASCII, true);// 将内容包裹为一个JSON属性,属性名由@JsonRootName注解指定mapper.configure(SerializationFeature.WRAP_ROOT_VALUE, true);
这里有三个方法,configure方法接受配置名和要设置的值,Jackson 2.5版本新加的enable和disable方法则直接启用和禁用相应属性,我推荐使用后面两个方法。
用注解管理映射
前面介绍了一些Jackson注解,下面来应用一下这些注解。首先来看看使用了注解的Java类。
@Data@NoArgsConstructor@AllArgsConstructor@JsonRootName("FriendDetail")@JsonIgnoreProperties({"uselessProp1", "uselessProp3"})public class FriendDetail {@JsonProperty("NickName")private String name;@JsonProperty("Age")private int age;private String uselessProp1;@JsonIgnoreprivate int uselessProp2;private String uselessProp3;}
然后看看代码。需要注意的是,由于设置了排除的属性,所以生成的JSON和Java类并不是完全对应关系,所以禁用DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES
是必要的。
ObjectMapper mapper = new ObjectMapper();//mapper.enable(SerializationFeature.WRAP_ROOT_VALUE);mapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);FriendDetail fd = new FriendDetail("yitian", 25, "", 0, "");String text = mapper.writeValueAsString(fd);System.out.println(text);FriendDetail fd2 = mapper.readValue(text, FriendDetail.class);System.out.println(fd2);
运行结果如下。可以看到生成JSON的时候忽略了我们制定的值,而且在转换为Java类的时候对应的属性为空。
{"NickName":"yitian","Age":25}FriendDetail(name=yitian, age=25, uselessProp1=null, uselessProp2=0, uselessProp3=null)
然后取消注释代码中的那行,也就是启用WRAP_ROOT_VALUE
功能,再运行一下程序,运行结果如下。可以看到生成的JSON结果发生了变化,而且由于JSON结果变化,所以Java类转换失败(所有字段值全为空)。WRAP_ROOT_VALUE
这个功能在有些时候比较有用,因为有些JSON文件需要这种结构。
{"FriendDetail":{"NickName":"yitian","Age":25}}FriendDetail(name=null, age=0, uselessProp1=null, uselessProp2=0, uselessProp3=null)
Java8日期时间类支持
Java8增加了一套全新的日期时间类,Jackson对此也有支持。这些支持是以Jackson模块形式提供的,所以首先就是注册这些模块。
ObjectMapper mapper = new ObjectMapper().registerModule(new JavaTimeModule()).registerModule(new ParameterNamesModule()).registerModule(new Jdk8Module());
导入类库之后,Jackson也可以自动搜索所有模块,不需要我们手动注册。
mapper.findAndRegisterModules();
我们新建一个带有LocalDate字段的Java类。
@Data@NoArgsConstructor@AllArgsConstructor@JsonRootName("Person")public class Person {@JsonProperty("Name")private String name;@JsonProperty("NickName")private String nickname;@JsonProperty("Age")private int age;@JsonProperty("IdentityCode")private String identityCode;@JsonProperty@JsonFormat(pattern = "yyyy-MM-DD")private LocalDate birthday;}
然后来看看代码。
static void java8DateTime() throws IOException {Person p1 = new Person("yitian", "易天", 25, "10000", LocalDate.of(1994, 1, 1));ObjectMapper mapper = new ObjectMapper().registerModule(new JavaTimeModule());//mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);String text = mapper.writeValueAsString(p1);System.out.println(text);Person p2 = mapper.readValue(text, Person.class);System.out.println(p2);}
运行结果如下。可以看到,生成的JSON日期变成了[1994,1,1]这样的时间戳形式,一般情况下不符合我们的要求。
{"birthday":[1994,1,1],"Name":"yitian","NickName":"易天","Age":25,"IdentityCode":"10000"}Person(name=yitian, nickname=易天, age=25, identityCode=10000, birthday=1994-01-01)
取消注释那行代码,程序运行结果如下。这样一来就变成了我们一般使用的形式了。如果有格式需要的话,可以使用@JsonFormat(pattern = "yyyy-MM-DD")
注解格式化日期显示。
{"birthday":"1994-01-01","Name":"yitian","NickName":"易天","Age":25,"IdentityCode":"10000"}Person(name=yitian, nickname=易天, age=25, identityCode=10000, birthday=1994-01-01)
处理XML
Jackson是一个处理JSON的类库,不过它也通过jackson-dataformat-xml
包提供了处理XML的功能。Jackson建议我们在处理XML的时候使用woodstox-core
包,它是一个XML的实现,比JDK自带XML实现更加高效,也更加安全。
这里有个注意事项,如果你正在使用Java 9以上的JDK,可能会出现java.lang.NoClassDefFoundError: javax/xml/bind/JAXBException
异常,这是因为Java 9实现了JDK的模块化,将原本和JDK打包在一起的JAXB实现分隔出来。所以这时候需要我们手动添加JAXB的实现。在Gradle中添加下面的代码即可。
compile group: 'javax.xml.bind', name: 'jaxb-api', version: '2.3.0'
注解
Jackson XML除了使用Jackson JSON和JDK JAXB的一些注解之外,自己也定义了一些注解。下面简单介绍一下几个常用注解。
@JacksonXmlProperty
注解有三个属性,namespace和localname属性用于指定XML命名空间的名称,isAttribute指定该属性作为XML的属性(<a b="xxx"></a>
)还是作为子标签(<a><b></b></a>
).
@JacksonXmlRootElement
注解有两个属性,namespace和localname属性用于指定XML根元素命名空间的名称。
@JacksonXmlText
注解将属性直接作为未被标签包裹的普通文本表现。
@JacksonXmlCData
将属性包裹在CDATA标签中。
XML映射
新建如下一个Java类。
@Data@NoArgsConstructor@AllArgsConstructor@JsonRootName("Person")public class Person {@JsonProperty("Name")private String name;@JsonProperty("NickName")//@JacksonXmlTextprivate String nickname;@JsonProperty("Age")private int age;@JsonProperty("IdentityCode")@JacksonXmlCDataprivate String identityCode;@JsonProperty("Birthday")//@JacksonXmlProperty(isAttribute = true)@JsonFormat(pattern = "yyyy/MM/DD")private LocalDate birthday;}
下面是代码示例,基本上和JSON的API非常相似,XmlMapper
实际上就是ObjectMapper
的子类。
Person p1 = new Person("yitian", "易天", 25, "10000", LocalDate.of(1994, 1, 1));XmlMapper mapper = new XmlMapper();mapper.findAndRegisterModules();mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);mapper.enable(SerializationFeature.INDENT_OUTPUT);String text = mapper.writeValueAsString(p1);System.out.println(text);Person p2 = mapper.readValue(text, Person.class);System.out.println(p2);
运行结果如下。
<Person><Name>yitian</Name><NickName>易天</NickName><Age>25</Age><IdentityCode><![CDATA[10000]]></IdentityCode><Birthday>1994/01/01</Birthday></Person>Person(name=yitian, nickname=易天, age=25, identityCode=10000, birthday=1994-01-01)
如果取消那两行注释,那么运行结果如下。可以看到Jackson XML注解对生成的XML的控制效果。
<Person birthday="1994/01/01"><Name>yitian</Name>易天<Age>25</Age><IdentityCode><![CDATA[10000]]></IdentityCode></Person>Person(name=yitian, nickname=null, age=25, identityCode=10000, birthday=1994-01-01)
Spring Boot集成
自动配置
Spring Boot对Jackson的支持非常完善,只要我们引入相应类库,Spring Boot就可以自动配置开箱即用的Bean。Spring自动配置的ObjectMapper(或者XmlMapper)作了如下配置,基本上可以适应大部分情况。
禁用了MapperFeature.DEFAULT_VIEW_INCLUSION禁用了DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES禁用了SerializationFeature.WRITE_DATES_AS_TIMESTAMPS
如果需要修改自动配置的ObjectMapper属性也非常简单,Spring Boot提供了一组环境变量,直接在application.properties文件中修改即可。
由于Spring会同时配置相应的HttpMessageConverters,所以我们其实要做的很简单,用Jackson注解标注好要映射的Java类,然后直接让控制器返回对象即可!下面是一个Java类。
@JsonRootName("person")public class Person {@JsonPropertyprivate String name;@JsonPropertyprivate int id;@JsonFormat(pattern = "yyyy-MM-DD")private LocalDate birthday;public Person(String name, int id, LocalDate birthday) {this.name = name;this.id = id;this.birthday = birthday;}}
然后是控制器代码。在整个过程中我们只需要引入Jackson类库,然后编写业务代码就好了。关于如何配置Jackson类库,我们完全不需要管,这就是Spring Boot的方便之处。
@Controllerpublic class MainController {private Person person = new Person("yitian", 10000, LocalDate.of(1994, 1, 1));@RequestMapping("/")public String index() {return "index";}@RequestMapping(value = "/json", produces = "application/json")@ResponseBodypublic Person json() {return person;}}
进入localhost:8080/xml就可以看到对应结果了。
结果
手动配置
Spring Boot自动配置非常方便,但不是万能的。在必要的时候,我们需要手动配置Bean来替代自动配置的Bean。
@Configurationpublic class JacksonConfig {@Bean@Primary@Qualifier("xml")public XmlMapper xmlMapper(Jackson2ObjectMapperBuilder builder) {XmlMapper mapper = builder.createXmlMapper(true).build();mapper.enable(SerializationFeature.INDENT_OUTPUT);mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);return mapper;}@Bean@Qualifier("json")public ObjectMapper jsonMapper(Jackson2ObjectMapperBuilder builder) {ObjectMapper mapper = builder.createXmlMapper(false).build();mapper.enable(SerializationFeature.INDENT_OUTPUT);mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);return mapper;}}
然后在需要的地方进行依赖注入。需要注意为了区分ObjectMapper和XmlMapper,需要使用@Qualifier
注解进行标记。
@Controllerpublic class MainController {private ObjectMapper jsonMapper;private XmlMapper xmlMapper;private Person person = new Person("yitian", 10000, LocalDate.of(1994, 1, 1));public MainController(@Autowired @Qualifier("json") ObjectMapper jsonMapper, @Autowired @Qualifier("xml") XmlMapper xmlMapper) {this.jsonMapper = jsonMapper;this.xmlMapper = xmlMapper;}
以上就是Jackson类库的一些介绍,希望对大家有所帮助。