netkorp / spring-boot-telegram-framework

import com.github.netkorp.telegram.framework.annotations.TelegramCommand;

import com.github.netkorp.telegram.framework.commands.interfaces.Command;

import com.github.netkorp.telegram.framework.commands.interfaces.HelpCommand;

import com.github.netkorp.telegram.framework.commands.interfaces.MultistageCommand;

import com.github.netkorp.telegram.framework.commands.multistage.MultistageCloseCommand;

import com.github.netkorp.telegram.framework.commands.multistage.MultistageDoneCommand;

import com.github.netkorp.telegram.framework.properties.CommandProperties;

import com.github.netkorp.telegram.framework.exceptions.CommandNotActive;

import com.github.netkorp.telegram.framework.exceptions.CommandNotFound;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.stereotype.Component;

import java.lang.invoke.MethodHandles;

import java.util.HashMap;

import java.util.LinkedList;

import java.util.List;

import java.util.Map;

import java.util.Optional;

/**

 * Provides the component for managing all of the commands available in the bot.

 * It includes the management of non-secure commands, active command, basic commands and

 * those commands that are involved in the multistage command flow.

 */

@Component

    /**

     * The list of the available commands into a map to get a quick access from its name.

     */

    private final Map<String, Command> commandsByFullName;

    /**

     * The list of the available commands.

     */

    private final List<Command> commands;

    /**

     * The list of the non-secure commands.

     */

    private final List<Command> nonSecureCommands;

    /**

     * The command that is active for each user.

     */

    private final Map<Long, MultistageCommand> activeCommand;

    /**

     * The properties of the commands.

     */

    private final CommandProperties commandProperties;

    /**

     * It is kept here for a quick access to the close command.

     */

    private MultistageCloseCommand closeCommand;

    /**

     * It is kept here for a quick access to the done command.

     */

    private MultistageDoneCommand doneCommand;

    /**

     * The command that shows the help of the bot.

     * It is kept here for a quick access to the help command.

     */

    private HelpCommand helpCommand;

    /**

     * Constructs a new {@link CommandManager} instance with the list of available {@link Command}

     * and the properties of the commands.

     *

     * @param commands          the list of available {@link Command}.

     * @param commandProperties the properties of the commands.

     */

    @Autowired

        this.commands = new LinkedList<>();

        this.nonSecureCommands = new LinkedList<>();

        this.activeCommand = new HashMap<>();

        this.commandProperties = commandProperties;

        commands.stream()

                .forEach(this::addCommand);

    }

    /**

     * Adds the command to the list of available/non-secure commands and sets the commands for

     * {@link #closeCommand}, {@link #doneCommand} and {@link #helpCommand}.

     *

     * @param command the command to be added.

     * @see #commandsByFullName

     * @see #commands

     * @see #nonSecureCommands

     * @see #closeCommand

     * @see #doneCommand

     * @see #helpCommand

     */

        }

    }

    /**

     * Returns {@code true} if the command name is a valid name for a command.

     *

     * @param commandName the name of the command to validate.

     * @return {@code true} if the command name is a valid name for a command; {@code false} otherwise.

     */

    }

    /**

     * Returns {@code true} if the command is non-secure.

     *

     * @param command the command to be processed.

     * @return {@code true} if the command is non-secure; {@code false} otherwise.

     */

    }

    /**

     * Returns the names of the command (the same names declared on {@link TelegramCommand#name()}).

     * The names may include the slash (/).

     *

     * @param command the command from which the names will be identified.

     * @return the names of the command.

     */

    }

    /**

     * Returns the name of the command. It includes the slash (/).

     *

     * @param commandName the command's name (the same name declared on {@link TelegramCommand#name()})

     * @return the name of the command.

     */

    }

    /**

     * Returns the names of the command. They include the slash (/).

     *

     * @param command the command from which the names will be identified.

     * @return the names of the command.

     */

        }

        return commandFullNames;

    }

    /**

     * Returns the {@link Command} instance from the command name.

     *

     * @param command the command name.

     * @return the {@link Command} instance.

     * @throws CommandNotFound if the name is not related to any commands.

     */

        }

        return this.commandsByFullName.get(command);

    }

    /**

     * Sets the multistage command as the active one.

     *

     * @param idChat  the chat identification of the user for whom the multistage command will be active.

     * @param command the command to activate.

     */

    }

    /**

     * Gets the active command for the user.

     *

     * @param idChat the chat identification of the user.

     * @return the active command.

     * @throws CommandNotActive if there is no an active command.

     */

        }

        return activeCommand.get(idChat);

    }

    /**

     * Removes the active command.

     *

     * @param idChat the chat identification of the user.

     */

    }

    /**

     * Returns {@code true} if there is an active command.

     *

     * @param idChat the chat identification of the user.

     * @return {@code true} if there is an active command; {@code false} otherwise.

     */

    }

    /**

     * Returns the {@link MultistageCloseCommand} if it exists.

     *

     * @return the {@link MultistageCloseCommand} instance.

     */

    }

    /**

     * Returns the {@link MultistageDoneCommand} if it exists.

     *

     * @return the {@link MultistageDoneCommand} instance.

     */

    }

    /**

     * Returns the {@link HelpCommand} if it exists.

     *

     * @return the {@link HelpCommand} instance.

     */

    }

    /**

     * Returns a list with the available commands.

     *

     * @return the available commands.

     */

    }

    /**

     * Returns a list with the available non-secure commands.

     *

     * @return the available non-secure commands.

     */

    }

}