小水滴

readme

多层XML对象数据的反序列化处理过程

需求分析

小水滴公司正在开发小水滴校园管理系统。其中一个重要的功能是管理和维护学生的信息和当前状态。为了将学生信息保存在文件系统中，小水滴校园管理系统需要将内存中保存的学生对象首先转化为XML字符串，然后再存放在文件中。当需要使用学生信息时，再将其从文件中读取出来，转化为学生对象。本项目练习的是从文件中读取学生对象的一个步骤。

学生对象的定义在com.littlewaterdrop.bean包中的Student.java文件中。该类包含三个成员变量，它们分别是(1) name，字符串类型；(2) age，整数类型；和(3) major，字符串类型。

package com.littlewaterdrop.bean;

public class Student {
    private String name = null;
    private Integer age = null;
    private String major = null;

    // 需要定义更多的成员变量，以表示该学生完成的课程信息
    ...
}

但是，现在项目有了新的需求，在学生对象中需要包含学生已完成课程的信息。因此，在项目com.littlewaterdrop.bean包中新增了Course类，用于表示课程信息。该类包含了四个成员变量，它们分别是(1) id，长整数类型；(2) name，字符串类型；(3) credits，单精度浮点数类型；和(4) hours，整数类型；分别用于表示课程的编号、名称、学分数和课时数。

package com.littlewaterdrop.bean;

public class Course {
    private Long id = null;  // 课程编号
    private String name = null;  // 课程名称
    private Float credits = null;  // 课程学分数
    private Integer hours = null;  // 课程课时数
    ...
}

在单层对象数据反序列化项目中，已实现了StudentInfoLoader::loadStudent()方法。因此，在本项目中，该文件的内容不再需要修改。学员需要在Student.java文件中，为Student对象添加新的成员变量，以便于能将表示学生信息的XML字符串转换为Student对象。

package com.littlewaterdrop;

public class StudentInfoLoader {
    public Student loadStudent(InputStream stream) {
        if (stream == null) {
            return null;
        }
        
        try {
            ObjectMapper mapper = new ObjectMapper();
            Student theStudent = mapper.readValue(stream, Student.class);
            return theStudent;
        } catch (Exception ex) {
            // Something happened.
            System.err.println(ex.getMessage());
            return null;
        } finally {
            try {
                stream.close();
            } catch (Exception ex) {}
        }
    }
}

以下是一个XML字符串的用例。注意，一名学生可能已完成多门课程的学习，但是XML格式不支持数组。因此，在下面的例子中， Student标签包含了多个course子标签。提示：本项目可在Student类中添加一个List类型的成员变量，表示已完成的课程。这个List对象正好对应下面XML字符串中的course字段。字段的名称可使用Jackson库中的标注@JsonProperty指定。Jackson序列化的使用方法可参考这里。

<Student xmlns="">
  <name>Adam</name>
  <age>21</age>
  <major>Chemistry</major>
  <course>
    <id>2683</id>
    <name>Introduction to Computer Science</name>
    <credits>3.0</credits>
    <hours>48</hours>
  </course>
  <course>
    <id>2686</id>
    <name>Data Structures</name>
    <credits>3.5</credits>
    <hours>56</hours>
  </course>
</Student>

多层XML对象数据的反序列化处理过程

需求分析

参考文档