/*
	Netwar
	Copyright (C) 2002  Daniel Grund, Kyle Kakligian, Jason Komutrattananon, & Brian Hibler.

	This file is part of Netwar.

	Netwar 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 2 of the License, or
	(at your option) any later version.

	Netwar 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 Netwar; if not, write to the Free Software
	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

package netwar.network;
import netwar.game.Command;
import netwar.settings.GameSettings;
import java.rmi.*;


/**
 * The Client network adapter that sends and recieves commands to and from the Netwar Server.
 * @author Group N2-Project Netwar
 * @author Jason Komutrattananon
 */
public interface NetworkClientInterface extends Remote{

	/**
	 * The Netwar server will send the complete set of commands once it recieves them from every single player using this method
	 * RMI type: Server
	 * @param completeSetOfCommands the server sends this Command array which should be the complete set of commands for 1 cycle
	 */
	public void setCompleteSetOfCommands(Command[] completeSetOfCommands) throws RemoteException;

	/**
	 * Signals the local machine that the server wants to start the game.
	 * RMI type: Server
	 */
	public void startGame() throws RemoteException;

	/**
	 * Remote method used to recieve settings and set them locally
	 * RMI method: Server
	 * @param gameSettings is the game settings that need to be propogated to all the players
	 */
	public void clientRecieveSettings(GameSettings gameSettings) throws RemoteException;
	
	/**
	 * invokes the method that displays the chat message to the player's screen
	 * RMI type: Server
	 * @param chatMessage The message to be displayed to the players screen.
	 */
	public void displayChat(String chatMessage) throws RemoteException;
	
	/**
	 * Sets the player's number. This method is primarily used for when a player is dropping out of the game before the game is started.
	 * RMI type: Server
	 * @param newPlayerNumber the new number that will be assigned to this player.
	 */
	public void setPlayerNumber(int newPlayerNumber) throws RemoteException;
}