使用Jackson读取指定JSON结构并获取对象的技术问询

嘿，你已经能搞定简单键值对JSON的读取了，这是个很棒的开始！接下来咱们一步步实现读取指定结构的JSON并转换成对应Java对象的操作——这可是Jackson库最核心、最实用的能力之一。

1. 定义与JSON结构匹配的Java实体类 #

首先你得创建一个和目标JSON结构完全对应的Java类（嵌套结构要拆分出单独的类或者用内部类）。举个例子，假设你要读取的JSON结构是这样的：

{
  "userId": 101,
  "fullName": "Rahul Uday",
  "isActive": true,
  "address": {
    "street": "Main Street",
    "city": "Bangalore"
  },
  "favoriteBooks": ["The Alchemist", "Clean Code"]
}

对应的Java实体类要这么写（注意你用的是旧版Jackson，注解要从org.codehaus.jackson.annotate包引入）：

import org.codehaus.jackson.annotate.JsonProperty;
import java.util.List;

// 主实体类
public class User {
    // 字段名和JSON键名一致时可省略@JsonProperty，不一致时用它指定映射关系
    private int userId;
    private String fullName;
    private boolean isActive;
    private Address address; // 嵌套结构对应另一个类
    private List<String> favoriteBooks; // 集合类型对应JSON数组

    // 必须要有无参构造方法，Jackson需要它实例化对象
    public User() {}

    // Getter和Setter方法，Jackson通过这些访问字段
    public int getUserId() {
        return userId;
    }

    public void setUserId(int userId) {
        this.userId = userId;
    }

    public String getFullName() {
        return fullName;
    }

    public void setFullName(String fullName) {
        this.fullName = fullName;
    }

    public boolean isActive() {
        return isActive;
    }

    public void setActive(boolean active) {
        isActive = active;
    }

    public Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }

    public List<String> getFavoriteBooks() {
        return favoriteBooks;
    }

    public void setFavoriteBooks(List<String> favoriteBooks) {
        this.favoriteBooks = favoriteBooks;
    }

    // 嵌套结构的内部类
    public static class Address {
        private String street;
        private String city;

        public Address() {}

        public String getStreet() {
            return street;
        }

        public void setStreet(String street) {
            this.street = street;
        }

        public String getCity() {
            return city;
        }

        public void setCity(String city) {
            this.city = city;
        }
    }
}

2. 使用ObjectMapper读取JSON并映射为对象 #

接下来就可以用你熟悉的ObjectMapper完成读取和映射了，这是完整的代码示例：

import java.io.FileReader;
import java.io.IOException;
import org.codehaus.jackson.JsonParseException;
import org.codehaus.jackson.map.JsonMappingException;
import org.codehaus.jackson.map.ObjectMapper;

public class ReadStructuredJson {
    public static void main(String[] args) {
        ObjectMapper objectMapper = new ObjectMapper();

        try (FileReader reader = new FileReader("path/to/your/structured.json")) {
            // 直接将JSON文件内容映射为User对象
            User user = objectMapper.readValue(reader, User.class);

            // 现在你可以直接操作这个对象了
            System.out.println("User ID: " + user.getUserId());
            System.out.println("Full Name: " + user.getFullName());
            System.out.println("City: " + user.getAddress().getCity());
            System.out.println("First Favorite Book: " + user.getFavoriteBooks().get(0));

        } catch (JsonParseException e) {
            System.err.println("JSON格式错误：" + e.getMessage());
        } catch (JsonMappingException e) {
            System.err.println("JSON结构和Java类不匹配：" + e.getMessage());
        } catch (IOException e) {
            System.err.println("文件读取错误：" + e.getMessage());
        }
    }
}

3. 关键注意事项 #

• 依赖确保正确：如果你用Maven，需要引入旧版Jackson的依赖（对应你用的org.codehaus.jackson包）：

  <dependency>
      <groupId>org.codehaus.jackson</groupId>
      <artifactId>jackson-mapper-asl</artifactId>
      <version>1.9.13</version>
  </dependency>
  

• 无参构造方法：Jackson要求实体类必须有公共的无参构造方法，否则无法实例化对象。
• 字段映射：如果JSON键名和Java字段名不一致，用@JsonProperty("json_key_name")注解标注字段，比如@JsonProperty("user_name") private String userName;。
• 忽略未知字段：如果JSON里有一些你不需要的字段，可以在实体类上添加@JsonIgnoreProperties(ignoreUnknown = true)，这样Jackson会忽略这些字段，不会抛出映射异常。
• 异常处理：记得捕获JsonParseException（JSON格式错误）、JsonMappingException（结构不匹配）和IOException（文件操作错误），避免程序崩溃。

内容的提问来源于stack exchange，提问作者rahul uday