package Torello.Java.JSON;


// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
// These are the User-Provided Lambda's / Functional-Interfaces
// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

import java.util.function.IntConsumer;
import Torello.Java.Function.TriIntCons;
import java.util.function.ToIntFunction;

import Torello.Java.Function.ShortConsumer;
import Torello.Java.Function.IntIntShortCons;
import Torello.Java.Function.ToShortFunction;

import Torello.Java.Function.ByteConsumer;
import Torello.Java.Function.IntIntByteCons;
import Torello.Java.Function.ToByteFunction;

import java.util.function.LongConsumer;
import Torello.Java.Function.IntIntLongCons;
import java.util.function.ToLongFunction;

import Torello.Java.Function.FloatConsumer;
import Torello.Java.Function.IntIntFloatCons;
import Torello.Java.Function.ToFloatFunction;

import java.util.function.DoubleConsumer;
import Torello.Java.Function.IntIntDoubleCons;
import java.util.function.ToDoubleFunction;

import Torello.Java.Function.BoolConsumer;
import Torello.Java.Function.IntIntBoolCons;
import java.util.function.Predicate;


// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
// The Rest of the imports
// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

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

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

import Torello.Java.JSON.JFlag;

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

import java.util.Objects;

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

import static Torello.Java.JSON.JFlag.NOT_ALLOWED_RET_NULL_MASKS;
import static Torello.Java.JSON.BASIC_TYPES.PRIMITIVE;


/**
 * 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_PRIM_CONS>
 * <EMBED CLASS='external-html' DATA-FILE-ID=JSON_BINDING_NOTE>
 *
 * @see Json
 * @see JsonArray
 */
