package Torello.Browser.BrowserAPI;

import java.util.*;
import javax.json.*;
import javax.json.stream.*;
import java.io.*;

import java.lang.reflect.Method;
import java.lang.reflect.Parameter;
import java.util.function.Function;

import Torello.Browser.BrowserEvent;
import Torello.Browser.JavaScriptAPI.*;
import Torello.Browser.helper.*;

import Torello.Java.Additional.*;
import Torello.Java.JSON.*;

import static Torello.Java.JSON.JFlag.*;

import Torello.Java.StrCmpr;
import Torello.JavaDoc.StaticFunctional;
import Torello.JavaDoc.JDHeaderBackgroundImg;
import Torello.JavaDoc.Excuse;

/**
 * <SPAN CLASS=COPIEDJDK><B><CODE>[No Description Provided by Google]</CODE></B></SPAN>
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=CODE_GEN_NOTE>
 */
@StaticFunctional(Excused={"counter"}, Excuses={Excuse.CONFIGURATION})
@JDHeaderBackgroundImg(EmbedTagFileID="WOOD_PLANK_NOTE")
public class FileSystem
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private FileSystem () { }

    // These two Vector's are used by all the "Methods" exported by this class.  java.lang.reflect
    // is used to generate the JSON String's.  It saves thousands of lines of Auto-Generated Code.
    private static final Map<String, Vector<String>>    parameterNames = new HashMap<>();
    private static final Map<String, Vector<Class<?>>>  parameterTypes = new HashMap<>();

    // Some Methods do not take any parameters - for instance all the "enable()" and "disable()"
    // I simply could not get ride of RAW-TYPES and UNCHECKED warnings... so there are now,
    // offically, two empty-vectors.  One for String's, and the other for Classes.

    private static final Vector<String>     EMPTY_VEC_STR = new Vector<>();
    private static final Vector<Class<?>>   EMPTY_VEC_CLASS = new Vector<>();

    static
    {
        for (Method m : FileSystem.class.getMethods())
        {
            // This doesn't work!  The parameter names are all "arg0" ... "argN"
            // It works for java.lang.reflect.Field, BUT NOT java.lang.reflect.Parameter!
            //
            // Vector<String> parameterNamesList = new Vector<>(); -- NOPE!

            Vector<Class<?>> parameterTypesList = new Vector<>();
        
            for (Parameter p : m.getParameters()) parameterTypesList.add(p.getType());

            parameterTypes.put(
                m.getName(),
                (parameterTypesList.size() > 0) ? parameterTypesList : EMPTY_VEC_CLASS
            );
        }
    }

    static
    {
        Vector<String> v = null;

        v = new Vector<String>(1);
        parameterNames.put("getDirectory", v);
        Collections.addAll(v, new String[]
        { "bucketFileSystemLocator", });
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Types - Static Inner Classes
    // ********************************************************************************************
    // ********************************************************************************************

    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class File
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String name;
        
        /** Timestamp */
        public final Number lastModified;
        
        /** Size in bytes */
        public final Number size;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String type;
        
        /**
         * Constructor
         *
         * @param name -
         * 
         * @param lastModified Timestamp
         * 
         * @param size Size in bytes
         * 
         * @param type -
         */
        public File(String name, Number lastModified, Number size, String type)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (name == null)         THROWS.throwNPE("name");
            if (lastModified == null) THROWS.throwNPE("lastModified");
            if (size == null)         THROWS.throwNPE("size");
            if (type == null)         THROWS.throwNPE("type");
            
            this.name          = name;
            this.lastModified  = lastModified;
            this.size          = size;
            this.type          = type;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'File'}.
         */
        public File (JsonObject jo)
        {
            this.name          = ReadJSON.getString(jo, "name", false, true);
            this.lastModified  = ReadNumberJSON.get(jo, "lastModified", false, true);
            this.size          = ReadNumberJSON.get(jo, "size", false, true);
            this.type          = ReadJSON.getString(jo, "type", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            File o = (File) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.lastModified, o.lastModified)
                &&  Objects.equals(this.size, o.size)
                &&  Objects.equals(this.type, o.type);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.lastModified)
                +   Objects.hashCode(this.size)
                +   Objects.hashCode(this.type);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class Directory
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String name;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String[] nestedDirectories;
        
        /** Files that are directly nested under this directory. */
        public final FileSystem.File[] nestedFiles;
        
        /**
         * Constructor
         *
         * @param name -
         * 
         * @param nestedDirectories -
         * 
         * @param nestedFiles Files that are directly nested under this directory.
         */
        public Directory(String name, String[] nestedDirectories, FileSystem.File[] nestedFiles)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (name == null)              THROWS.throwNPE("name");
            if (nestedDirectories == null) THROWS.throwNPE("nestedDirectories");
            if (nestedFiles == null)       THROWS.throwNPE("nestedFiles");
            
            this.name               = name;
            this.nestedDirectories  = nestedDirectories;
            this.nestedFiles        = nestedFiles;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Directory'}.
         */
        public Directory (JsonObject jo)
        {
            this.name               = ReadJSON.getString(jo, "name", false, true);
            this.nestedDirectories = (jo.getJsonArray("nestedDirectories") == null)
                ? null
                : RJArrIntoStream.strArr(jo.getJsonArray("nestedDirectories"), null, 0).toArray(String[]::new);
        
            this.nestedFiles = (jo.getJsonArray("nestedFiles") == null)
                ? null
                : RJArrIntoStream.objArr(jo.getJsonArray("nestedFiles"), null, 0, FileSystem.File.class).toArray(FileSystem.File[]::new);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            Directory o = (Directory) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Arrays.deepEquals(this.nestedDirectories, o.nestedDirectories)
                &&  Arrays.deepEquals(this.nestedFiles, o.nestedFiles);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Arrays.deepHashCode(this.nestedDirectories)
                +   Arrays.deepHashCode(this.nestedFiles);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class BucketFileSystemLocator
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, true, false, }; }
        
        /** Storage key */
        public final String storageKey;
        
        /**
         * Bucket name. Not passing a {@code bucketName} will retrieve the default Bucket. (https://developer.mozilla.org/en-US/docs/Web/API/Storage_API#storage_buckets)
         * <BR /><B CLASS=Opt>OPTIONAL</B>
         */
        public final String bucketName;
        
        /** Path to the directory using each path component as an array item. */
        public final String[] pathComponents;
        
        /**
         * Constructor
         *
         * @param storageKey Storage key
         * 
         * @param bucketName Bucket name. Not passing a {@code bucketName} will retrieve the default Bucket. (https://developer.mozilla.org/en-US/docs/Web/API/Storage_API#storage_buckets)
         * <BR /><B CLASS=Opt>OPTIONAL</B>
         * 
         * @param pathComponents Path to the directory using each path component as an array item.
         */
        public BucketFileSystemLocator
            (String storageKey, String bucketName, String[] pathComponents)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (storageKey == null)     THROWS.throwNPE("storageKey");
            if (pathComponents == null) THROWS.throwNPE("pathComponents");
            
            this.storageKey      = storageKey;
            this.bucketName      = bucketName;
            this.pathComponents  = pathComponents;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'BucketFileSystemLocator'}.
         */
        public BucketFileSystemLocator (JsonObject jo)
        {
            this.storageKey      = ReadJSON.getString(jo, "storageKey", false, true);
            this.bucketName      = ReadJSON.getString(jo, "bucketName", true, false);
            this.pathComponents = (jo.getJsonArray("pathComponents") == null)
                ? null
                : RJArrIntoStream.strArr(jo.getJsonArray("pathComponents"), null, 0).toArray(String[]::new);
        
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (this == other)                       return true;
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            BucketFileSystemLocator o = (BucketFileSystemLocator) other;
        
            return
                    Objects.equals(this.storageKey, o.storageKey)
                &&  Objects.equals(this.bucketName, o.bucketName)
                &&  Arrays.deepEquals(this.pathComponents, o.pathComponents);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.storageKey)
                +   Objects.hashCode(this.bucketName)
                +   Arrays.deepHashCode(this.pathComponents);
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @param bucketFileSystemLocator -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link FileSystem.Directory}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link FileSystem.Directory}&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link FileSystem.Directory} (<B>directory</B></CODE>)
     *     <BR />Returns the directory object at the path.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, FileSystem.Directory> getDirectory
        (FileSystem.BucketFileSystemLocator bucketFileSystemLocator)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (bucketFileSystemLocator == null) THROWS.throwNPE("bucketFileSystemLocator");
        
        final int       webSocketID = 26000000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getDirectory"),
            parameterNames.get("getDirectory"),
            optionals, webSocketID,
            "FileSystem.getDirectory",
            bucketFileSystemLocator
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'FileSystem.Directory'
        Function<JsonObject, FileSystem.Directory> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "directory", FileSystem.Directory.class, false, true);
        
        return new Script<>(webSocketID, requestJSON, responseProcessor);
    }
    
}