agentmanager.java

Java Communicating Agents是一个用于开发网络反应式信息agent的框架

/*
 * $Source: /home/data/cvsroot/src/jacomma/platform/core/AgentManager.java,v $
 * $Revision: 1.8 $
 * $Date: 2000/10/28 20:09:07 $
 *
 * This file is part of the jacomma framework
 * Copyright (c) 2000 	Dimitrios Vyzovitis
 *			mailto:[e-mail]
 *			
 *
 *			
 *			
 *			
 *
 *	This library is free software; you can redistribute it and/or modify
 *	it under the terms of the GNU Library General Public License as published by
 *	the Free Software Foundation; either version 2 of the License, or
 *	(at your option) any later version.
 *
 *	This library is distributed in the hope that it will be useful,
 *	but WITHOUT ANY WARRANTY; without even the implied warranty of
 *	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *	GNU Library General Public License for more details.
 *
 *	You should have received a copy of the GNU Library General Public License
 *	along with this library; if not, write to the Free Software
 *	Foundation, Inc., 59 Temple Place, Suite 330, 
 *	Boston, MA  02111-1307  USA
 */

package jacomma.platform.core;

import java.util.Date;
import java.util.List;
import java.util.Set;
import java.net.InetAddress;

import jacomma.icm.type.Handle;

/**
 * TBA
 **/
public interface AgentManager {
	
	public Agent createAgent( String name, AgentObserver obs ) 
		throws RequestFailedException;
	public Agent createAgent( String name, AgentObserver obs, 
							  Date lease_time ) 
		throws RequestFailedException;
	public Agent createAgent( Handle han, AgentObserver obs ) 
		throws RequestFailedException;
	public Agent createAgent( Handle han, AgentObserver obs, 
							  Date lease_time ) 
		throws RequestFailedException;
	
	public Agent attachAgent( String name, AgentObserver obs ) 
		throws RequestFailedException;
	public Agent attachAgent( String name, AgentObserver obs, 
							  Date lease_time ) 
		throws RequestFailedException;
	public Agent attachAgent( Handle han, AgentObserver obs ) 
		throws RequestFailedException;
	public Agent attachAgent( Handle han, AgentObserver obs, 
							  Date lease_time ) 
		throws RequestFailedException;

	public void disconnect() 
		throws RequestFailedException;
	public void reconnect() 
		throws RequestFailedException;
	
	public List listManagedAgents()  // local (address space) agents
		throws RequestFailedException;
	public List listAgents( )  // Local (commserver) agents
		throws RequestFailedException;
	public List listAgents( InetAddress host ) 
		throws RequestFailedException;
	public Handle lookupLocation( Handle target ) 
		throws RequestFailedException;
	public Handle lookupLocation( Handle target, InetAddress host ) 
		throws RequestFailedException;
	public boolean ping( Handle han ) 
		throws RequestFailedException;
	
	public void monitorAgent( Handle han, AgentObserver obs ) 
		throws RequestFailedException;
	public void monitorAgent( Handle han, InetAddress host, AgentObserver obs ) 
		throws RequestFailedException;
	public void unmonitorAgent( Handle han, AgentObserver obs ) 
		throws RequestFailedException;
	public void unmonitorAgent( Handle han, InetAddress host, AgentObserver obs ) 
		throws RequestFailedException;
	
	public void load( java.util.Properties prop );
	public static final AgentManager instance = 
		(AgentManager)jacomma.util.Environment.newSingleton( AgentManager.class );

	public void stopEngine();
}