package org.menacheri.app;

import org.menacheri.protocols.IProtocol;
import org.menacheri.service.IGameConnectionService;


/**
 * This interface abstracts a user session to a {@link IGame}. The
 * implementation class of this interface will not be used in isolation but
 * would be connected by the {@link IGameConnectionService} to a
 * {@link IGameRoom} based on some reference key or other input.
 * 
 * @author Abraham Menacherry
 * 
 */
public interface IPlayerSession extends ISession
{
	/**
	 * Each session is associated with a {@link IPlayer}. This is the actual
	 * human or machine using this session.
	 * 
	 * @return Returns that associated Player object or null if it is not
	 *         associated yet.
	 */
	public abstract IPlayer getPlayer();

	/**
	 * Set the {@link IPlayer} associated with this session. The lookup to find
	 * the player can be done using the lookup service based on some reference
	 * key provided by this session.
	 * 
	 * @param player
	 */
	public abstract void setPlayer(IPlayer player);

	/**
	 * Each user session is attached to a game room. This method is used to retrieve that
	 * game room object.
	 * 
	 * @return Returns the associated game room object or null if none is
	 *         associated.
	 */
	public abstract IGameRoom getGameRoom();

	/**
	 * Method used to set the game room for a particular session.
	 * 
	 * @param gameRoom
	 *            The gameRoom object to set.
	 */
	public abstract void setGameRoom(IGameRoom gameRoom);

	/**
	 * Get the {@link IProtocol} associated with this session.
	 * 
	 * @return Returns the associated enumeration or default AMF3_STRING.
	 */
	public IProtocol getProtocol();

	/**
	 * Set the protocol on the user session.
	 * 
	 * @param protocol
	 *            The {@link IProtocol} enumeration to set.
	 */
	public void setProtocol(IProtocol protocol);
}

@@ -786,287 +786,8 @@
 %0D%0A%0D%0A
-%09/**%0D%0A%09 * Set the %7B@link IPlayer%7D associated with this session. The lookup to find%0D%0A%09 * the player can be done using the lookup service based on some reference%0D%0A%09 * key provided by this session.%0D%0A%09 * %0D%0A%09 * @param player%0D%0A%09 */%0D%0A%09public abstract void setPlayer(IPlayer player);%0D%0A%0D%0A
 %09/**

Set player method is removed since it is supposed to be supplied via a constructor argument. The playersession now has it as a final variable.