org.dominokit.jacksonapt.deser.array.ArrayJsonDeserializer Maven / Gradle / Ivy

Go to download
/*
 * 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.jacksonapt.deser.array;

import org.dominokit.jacksonapt.JsonDeserializationContext;
import org.dominokit.jacksonapt.JsonDeserializer;
import org.dominokit.jacksonapt.JsonDeserializerParameters;
import org.dominokit.jacksonapt.stream.JsonReader;

import java.util.List;

/**
 * Default {@link org.dominokit.jacksonapt.JsonDeserializer} implementation for array.
 *
 * @author Nicolas Morel
 * @version $Id: $
 */
public class ArrayJsonDeserializer extends AbstractArrayJsonDeserializer {

    @FunctionalInterface
    public interface ArrayCreator {
        T[] create(int length);
    }

    /**
     * newInstance
     *
     * @param deserializer {@link org.dominokit.jacksonapt.JsonDeserializer} used to deserialize the objects inside the array.
     * @param arrayCreator {@link org.dominokit.jacksonapt.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.jacksonapt.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.jacksonapt.JsonDeserializer} used to deserialize the objects inside the array.
     * @param arrayCreator {@link org.dominokit.jacksonapt.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);
            }
        }
    }
}