dfgui.java

java实现的P2P多agent中间件

/*****************************************************************
JADE - Java Agent DEvelopment Framework is a framework to develop 
multi-agent systems in compliance with the FIPA specifications.
Copyright (C) 2000 CSELT S.p.A. 

GNU Lesser General Public License

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation, 
version 2.1 of the License. 

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
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser 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 jade.tools.dfgui;

// Import required Java classes 
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import javax.swing.border.*;
import javax.swing.event.*;
import javax.swing.table.*;

import jade.util.leap.Iterator;
import jade.util.leap.List;
import java.util.HashMap;
import java.applet.*;

// Import required Jade classes
import jade.domain.*;
import jade.domain.FIPAAgentManagement.DFAgentDescription;
import jade.core.AID;
import jade.domain.DFGUIAdapter;
import jade.gui.AboutJadeAction;
import jade.gui.JadeLogoButton;

/**
* This class implements the GUI of the Directory Facilitator.
* The gui shows a tabbed pane with three different views of the functions  
* provided by a Directory Facilitator.
* The three views are: <ul>
* <li><b>Registrations with this DF</b> shows a table with all the agents 
* registered with the DF.
* <li><b>Search Result</b> shows a table with the list of agent descriptions that
* were returned as a result of the last search operation on a specified df.
* <li><b>DF Federation</b> shows the DF federation. The Parents table shows the list of DF's 
* with which this
* DF is federated, while the Children table shows the list of DF's 
* that are registered with this DF.</ul>
* According to the tab selected, the actions allowed have a proper meaning:
* <ol><b>Registrations with this df</b>.
* <ul>
* <li><b>View</b> the description of the selected  agent from the table.
* <li><b>Modify</b> the description of the selected agent.
* <li><b>Register</b> an agent with the DF. The user is then requested to fill in 
* an agent description, notice that  
* some values are mandatory for registration,
* <li><b>Deregister</b> an agent selected in the table.
* <li><b>Search</b> for agent descriptions with this DF. The user must first insert the
* search constraint: <code> maximum depth</code> the depth of propagation of the search 
* operation to the federate DF's (children);<code> maximum number of results </code>. 
* If no values are inserted then the default one are used :local search on this df 
* and all agents found returned.The the user must provide an agent description. 
* If no value is inserted in the agent description, the search action returns 
* all the active agents currently registered with this DF.
* <li><b>Federate</b> allow to federate this DF with another DF. First of all, 
* the user must provide the full name of the DF with which to federate and then the 
* description of this DF that must be registered with the specified DF. </ul>
* <b>Search Result</b>
* <ul>
* <li><b>View</b> the description of a selected agent on the table of the results.
* <li><b>Register</b> a new agent with last DF used for the search operation (indicated in the tab). 
* <li><b>Modify</b> the agent description of the agent selected in the table (with the appropriate df).
* <li><b>Search</b> for agent descriptions with the DF involved in the last search operation. (see above)
* <li><b>Federation</b> (see above)</ul>
* <b>DF Federation</b>
* <ul>
* <li><b>View</b> the description of an agent selected in one of the two tables.
* If the agent selected is a parent, then the description of this DF used to fedearate is shown. 
* Otherwise if the selected agent is a child,then the description of this child DF is shown.
* <li><b>Register</b> a new agent with the DF selected in one of the two tables.
* <li><b>Deregister</b> If the selected agent is a parent then this DF is deregistered from 
* the selected one, otherwise, if the agent selected is a child, this child is deregistered 
* from this DF.
* <li><b>Search</b> permits to make a search operation with the DF selected in one of the tables. 
* <li><b>Federate</b> (see above).
*</ol>
* @author Giovanni Caire - Tiziana Trucco - CSELT S.p.A.
* @version $Date: 2003-12-15 12:09:35 +0100 (lun, 15 dic 2003) $ $Revision: 4664 $
*/

public class DFGUI extends JFrame implements DFGUIInterface
{
	// class variables used to discriminate between the view of the dfgui.
	public static int AGENT_VIEW = 0;
	public static int LASTSEARCH_VIEW = 1;
	public static int PARENT_VIEW = 2;
	public static int CHILDREN_VIEW = 3;
	
