圖片來源網(wǎng)絡(luò)门扇，入侵必刪
在日常的Android開發(fā)當(dāng)中往踢，我們肯定少不了要使用Gson框架解析JSON字符串茶行。這篇博客分享一下我了解到Gson框架的知識断序，希望對看文章的小伙伴有所幫助。
Gson的依賴
implementation 'com.google.code.gson:gson:2.9.0'
這里需要注意的是：
Gson2.9.0最低適配Java7拆挥，如果想要是用Java6及其以下的版本要使用Gson2.8.9薄霜。
使用Gson開發(fā)的時候，我推薦一個工具類：
package com.blankj.utilcode.util;
import android.text.TextUtils;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.reflect.TypeToken;
import java.io.Reader;
import java.lang.reflect.Type;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
import androidx.annotation.NonNull;
/**
* <pre>
* author: Blankj
* blog : http://blankj.com
* time : 2018/04/05
* desc : utils about gson
* </pre>
*/
public final class GsonUtils {
private static final String KEY_DEFAULT = "defaultGson";
private static final String KEY_DELEGATE = "delegateGson";
private static final String KEY_LOG_UTILS = "logUtilsGson";
private static final Map<String, Gson> GSONS = new ConcurrentHashMap<>();
private GsonUtils() {
throw new UnsupportedOperationException("u can't instantiate me...");
}
/**
* Set the delegate of {@link Gson}.
*
* @param delegate The delegate of {@link Gson}.
*/
public static void setGsonDelegate(Gson delegate) {
if (delegate == null) return;
GSONS.put(KEY_DELEGATE, delegate);
}
/**
* Set the {@link Gson} with key.
*
* @param key The key.
* @param gson The {@link Gson}.
*/
public static void setGson(final String key, final Gson gson) {
if (TextUtils.isEmpty(key) || gson == null) return;
GSONS.put(key, gson);
}
/**
* Return the {@link Gson} with key.
*
* @param key The key.
* @return the {@link Gson} with key
*/
public static Gson getGson(final String key) {
return GSONS.get(key);
}
public static Gson getGson() {
Gson gsonDelegate = GSONS.get(KEY_DELEGATE);
if (gsonDelegate != null) {
return gsonDelegate;
}
Gson gsonDefault = GSONS.get(KEY_DEFAULT);
if (gsonDefault == null) {
gsonDefault = createGson();
GSONS.put(KEY_DEFAULT, gsonDefault);
}
return gsonDefault;
}
/**
* Serializes an object into json.
*
* @param object The object to serialize.
* @return object serialized into json.
*/
public static String toJson(final Object object) {
return toJson(getGson(), object);
}
/**
* Serializes an object into json.
*
* @param src The object to serialize.
* @param typeOfSrc The specific genericized type of src.
* @return object serialized into json.
*/
public static String toJson(final Object src, @NonNull final Type typeOfSrc) {
return toJson(getGson(), src, typeOfSrc);
}
/**
* Serializes an object into json.
*
* @param gson The gson.
* @param object The object to serialize.
* @return object serialized into json.
*/
public static String toJson(@NonNull final Gson gson, final Object object) {
return gson.toJson(object);
}
/**
* Serializes an object into json.
*
* @param gson The gson.
* @param src The object to serialize.
* @param typeOfSrc The specific genericized type of src.
* @return object serialized into json.
*/
public static String toJson(@NonNull final Gson gson, final Object src, @NonNull final Type typeOfSrc) {
return gson.toJson(src, typeOfSrc);
}
/**
* Converts {@link String} to given type.
*
* @param json The json to convert.
* @param type Type json will be converted to.
* @return instance of type
*/
public static <T> T fromJson(final String json, @NonNull final Class<T> type) {
return fromJson(getGson(), json, type);
}
/**
* Converts {@link String} to given type.
*
* @param json the json to convert.
* @param type type type json will be converted to.
* @return instance of type
*/
public static <T> T fromJson(final String json, @NonNull final Type type) {
return fromJson(getGson(), json, type);
}
/**
* Converts {@link Reader} to given type.
*
* @param reader the reader to convert.
* @param type type type json will be converted to.
* @return instance of type
*/
public static <T> T fromJson(@NonNull final Reader reader, @NonNull final Class<T> type) {
return fromJson(getGson(), reader, type);
}
/**
* Converts {@link Reader} to given type.
*
* @param reader the reader to convert.
* @param type type type json will be converted to.
* @return instance of type
*/
public static <T> T fromJson(@NonNull final Reader reader, @NonNull final Type type) {
return fromJson(getGson(), reader, type);
}
/**
* Converts {@link String} to given type.
*
* @param gson The gson.
* @param json The json to convert.
* @param type Type json will be converted to.
* @return instance of type
*/
public static <T> T fromJson(@NonNull final Gson gson, final String json, @NonNull final Class<T> type) {
return gson.fromJson(json, type);
}
/**
* Converts {@link String} to given type.
*
* @param gson The gson.
* @param json the json to convert.
* @param type type type json will be converted to.
* @return instance of type
*/
public static <T> T fromJson(@NonNull final Gson gson, final String json, @NonNull final Type type) {
return gson.fromJson(json, type);
}
/**
* Converts {@link Reader} to given type.
*
* @param gson The gson.
* @param reader the reader to convert.
* @param type type type json will be converted to.
* @return instance of type
*/
public static <T> T fromJson(@NonNull final Gson gson, final Reader reader, @NonNull final Class<T> type) {
return gson.fromJson(reader, type);
}
/**
* Converts {@link Reader} to given type.
*
* @param gson The gson.
* @param reader the reader to convert.
* @param type type type json will be converted to.
* @return instance of type
*/
public static <T> T fromJson(@NonNull final Gson gson, final Reader reader, @NonNull final Type type) {
return gson.fromJson(reader, type);
}
/**
* Return the type of {@link List} with the {@code type}.
*
* @param type The type.
* @return the type of {@link List} with the {@code type}
*/
public static Type getListType(@NonNull final Type type) {
return TypeToken.getParameterized(List.class, type).getType();
}
/**
* Return the type of {@link Set} with the {@code type}.
*
* @param type The type.
* @return the type of {@link Set} with the {@code type}
*/
public static Type getSetType(@NonNull final Type type) {
return TypeToken.getParameterized(Set.class, type).getType();
}
/**
* Return the type of map with the {@code keyType} and {@code valueType}.
*
* @param keyType The type of key.
* @param valueType The type of value.
* @return the type of map with the {@code keyType} and {@code valueType}
*/
public static Type getMapType(@NonNull final Type keyType, @NonNull final Type valueType) {
return TypeToken.getParameterized(Map.class, keyType, valueType).getType();
}
/**
* Return the type of array with the {@code type}.
*
* @param type The type.
* @return the type of map with the {@code type}
*/
public static Type getArrayType(@NonNull final Type type) {
return TypeToken.getArray(type).getType();
}
/**
* Return the type of {@code rawType} with the {@code typeArguments}.
*
* @param rawType The raw type.
* @param typeArguments The type of arguments.
* @return the type of map with the {@code type}
*/
public static Type getType(@NonNull final Type rawType, @NonNull final Type... typeArguments) {
return TypeToken.getParameterized(rawType, typeArguments).getType();
}
static Gson getGson4LogUtils() {
Gson gson4LogUtils = GSONS.get(KEY_LOG_UTILS);
if (gson4LogUtils == null) {
gson4LogUtils = new GsonBuilder().setPrettyPrinting().serializeNulls().create();
GSONS.put(KEY_LOG_UTILS, gson4LogUtils);
}
return gson4LogUtils;
}
private static Gson createGson() {
return new GsonBuilder().serializeNulls().disableHtmlEscaping().create();
}
}
這個Gson工具類來源于AndroidUtilCode工具類開源庫纸兔，主要實(shí)現(xiàn)了一下幾種功能呢：
- 設(shè)置代理對象：setGsonDelegate();
- 設(shè)置Gson對象：setGson();
- 獲取Gson對象：getGson();
- 對賬轉(zhuǎn)Json字符串：toJson()惰瓜，這個方法常用于服務(wù)器請求使用Json傳遞參數(shù)；
- Json轉(zhuǎn)對象：fromJson();
- 獲取鏈表類型：getListType();
- 獲取集合類型：getSetType();
- 獲取字典類型：getMapType();
- 獲取數(shù)組類型：getArrayType();
- 獲取類型：getType()汉矿。
