org.dominokit.jackson.deser.array.ArrayJsonDeserializer Maven / Gradle / Ivy
/*
* Copyright 2013 Nicolas Morel
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.dominokit.jackson.deser.array;
import java.util.List;
import org.dominokit.jackson.JsonDeserializationContext;
import org.dominokit.jackson.JsonDeserializer;
import org.dominokit.jackson.JsonDeserializerParameters;
import org.dominokit.jackson.stream.JsonReader;
/** Default {@link org.dominokit.jackson.JsonDeserializer} implementation for array. */
public class ArrayJsonDeserializer extends AbstractArrayJsonDeserializer {
/**
* A Functional interface to create a new array instance in the deserializer
*
* @param the type of the array elements.
*/
@FunctionalInterface
public interface ArrayCreator {
T[] create(int length);
}
/**
* newInstance
*
* @param deserializer {@link org.dominokit.jackson.JsonDeserializer} used to deserialize the
* objects inside the array.
* @param arrayCreator {@link
* org.dominokit.jackson.deser.array.ArrayJsonDeserializer.ArrayCreator} used to create a new
* array
* @param Type of the elements inside the {@link java.util.AbstractCollection}
* @return a new instance of {@link org.dominokit.jackson.deser.array.ArrayJsonDeserializer}
*/
public static ArrayJsonDeserializer newInstance(
JsonDeserializer deserializer, ArrayCreator arrayCreator) {
return new ArrayJsonDeserializer(deserializer, arrayCreator);
}
private final JsonDeserializer deserializer;
private final ArrayCreator arrayCreator;
/**
* Constructor for ArrayJsonDeserializer.
*
* @param deserializer {@link org.dominokit.jackson.JsonDeserializer} used to deserialize the
* objects inside the array.
* @param arrayCreator {@link
* org.dominokit.jackson.deser.array.ArrayJsonDeserializer.ArrayCreator} used to create a new
* array
*/
protected ArrayJsonDeserializer(JsonDeserializer deserializer, ArrayCreator arrayCreator) {
if (null == deserializer) {
throw new IllegalArgumentException("deserializer cannot be null");
}
if (null == arrayCreator) {
throw new IllegalArgumentException("Cannot deserialize an array without an arrayCreator");
}
this.deserializer = deserializer;
this.arrayCreator = arrayCreator;
}
/** {@inheritDoc} */
@Override
public T[] doDeserializeArray(
JsonReader reader, JsonDeserializationContext ctx, JsonDeserializerParameters params) {
List list = deserializeIntoList(reader, ctx, deserializer, params);
return list.toArray(arrayCreator.create(list.size()));
}
/** {@inheritDoc} */
@Override
protected T[] doDeserializeSingleArray(
JsonReader reader, JsonDeserializationContext ctx, JsonDeserializerParameters params) {
T[] result = arrayCreator.create(1);
result[0] = deserializer.deserialize(reader, ctx, params);
return result;
}
/** {@inheritDoc} */
@Override
public void setBackReference(
String referenceName, Object reference, T[] value, JsonDeserializationContext ctx) {
if (null != value && value.length > 0) {
for (T val : value) {
deserializer.setBackReference(referenceName, reference, val, ctx);
}
}
}
}