communicationcontroller.java

自己写的一个聊天的小程序 请多多指教

/*
 * Copyright (c) 2003 - 2007, Silvio Meier and Tobias Reinhard
 *
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, 
 * with or without modification, are permitted provided 
 * that the following conditions are met:
 *
 *   o Redistributions of source code must retain the above 
 *     copyright notice, this list of conditions and the 
 *     following disclaimer.
 *   o Redistributions in binary form must reproduce the above 
 *     copyright notice, this list of conditions and the 
 *     following disclaimer in the documentation and/or other 
 *     materials provided with the distribution.
 *   o The names of its contributors may not be used to endorse 
 *     or promote products derived from this software without 
 *     specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
package net.sf.cscc;

/**
 * This interface is used for the decoupling of the
 * {@link net.sf.cscc.ObjectSender} and
 * {@link net.sf.cscc.ObjectReceiver} functionality from the
 * classes {@link net.sf.cscc.ClientConnectionManager}
 * and {@link net.sf.cscc.ServerConnectionManager}.
 *
 *	@author             Silvio Meier (SM)
 *	@copyright          Silvio Meier, Tobias Reinhard, 2003
 *	@history            2003-05-09 SM First Version
 *                      2003-05-14 SM working on additional methods and events,
 *                      some comments revised.
 *                      2003-05-20 TR Comments revised
 *                      2003-05-20 SM Modified interface access to package
 *                      private, interface must not be seen outside of
 *                      the component.
 *                      2006-10-28 SM Comments revised.
 *	@version            $Date: 2007/07/01 17:04:05 $, $Author: reode_orm $, $Revision: 1.1 $
 */
interface CommunicationController {
     /**
      *   This method  handles the breaking of a connection, ie.
      *   if a {@link net.sf.cscc.ObjectReceiver} or a
      *   {@ink ifi.comm.ObjectSender} thread gets informed about the
      *   the breaking of a connection of one of its
      *   communication partners.
      *
      *   @pre sender != null
      *   @post true
      *   @param sender sender or receiver to which the communication has broken
      *   the connection
     */
    void communicationBroken(Object sender);

    /**
     *   This method is called by an instance of
     *   {@link net.sf.cscc.ObjectReceiver}
     *   and causes the enqueuing of a received
     *   data event in the incoming data
     *   event queue.
     *
     *   @pre de != null
     *   @post true
     *   @param de DataEvent that has to be enqued in the queue
     */
    void enqueueIncomingDataEvent(DataEvent de);
}