INetwork.java

package alma.logoot.network;

/**
 * The {@link INetwork} interface specifies the methods the
 * <code>Controller</code> will use to send and get patch for collaborative
 * work.
 * 
 * @author Adrien Bougouin adrien.bourgoin{at}gmail{dot}com
 * @author Adrien Drouet drizz764{at}gmail{dot}com
 * @author Alban Ménager alban.menager{at}gmail{dot}com
 * @author Alexandre Prenza prenza.a{at}gmail{dot}com
 * @author Ronan-Alexandre Cherrueau ronancherrueau{at}gmail{dot}com
 */
public interface INetwork {
  /**
   * Sends information over network.
   * 
   * @param object
   *          Object to send.
   */
  void send(String object);

  /**
   * Connect a new user to the network.
   * 
   * Connect a user to the network. You must register with connect before sends
   * informations with <code>INetwork::send()</code>.
   * 
   * @return A unique identifier of the user on the network.
   */
  Integer connect();

  /**
   * Allow a user to listen to a network.
   * 
   * Whenever new information is send to this Network contributor, the
   * {@link IReceiveListener} is call to execute specific code.
   * 
   * @param listener
   *          Listener to call at each new received informations.
   */
  void addReceiverListener(IReceiveListener listener);
  
  public Integer getId();
}