AbstractRS274CommandBuilder.java

/*******************************************************************************
 * 	This file is part of Goko.
 *
 *   Goko is free software: you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation, either version 3 of the License, or
 *   (at your option) any later version.
 *
 *   Goko 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 General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with Goko.  If not, see <http://www.gnu.org/licenses/>.
 *******************************************************************************/
package org.goko.core.rs274ngcv3.parser.advanced;

import java.util.List;

import org.goko.core.common.exception.GkException;
import org.goko.core.gcode.bean.GCodeCommand;
import org.goko.core.gcode.bean.GCodeContext;
import org.goko.core.rs274ngcv3.parser.GCodeToken;

/**
 * Abstract RS274 commands builder
 * @author PsyKo
 *
 * @param <T> the type of builded command
 */
public abstract class AbstractRS274CommandBuilder<T extends GCodeCommand> implements IRS274CommandBuilder<T> {

	/**
	 * Instantiate the constructed command
	 * @return the T command
	 * @throws GkException GkException
	 */
	protected abstract T newInstance() throws GkException;
	/**
	 * Build the command by reading information in the rawCommand and completing the targetCommand
	 * @param lstTokens the list of GCodeTokens
	 * @param context the context
	 * @param targetCommand the target command
	 * @return the built T command
	 * @throws GkException GkException
	 */
	protected abstract void buildCommand(List<GCodeToken> lstTokens, GCodeContext context, T targetCommand) throws GkException;
	/**
	 * Build the command by reading information in the rawCommand and completing the targetCommand
	 * @param lstTokens the list of GCodeTokens
	 * @param context the context
	 * @return the built T command
	 * @throws GkException GkException
	 */
	@Override
	public T createCommand(List<GCodeToken> lstTokens, GCodeContext context) throws GkException{
		T command = newInstance();
		buildCommand(lstTokens, context, command);
		return command;
	}
}