/**

  * Back 2 Browser Bytecode Translator

  * Copyright (C) 2012 Jaroslav Tulach <jaroslav.tulach@apidesign.org>

  *

  * This program is free software: you can redistribute it and/or modify

  * it under the terms of the GNU General Public License as published by

  * the Free Software Foundation, version 2 of the License.

  *

  * 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.

  *

  * You should have received a copy of the GNU General Public License

  * along with this program. Look for COPYING file in the top folder.

  * If not, see http://opensource.org/licenses/GPL-2.0.

  */

 package org.apidesign.bck2brwsr.launcher;

 import java.io.Closeable;

 import java.io.File;

 import java.io.IOException;

 import java.net.URLClassLoader;

 import org.apidesign.vm4brwsr.Bck2Brwsr;

 /** An abstraction for executing tests in a Bck2Brwsr virtual machine.

  * Either in {@linkm Launcher#createJavaScript JavaScript engine}, 

  * or in {@linkm Launcher#createBrowser external browser}.

  * <p>

  * There also are methods to {@link #showDir(java.io.File, java.lang.String) display pages} 

  * in an external browser served by internal HTTP server.

  *

  * @author Jaroslav Tulach <jtulach@netbeans.org>

  */

 public abstract class Launcher {

     Launcher() {

     }

     /** Initializes the launcher. This may mean starting a web browser or

      * initializing execution engine.

      * @throws IOException if something goes wrong

      */

     public abstract void initialize() throws IOException;

     /** Shuts down the launcher.

      * @throws IOException if something goes wrong

      */

     public abstract void shutdown() throws IOException;

     /** Builds an invocation context. The context can later be customized

      * and {@link InvocationContext#invoke() invoked}.

      * 

      * @param clazz the class to execute method from

      * @param method the method to execute

      * @return the context pointing to the selected method

      */

     public InvocationContext createInvocation(Class<?> clazz, String method) {

         return new InvocationContext(this, clazz, method);

     }

     /** Creates launcher that uses internal JavaScript engine (Rhino).

      * @return the launcher

      */

     public static Launcher createJavaScript() {

         final JSLauncher l = new JSLauncher();

         l.addClassLoader(Bck2Brwsr.class.getClassLoader());

         return l;

     }

     /** Creates launcher that is using external browser.

      * 

      * @param cmd <code>null</code> to use <code>java.awt.Desktop</code> to show the launcher

      *    or a string to execute in an external process (with a parameter to the URL)

      * @return launcher executing in external browser.

      */

     public static Launcher createBrowser(String cmd) {

         final Bck2BrwsrLauncher l = new Bck2BrwsrLauncher(cmd);

         l.addClassLoader(Bck2Brwsr.class.getClassLoader());

         l.setTimeout(180000);

         return l;

     }

     /** Starts an HTTP server which provides access to classes and resources

      * available in the <code>classes</code> URL and shows a start page

      * available as {@link ClassLoader#getResource(java.lang.String)} from the

      * provide classloader. Opens a browser with URL showing the start page.

      * 

      * @param classes classloader offering access to classes and resources

      * @param startpage page to show in the browser

      * @return interface that allows one to stop the server

      * @throws IOException if something goes wrong

      */

     public static Closeable showURL(URLClassLoader classes, String startpage) throws IOException {

         Bck2BrwsrLauncher l = new Bck2BrwsrLauncher(null);

         l.addClassLoader(classes);

         l.showURL(startpage);

         return l;

     }

     /** Starts an HTTP server which provides access to certain directory.

      * The <code>startpage</code> should be relative location inside the root 

      * directory. Opens a browser with URL showing the start page.

      * 

      * @param directory the root directory on disk

      * @param startpage relative path from the root to the page

      * @exception IOException if something goes wrong.

      */

     public static Closeable showDir(File directory, String startpage) throws IOException {

         Bck2BrwsrLauncher l = new Bck2BrwsrLauncher(null);

         l.showDirectory(directory, startpage);

         return l;

     }

     abstract InvocationContext runMethod(InvocationContext c) throws IOException; 

 }