	/**
	@serial
	*/
	DFGUIAdapter myAgent;
	/**
	@serial
	*/
	AgentNameTableModel         registeredModel, foundModel,parentModel,childrenModel;
  /**
  @serial
  */
	JTable                      registeredTable, foundTable,parentTable,childrenTable;
	/**
	@serial
	*/
	JSplitPane                  tablePane;
	/**
	@serial
	*/
	JTabbedPane                 tabbedPane;
	/**
	@serial
	*/
	JButton                     modifyB,deregB,regNewB,fedDFB,viewB,searchB,searchWithB;
	/**
	@serial
	*/
	JTextField                  statusField;
	/**
	@serial
	*/
	JScrollPane                 textScroll;
	/**
	@serial
	*/
	DFGUIModifyAction           dfModifyAction;
	/**
	@serial
	*/
	DFGUIViewAction             dfViewAction;
	/**
	@serial
	*/
	DFGUISearchAction           dfSearchAction; 
	/**
	@serial
	*/
	DFGUIRegisterAction         dfRegAction;
	/**
	@serial
	*/
	DFGUIDeregisterAction       dfDeregAction;
	/**
	@serial
	*/
	DFGUIFederateAction         dfFedAction;
	

	JButton refreshB;
    JMenuItem refreshItem;

   
  HashMap lastSearchResults; // this HashMap mantains the result of the last search made on a df.
  AID lastDF = null;                // this AID is the AID of the DF on which the last search was made. 
  
