package project;

/**
 * The world for Multi-User Grinnell.  Although it violates
 * some standards of object-oriented design, we use the world
 * as a central repository for all our objects.
 *
 * @author CSC152 2004F
 * @version 1.0 of November 2004
 */
public interface WorldInterface
{

// Methods for "normal" UI to interact with.
	
	/**
	 * Get the location of someone in the world.
	 */
	public String getLocation(String name);
	
	/**
	 * Get the description of something (a noun).
	 */
	public String describe(String name);
	
	/**
	* Find all the people in a room
	*/
	public String[] listPeople(String room);
	
	/**
	* find all the things in a room
	*/
	public String[] listContents(String room);
	
	/**
	 * Record that an interaction has happened.  Return a comment on the
	 * results of the action.
	 *
	 * @exception
	 *   If the action is invalid or the object is invalid or ...
	 */
	public String perform(Action tim)
		throws InvalidVerbException, InvalidTargetException;

} // interface World