Arakne / Araknemu

 * This file is part of Araknemu.

 *

 * Araknemu is free software: you can redistribute it and/or modify

 * it under the terms of the GNU Lesser General Public License as published by

 * the Free Software Foundation, either version 3 of the License, or

 * (at your option) any later version.

 *

 * Araknemu is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU Lesser General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser General Public License

 * along with Araknemu.  If not, see <https://www.gnu.org/licenses/>.

 *

 * Copyright (c) 2017-2020 Vincent Quatrevieux

 */

package fr.quatrevieux.araknemu.game.exploration.npc.dialog;

import fr.quatrevieux.araknemu.data.world.entity.environment.npc.Npc;

import fr.quatrevieux.araknemu.data.world.entity.environment.npc.Question;

import fr.quatrevieux.araknemu.data.world.entity.environment.npc.ResponseAction;

import fr.quatrevieux.araknemu.data.world.repository.environment.npc.QuestionRepository;

import fr.quatrevieux.araknemu.data.world.repository.environment.npc.ResponseActionRepository;

import fr.quatrevieux.araknemu.game.PreloadableService;

import fr.quatrevieux.araknemu.game.exploration.npc.dialog.action.Action;

import fr.quatrevieux.araknemu.game.exploration.npc.dialog.action.ActionFactory;

import fr.quatrevieux.araknemu.game.exploration.npc.dialog.action.dialog.LeaveDialog;

import fr.quatrevieux.araknemu.game.exploration.npc.dialog.action.dialog.NextQuestion;

import fr.quatrevieux.araknemu.game.exploration.npc.dialog.parameter.ParametersResolver;

import org.apache.commons.lang3.ArrayUtils;

import org.apache.logging.log4j.Logger;

import org.checkerframework.checker.nullness.qual.Nullable;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.Collection;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import java.util.Optional;

import java.util.concurrent.ConcurrentHashMap;

import java.util.stream.Collectors;

/**

 * Manage dialogs, questions, responses and actions

 */

public final class DialogService implements PreloadableService {

    private final QuestionRepository questionRepository;

    private final ResponseActionRepository responseActionRepository;

    private final ParametersResolver parametersResolver;

    private final Logger logger;

    private final Map<String, ActionFactory> actionFactories = new HashMap<>();

    private final Map<Integer, NpcQuestion> questions = new ConcurrentHashMap<>();

    private final Map<Integer, Response> responses = new ConcurrentHashMap<>();

    public DialogService(QuestionRepository questionRepository, ResponseActionRepository responseActionRepository, ActionFactory[] actionFactories, ParametersResolver parametersResolver, Logger logger) {

        this.questionRepository = questionRepository;

        this.responseActionRepository = responseActionRepository;

        this.parametersResolver = parametersResolver;

        this.logger = logger;

        initActionFactories(actionFactories);

    }

    @Override

    public void preload(Logger logger) {

        logger.info("Loading dialogs responses...");

        createResponses(responseActionRepository.all());

        logger.info("{} responses loaded", responses.size());

        logger.info("Loading dialogs questions...");

        questionRepository.all().forEach(question -> createQuestion(question, false));

        logger.info("{} questions loaded", questions.size());

    }

    @Override

    public String name() {

        return "npc.dialog";

    }

    /**

     * Get list of questions for a given NPC

     */

    public Collection<NpcQuestion> forNpc(Npc npc) {

        return byIds(npc.questions());

    }

    /**

     * Get list of questions

     *

     * Note: If the returned questions size if different from requested questions, a warning will be logged without fail

     */

    public Collection<NpcQuestion> byIds(int[] ids) {

        return loadQuestionFromCache(ids).orElseGet(() -> loadQuestionFromDatabase(ids));

    }

    /**

     * Register a new response action factory

     */

    public void registerActionFactory(ActionFactory factory) {

        actionFactories.put(factory.type(), factory);

    }