	// CONSTRUCTORS
/**
Constructor without parameter. Used by the df to avoid reflection, 
Using this constructor, the method setAdapter must be called (after the constructor)
to set the agent with which the gui interacts.
*/
	public DFGUI()
	{
		//////////////////////////
		// Initialization
		super();
		lastSearchResults = new HashMap();
	
		Image image = getToolkit().getImage(getClass().getResource("images/df.gif"));
    setIconImage(image);

    setSize(550,450);
  
    Icon viewImg = DFGuiProperties.getIcon("view");
		Icon modifyImg = DFGuiProperties.getIcon("modify");
		Icon deregImg = DFGuiProperties.getIcon("deregister");
    Icon regNewImg = DFGuiProperties.getIcon("registeragent");
		Icon fedDFImg = DFGuiProperties.getIcon("federatedf");
		Icon searchImg = DFGuiProperties.getIcon("search");
		
		/////////////////////////////////////
		// Add main menu to the GUI window
		JMenuBar jmb = new JMenuBar();
		JMenuItem item;

		JMenu generalMenu = new JMenu ("General");
		item = generalMenu.add(new DFGUIExitDFAction(this));
		item = generalMenu.add(new DFGUICloseGuiAction(this));
		
		// feature only for applet
		refreshItem = generalMenu.add(new DFGUIRefreshAppletAction(this));
		refreshItem.setVisible(false);

		jmb.add (generalMenu);

		JMenu catalogueMenu = new JMenu ("Catalogue");
		dfModifyAction = new DFGUIModifyAction(this);
		dfViewAction =  new DFGUIViewAction(this);
		dfDeregAction = new DFGUIDeregisterAction(this);
		dfRegAction = new DFGUIRegisterAction(this);
		dfSearchAction = new DFGUISearchAction(this); 
	
		
		item = catalogueMenu.add(dfViewAction);
		item.setIcon(viewImg);
		item = catalogueMenu.add(dfModifyAction);
		item.setIcon(modifyImg);
		item = catalogueMenu.add(dfDeregAction);
		item.setIcon(deregImg);
		item = catalogueMenu.add(dfRegAction);
		item.setIcon(regNewImg);
		item = catalogueMenu.add(dfSearchAction);
		item.setIcon(searchImg);


		
		jmb.add (catalogueMenu);
		
		JMenu superDFMenu = new JMenu ("Super DF");
		dfFedAction = new DFGUIFederateAction(this);
		item = superDFMenu.add(dfFedAction);
		item.setIcon(fedDFImg);
		jmb.add (superDFMenu);

		JMenu helpMenu = new JMenu ("Help");
		item = helpMenu.add(new DFGUIAboutAction(this));
		item = helpMenu.add(new AboutJadeAction(this));
		jmb.add (helpMenu);

		setJMenuBar(jmb);

		/////////////////////////////////////////////////////
		// Add Toolbar to the NORTH part of the border layout 
		JToolBar bar = new JToolBar();

		// GENERAL
		Icon exitImg = DFGuiProperties.getIcon("exitdf");
		JButton exitB  = bar.add(new DFGUIExitDFAction(this));
		exitB.setText("");
		exitB.setIcon(exitImg);
		exitB.setToolTipText("Exit and kill the DF agent");

		Icon closeImg = DFGuiProperties.getIcon("closegui");
		JButton closeB  = bar.add(new DFGUICloseGuiAction(this));
		closeB.setText("");
		closeB.setIcon(closeImg);
		closeB.setToolTipText("Close the DF GUI");

		// feature only for applets.
		Icon refreshImg = DFGuiProperties.getIcon("refreshapplet");
		refreshB = bar.add(new DFGUIRefreshAppletAction(this));
		refreshB.setText("");
		refreshB.setIcon(refreshImg);
		refreshB.setToolTipText("Refresh the GUI");
		refreshB.setVisible(false);
	
		
		bar.addSeparator();

		// CATALOGUE
		
		viewB  = bar.add(new DFGUIViewAction(this));
		viewB.setText("");
		viewB.setIcon(viewImg);
		viewB.setToolTipText("View the services provided by the selected agent");
											
		
		modifyB = bar.add(new DFGUIModifyAction(this));
		modifyB.setText("");
		modifyB.setIcon(modifyImg);
		modifyB.setToolTipText("Modify the services provided by the selected agent");

	
		deregB  = bar.add(new DFGUIDeregisterAction(this));
		deregB.setText("");
		deregB.setIcon(deregImg);
		deregB.setToolTipText("Deregister the selected agent");

	
		regNewB  = bar.add(new DFGUIRegisterAction(this));
		regNewB.setText("");
		regNewB.setIcon(regNewImg);
		regNewB.setToolTipText("Register a new agent with this DF");

	
		searchB  = bar.add(new DFGUISearchAction(this));
		searchB.setText("");
		searchB.setIcon(searchImg);
		searchB.setToolTipText("Search for agents matching a given description");

		
		bar.addSeparator();

		// SUPER DF
		fedDFB  = bar.add(new DFGUIFederateAction(this));
		fedDFB.setText("");
		fedDFB.setIcon(fedDFImg);
		fedDFB.setToolTipText("Federate this DF with another DF");

		bar.addSeparator();

		// HELP
		Icon aboutImg = DFGuiProperties.getIcon("about");
		JButton aboutB  = bar.add(new DFGUIAboutAction(this));
		aboutB.setText("");
		aboutB.setIcon(aboutImg);
		aboutB.setToolTipText("About DF");
		
		bar.addSeparator(); //new Dimension(120,30));
		bar.add(javax.swing.Box.createHorizontalGlue());
		JadeLogoButton logo = new JadeLogoButton();
		bar.add(logo);

		getContentPane().add(bar, BorderLayout.NORTH);

		////////////////////////////////////////////////////
		// Table Pane to the Center part
		// tablePane = new JSplitPane(JSplitPane.VERTICAL_SPLIT);
		// tablePane.setContinuousLayout(true);

		////////////////////////////////////////////////////
		// JTabbedPane
		////////////////////////////////////////////////////
		tabbedPane = new JTabbedPane();
		
		//////////////////////////////
		// Registered agents table
		JPanel registerPanel = new JPanel();
		registerPanel.setLayout(new BorderLayout());
		registeredModel = new AgentNameTableModel();
		registeredTable = new JTable(registeredModel); 
		registeredTable.setRowHeight(20);
		registeredTable.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
		
		// Column names
		TableColumn c;
		c = registeredTable.getColumn((Object) registeredTable.getColumnName(0));
		c.setHeaderValue((Object) (new String("Agent name")));
		c = registeredTable.getColumn((Object) registeredTable.getColumnName(1));
		c.setHeaderValue((Object) (new String("Addresses")));
		c = registeredTable.getColumn((Object) registeredTable.getColumnName(2));
		c.setHeaderValue((Object) (new String("Resolvers")));

		// Doubleclick = view
		MouseListener mouseListener = new MouseAdapter() 
		{
     			public void mouseClicked(MouseEvent e)
			{
				if (e.getClickCount() == 2)
				{
					DFGUIViewAction ac = new DFGUIViewAction(DFGUI.this);
					ac.actionPerformed(new ActionEvent((Object) this, 0, "View"));
				}  
			} 
 		};
 		registeredTable.addMouseListener(mouseListener); 
		// Press Del = Deregister
		KeyListener keyListener = new KeyAdapter()
		{
			public void keyPressed(KeyEvent e)
			{
				int code = e.getKeyCode();
				if (code == KeyEvent.VK_CANCEL || code == KeyEvent.VK_DELETE)
				{
					DFGUIDeregisterAction ac = new DFGUIDeregisterAction(DFGUI.this);
					ac.actionPerformed(new ActionEvent((Object) this, 0, "Deregister"));
				}

			}
		}; 
 		registeredTable.addKeyListener(keyListener);

		registerPanel.setLayout(new BorderLayout());
		JScrollPane pane = new JScrollPane();
		pane.getViewport().setView(registeredTable); 
		registerPanel.add(pane, BorderLayout.CENTER);
		registerPanel.setBorder(BorderFactory.createEtchedBorder());
		
		tabbedPane.addTab("Registrations with this DF",registerPanel);
		tabbedPane.setSelectedIndex(0);
		
		/////////////////////////
		// Search result table

		JPanel lastSearchPanel = new JPanel();
		lastSearchPanel.setLayout(new BorderLayout());
		foundModel = new AgentNameTableModel();
		foundTable = new JTable(foundModel); 
		foundTable.setRowHeight(20);
		foundTable.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
		foundTable.setToolTipText("Double click on agent name to view the services provided by the selected agent");
		// Column names
		c = foundTable.getColumn((Object) foundTable.getColumnName(0));
		c.setHeaderValue((Object) (new String("Agent name")));
		c = foundTable.getColumn((Object) foundTable.getColumnName(1));
		c.setHeaderValue((Object) (new String("Addresses")));
		c = foundTable.getColumn((Object) foundTable.getColumnName(2));
		c.setHeaderValue((Object) (new String("Resolvers")));
	
			// Doubleclick = view
		MouseListener mouseListener2 = new MouseAdapter() 
		{
     			public void mouseClicked(MouseEvent e)
			{
				if (e.getClickCount() == 2)
				{
					DFGUIViewAction ac = new DFGUIViewAction(DFGUI.this);
					ac.actionPerformed(new ActionEvent((Object) this, 0, "View"));
				}  
			} 
 		};
 		foundTable.addMouseListener(mouseListener2); 


		lastSearchPanel.setLayout(new BorderLayout());
		pane = new JScrollPane();
		pane.getViewport().setView(foundTable); 
		lastSearchPanel.add(pane, BorderLayout.CENTER);
		lastSearchPanel.setBorder(BorderFactory.createEtchedBorder());
	
		tabbedPane.addTab("Search Result",lastSearchPanel);	
		
		JSplitPane tablePane = new JSplitPane(JSplitPane.VERTICAL_SPLIT);
		tablePane.setContinuousLayout(true);
		
		//////////////////////////////
		// Parent agents table
		JPanel parentPanel = new JPanel();
		parentPanel.setLayout(new BorderLayout());
		parentModel = new AgentNameTableModel();
		parentTable = new JTable(parentModel); 
		parentTable.setRowHeight(20);
		parentTable.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
		
		// Column names
	
		c = parentTable.getColumn((Object) parentTable.getColumnName(0));
		c.setHeaderValue((Object) (new String("Agent name")));
		c = parentTable.getColumn((Object) parentTable.getColumnName(1));
		c.setHeaderValue((Object) (new String("Addresses")));
		c = parentTable.getColumn((Object) parentTable.getColumnName(2));
		c.setHeaderValue((Object) (new String("Resolvers")));

		MouseListener mouseListenerParent = new MouseAdapter()
		{
			public void mouseClicked(MouseEvent e)
			{
				if (e.getClickCount() >= 1)
					childrenTable.clearSelection();
				if (e.getClickCount() == 2)
				{
					DFGUIViewAction ac = new DFGUIViewAction(DFGUI.this);
					ac.actionPerformed(new ActionEvent((Object)this, 0, "View"));
				
				}
			}
		
		};
		
		parentTable.addMouseListener(mouseListenerParent);
		
		parentPanel.setLayout(new BorderLayout());
		JScrollPane pane1 = new JScrollPane();
		pane1.getViewport().setView(parentTable);
		parentPanel.add(pane1,BorderLayout.CENTER);
		parentPanel.setBorder(BorderFactory.createTitledBorder("Parents"));
		
		tablePane.setTopComponent(parentPanel);
		
		JPanel childrenPanel = new JPanel();
		childrenPanel.setLayout(new BorderLayout());
		childrenModel = new AgentNameTableModel();
		childrenTable = new JTable(childrenModel); 
		childrenTable.setRowHeight(20);
		childrenTable.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);