Jackson - ObjectMapper 類

介紹

ObjectMapper 是 Jackson 庫中的主要參與者類。ObjectMapper 類提供讀取和寫入 JSON 的功能，可以從基本 POJO（普通舊 Java 物件）或通用 JSON 樹模型 (JsonNode) 讀寫 JSON，以及執行轉換的相關功能。它還可以高度自定義，以適應不同樣式的 JSON 內容，並支援更高階的物件概念，例如多型性和物件標識。ObjectMapper 也可以作為更高階的 ObjectReader 和 ObjectWriter 類的工廠。

類宣告

以下是 **com.fasterxml.jackson.databind.ObjectMapper** 類的宣告：

public class ObjectMapper
   extends ObjectCodec
      implements Versioned, Serializable

巢狀類

欄位

• **protected DeserializationConfig _deserializationConfig** - 定義序列化過程基本全域性設定的配置物件。

• **protected DefaultDeserializationContext _deserializationContext** - 藍圖上下文物件；儲存在此處以允許自定義子類。

• **protected InjectableValues _injectableValues** - 用於在反序列化 POJO 中注入值的提供程式。

• **protected JsonFactory _jsonFactory** - 用於根據需要建立 JsonParser 和 JsonGenerator 例項的工廠。

• **protected SimpleMixInResolver _mixIns** - 定義如何應用 mix-in 註解的對映：鍵是要接收附加註解的型別，值是要“混合”的註解的型別。

• **protected ConfigOverrides _propertyOverrides** - 當前活動的每個型別配置覆蓋，透過屬性的宣告型別訪問。

• **protected Set<Object> _registeredModuleTypes** - 已註冊的模組型別集（根據 Module.getTypeId()）；如果啟用了 MapperFeature.IGNORE_DUPLICATE_MODULE_REGISTRATIONS，則對其進行跟蹤，以便可以忽略重複的註冊呼叫（主要是為了避免多次新增相同的處理程式）。

• **protected ConcurrentHashMap<JavaType,JsonDeserializer<Object>> _rootDeserializers** - 我們將使用單獨的主級 Map 來跟蹤根級反序列化器。

• **protected SerializationConfig _serializationConfig** - 定義序列化過程基本全域性設定的配置物件。

• **protected SerializerFactory _serializerFactory** - 用於構造序列化器的序列化器工廠。

• **protected DefaultSerializerProvider _serializerProvider** - 管理對用於序列化的序列化器的訪問（包括快取）的物件。

• **protected SubtypeResolver _subtypeResolver** - 用於註冊子型別，根據需要將它們解析為超型別/子型別。

• **protected TypeFactory _typeFactory** - 用於建立 JavaType 例項的特定工廠；需要允許模組新增更多自定義型別處理（主要是為了支援非 Java JVM 語言的型別）。

• protected static AnnotationIntrospector DEFAULT_ANNOTATION_INTROSPECTOR

• **protected static BaseSettings DEFAULT_BASE** - 基本設定包含所有 ObjectMapper 例項使用的預設值。

• protected static VisibilityChecker<?> STD_VISIBILITY_CHECKER

建構函式

方法

繼承的方法

此類繼承自以下類的方法

• java.lang.Object

ObjectMapper 示例

使用您選擇的任何編輯器在例如 C:/> Jackson_WORKSPACE 中建立以下 Java 程式

檔案：JacksonTester.java

import java.io.IOException;

import com.fasterxml.jackson.core.JsonParseException;
import com.fasterxml.jackson.databind.JsonMappingException;
import com.fasterxml.jackson.databind.ObjectMapper;

public class JacksonTester {
   public static void main(String args[]){
   
      ObjectMapper mapper = new ObjectMapper();
      String jsonString = "{\"name\":\"Mahesh\", \"age\":21}";
      
      //map json to student
      try{
         Student student = mapper.readValue(jsonString, Student.class);
         
         System.out.println(student);
         
         jsonString = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(student);
         
         System.out.println(jsonString);
      }
      catch (JsonParseException e) { e.printStackTrace();}
      catch (JsonMappingException e) { e.printStackTrace(); }
      catch (IOException e) { e.printStackTrace(); }
   }
}

class Student {
   private String name;
   private int age;
   public Student(){}
   public String getName() {
      return name;
   }
   public void setName(String name) {
      this.name = name;
   }
   public int getAge() {
      return age;
   }
   public void setAge(int age) {
      this.age = age;
   }
   public String toString(){
      return "Student [ name: "+name+", age: "+ age+ " ]";
   }
}

驗證結果

使用 javac 編譯器編譯類，如下所示

C:\Jackson_WORKSPACE>javac JacksonTester.java

現在執行 jacksonTester 以檢視結果

C:\Jackson_WORKSPACE>java JacksonTester

驗證輸出

Student [ name: Mahesh, age: 21 ]
{
  "name" : "Mahesh",
  "age" : 21
}