diff -r 5652acd48509 -r 42bc1e89134d vm/src/main/java/org/apidesign/vm4brwsr/Bck2Brwsr.java --- a/vm/src/main/java/org/apidesign/vm4brwsr/Bck2Brwsr.java Mon Feb 25 19:00:08 2013 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,116 +0,0 @@ -/** - * Back 2 Browser Bytecode Translator - * Copyright (C) 2012 Jaroslav Tulach - * - * 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.vm4brwsr; - -import java.io.IOException; -import java.io.InputStream; -import java.net.URL; -import java.util.Enumeration; - -/** Build your own virtual machine! Use methods in this class to generate - * a skeleton JVM in JavaScript that contains pre-compiled classes of your - * choice. The generated script defines one JavaScript method that can - * be used to bootstrap and load the virtual machine:
- * var vm = bck2brwsr();
- * var main = vm.loadClass('org.your.pkg.Main');
- * main.main__V_3Ljava_lang_String_2(null);
- * 
- * In case one wants to initialize the virtual machine with ability to - * load classes lazily when needed, one can provide a loader function to - * when creating the virtual machine:
- * var vm = bck2brwsr(function(resource) { 
- *   return null; // byte[] for the resource
- * });
- * 
- * In this scenario, when a request for an unknown class is made, the loader - * function is asked for its byte code and the system dynamically transforms - * it to JavaScript. - *

- * Instead of a loader function, one can also provide a URL to a JAR file. - * The bck2brwsr system will do its best to download the file - * and provide loader function for it automatically. - *

- * One can provide as many loader functions and JAR URL references as necessary. - * Then the initialization code would look like:

- * var vm = bck2brwsr(url1, url2, fnctn1, url3, functn2);
- * 
- * The provided URLs and loader functions will be consulted one by one. - * - * @author Jaroslav Tulach - */ -public final class Bck2Brwsr { - private Bck2Brwsr() { - } - - /** Generates virtual machine from bytes served by a resources - * provider. - * - * @param out the output to write the generated JavaScript to - * @param resources provider of class files to use - * @param classes additional classes to include in the generated script - * @throws IOException I/O exception can be thrown when something goes wrong - */ - public static void generate(Appendable out, Resources resources, String... classes) throws IOException { - StringArray arr = StringArray.asList(classes); - arr.add(VM.class.getName().replace('.', '/')); - VM.compile(resources, out, arr); - } - - /** Generates virtual machine from bytes served by a class loader. - * - * @param out the output to write the generated JavaScript to - * @param loader class loader to load needed classes from - * @param classes additional classes to include in the generated script - * @throws IOException I/O exception can be thrown when something goes wrong - */ - public static void generate(Appendable out, final ClassLoader loader, String... classes) throws IOException { - class R implements Resources { - @Override - public InputStream get(String name) throws IOException { - Enumeration en = loader.getResources(name); - URL u = null; - while (en.hasMoreElements()) { - u = en.nextElement(); - } - if (u == null) { - throw new IOException("Can't find " + name); - } - return u.openStream(); - } - } - generate(out, new R(), classes); - } - - /** Provider of resources (classes and other files). The - * {@link #generate(java.lang.Appendable, org.apidesign.vm4brwsr.Bck2Brwsr.Resources, java.lang.String[]) - * generator method} will call back here for all classes needed during - * translation to JavaScript. - */ - public interface Resources { - /** Loads given resource (class or other file like image). The - * resource name to load bytes for the {@link String} class - * would be "java/lang/String.class". - * - * @param resource path to resource to load - * @return the input stream for the resource - * @throws IOException can be thrown if the loading fails on some error - * or the file cannot be found - */ - public InputStream get(String resource) throws IOException; - } -}