@StaticFunctional
@JDHeaderBackgroundImg(EmbedTagFileID="RJA_JDHBI_PRIM_CONS")
public class RJArrIntoPrimConsumer
{
    private RJArrIntoPrimConsumer() { }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Int DATA-PRIM_TYPE=int>
     * <EMBED CLASS='external-html' DATA-TYPE=Integer DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS>
     */
    @IntoHTMLTable(background=GreenDither, title="Java-Consumer which accepts Primitive-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 ToIntFunction<String> optionalUserParser,
            final IntConsumer           c
        )
    {
        Objects.requireNonNull(c, "IntConsumer parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Integer, Void>(
            SETTINGS_REC_BUILDER.createForConsumers(
                defaultValue,
                FLAGS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsInt,
                c::accept,
                BASIC_TYPES.PRIMITIVE_INTEGER()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Short DATA-PRIM_TYPE=short>
     * <EMBED CLASS='external-html' DATA-TYPE=Short DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS>
     */
    @IntoHTMLTable(background=BlueDither,
        title="Java-Consumer which accepts Primitive 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 ToShortFunction<String>   optionalUserParser,
            final ShortConsumer             c
        )
    {
        Objects.requireNonNull(c, "ShortConsumer parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Short, Void>(
            SETTINGS_REC_BUILDER.createForConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsShort,
                c::accept,
                BASIC_TYPES.PRIMITIVE_SHORT()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Byte DATA-PRIM_TYPE=byte>
     * <EMBED CLASS='external-html' DATA-TYPE=Byte DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS>
     */
    @IntoHTMLTable(background=GreenDither, title="Java-Consumer which accepts Primitive-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 ToByteFunction<String>    optionalUserParser,
            final ByteConsumer              c
        )
    {
        Objects.requireNonNull(c, "ByteConsumer parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Byte, Void>(
            SETTINGS_REC_BUILDER.createForConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsByte,
                c::accept,
                BASIC_TYPES.PRIMITIVE_BYTE()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Long DATA-PRIM_TYPE=long>
     * <EMBED CLASS='external-html' DATA-TYPE=Long DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS>
     */
    @IntoHTMLTable(background=BlueDither,
        title="Java-Consumer which accepts Primitive 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 ToLongFunction<String>    optionalUserParser,
            final LongConsumer              c
        )
    {
        Objects.requireNonNull(c, "LongConsumer parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Long, Void>(
            SETTINGS_REC_BUILDER.createForConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsLong,
                c::accept,
                BASIC_TYPES.PRIMITIVE_LONG()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Double DATA-PRIM_TYPE=double>
     * <EMBED CLASS='external-html' DATA-TYPE=Double DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS>
     */
    @IntoHTMLTable(background=GreenDither, title="Java-Consumer which accepts Primitive-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 ToDoubleFunction<String>  optionalUserParser,
            final DoubleConsumer            c
        )
    {
        Objects.requireNonNull(c, "DoubleConsumer parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Double, Void>(
            SETTINGS_REC_BUILDER.createForConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsDouble,
                c::accept,
                BASIC_TYPES.PRIMITIVE_DOUBLE()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Float DATA-PRIM_TYPE=float>
     * <EMBED CLASS='external-html' DATA-TYPE=Float DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS>
     */
    @IntoHTMLTable(background=BlueDither, title="Java-Consumer which accepts Primitive-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 ToFloatFunction<String>   optionalUserParser,
            final FloatConsumer             c
        )
    {
        Objects.requireNonNull(c, "FloatConsumer parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Float, Void>(
            SETTINGS_REC_BUILDER.createForConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsFloat,
                c::accept,
                BASIC_TYPES.PRIMITIVE_FLOAT()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=boolean DATA-CONS_TYPE=Bool DATA-PRIM_TYPE=boolean>
     * <EMBED CLASS='external-html' DATA-TYPE=Boolean DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS>
     */
    @IntoHTMLTable(background=GreenDither, title="Java-Consumer which accepts Primitive-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 Predicate<String> optionalUserParser,
            final BoolConsumer      c
        )
    {
        Objects.requireNonNull(c, "BoolConsumer parameter 'c' is null");

        ProcessJsonArray.booleanToJava(
            ja,
            // new SettingsRec<Boolean, Void>(
            SETTINGS_REC_BUILDER.createForConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::test,
                c::accept,
                BASIC_TYPES.PRIMITIVE_BOOLEAN()
            ));
    }




    // ********************************************************************************************
    // ********************************************************************************************
    // IntInt (w/ Array-Indices) Primitive-Consumer Variant
    // ********************************************************************************************
    // ********************************************************************************************




    /** <EMBED CLASS='external-html' DATA-TYPE=Integer DATA-FILE-ID=RJ_ARR_INTO_PRIM_TRIINT> */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer which accepts Primitive-Integers &amp; 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 ToIntFunction<String> optionalUserParser,
            final TriIntCons            c
        )
    {
        Objects.requireNonNull(c, "TriIntCons parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Integer, Void>(
            SETTINGS_REC_BUILDER.createForIIConsumers(
                defaultValue,
                FLAGS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsInt,
                c::accept,
                BASIC_TYPES.PRIMITIVE_INTEGER()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Short DATA-PRIM_TYPE=short>
     * <EMBED CLASS='external-html' DATA-TYPE=Short DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS2>
     */
    @IntoHTMLTable(
        background=GreenDither,
        title="Java-Consumer which accepts Primitive Short-Integers &amp; 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 ToShortFunction<String>   optionalUserParser,
            final IntIntShortCons           c
        )
    {
        Objects.requireNonNull(c, "IntIntShortCons parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Short, Void>(
            SETTINGS_REC_BUILDER.createForIIConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsShort,
                c::accept,
                BASIC_TYPES.PRIMITIVE_SHORT()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Byte DATA-PRIM_TYPE=byte>
     * <EMBED CLASS='external-html' DATA-TYPE=Byte DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS2>
     */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer which accepts Primitive-Bytes &amp; 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 ToByteFunction<String>    optionalUserParser,
            final IntIntByteCons            c
        )
    {
        Objects.requireNonNull(c, "IntIntByteCons parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Byte, Void>(
            SETTINGS_REC_BUILDER.createForIIConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsByte,
                c::accept,
                BASIC_TYPES.PRIMITIVE_BYTE()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Long DATA-PRIM_TYPE=long>
     * <EMBED CLASS='external-html' DATA-TYPE=Long DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS2>
     */
    @IntoHTMLTable(
        background=GreenDither,
        title="Java-Consumer which accepts Primitive Long-Integers &amp; 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 ToLongFunction<String>    optionalUserParser,
            final IntIntLongCons            c
        )
    {
        Objects.requireNonNull(c, "IntIntLongCons parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Long, Void>(
            SETTINGS_REC_BUILDER.createForIIConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsLong,
                c::accept,
                BASIC_TYPES.PRIMITIVE_LONG()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Double DATA-PRIM_TYPE=double>
     * <EMBED CLASS='external-html' DATA-TYPE=Double DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS2>
     */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer which accepts Primitive-Doubles &amp; 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 ToDoubleFunction<String>  optionalUserParser,
            final IntIntDoubleCons          c
        )
    {
        Objects.requireNonNull(c, "IntIntDoubleCons parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Double, Void>(
            SETTINGS_REC_BUILDER.createForIIConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsDouble,
                c::accept,
                BASIC_TYPES.PRIMITIVE_DOUBLE()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=numeric DATA-CONS_TYPE=Float DATA-PRIM_TYPE=float>
     * <EMBED CLASS='external-html' DATA-TYPE=Float DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS2>
     */
    @IntoHTMLTable(
        background=GreenDither,
        title="Java-Consumer which accepts Primitive-Floats &amp; 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 ToFloatFunction<String>   optionalUserParser,
            final IntIntFloatCons           c
        )
    {
        Objects.requireNonNull(c, "IntIntFloatCons parameter 'c' is null");

        ProcessJsonArray.numericToJava(
            ja,
            // new SettingsRec<Float, Void>(
            SETTINGS_REC_BUILDER.createForIIConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::applyAsFloat,
                c::accept,
                BASIC_TYPES.PRIMITIVE_FLOAT()
            ));
    }

    /**
     * <EMBED CLASS=defs DATA-METH_NAME=boolean DATA-CONS_TYPE=Bool DATA-PRIM_TYPE=boolean>
     * <EMBED CLASS='external-html' DATA-TYPE=Boolean DATA-FILE-ID=RJ_ARR_INTO_PRIM_CONS2>
     */
    @IntoHTMLTable(
        background=BlueDither,
        title="Java-Consumer which accepts Primitive-Booleans &amp; 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 Predicate<String>     optionalUserParser,
            final IntIntBoolCons        c
        )
    {
        Objects.requireNonNull(c, "IntIntBoolCons parameter 'c' is null");

        ProcessJsonArray.booleanToJava(
            ja,
            // new SettingsRec<Boolean, Void>(
            SETTINGS_REC_BUILDER.createForIIConsumers(
                defaultValue,
                FLAGS & NOT_ALLOWED_RET_NULL_MASKS,
                (optionalUserParser == null) ? null : optionalUserParser::test,
                c::accept,
                BASIC_TYPES.PRIMITIVE_BOOLEAN()
            ));
    }


}