Hacky way (relies on singleton) to get FX working. Can attach @On(event=CLICK) and show alert in FX WebView now
2 * Back 2 Browser Bytecode Translator
3 * Copyright (C) 2012 Jaroslav Tulach <jaroslav.tulach@apidesign.org>
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, version 2 of the License.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. Look for COPYING file in the top folder.
16 * If not, see http://opensource.org/licenses/GPL-2.0.
18 package org.apidesign.bck2brwsr.launcher;
20 import java.io.Closeable;
22 import java.io.IOException;
23 import java.lang.reflect.Method;
24 import java.net.URLClassLoader;
25 import org.apidesign.vm4brwsr.Bck2Brwsr;
27 /** An abstraction for executing tests in a Bck2Brwsr virtual machine.
28 * Either in {@linkm Launcher#createJavaScript JavaScript engine},
29 * or in {@linkm Launcher#createBrowser external browser}.
31 * There also are methods to {@link #showDir(java.io.File, java.lang.String) display pages}
32 * in an external browser served by internal HTTP server.
34 * @author Jaroslav Tulach <jtulach@netbeans.org>
36 public abstract class Launcher {
41 /** Initializes the launcher. This may mean starting a web browser or
42 * initializing execution engine.
43 * @throws IOException if something goes wrong
45 public abstract void initialize() throws IOException;
47 /** Shuts down the launcher.
48 * @throws IOException if something goes wrong
50 public abstract void shutdown() throws IOException;
53 /** Builds an invocation context. The context can later be customized
54 * and {@link InvocationContext#invoke() invoked}.
56 * @param clazz the class to execute method from
57 * @param method the method to execute
58 * @return the context pointing to the selected method
60 public InvocationContext createInvocation(Class<?> clazz, String method) {
61 return new InvocationContext(this, clazz, method);
65 /** Creates launcher that uses internal JavaScript engine (Rhino).
66 * @return the launcher
68 public static Launcher createJavaScript() {
69 final JSLauncher l = new JSLauncher();
70 l.addClassLoader(Bck2Brwsr.class.getClassLoader());
74 /** Creates launcher that is using external browser. Value of <code>cmd</code>
75 * may be <code>"fx"</code> to indicate one wants to use JavaFX's WebView
76 * instead of command line browser.
78 * @param cmd <code>null</code> to use <code>java.awt.Desktop</code> to show the launcher
79 * or a string to execute in an external process (with a parameter to the URL)
80 * @return launcher executing in external browser.
82 public static Launcher createBrowser(String cmd) {
83 final Bck2BrwsrLauncher l;
84 if ("fx".equals(cmd)) {
85 l = new WebViewLauncher();
87 l = new Bck2BrwsrLauncher(cmd);
89 l.addClassLoader(Bck2Brwsr.class.getClassLoader());
94 /** Starts an HTTP server which provides access to classes and resources
95 * available in the <code>classes</code> URL and shows a start page
96 * available as {@link ClassLoader#getResource(java.lang.String)} from the
97 * provide classloader. Opens a browser with URL showing the start page.
99 * @param classes classloader offering access to classes and resources
100 * @param startpage page to show in the browser
101 * @return interface that allows one to stop the server
102 * @throws IOException if something goes wrong
104 public static Closeable showURL(URLClassLoader classes, String startpage) throws IOException {
105 Bck2BrwsrLauncher l = new WebViewLauncher();
106 l.addClassLoader(classes);
107 l.showURL(startpage);
110 /** Starts an HTTP server which provides access to certain directory.
111 * The <code>startpage</code> should be relative location inside the root
112 * directory. Opens a browser with URL showing the start page.
114 * @param directory the root directory on disk
115 * @param startpage relative path from the root to the page
116 * @exception IOException if something goes wrong.
118 public static Closeable showDir(File directory, String startpage) throws IOException {
119 Bck2BrwsrLauncher l = new WebViewLauncher();
120 l.showDirectory(directory, startpage);
124 abstract InvocationContext runMethod(InvocationContext c) throws IOException;