赞
踩
XML这种数据格式。XML的特点是功能全面,但标签繁琐,格式复杂。在Web上使用XML现在越来越少,取而代之的是JSON这种数据结构。
JSON是JavaScript Object Notation的缩写,它去除了所有JavaScript执行代码,只保留JavaScript的对象格式。典型的JSON如下:
- {
-
- "ID": 1001,
-
- "name": "张三",
-
- }
- /*
- 特点:
- 数据在花括号中数据以"键:值"对的形式出现(其中键多以字符串形式出现,值可取字符串,数值,甚至其他json对象)
- 每两个"键:值"对以逗号分隔(最后一个"键:值"对省略逗号)
- */
- {
-
- "部门名称":"研发部",
-
- "部门成员":[
-
- {"ID": 1001, "name": "张三", "age": 24},
-
- {"ID": 1002, "name": "李四", "age": 25},
-
- {"ID": 1003, "name": "王五", "age": 22}],
-
- "部门位置":"xx楼21号"
-
- }
JSON字符串也是在平时开发中使用较多的,json字符串应满足以下条件:
1:它必须是一个字符串,由" "或者' '包裹数据,支持字符串的各种操作
2:里面的数据格式应该要满足其中一个格式,可以是json对象,也可以是json对象数组或者是两种基本形式的组合变形。
JSON作为数据传输的格式,有几个显著的优点:
\
转义,格式简单;开发Web应用的时候,使用JSON作为数据传输,在浏览器端非常方便。因为JSON天生适合JavaScript处理,所以,绝大多数REST API都选择JSON作为数据传输格式
1.json字符串转成对象, 使用json.parse(jsonStr)
2.json格式对象转成json格式字符串,使用JSON.stringify(jsonObj);
var jsonObj = {"name":"张三","age":14};
使用JSON.stringify(jsonObj);
在Java中,针对JSON也有标准的JSR 353 API,但是我们在前面讲XML的时候发现,如果能直接在XML和JavaBean之间互相转换是最好的。类似的,如果能直接在JSON和JavaBean之间转换,那么用起来就简单多了。
常用的用于解析JSON的第三方库有:
在fastjson包中主要有3个类,JSON,JSONArray,JSONObject
三者之间的关系如下,JSONObject和JSONArray继承JSON
JSONObject代表json对象,
JSONArray代表json对象数组,
JSON代表JSONObject和JSONArray的转化。
JSONObject类使用
JSONObject实现了Map接口,而json对象中的数据都是以"键:值"对形式出现, JSONObject底层操作是由Map实现的。类中主要是get()方法。JSONObject相当于json对象,该类中主要封装了各种get方法,通过"键:值"对中的键来获取其对应的值。
JSONArray类使用
JSONArray的内部是通过List接口中的方法来完成操作的。JSONArray代表json对象数组,json数组对象中存储的是一个个json对象,所以类中的方法主要用于直接操作json对象。比如其中的add(),remove(),containsAll()方法,对应于json对象的添加,删除与判断。 其内部主要由List接口中的对应方法来实现。
跟JSONObject一样,JSONArray里面也有一些get()方法,不过不常用,最有用的应该是getJSONObject(int index)方法,该方法用于获取json对象数组中指定位置的JSONObject对象,配合size()方法,可用于遍历json对象数组中的各个对象。 通过以上两个方法,在配合for循环,即可实现json对象数组的遍历。此外JSONArray中也实现了迭代器方法来遍历。 通过遍历得到JSONObject对象,然后再利用JSONObject类中的get()方法,即可实现最终json数据的获取。
JSON类使用
JSON类主要是实现转化用的,最后的数据获取,还是要通过JSONObject和JSONArray来实现。类中的主要是实现json对象,json对象数组,javabean对象,json字符串之间的相互转化。
json字符串—》JSONObject
用JSON.parseObject()方法即可将JSon字符串转化为JSON对象,利用JSONObject中的get()方法来获取JSONObject中的相对应的键对应的值
- //json格式数据---对象类型
- String JSON_OBJ_STR = "{\"studentName\":\"lily\",\"studentAge\":12}";
- JSONObject jsonObject = JSON.parseObject(JSON_OBJ_STR);
- System.out.println("StudentName: " + jsonObject.getString("studentName") + "," + "StudentAge: " + jsonObject.getInteger("studentAge"));
JSONObject—》json字符串
用JSON.toJSONString()方法即可将JSON对象转化为JSON字符串
JSON字符串数组—》JSONArray
将JSON字符串数组转化为JSONArray,通过JSON的parseArray()方法。JSONArray本质上还是一个数组,对其进行遍历取得其中的JSONObject,然后再利用JSONObject的get()方法取得其中的值。有两种方式进行遍历
方式一:通过jsonArray.size()获取JSONArray中元素的个数,再通过getJSONObject(index)获取相应位置的JSONObject,循环变量取得JSONArray中的JSONObject,再利用JSONObject的get()进行取值。
方式二:通过jsonArray.iterator()获取迭代器
- JSON_ARRAY_STR = " [{\"studentName\":\"lily\",\"studentAge\":12}," +
- "{\"studentName\":\"lucy\",\"studentAge\":15}]";
- JSONArray jsonArray = JSON.parseArray(JSON_ARRAY_STR);
- // 遍历方式一
- // int size = jsonArray.size();
- // for(int i = 0;i < size;i++){
- // JSONObject jsonObject = jsonArray.getJSONObject(i);
- // System.out.println("studentName: " + jsonObject.getString("studentName") + ",StudentAge: " + jsonObject.getInteger("studentAge"));
- // }
- // 遍历方式二
- Iterator<Object> iterator = jsonArray.iterator();
- while (iterator.hasNext()){
- JSONObject jsonObject = (JSONObject) iterator.next();
- System.out.println("studentName: " + jsonObject.getString("studentName") + ",StudentAge: " + jsonObject.getInteger("studentAge"));
- }
JSONArray—》json字符串
用JSON.toJSONString()方法即可将JSONArray转化为JSON字符串
json字符串—》JavaBean
- String JSON_OBJ_STR = "{\"studentName\":\"lily\",\"studentAge\":12}";
- // 第一种方式
- JSONObject jsonObject = JSON.parseObject(JSON_OBJ_STR);
- String studentName = jsonObject.getString("studentName");
- Integer studentAge = jsonObject.getInteger("studentAge");
- Student student = new Student(studentName, studentAge);
- // 第二种方式,//第二种方式,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
- Student student1 = JSON.parseObject(JSON_OBJ_STR, new TypeReference<Student>() {});
- // 第三种方式,通过反射,建议这种方式
- Student student2 = JSON.parseObject(JSON_OBJ_STR, Student.class);
JavaBean —》json字符串
也是通过JSON的toJSONString,不管是JSONObject、JSONArray还是JavaBean转为为JSON字符串都是通过JSON的toJSONString方法。
- Student lily = new Student("lily", 12);
- String s = JSON.toJSONString(lily);
json字符串数组—》JavaBean-List
- JSON_ARRAY_STR = " [{\"studentName\":\"lily\",\"studentAge\":12}," +
- "{\"studentName\":\"lucy\",\"studentAge\":15}]";
- // 方式一:
- JSONArray jsonArray = JSON.parseArray(JSON_ARRAY_STR);
- //遍历JSONArray
- List<Student> students = new ArrayList<Student>();
- Iterator<Object> iterator = jsonArray.iterator();
- while (iterator.hasNext()){
- JSONObject next = (JSONObject) iterator.next();
- String studentName = next.getString("studentName");
- Integer studentAge = next.getInteger("studentAge");
- Student student = new Student(studentName, studentAge);
- students.add(student);
- }
- // 方式二,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
- List<Student> studentList = JSON.parseObject(JSON_ARRAY_STR,new TypeReference<ArrayList<Student>>() {});
- // 方式三,使用反射
- List<Student> students1 = JSON.parseArray(JSON_ARRAY_STR, Student.class);
- System.out.println(students1);
JavaBean-List —》json字符串数组
JavaBean_List到json字符串-数组类型的转换,直接调用JSON.toJSONString()方法即可
复杂嵌套json格式字符串—》JavaBean_obj
对于复杂嵌套的JSON格式,利用JavaBean进行转换的时候要注意:
有几个JSONObject就定义几个JavaBean
内层的JSONObject对应的JavaBean作为外层JSONObject对应的JavaBean的一个属性
- public class Student {
- private String studentName;
- private int studentAge;
-
- public Student() {
- }
-
- public Student(String studentName, int studentAge) {
- this.studentName = studentName;
- this.studentAge = studentAge;
- }
-
- public String getStudentName() {
- return studentName;
- }
-
- public void setStudentName(String studentName) {
- this.studentName = studentName;
- }
-
- public int getStudentAge() {
- return studentAge;
- }
-
- public void setStudentAge(int studentAge) {
- this.studentAge = studentAge;
- }
-
- @Override
- public String toString() {
- return "Student{" +
- "studentName='" + studentName + '\'' +
- ", studentAge=" + studentAge +
- '}';
- }
- }
-
-
-
-
- import java.util.List;
-
- public class Teacher {
- private String teacherName;
- private int teacherAge;
- private Course course;
- private List<Student> students;
-
- public Teacher() {
- }
-
- public Teacher(String teacherName, int teacherAge, Course course, List<Student> students) {
- this.teacherName = teacherName;
- this.teacherAge = teacherAge;
- this.course = course;
- this.students = students;
- }
-
- public String getTeacherName() {
- return teacherName;
- }
-
- public void setTeacherName(String teacherName) {
- this.teacherName = teacherName;
- }
-
- public int getTeacherAge() {
- return teacherAge;
- }
-
- public void setTeacherAge(int teacherAge) {
- this.teacherAge = teacherAge;
- }
-
- public Course getCourse() {
- return course;
- }
-
- public void setCourse(Course course) {
- this.course = course;
- }
-
- public List<Student> getStudents() {
- return students;
- }
-
- public void setStudents(List<Student> students) {
- this.students = students;
- }
-
- @Override
- public String toString() {
- return "Teacher{" +
- "teacherName='" + teacherName + '\'' +
- ", teacherAge=" + teacherAge +
- ", course=" + course +
- ", students=" + students +
- '}';
- }
- }
-
-
-
- public class Course {
- private String courseName;
- private int code;
-
- public Course() {
- }
-
- public Course(String courseName, int code) {
- this.courseName = courseName;
- this.code = code;
- }
-
- public String getCourseName() {
- return courseName;
- }
-
- public void setCourseName(String courseName) {
- this.courseName = courseName;
- }
-
- public int getCode() {
- return code;
- }
-
- public void setCode(int code) {
- this.code = code;
- }
-
- @Override
- public String toString() {
- return "Course{" +
- "courseName='" + courseName + '\'' +
- ", code=" + code +
- '}';
- }
- }
-
-
- //第一种方式,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
- Teacher teacher = JSON.parseObject(COMPLEX_JSON_STR, new TypeReference<Teacher>() {});
- // 第二种方式,使用反射
- Teacher teacher1 = JSON.parseObject(COMPLEX_JSON_STR, Teacher.class);
JavaBean_obj —》复杂json格式字符串
- Teacher teacher = JSON.parseObject(COMPLEX_JSON_STR, Teacher.class);
- String s = JSON.toJSONString(teacher);
备注:设置实体中的某个属性转json
Jackson 是当前用的比较广泛的,用来序列化和反序列化 json 的 Java 的开源框架。
Jackson 社区相对比较活跃,更新速度也比较快, 从 Github 中的统计来看,Jackson 是最流行的 json 解析器之一 。
Spring MVC 的默认 json 解析器便是 Jackson。
Jackson 优点很多。 Jackson 所依赖的 jar 包较少 ,简单易用。
与其他 Java 的 json 的框架 Gson 等相比, Jackson 解析大的 json 文件速度比较快
Jackson 运行时占用内存比较低,性能比较好
Jackson 有灵活的 API,可以很容易进行扩展和定制。
Jackson 的 1.x 版本的包名是 org.codehaus.jackson ,当升级到 2.x 版本时,包名变为 com.fasterxml.jackson。
Jackson可以解析JSON也可以解析xml
Jackson 的核心模块由三部分组成。
jackson-core,核心包,提供基于"流模式"解析的相关 API,它包括 JsonPaser 和 JsonGenerator。 Jackson 内部实现正是通过高性能的流模式 API 的 JsonGenerator 和 JsonParser 来生成和解析 json。
jackson-annotations,注解包,提供标准注解功能;
jackson-databind ,数据绑定包, 提供基于"对象绑定" 解析的相关 API ( ObjectMapper ) 和"树模型" 解析的相关 API (JsonNode);基于"对象绑定" 解析的 API 和"树模型"解析的 API 依赖基于"流模式"解析的 API。
源码地址:https://github.com/FasterXML/jackson
当然了,jackson-databind 依赖 jackson-core 和 jackson-annotations,所以可以只显示地添加jackson-databind依赖,jackson-core 和 jackson-annotations 也随之添加到 Java 项目工程中。
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.6</version>
</dependency>
使用下面的代码解析一个JSON文件:
- InputStream input = Main.class.getResourceAsStream("/book.json");
- ObjectMapper mapper = new ObjectMapper();
- // 反序列化时忽略不存在的JavaBean属性:
- mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
- Book book = mapper.readValue(input, Book.class);
核心代码是创建一个ObjectMapper
对象。关闭DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES
功能使得解析时如果JavaBean不存在该属性时解析不会报错。
把JSON解析为JavaBean的过程称为反序列化。如果把JavaBean变为JSON,那就是序列化。要实现JavaBean到JSON的序列化,只需要一行代码:
String json = mapper.writeValueAsString(book);
要把JSON的某些值解析为特定的Java对象,例如LocalDate
,也是完全可以的。例如:
- {
- "name": "Java核心技术",
- "pubDate": "2016-09-01"
- }
要解析为:
- public class Book {
- public String name;
- public LocalDate pubDate;
- }
只需要引入标准的JSR 310关于JavaTime的数据格式定义至Maven:
然后,在创建ObjectMapper
时,注册一个新的JavaTimeModule
:
ObjectMapper mapper = new ObjectMapper().registerModule(new JavaTimeModule());
有些时候,内置的解析规则和扩展的解析规则如果都不满足我们的需求,还可以自定义解析。
举个例子,假设Book
类的isbn
是一个BigInteger
:
- public class Book {
- public String name;
- public BigInteger isbn;
- }
但JSON数据并不是标准的整形格式:
- {
- "name": "Java核心技术",
- "isbn": "978-7-111-54742-6"
- }
直接解析,肯定报错。这时,我们需要自定义一个IsbnDeserializer
,用于解析含有非数字的字符串:
- public class IsbnDeserializer extends JsonDeserializer<BigInteger> {
- public BigInteger deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
- // 读取原始的JSON字符串内容:
- String s = p.getValueAsString();
- if (s != null) {
- try {
- return new BigInteger(s.replace("-", ""));
- } catch (NumberFormatException e) {
- throw new JsonParseException(p, s, e);
- }
- }
- return null;
- }
- }
然后,在Book
类中使用注解标注:
- public class Book {
- public String name;
- // 表示反序列化isbn时使用自定义的IsbnDeserializer:
- @JsonDeserialize(using = IsbnDeserializer.class)
- public BigInteger isbn;
- }
类似的,自定义序列化时我们需要自定义一个IsbnSerializer
,然后在Book
类中标注@JsonSerialize(using = ...)
即可。
反序列化
在反序列化时,Jackson要求Java类需要一个默认的无参数构造方法,否则,无法直接实例化此类。存在带参数构造方法的类,如果要反序列化,注意再提供一个无参数构造方法。
对于enum
字段,Jackson按String类型处理,即:
- class Book {
- public DayOfWeek start = MONDAY;
- }
序列化为:
- {
- "start": "MONDAY"
- }
对于record
类型,Jackson会自动找出它的带参数构造方法,并根据JSON的key进行匹配,可直接反序列化。对record
类型的支持需要版本2.12.0
以上。
使用详解参考
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。