簡介

在 Java 中，泛型類型在運行時會被擦除。這意味著當我們使用泛型時，運行時無法直接獲取到泛型的具體類型信息。例如，我們無法直接通過 Class 對象來獲取一個泛型類型的類型參數。這在某些情況下可能會導致問題，特別是在我們需要對泛型類型進行反射操作時。

TypeReference 是 Jackson 庫提供的一個類，它可以幫助我們解決這個問題。通過 TypeReference，我們可以在運行時保留泛型的類型信息，從而能夠正確地處理復雜的泛型類型。

本文將詳細介紹 TypeReference 泛型的使用場景及具體使用流程，并通過一個實際例子展示如何在自定義 HttpClient 中使用 TypeReference。

使用場景

處理復雜泛型的 JSON 反序列化

在使用 Jackson 庫進行 JSON 反序列化時，如果目標類型是一個復雜的泛型類型，直接使用 Class 對象可能會導致類型擦除問題，從而無法正確地反序列化。例如，我們有一個泛型類 Map<String, List<String>>，如果我們直接使用 Class<Map<String, List<String>>> 來進行反序列化，會因為類型擦除而無法正確地獲取到具體的泛型類型參數。

通過 TypeReference，我們可以正確地指定泛型類型參數，從而能夠正確地反序列化復雜的泛型類型。

處理復雜泛型的反射操作

在進行反射操作時，我們可能需要獲取泛型類型的類型參數。由于類型擦除，直接使用 Class 對象無法獲取到這些類型參數。而 TypeReference 可以幫助我們保留這些類型參數，從而能夠正確地進行反射操作。

具體使用流程

引入 Jackson 依賴

在使用 TypeReference 之前，我們需要先引入 Jackson 的依賴。如果你使用的是 Maven 項目，可以在 pom.xml 文件中添加以下依賴：

<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.13.3</version>
</dependency>

定義 TypeReference 的子類

為了使用 TypeReference，我們需要定義一個 TypeReference 的子類。這個子類需要繼承自 TypeReference，并且指定具體的泛型類型。例如，如果我們需要處理 Map<String, List<String>> 類型，可以這樣定義：

new TypeReference<Map<String, List<String>>>() {};

使用 TypeReference 進行 JSON 反序列化

在使用 Jackson 進行 JSON 反序列化時，我們可以使用 TypeReference 來指定具體的泛型類型。例如：

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;import java.io.IOException;
import java.util.List;
import java.util.Map;public class TypeReferenceExample {public static void main(String[] args) throws IOException {String json = "{\"key1\":[\"value1\",\"value2\"],\"key2\":[\"value3\",\"value4\"]}";ObjectMapper objectMapper = new ObjectMapper();TypeReference<Map<String, List<String>>> typeReference = new TypeReference<Map<String, List<String>>>() {};Map<String, List<String>> map = objectMapper.readValue(json, typeReference);System.out.println(map);}
}

在上面的代碼中，我們定義了一個 TypeReference<Map<String, List<String>>> 的子類，并將其傳遞給 ObjectMapper 的 readValue 方法。這樣，Jackson 就可以正確地反序列化 JSON 字符串到 Map<String, List<String>> 類型。

使用 TypeReference 進行反射操作

在進行反射操作時，我們可以通過 TypeReference 獲取泛型類型的類型參數。例如：

import com.fasterxml.jackson.core.type.TypeReference;import java.lang.reflect.Type;public class TypeReferenceReflectionExample {public static void main(String[] args) {TypeReference<Map<String, List<String>>> typeReference = new TypeReference<Map<String, List<String>>>() {};Type type = typeReference.getType();System.out.println(type);}
}

在上面的代碼中，我們通過 TypeReference 的 getType 方法獲取了泛型類型的 Type 對象。這個 Type 對象包含了泛型類型的類型參數信息，我們可以使用它來進行反射操作。

實際例子：HttpClient 通用類實現

在實際開發中，我們經常需要與外部服務進行 HTTP 通信。為了提高代碼的復用性和可維護性，我們通常會自定義一個 HttpClient 類，用于封裝 HTTP 請求和響應處理。由于返回值類型不固定，我們可以使用 TypeReference 來實現一個通用的 HttpClient 類。

定義 HttpClient 類

我們定義一個通用的 HttpClient 類，用于發送 HTTP 請求并處理響應。這個類將使用 TypeReference 來支持返回值類型不固定的場景。

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;import java.io.IOException;public class HttpClient {private static final ObjectMapper objectMapper = new ObjectMapper();private static final CloseableHttpClient httpClient = HttpClients.createDefault();public static <T> T get(String url, TypeReference<T> typeReference) throws IOException {HttpGet httpGet = new HttpGet(url);try (CloseableHttpResponse response = httpClient.execute(httpGet)) {String jsonResponse = EntityUtils.toString(response.getEntity());return objectMapper.readValue(jsonResponse, typeReference);}}
}

使用 HttpClient 類

我們可以使用 HttpClient 類來發送 HTTP 請求，并指定返回值的類型。例如，假設我們有一個外部服務返回一個 Map<String, List<String>> 類型的 JSON 數據，我們可以這樣使用 HttpClient 類：

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;import java.util.List;
import java.util.Map;public class HttpClientExample {public static void main(String[] args) {try {String url = "https://api.example.com/data";Map<String, List<String>> result = HttpClient.get(url, new CustomTypeReference().mapReference);System.out.println(result);} catch (IOException e) {e.printStackTrace();}}
}

自定義 TypeReference

import java.util.List;
import java.util.Map;import com.fasterxml.jackson.core.type.TypeReference;/*** CustomTypeReference 自定義TypeReference** @author xxx* @since 2025/7/24*/
public class CustomTypeReference {public TypeReference<Map<String, List<String>>> mapReference =new TypeReference<Map<String, List<String>>>() {};
}

在上面的代碼中，我們定義了一個 TypeReference<Map<String, List<String>>> 的子類，并將其傳遞給 HttpClient.get 方法。這樣，HttpClient 類就可以正確地反序列化返回的 JSON 數據到 Map<String, List<String>> 類型。

---

至此，本次分享到此結束啦！！！