/*
 * Copyright 2004 Sun Microsystems, Inc. All  Rights Reserved.
 *  
 * Redistribution and use in source and binary forms, with or 
 * without modification, are permitted provided that the following 
 * conditions are met:
 * 
 * -Redistributions of source code must retain the above copyright  
 *  notice, this list of conditions and the following disclaimer.
 * 
 * -Redistribution 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.
 *  
 * Neither the name of Sun Microsystems, Inc. or the names of 
 * contributors may be used to endorse or promote products derived 
 * from this software without specific prior written permission.
 * 
 * This software is provided "AS IS," without a warranty of any
 * kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
 * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
 * EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
 * NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
 * USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
 * DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
 * ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT,
 * SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
 * CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF
 * THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 *  
 * You acknowledge that Software is not designed, licensed or 
 * intended for use in the design, construction, operation or 
 * maintenance of any nuclear facility.
 */
package examples.activation; 

import java.rmi.registry.LocateRegistry;
import java.rmi.registry.Registry;

/**
 * This program looks up a remote object's stub (that implements the
 * <code>Counter</code> remote interface) in the registry on the host
 * supplied as the optional first argument, and then invokes the
 * stub's <code>increment</code> method.  When this client invokes a
 * remote method on the stub acquired from the registry, the remote
 * object will activate if not already active.
 *
 * <p>This program should be run as follows:
 * <pre>
 *	java -Djava.security.policy=<i><b>client.policy</b></i>        \
 *	    -Dexamples.activation.classes=<i><b>classes</b></i>	      \
 *	    -Dexamples.activation.name=<i><b>name</b></i>	      \
 *	    examples.activation.CounterClient [<i><b>host</b></i>]
 * </pre>
 *
 * <p>where:<ul>
 * <li><i><b>client.policy</b></i> is the security policy file for this
 * program,
 * <li><i><b>classes</b></i> is the root directory for this program's
 * class (used in granting permissions to this program in the
 * <i><b>client.policy</b></i> file)
 * <li><i><b>name</b></i> is the name for the object's stub 
 * in the registry 
 * <li><i><b>host</b></i> is the server's host
 * </ul>
 *
 * <p>Note: <code>rmid</code> must be running on its default port,
 * and <code>rmiregistry</code> must be running on its default port
 * (both on the remote host) prior to running this program.
 **/
public class CounterClient {

    public static void main(String args[])  throws Exception {

	/*
	 * Obtain hostname supplied (optionally) as the first argument on
	 * the command line.
	 */
	String hostname = "localhost";
	if (args.length < 1) {
	    System.err.println(
		"usage: java [options] examples.activation.CounterClient [host]");
	    System.exit(1);
	} else {
	    hostname = args[0];
	}

	/*
	 * Set a security manager, if one is not already set.
	 */
	if (System.getSecurityManager() == null) {
	    System.setSecurityManager(new SecurityManager());
	}

	/*
	 * Obtain the stub for the activatable object from the
	 * rmiregistry on port 1099 of the supplied host.  The
	 * name to look up in the registry is specified by the
	 * system property examples.activation.name.
	 */
	String name = System.getProperty("examples.activation.name");
	Registry registry = LocateRegistry.getRegistry(hostname);
	Counter stub = (Counter) registry.lookup(name);
	System.err.println("Obtained stub from the registry.");
	
	/*
	 * Invoke the remote method using the stub.
	 */
	System.err.println("Invoking increment method...");
	
	int count = stub.increment();
	System.err.println("Returned from increment remote call.");
	System.err.println("count = " + count);
    }
}