package Torello.JSON;

import Torello.Java.Function.ToShortFunction;
import Torello.Java.Function.ToByteFunction;
import Torello.Java.Function.ToFloatFunction;

import java.util.function.ToIntFunction;
import java.util.function.ToLongFunction;
import java.util.function.ToDoubleFunction;
import java.util.function.Predicate;

import Torello.JavaDoc.Annotations.LinkJavaSource;
import Torello.JavaDoc.Annotations.StaticFunctional;
import Torello.JavaDoc.Annotations.JDHeaderBackgroundImg;
import Torello.JavaDoc.Annotations.IntoHTMLTable;

// import Torello.JavaDoc.Annotations.IntoHTMLTable.Background;
import static Torello.JavaDoc.Annotations.IntoHTMLTable.Background.*;

import static Torello.JSON.JFlag.NOT_ALLOWED_RET_NULL_MASKS;

import java.util.function.Predicate;

import javax.json.Json;
import javax.json.JsonArray;

/**
 * Utilities for parsing Json Array's and sending the parsed values into a Java-Array
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=ALL_CLASSES_NOTE>
 * <EMBED CLASS='external-html' DATA-FILE-ID=RJA_INTO_PRIM_ARR>
 * 
 * <BR /><HR><BR />
 * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_PRIM_ARR>
 * <EMBED CLASS='external-html' DATA-FILE-ID=RJA_PT_PRIM_ARR>
 * 
 * @see Json
 * @see JsonArray
 */
@StaticFunctional
@JDHeaderBackgroundImg(EmbedTagFileID="RJA_JDHBI_PRIM_ARR")
public class RJArrIntoPrimArray
{
    private RJArrIntoPrimArray() {}

    /**
     * <EMBED CLASS=defs DATA-TYPE=short DATA-INTERIM=Short>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_PRIM_ARR_M_DOC>
     */
    @IntoHTMLTable(background=BlueDither, title="JsonArray of Short")
    @LinkJavaSource(handle="GENERATE_1DARRAY", name="boxedStreamToPrimitiveArray")
    public static short[] shortArr(
            final JsonArray                 ja,
            final short                     defaultValue,
            final int                       FLAGS,
            final ToShortFunction<String>   optionalUserParser
        )
    {
        final short[] retArr = new short[ja.size()];

        return GENERATE_1DARRAY.boxedStreamToPrimitiveArray(
            RJArrIntoBoxedStream.shortArr(
                ja,
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsShort
            ),
            ja,
            short.class,
            (Short s, int i) -> retArr[i] = s.shortValue(),
            retArr
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=byte DATA-INTERIM=Byte>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_PRIM_ARR_M_DOC>
     */
    @IntoHTMLTable(background=GreenDither, title="JsonArray of Bytes")
    @LinkJavaSource(handle="GENERATE_1DARRAY", name="boxedStreamToPrimitiveArray")
    public static byte[] byteArr(
            final JsonArray                 ja,
            final byte                      defaultValue,
            final int                       FLAGS,
            final ToByteFunction<String>    optionalUserParser
        )
    {
        final byte[] retArr = new byte[ja.size()];

        return GENERATE_1DARRAY.boxedStreamToPrimitiveArray(
            RJArrIntoBoxedStream.byteArr(
                ja,
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsByte
            ),
            ja,
            byte.class,
            (Byte s, int i) -> retArr[i] = s.byteValue(),
            retArr
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=float DATA-INTERIM=Float>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_PRIM_ARR_M_DOC>
     */
    @IntoHTMLTable(background=BlueDither, title="JsonArray of Floats")
    @LinkJavaSource(handle="GENERATE_1DARRAY", name="boxedStreamToPrimitiveArray")
    public static float[] floatArr(
            final JsonArray                 ja,
            final float                     defaultValue,
            final int                       FLAGS,
            final ToFloatFunction<String>   optionalUserParser
        )
    {
        final float[] retArr = new float[ja.size()];

        return GENERATE_1DARRAY.boxedStreamToPrimitiveArray(
            RJArrIntoBoxedStream.floatArr(
                ja,
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsFloat
            ),
            ja,
            float.class,
            (Float s, int i) -> retArr[i] = s.floatValue(),
            retArr
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=boolean DATA-INTERIM=Boolean>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_PRIM_ARR_M_DOC>
     */
    @IntoHTMLTable(background=GreenDither, title="JsonArray of Booleans")
    @LinkJavaSource(handle="GENERATE_1DARRAY", name="boxedStreamToPrimitiveArray")
    public static boolean[] booleanArr(
            final JsonArray         ja,
            final boolean           defaultValue,
            final int               FLAGS,
            final Predicate<String> optionalUserParser
        )
    {
        final boolean[] retArr = new boolean[ja.size()];

        return GENERATE_1DARRAY.boxedStreamToPrimitiveArray(
            RJArrIntoBoxedStream.booleanArr(
                ja,
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::test
            ),
            ja,
            boolean.class,
            (Boolean s, int i) -> retArr[i] = s.booleanValue(),
            retArr
        );
    }

    /**
     * <BR>Invokes: {@link RJArrIntoPrimStream#intArr(JsonArray, int, int, ToIntFunction)}
     * <BR>And-Then: {@code toArray()}, as explained in the comments at the top of this class
     */
    @IntoHTMLTable(background=BlueDither, title="JsonArray of Integers")
    public static int[] intArr(
            final JsonArray             ja,
            final int                   defaultValue,
            final int                   FLAGS,
            final ToIntFunction<String> optionalUserParser
        )
    {
        return RJArrIntoPrimStream
            .intArr(ja, defaultValue, FLAGS, optionalUserParser)
            .toArray();
    }

    /**
     * <BR>Invokes: {@link RJArrIntoPrimStream#longArr(JsonArray, long, int, ToLongFunction)}
     * <BR>And-Then: {@code toArray()}, as explained in the comments at the top of this class
     */
    @IntoHTMLTable(background=GreenDither, title="JsonArray of Longs")
    public static long[] longArr(
            final JsonArray                 ja,
            final long                      defaultValue,
            final int                       FLAGS,
            final ToLongFunction<String>    optionalUserParser
        )
    {
        return RJArrIntoPrimStream
            .longArr(ja, defaultValue, FLAGS, optionalUserParser)
            .toArray();
    }

    /**
     * <BR>Invokes:
     *  {@link RJArrIntoPrimStream#doubleArr(JsonArray, double, int, ToDoubleFunction)}
     * <BR>And-Then: {@code toArray()}, as explained in the comments at the top of this class
     */
    @IntoHTMLTable(background=BlueDither, title="JsonArray of Doubles")
    public static double[] doubleArr(
            final JsonArray                 ja,
            final double                    defaultValue,
            final int                       FLAGS,
            final ToDoubleFunction<String>  optionalUserParser
        )
    {
        return RJArrIntoPrimStream
            .doubleArr(ja, defaultValue, FLAGS, optionalUserParser)
            .toArray();
    }

}