napletmanager.java

移动Agent编程工具Naplet

/*
 * @<#>NapletManager.java version 0.0.1, 1/1/2000
 *
 * THIS PROGRAM IS FREE SOFTWARE; YOU CAN DISTRIBUTE IT AND/OR
 * MODIFY IT UNDER THE TERMS OF THE GNU GENERAL PUBLIC LICENSE 
 * AS PUBLISHED BY THE FREE SOFTWARE FOUNDATION.
 *
 * THIS PROGRAM 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 GENERAL PUBLIC LICENSE FOR MORE DETAILS.
 *
 * Copyright (c) 2000 Wayne State University. All Rights Reserved.
 */

package naplet.server;

import java.rmi.Remote;
import java.rmi.RemoteException;
import naplet.*;

/**
 * The <code>NapletManager</code> provides local users or applications
 * with an interface to launch naplets and remotely control their 
 * behaviors. It extends a remote interface so that the mobile application
 * and the naplet server are running on separate Java virtual machines.
 *
 * @see NapletManagerImpl
 * @version 0.0.1, 1/1/2000
 * @author C. Xu
 */ 

public interface NapletManager extends Remote {
      public static final String DefaultNapletManagerName = "NapletManager";

      public URN getServerURN() throws RemoteException;;


      /**
       * Launch a naplet
       * @param nap Naplet to be launched 
       */
      public void launch( Naplet nap ) throws RemoteException;

      /**
       * Locate where the naplet is.
       * @param nid ID of the naplet
       */
      public URN locate( NapletID nid )throws RemoteException;
      public URN locate( NapletID nid, long timeout )throws RemoteException;
	
      /**
       * Terminate an outstanding naplet. 
       *
       * @param nid NapletID to be terminated 
       */
      public void terminate( NapletID nid) throws RemoteException;

      /**
       * Terminate an outstanding naplet in a specified server. 
       *
       * @param server Naplet server to which message addresses
       * @param nid NapletID to be termianted 
       */
      public void terminate( URN server, NapletID nid) 
	 throws RemoteException;
	
      /** 
       * Stop the itinerary of the naplet and call it back to home
       *
       * @param nid ID of the naplet 
       */
      public void callback( NapletID nid )throws RemoteException;

      /**
       * Hooks for outstanding naplets to report running status
       * @param nid ID of the naplet calling back
       * @param server Where the naplet calls back
       * @param msg Messages reported back
       */
      public void status( NapletID nid, URN server, String msg ) 
	 throws RemoteException; 

      // public void status( NapletID nid, URN server, Throwable t ) 
      //   throws RemoteException; 
	
}