source: trunk/autoquest-ui-core/src/main/java/de/ugoe/cs/autoquest/commands/usage/AbstractTrainCommand.java @ 927

//   Copyright 2012 Georg-August-Universität Göttingen, Germany
//
//   Licensed under the Apache License, Version 2.0 (the "License");
//   you may not use this file except in compliance with the License.
//   You may obtain a copy of the License at
//
//       http://www.apache.org/licenses/LICENSE-2.0
//
//   Unless required by applicable law or agreed to in writing, software
//   distributed under the License is distributed on an "AS IS" BASIS,
//   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//   See the License for the specific language governing permissions and
//   limitations under the License.

package de.ugoe.cs.autoquest.commands.usage;

import java.util.Collection;
import java.util.List;

import de.ugoe.cs.autoquest.CommandHelpers;
import de.ugoe.cs.autoquest.SequenceInstanceOf;
import de.ugoe.cs.autoquest.eventcore.Event;
import de.ugoe.cs.autoquest.usageprofiles.TrieBasedModel;
import de.ugoe.cs.util.console.Command;
import de.ugoe.cs.util.console.GlobalDataContainer;

/**
 * <p>
 * Abstract class for commands to train {@link TrieBasedModel}s.
 * </p>
 * 
 * @author Steffen Herbold
 * @version 1.0
 */
public abstract class AbstractTrainCommand implements Command {

        /**
         * <p>
         * Handling of additional parameters.
         * </p>
         * 
         * @param parameters
         *            same as the parameters passed to {@link #run(List)}.
         * @throws Exception
         *             thrown, if there is an error parsing the parameters
         */
        abstract void handleAdditionalParameters(List<Object> parameters)
                        throws Exception;

        /**
         * <p>
         * Returns a concrete instance of {@link TrieBasedModel} to be trained. This
         * is a factory method.
         * </p>
         * 
         * @return instance of {@link TrieBasedModel}
         */
        abstract TrieBasedModel createModel();

        /**
         * <p>
         * The command is implemented as a template method. The general structure of
         * the command is always the same, only the parameters of the command and
         * the creation of the {@link TrieBasedModel} instance. The former is
         * handled by {@link #handleAdditionalParameters(List)}, the latter by
         * {@link #createModel()}.
         * </p>
         * 
         * @see de.ugoe.cs.util.console.Command#run(java.util.List)
         */
        @SuppressWarnings("unchecked")
        @Override
        public void run(List<Object> parameters) {
                String modelname;
                String sequencesName;

                try {
                        modelname = (String) parameters.get(0);
                        sequencesName = (String) parameters.get(1);
                        handleAdditionalParameters(parameters);
                } catch (Exception e) {
                        throw new IllegalArgumentException();
                }

                Object dataObject = GlobalDataContainer.getInstance().getData(
                                sequencesName);
                if (dataObject == null) {
                        CommandHelpers.objectNotFoundMessage(sequencesName);
                        return;
                }
                if (!SequenceInstanceOf.isCollectionOfSequences(dataObject)) {
                        CommandHelpers.objectNotType(sequencesName,
                                        "Collection<List<Event<?>>>");
                        return;
                }
                Collection<List<Event>> sequences = (Collection<List<Event>>) dataObject;

                TrieBasedModel model = createModel();
                model.train(sequences);
                if (GlobalDataContainer.getInstance().addData(modelname, model)) {
                        CommandHelpers.dataOverwritten(modelname);
                }

        }

}