/*
 * Crķķ le 19 juil. 2004
 *
 */
package traitement.distance;

import principal.copiercoller.HomonymeIntrouvableException;
import principal.copiercoller.InterfaceHomonyme;
import traitement.modele.Modele;


/**
 * ensemble de mķthodes qui doivent Ļtre implķmentķes par un objet contenant une Distance.
 * 
 * @author	Vincent Labatut
 * @version	1
 * @see		traitement.distance.InterfaceDistance
  */
public interface InterfaceContientDistance
{
//	----------------------------------------	
//	Distance
//	----------------------------------------
	/**
	 * renvoie la Distance contenue par cette InterfaceContientDistance.
	 * 
	 * @return	la Distance appartenant Ó cette InterfaceContientDistance.
	  */
	public InterfaceDistance getDistance();

//	----------------------------------------	
//	Modele
//	----------------------------------------
	/**
	 * renvoie le Modele qui contient indirectement cette InterfaceContientDistance.  
	 * 
	 * @return	le Modele contenant cette InterfaceContientDistance.
	  */
	public Modele getModele();

//	----------------------------------------	
//	Copier/Coller/Undo
//	----------------------------------------
	/**
	 * renvoie l'homonyme de cette InterfaceContientDistance dans un autre Modele.
	 * Si l'homonyme n'existe pas, une ObjetRageIntrouvableException est levķe.
	 * 
	 * @param	modele	Modele dans lequel il faut chercher l'homonyme.
	 * @return 	l'homonyme de cette InterfaceContientDistance.
	 * @throws	ObjetRageIntrouvableException s'il n'existe pas d'homonyme dans le Modele passķ en paramĶtre.
	  */
	public InterfaceHomonyme getHomonyme(Modele modele) throws HomonymeIntrouvableException;
	/**
	 * renvoie une reprķsentation textuelle de cette InterfaceContientDistance, en 
	 * remontant Ó partir de celle-ci jusqu'Ó ses parents.
	 * (utilisķ lors du dķbuggage)  
	 * 
	 * @return	une reprķsentation textuelle de cette InterfaceContientDistance.
	  */
	public String getIdentification();
}