Перейти к основному содержимому

Поваренная книга сериализации Gson

· 3 мин. чтения

В этой статье мы рассмотрим наиболее распространенные сценарии сериализации с использованием библиотеки Gson .

Давайте начнем с представления простой сущности , которую мы будем использовать в следующих примерах:

public class SourceClass {
private int intValue;
private String stringValue;

// standard getters and setters
}

1. Сериализация массива сущностей

Во-первых, давайте сериализуем массив объектов с помощью Gson:

@Test
public void givenArrayOfObjects_whenSerializing_thenCorrect() {
SourceClass[] sourceArray = {new SourceClass(1, "one"), new SourceClass(2, "two")};
String jsonString = new Gson().toJson(sourceArray);

String expectedResult =
"[{"intValue":1,"stringValue":"one"},{"intValue":2,"stringValue":"two"}]";
assertEquals(expectedResult, jsonString);
}

2. Сериализация коллекции сущностей

Далее, давайте сделаем то же самое для коллекции объектов:

@Test
public void givenCollection_whenSerializing_thenCorrect() {
Collection<SourceClass> sourceCollection =
Lists.newArrayList(new SourceClass(1, "one"), new SourceClass(2, "two"));
String jsonCollection = new Gson().toJson(sourceCollection);

String expectedResult =
"[{"intValue":1,"stringValue":"one"},{"intValue":2,"stringValue":"two"}]";
assertEquals(expectedResult, jsonCollection);
}

3. Измените имена полей объекта при сериализации

Далее давайте посмотрим, как мы можем изменить имя поля при сериализации объекта.

Мы собираемся сериализовать нашу сущность, содержащую поля intValue и stringValue , в json с otherIntValue и otherStringValue :

@Test
public void givenUsingCustomSerializer_whenChangingNameOfFieldOnSerializing_thenCorrect() {
SourceClass sourceObject = new SourceClass(7, "seven");
GsonBuilder gsonBuildr = new GsonBuilder();
gsonBuildr.registerTypeAdapter(SourceClass.class, new DifferentNameSerializer());
String jsonString = gsonBuildr.create().toJson(sourceObject);

String expectedResult = "{"otherIntValue":7,"otherStringValue":"seven"}";
assertEquals(expectedResult, jsonString);
}

Обратите внимание, что здесь мы используем собственный сериализатор, чтобы изменить имя наших полей:

public class DifferentNameSerializer implements JsonSerializer<SourceClass> {
@Override
public JsonElement serialize
(SourceClass src, Type typeOfSrc, JsonSerializationContext context) {
String otherIntValueName = "otherIntValue";
String otherStringValueName = "otherStringValue";

JsonObject jObject = new JsonObject();
jObject.addProperty(otherIntValueName, src.getIntValue());
jObject.addProperty(otherStringValueName, src.getStringValue());

return jObject;
}
}

4. Игнорировать поле при сериализации сущности

Давайте теперь полностью проигнорируем поле при выполнении сериализации:

@Test
public void givenIgnoringAField_whenSerializingWithCustomSerializer_thenFieldIgnored() {
SourceClass sourceObject = new SourceClass(7, "seven");
GsonBuilder gsonBuildr = new GsonBuilder();
gsonBuildr.registerTypeAdapter(SourceClass.class, new IgnoringFieldsSerializer());
String jsonString = gsonBuildr.create().toJson(sourceObject);

String expectedResult = "{"intValue":7}";
assertEquals(expectedResult, jsonString);
}

Как и в предыдущем примере, здесь мы также используем собственный сериализатор:

public class IgnoringFieldsSerializer implements JsonSerializer<SourceClass> {
@Override
public JsonElement serialize
(SourceClass src, Type typeOfSrc, JsonSerializationContext context) {
String intValue = "intValue";
JsonObject jObject = new JsonObject();
jObject.addProperty(intValue, src.getIntValue());

return jObject;
}
}

Также обратите внимание, что нам, скорее всего, нужно сделать это в тех случаях, когда мы не можем изменить исходный код сущности, или если поле следует игнорировать только в очень специфических случаях. В противном случае мы можем проще игнорировать поле с помощью прямой аннотации к классу сущности.

5. Сериализуйте поле, только если оно соответствует пользовательскому условию

Наконец, давайте проанализируем более сложный вариант использования — мы хотим сериализовать поле только в том случае, если оно соответствует определенному пользовательскому условию.

Например, давайте сериализуем значение int только в том случае, если оно положительное, и просто пропустим его, если оно отрицательное:

@Test
public void givenUsingCustomDeserializer_whenFieldNotMatchesCriteria_thenIgnored() {
SourceClass sourceObject = new SourceClass(-1, "minus 1");
GsonBuilder gsonBuildr = new GsonBuilder();
gsonBuildr.registerTypeAdapter(SourceClass.class,
new IgnoringFieldsNotMatchingCriteriaSerializer());
Gson gson = gsonBuildr.create();
Type sourceObjectType = new TypeToken<SourceClass>() {}.getType();
String jsonString = gson.toJson(sourceObject, sourceObjectType);

String expectedResult = "{"stringValue":"minus 1"}";
assertEquals(expectedResult, jsonString);
}

Конечно, здесь мы также используем собственный сериализатор :

public class IgnoringFieldsNotMatchingCriteriaSerializer 
implements JsonSerializer<SourceClass> {
@Override
public JsonElement serialize
(SourceClass src, Type typeOfSrc, JsonSerializationContext context) {
JsonObject jObject = new JsonObject();

// Criteria: intValue >= 0
if (src.getIntValue() >= 0) {
String intValue = "intValue";
jObject.addProperty(intValue, src.getIntValue());
}

String stringValue = "stringValue";
jObject.addProperty(stringValue, src.getStringValue());

return jObject;
}
}

Вот и все — 5 распространенных вариантов сериализации с помощью Gson .