gistfile1.java

package me.lory;

import java.io.IOException;
import java.net.UnknownHostException;
import java.util.Collection;

import me.lory.irc.ServerDescription;

/**
 * Describes an IRC server and a connection to that IRC server. Servers are
 * described by {@link ServerDescription}.
 * 
 * @author hornd
 *
 */
public interface IServer extends IServerMessageDispatcher {

	/**
	 * Connect to this server.
	 * 
	 * @throws IOException
	 * @throws UnknownHostException
	 */
	void connect() throws IOException, UnknownHostException;

	/**
	 * Disconnect from this server.
	 * 
	 * @throws IOException
	 */
	void disconnect() throws IOException;

	/**
	 * Returns true if connected, false otherwise.
	 */
	boolean isConnected();
	
	/**
	 * Return the collection of conversations associated with
	 * this server.
	 * @return
	 */
	Collection<IConversation> getConversations();
	
	/**
	 * Return the status conversation associated with this server.
	 * @return
	 */
	IConversation getStatusConversation();
}