iudpservice.java

一个实用工具类

/*
 * Copyright (C) butor.com. All rights reserved.
 *
 * This software is published under the terms of the GNU Library General
 * Public License (GNU LGPL), a copy of which has been included with this
 * distribution in the LICENSE.txt file. 
 */


package org.butor.net.udp;

/**
 * ----------------------------------------------------------------
 * 2002/06/20,fm,as: Creation
 */
import java.util.Hashtable;

/**
 * 
 *
 * @author Filipe Mateus, Aiman Sawan
 */
public interface IUDPService {
	/**
	 * Register an IUDPListener
	 * 
	 * @param org.butor.web.listener IUDPListener, org.butor.web.listener interested to
	 * 		receive datagram messages.
	 */
	public void registerUdpMessageListener(IUDPMessageListener listener);
	/**
	 * Unregister an IUDPListener
	 * 
	 * @param org.butor.web.listener IUDPListener, org.butor.web.listener to be unregistered.
	 */
	public void unregisterUdpMessageListener(IUDPMessageListener listener);
	/**
	 * Get registered listeners.
	 * 
	 * @return Hashtable
	 */
	public Hashtable getListeners();
	/**
	 * Get registered org.butor.web.listener.
	 * 
	 * @param name String, org.butor.web.listener name.
	 * 
	 * @return IAdminMessageHandler
	 */
	public IUDPMessageListener getUdpMessageListener(String name);
	/**
	 * Tell if the service is started in single org.butor.web.listener mode.
	 * 
	 * Send message to all registered listeners if not in single 
	 * org.butor.web.listener mode. If in single org.butor.web.listener mode then send message 
	 * to the specified org.butor.web.listener only.
	 *
	 * @return boolean.
	 */
	public boolean isSingleListenerMode();

	/**
	 * Returns the port number on which datagrams are listened.
	 * 
	 * @return port number
	 */	
	public int getListenPort();
}