package Torello.Java.JSON;

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

import Torello.JavaDoc.IntoHTMLTable;
import static Torello.JavaDoc.IntoHTMLTable.Background.GreenDither;
import static Torello.JavaDoc.IntoHTMLTable.Background.BlueDither;

import javax.json.Json;
import javax.json.JsonArray;
import javax.json.JsonString;
import javax.json.JsonValue;

import java.util.Objects;

import Torello.Java.Function.IntIntTConsumer;
import java.util.function.Consumer;
import java.util.function.Function;

import Torello.Java.JSON.JFlag;

import static Torello.Java.JSON.BASIC_TYPES.BOXED;

import static javax.json.JsonValue.TRUE;
import static javax.json.JsonValue.FALSE;

/**
 * Utilities for parsing Json Array's and sending the parsed values into a Java
 * Consumer of Boxed-Primitives.
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=GLASS_FISH_NOTE>
 * <EMBED CLASS='external-html' DATA-FILE-ID=RJA_INTO_BOXED_CONS>
 * <EMBED CLASS='external-html' DATA-FILE-ID=JSON_BINDING_NOTE>
 * 
 *
 * @see Json
 * @see JsonArray
 */
@StaticFunctional
@JDHeaderBackgroundImg(EmbedTagFileID="RJA_JDHBI_BOXED_CONS")
public class RJArrIntoBoxedConsumer
{
    private RJArrIntoBoxedConsumer() { }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Integer DATA-TYPE_LC=int DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS>
     */
    @IntoHTMLTable(background=GreenDither, title="Java-Consumer which accepts Boxed-Integers")
    @LinkJavaSource(handle="BASIC_TYPES", name="INTEGER")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForConsumers")
    public static void intArr(
            final JsonArray                 ja,
            final int                       defaultValue,
            final int                       FLAGS,
            final Function<String, Integer> optionalUserParser,
            final Consumer<Integer>         c
        )
    {
        Objects.requireNonNull(c, "Consumer<Integer> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Integer, Void>
            SETTINGS_REC_BUILDER.createForConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_INTEGER())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Short DATA-TYPE_LC=short DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS>
     */
    @IntoHTMLTable(background=BlueDither, title="Java-Consumer which accepts Boxed Short-Integers")
    @LinkJavaSource(handle="BASIC_TYPES", name="SHORT")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForConsumers")
    public static void shortArr(
            final JsonArray                 ja,
            final short                     defaultValue,
            final int                       FLAGS,
            final Function<String, Short>   optionalUserParser,
            final Consumer<Short>           c
        )
    {
        Objects.requireNonNull(c, "Consumer<Short> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Short, Void>
            SETTINGS_REC_BUILDER.createForConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_SHORT())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Byte DATA-TYPE_LC=byte DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS>
     */
    @IntoHTMLTable(background=GreenDither, title="Java-Consumer which accepts Boxed-Bytes")
    @LinkJavaSource(handle="BASIC_TYPES", name="BYTE")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForConsumers")
    public static void byteArr(
            final JsonArray                 ja,
            final byte                      defaultValue,
            final int                       FLAGS,
            final Function<String, Byte>    optionalUserParser,
            final Consumer<Byte>            c
        )
    {
        Objects.requireNonNull(c, "Consumer<Byte> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Byte, Void>
            SETTINGS_REC_BUILDER.createForConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_BYTE())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Long DATA-TYPE_LC=long DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS>
     */
    @IntoHTMLTable(background=BlueDither, title="Java-Consumer which accepts Boxed Long-Integers")
    @LinkJavaSource(handle="BASIC_TYPES", name="LONG")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForConsumers")
    public static void longArr(
            final JsonArray                 ja,
            final long                      defaultValue,
            final int                       FLAGS,
            final Function<String, Long>    optionalUserParser,
            final Consumer<Long>            c
        )
    {
        Objects.requireNonNull(c, "Consumer<Long> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Long, Void>
            SETTINGS_REC_BUILDER.createForConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_LONG())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Double DATA-TYPE_LC=double DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS>
     */
    @IntoHTMLTable(background=GreenDither, title="Java-Consumer which accepts Boxed-Doubles")
    @LinkJavaSource(handle="BASIC_TYPES", name="DOUBLE")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForConsumers")
    public static void doubleArr(
            final JsonArray                 ja,
            final double                    defaultValue,
            final int                       FLAGS,
            final Function<String, Double>  optionalUserParser,
            final Consumer<Double>          c
        )
    {
        Objects.requireNonNull(c, "Consumer<Double> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Double, Void>
            SETTINGS_REC_BUILDER.createForConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_DOUBLE())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Float DATA-TYPE_LC=float DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS>
     */
    @IntoHTMLTable(background=BlueDither, title="Java-Consumer which accepts Boxed-Floats")
    @LinkJavaSource(handle="BASIC_TYPES", name="FLOAT")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForConsumers")
    public static void floatArr(
            final JsonArray                 ja,
            final float                     defaultValue,
            final int                       FLAGS,
            final Function<String, Float>   optionalUserParser,
            final Consumer<Float>           c
        )
    {
        Objects.requireNonNull(c, "Consumer<Float> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Float, Void>
            SETTINGS_REC_BUILDER.createForConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_FLOAT())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Boolean DATA-TYPE_LC=boolean DATA-METH_NAME=boolean>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS>
     */
    @IntoHTMLTable(background=GreenDither, title="Java-Consumer which accepts Boxed-Booleans")
    @LinkJavaSource(handle="BASIC_TYPES", name="BOOLEAN")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForConsumers")
    public static void booleanArr(
            final JsonArray                 ja,
            final boolean                   defaultValue,
            final int                       FLAGS,
            final Function<String, Boolean> optionalUserParser,
            final Consumer<Boolean>         c
        )
    {
        Objects.requireNonNull(c, "Consumer<Boolean> parameter 'c' is null");

        ProcessJsonArray.booleanToJava(
            ja,
            // new SettingsRec<Boolean, Void>
            SETTINGS_REC_BUILDER.createForConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_BOOLEAN())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Number DATA-TYPE_LC=int DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS>
     */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer which accepts Best-Fit Boxed-Numbers"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="NUMBER_REC")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForConsumers")
    public static void numberArr(
            final JsonArray                 ja,
            final Number                    defaultValue,
            final int                       FLAGS,
            final Function<String, Number>  optionalUserParser,
            final Consumer<Number>          c
        )
    {
        Objects.requireNonNull(c, "Consumer<Number> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Number, Void>
            SETTINGS_REC_BUILDER.createForConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.NUMBER_REC())
        );
    }




    // ********************************************************************************************
    // ********************************************************************************************
    // IntIntTConsumer Variant
    // ********************************************************************************************
    // ********************************************************************************************




    /**
     * <EMBED CLASS=defs DATA-TYPE=Integer DATA-TYPE_LC=int DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS2>
     */
    @IntoHTMLTable(
        background=GreenDither,
        title="Java-Consumer accepting Boxed-Integers, w/ Array-Indices"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="INTEGER")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForIIConsumers")
    public static void intArr2(
            final JsonArray                 ja,
            final int                       defaultValue,
            final int                       FLAGS,
            final Function<String, Integer> optionalUserParser,
            final IntIntTConsumer<Integer>  c
        )
    {
        Objects.requireNonNull(c, "IntIntTConsumer<Integer> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Integer, Void>
            SETTINGS_REC_BUILDER.createForIIConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_INTEGER())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Short DATA-TYPE_LC=short DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS2>
     */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer accepting Boxed Short-Integers, w/ Array-Indices"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="SHORT")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForIIConsumers")
    public static void shortArr2(
            final JsonArray                 ja,
            final short                     defaultValue,
            final int                       FLAGS,
            final Function<String, Short>   optionalUserParser,
            final IntIntTConsumer<Short>    c
        )
    {
        Objects.requireNonNull(c, "IntIntTConsumer<Short> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Short, Void>
            SETTINGS_REC_BUILDER.createForIIConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_SHORT())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Byte DATA-TYPE_LC=byte DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS2>
     */
    @IntoHTMLTable(
        background=GreenDither, 
        title="Java-Consumer accepting Boxed-Bytes, w/ Array-Indices"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="BYTE")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForIIConsumers")
    public static void byteArr2(
            final JsonArray                 ja,
            final byte                      defaultValue,
            final int                       FLAGS,
            final Function<String, Byte>    optionalUserParser,
            final IntIntTConsumer<Byte>     c
        )
    {
        Objects.requireNonNull(c, "IntIntTConsumer<Byte> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Byte, Void>
            SETTINGS_REC_BUILDER.createForIIConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_BYTE())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Long DATA-TYPE_LC=long DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS2>
     */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer accepting Boxed Long-Integers, w/ Array-Indices"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="LONG")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForIIConsumers")
    public static void longArr2(
            final JsonArray                 ja,
            final long                      defaultValue,
            final int                       FLAGS,
            final Function<String, Long>    optionalUserParser,
            final IntIntTConsumer<Long>     c
        )
    {
        Objects.requireNonNull(c, "IntIntTConsumer<Long> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Long, Void>
            SETTINGS_REC_BUILDER.createForIIConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_LONG())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Double DATA-TYPE_LC=double DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS2>
     */
    @IntoHTMLTable(
        background=GreenDither,
        title="Java-Consumer accepting Boxed-Doubles, w/ Array-Indices"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="DOUBLE")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForIIConsumers")
    public static void doubleArr2(
            final JsonArray                 ja,
            final double                    defaultValue,
            final int                       FLAGS,
            final Function<String, Double>  optionalUserParser,
            final IntIntTConsumer<Double>   c
        )
    {
        Objects.requireNonNull(c, "IntIntTConsumer<Double> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Double, Void>
            SETTINGS_REC_BUILDER.createForIIConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_DOUBLE())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Float DATA-TYPE_LC=float DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS2>
     */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer accepting Boxed-Floats, w/ Array-Indices"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="FLOAT")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForIIConsumers")
    public static void floatArr2(
            final JsonArray                 ja,
            final float                     defaultValue,
            final int                       FLAGS,
            final Function<String, Float>   optionalUserParser,
            final IntIntTConsumer<Float>    c
        )
    {
        Objects.requireNonNull(c, "IntIntTConsumer<Float> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Float, Void>
            SETTINGS_REC_BUILDER.createForIIConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_FLOAT())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Boolean DATA-TYPE_LC=boolean DATA-METH_NAME=boolean>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS2>
     */
    @IntoHTMLTable(
        background=GreenDither,
        title="Java-Consumer accepting Boxed-Booleans, w/ Array-Indices"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="BOOLEAN")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForIIConsumers")
    public static void booleanArr2(
            final JsonArray                 ja,
            final boolean                   defaultValue,
            final int                       FLAGS,
            final Function<String, Boolean> optionalUserParser,
            final IntIntTConsumer<Boolean>  c
        )
    {
        Objects.requireNonNull(c, "IntIntTConsumer<Boolean> parameter 'c' is null");

        ProcessJsonArray.booleanToJava(
            ja,
            // new SettingsRec<Boolean, Void>
            SETTINGS_REC_BUILDER.createForIIConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.BOXED_BOOLEAN())
        );
    }

    /**
     * <EMBED CLASS=defs DATA-TYPE=Number DATA-TYPE_LC=number DATA-METH_NAME=numeric>
     * <EMBED CLASS='external-html' DATA-FILE-ID=RJ_ARR_INTO_BOXED_CONS2>
     */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer accepting Best-Fit Boxed-Numbers, w/ Array-Indices"
    )
    @LinkJavaSource(handle="BASIC_TYPES", name="NUMBER_REC")
    @LinkJavaSource(handle="SETTINGS_REC_BUILDER", name="createForIIConsumers")
    public static void numberArr2(
            final JsonArray                 ja,
            final Number                    defaultValue,
            final int                       FLAGS,
            final Function<String, Number>  optionalUserParser,
            final IntIntTConsumer<Number>   c
        )
    {
        Objects.requireNonNull(c, "IntIntTConsumer<Number> parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Number, Void>
            SETTINGS_REC_BUILDER.createForIIConsumers
                (defaultValue, FLAGS, optionalUserParser, c, BASIC_TYPES.NUMBER_REC())
        );
    }

}