    /**

     * Create or retrieve a NpcQuestion from an entity

     *

     * @param fromDatabase Allows loading responses from database ? false during preloading

     */

    private NpcQuestion createQuestion(Question entity, boolean fromDatabase) {

        return questions.computeIfAbsent(

            entity.id(),

            id -> new NpcQuestion(entity, responsesByQuestion(entity, fromDatabase), parametersResolver)

        );

    }

    /**

     * Try to load all questions from cache

     * If at least one question is not into the cache, will returns nothing (and let loading from database)

     */

    private Optional<Collection<NpcQuestion>> loadQuestionFromCache(int[] ids) {

        for (int id : ids) {

            final NpcQuestion cachedQuestion = this.questions.get(id);

            if (cachedQuestion == null) {

                return Optional.empty();

            }

            questions.add(cachedQuestion);

        }

        return Optional.of(questions);

    }

    /**

     * Load all questions from database

     */

    private Collection<NpcQuestion> loadQuestionFromDatabase(int[] ids) {

            .stream()

            .map(question -> createQuestion(question, true))

            .collect(Collectors.toList())

        ;

        if (questions.size() != ids.length) {

            logger.warn(

                "NPC question not found : requested {}, actual {}",

                Arrays.toString(ids),

                questions.stream()

                    .map(question -> Integer.toString(question.id()))

                    .collect(Collectors.joining(", ", "[", "]"))

            );

        }

        return questions;

    }

    /**

     * Load responses for a question

     *

     * @param question The question entity

     * @param fromDatabase Allows loading responses from database ? false during preloading

     *

     * @return The list of responses

     */

    private Collection<Response> responsesByQuestion(Question question, boolean fromDatabase) {

        // Disallow loading from database : only retrieve loaded questions

        if (!fromDatabase) {

            return responsesFromIds(question.responseIds());

        }

        // Check if all responses are already loaded

        if (responses.keySet().containsAll(Arrays.asList(ArrayUtils.toObject(question.responseIds())))) {

            return responsesFromIds(question.responseIds());

        }

        // Load an creates responses

        return createResponses(responseActionRepository.byQuestion(question));

    }

    /**

     * Get already loaded responses from ids

     *

     * @param responseIds List of response ids to get

     *

     * @return The list of responses

     */

    private Collection<Response> responsesFromIds(int[] responseIds) {

        for (int id : responseIds) {

            final Response response = this.responses.get(id);

            if (response != null) {

                responses.add(response);

            }

        }

        return responses;

    }

    /**

     * Create responses from actions

     *

     * @param responsesActions Actions, grouping by the response id

     */

    private Collection<Response> createResponses(Map<Integer, List<ResponseAction>> responsesActions) {

        for (Map.Entry<Integer, List<ResponseAction>> entry : responsesActions.entrySet()) {

            responses.add(

                this.responses.computeIfAbsent(

                    entry.getKey(),

                    id -> createResponse(id, entry.getValue())

                )

            );

        }

        return responses;

    }

    /**

     * Create a dialog response

     */

    private Response createResponse(int id, List<ResponseAction> actionEntities) {

        final List<Action> actions = new ArrayList<>(actionEntities.size());

        for (ResponseAction actionEntity : actionEntities) {

            final Action action = createAction(actionEntity);

            if (action != null) {

                actions.add(action);

            }

        }

        return new Response(id, actions);

    }

    /**

     * Create a single response action

     * Note: If the action is not supported, the method will log a warning, and return null

     *

     * @return The created action or null if no factory is found (a warning will be logged)

     */

    private @Nullable Action createAction(ResponseAction action) {

        final ActionFactory factory = actionFactories.get(action.action());

        if (factory == null) {

            logger.warn("Response action {} is not supported for response {}", action.action(), action.responseId());

            return null;

        }

        return factory.create(action);

    }

    /**

     * Initialize factories

     * Note: Because of circular references, all dialog actions are registered here instead of the module

     */

}