usersinfomanager.java

enable to do work a local chat in java using UDP

package fr.iutvalence.java.tp8.chat.server;

import fr.iutvalence.java.tp8.chat.server.exceptions.InformationAccessException;
import fr.iutvalence.java.tp8.chat.server.exceptions.NotConnectedException;
import fr.iutvalence.java.tp8.chat.server.exceptions.UnknownUserException;

/**
 * Exercice d'application sur l'utilisation de JDBC (TP8).<br/> Interface
 * définissant le comportement attendu d'un mécanisme de gestion des
 * informations utilisateurs (via un fichier, une bd, ...) <br/><br/>
 * 
 * Commentaires à [e-mail]
 * 
 * @author Sébastien JEAN, IUT Valence, oct. 2006
 * @version 1.0
 */
public interface UsersInfoManager
{
	/**
	 * Obtention du mot de passe associé à un utilisateur
	 * 
	 * @param pseudo le pseudonyme de l'utilisateur
	 * @return le mot de passe associé à l'utilisateur <tt>pseudo</tt> s'il
	 *         existe.
	 * @throws UnknownUserException si le pseudonyme ne désigne pas un
	 *         utilisateur connnu.
	 * @throws InformationAccessException si l'accès à l'information échoue.
	 */
	public String getPassword(String pseudo) throws UnknownUserException,
			InformationAccessException;

	/**
	 * Obtention de l'état de présence d'un utilisateur connecté.
	 * 
	 * @param pseudo le pseudonyme de l'utilisateur.
	 * @return <tt>true</tt> si l'utilisateur <tt>pseudo</tt> est connecté
	 *         et présent, <tt>false</tt> si l'utilisateur <tt>pseudo</tt>
	 *         est connecté et absent.
	 * @throws UnknownUserException si le pseudonyme ne désigne pas un
	 *         utilisateur connu.
	 * @throws NotConnectedException si l'utilisateur <tt>pseudo</tt> n'est
	 *         pas connecté.
	 * @throws InformationAccessException si l'accès à l'information échoue.
	 */
	public boolean getAwayState(String pseudo) throws UnknownUserException,
			NotConnectedException, InformationAccessException;

	/**
	 * Modification de l'état de présence d'un utilisateur connecté.
	 * 
	 * @param pseudo le pseudonyme de l'utilisateur.
	 * @param away le nouvel état de présence.
	 * @throws UnknownUserException si le pseudonyme ne désigne pas un
	 *         utilisateur connu.
	 * @throws NotConnectedException si l'utilisateur <tt>pseudo</tt> n'est
	 *         pas connecté.
	 * @throws InformationAccessException si l'accès à l'information échoue.
	 */
	public void setAwayState(String pseudo, boolean away)
			throws UnknownUserException, NotConnectedException,
			InformationAccessException;

	/**
	 * Obtention de l'état de connexion d'un utilisateur.
	 * 
	 * @param pseudo le pseudonyme de l'utilisateur.
	 * @return <tt>true</tt> si l'utilisateur <tt>pseudo</tt> est connecté,
	 *         <tt>false</tt> sinon.
	 * @throws UnknownUserException si le pseudonyme ne désigne pas un
	 *         utilisateur connu.
	 * @throws InformationAccessException si l'accès à l'information échoue.
	 */
	public boolean getConnectionState(String pseudo)
			throws UnknownUserException, InformationAccessException;

	/**
	 * Modification de l'état de connexion d'un utilisateur.
	 * 
	 * @param pseudo le pseudonyme de l'utilisateur.
	 * @param connected le nouvel état de connexion.
	 * @throws UnknownUserException si le pseudonyme ne désigne pas un
	 *         utilisateur connu.
	 * @throws InformationAccessException si l'accès à l'information échoue.
	 */
	public void setConnectionState(String pseudo, boolean connected)
			throws UnknownUserException, InformationAccessException;
}