Static compilator demo is capable to load itself from individual extension files
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.vm4brwsr;
20 import java.io.IOException;
21 import java.io.InputStream;
22 import org.apidesign.bck2brwsr.core.JavaScriptBody;
23 import org.apidesign.vm4brwsr.ByteCodeParser.ClassData;
24 import org.apidesign.vm4brwsr.ByteCodeParser.FieldData;
25 import org.apidesign.vm4brwsr.ByteCodeParser.MethodData;
27 /** Generator of JavaScript from bytecode of classes on classpath of the VM.
29 * @author Jaroslav Tulach <jtulach@netbeans.org>
31 abstract class VM extends ByteCodeToJavaScript {
32 protected final ClassDataCache classDataCache;
34 private final Bck2Brwsr.Resources resources;
35 private final ExportedSymbols exportedSymbols;
36 private final StringArray invokerMethods;
38 private VM(Appendable out, Bck2Brwsr.Resources resources, StringArray explicitlyExported) {
40 this.resources = resources;
41 this.classDataCache = new ClassDataCache(resources);
42 this.exportedSymbols = new ExportedSymbols(resources, explicitlyExported);
43 this.invokerMethods = new StringArray();
47 // uses VMLazy to load dynamic classes
48 boolean assertsOn = false;
49 assert assertsOn = true;
57 boolean debug(String msg) throws IOException {
61 static void compile(Appendable out,
63 ) throws IOException {
64 String[] both = config.classes().toArray();
66 final StringArray fixedNames = new StringArray();
67 fixedNames.add(Class.class.getName().replace('.', '/'));
68 fixedNames.add(ArithmeticException.class.getName().replace('.', '/'));
71 if (config.isExtension()) {
72 fixedNames.add(VM.class.getName().replace('.', '/'));
73 vm = new Extension(out, config.getResources(), both, config.exported());
75 if (config.includeVM()) {
76 fixedNames.add(VM.class.getName().replace('.', '/'));
78 vm = new Standalone(out, config.getResources(), config.exported());
80 vm.doCompile(fixedNames.addAndNew(both), config.allResources());
83 private void doCompile(StringArray names, StringArray asBinary) throws IOException {
86 "\n var invoker = {};");
88 for (String invokerMethod: invokerMethods.toArray()) {
89 append("\n invoker." + invokerMethod + " = function(target) {"
90 + "\n return function() {"
91 + "\n return target['" + invokerMethod + "'].apply(target, arguments);"
97 for (String r : asBinary.toArray()) {
98 append("\n ").append(getExportsObject()).append("['registerResource']('");
99 append(r).append("', '");
100 InputStream is = this.resources.get(r);
101 byte[] arr = new byte[is.available()];
104 if (offset == arr.length) {
105 byte[] tmp = new byte[arr.length * 2];
106 System.arraycopy(arr, 0, tmp, 0, arr.length);
109 int len = is.read(arr, offset, arr.length - offset);
115 if (offset != arr.length) {
116 byte[] tmp = new byte[offset];
117 System.arraycopy(arr, 0, tmp, 0, offset);
128 @JavaScriptBody(args = { "arr" }, body = "return btoa(arr);")
129 private static String btoa(byte[] arr) {
130 return javax.xml.bind.DatatypeConverter.printBase64Binary(arr);
133 protected abstract void generatePrologue() throws IOException;
135 protected abstract void generateEpilogue() throws IOException;
137 protected abstract String getExportsObject();
139 protected abstract boolean isExternalClass(String className);
142 protected final void declaredClass(ClassData classData, String mangledName)
144 if (exportedSymbols.isExported(classData)) {
145 append("\n").append(getExportsObject()).append("['")
148 .append(accessClass(mangledName))
153 protected String generateClass(String className) throws IOException {
154 ClassData classData = classDataCache.getClassData(className);
155 if (classData == null) {
156 throw new IOException("Can't find class " + className);
158 return compile(classData);
162 protected void declaredField(FieldData fieldData,
164 String mangledName) throws IOException {
165 if (exportedSymbols.isExported(fieldData)) {
166 exportMember(destObject, mangledName);
171 protected void declaredMethod(MethodData methodData,
173 String mangledName) throws IOException {
174 if (isHierarchyExported(methodData)) {
175 exportMember(destObject, mangledName);
179 private void exportMember(String destObject, String memberName)
181 append("\n").append(destObject).append("['")
184 .append(destObject).append(".").append(memberName)
188 private void generateBody(StringArray names) throws IOException {
189 StringArray processed = new StringArray();
190 StringArray initCode = new StringArray();
191 StringArray skipClass = new StringArray();
192 for (String baseClass : names.toArray()) {
193 references.add(baseClass);
196 for (String n : references.toArray()) {
197 if (skipClass.contains(n)) {
200 if (processed.contains(n)) {
208 InputStream is = resources.get(name + ".class");
210 lazyReference(this, name);
215 String ic = generateClass(name);
217 initCode.add(ic == null ? "" : ic);
218 } catch (RuntimeException ex) {
219 throw new IOException("Error while compiling " + name + "\n", ex);
223 for (String resource : scripts.toArray()) {
224 while (resource.startsWith("/")) {
225 resource = resource.substring(1);
227 InputStream emul = resources.get(resource);
229 throw new IOException("Can't find " + resource);
231 readResource(emul, this);
233 scripts = new StringArray();
235 StringArray toInit = StringArray.asList(references.toArray());
238 for (String ic : toInit.toArray()) {
239 int indx = processed.indexOf(ic);
241 final String theCode = initCode.toArray()[indx];
242 if (!theCode.isEmpty()) {
243 append(theCode).append("\n");
245 initCode.toArray()[indx] = "";
251 private static void readResource(InputStream emul, Appendable out) throws IOException {
255 int ch = emul.read();
259 if (ch < 0 || ch > 255) {
260 throw new IOException("Invalid char in emulation " + ch);
267 out.append((char)ch);
274 out.append('/').append((char)ch);
297 static String toString(String name) throws IOException {
298 StringBuilder sb = new StringBuilder();
299 // compile(sb, name);
300 return sb.toString().toString();
303 private StringArray scripts = new StringArray();
304 private StringArray references = new StringArray();
307 protected boolean requireReference(String cn) {
308 if (references.contains(cn)) {
316 protected void requireScript(String resourcePath) {
317 scripts.add(resourcePath);
321 String assignClass(String className) {
322 return "vm." + className + " = ";
326 String accessClass(String className) {
327 return "vm." + className;
331 protected String accessField(String object, String mangledName,
332 String[] fieldInfoName) throws IOException {
333 final FieldData field =
334 classDataCache.findField(fieldInfoName[0],
337 return accessNonVirtualMember(object, mangledName,
338 (field != null) ? field.cls : null);
342 protected String accessStaticMethod(
345 String[] fieldInfoName) throws IOException {
346 final MethodData method =
347 classDataCache.findMethod(fieldInfoName[0],
350 return accessNonVirtualMember(object, mangledName,
351 (method != null) ? method.cls : null);
355 protected String accessVirtualMethod(
358 String[] fieldInfoName) throws IOException {
359 final ClassData referencedClass =
360 classDataCache.getClassData(fieldInfoName[0]);
361 final MethodData method =
362 classDataCache.findMethod(referencedClass,
367 && !isExternalClass(method.cls.getClassName())
368 && (((method.access & ByteCodeParser.ACC_FINAL) != 0)
369 || ((referencedClass.getAccessFlags()
370 & ByteCodeParser.ACC_FINAL) != 0)
371 || !isHierarchyExported(method))) {
372 return object + "." + mangledName;
375 return accessThroughInvoker(object, mangledName);
378 private String accessThroughInvoker(String object, String mangledName) {
379 if (!invokerMethods.contains(mangledName)) {
380 invokerMethods.add(mangledName);
382 return "invoker." + mangledName + '(' + object + ')';
385 private boolean isHierarchyExported(final MethodData methodData)
387 if (exportedSymbols.isExported(methodData)) {
390 if ((methodData.access & (ByteCodeParser.ACC_PRIVATE
391 | ByteCodeParser.ACC_STATIC)) != 0) {
395 final ExportedMethodFinder exportedMethodFinder =
396 new ExportedMethodFinder(exportedSymbols);
398 classDataCache.findMethods(
400 methodData.getName(),
401 methodData.getInternalSig(),
402 exportedMethodFinder);
404 return (exportedMethodFinder.getFound() != null);
407 private String accessNonVirtualMember(String object,
409 ClassData declaringClass) {
410 return ((declaringClass != null)
411 && !isExternalClass(declaringClass.getClassName()))
412 ? object + "." + mangledName
413 : object + "['" + mangledName + "']";
416 private static final class ExportedMethodFinder
417 implements ClassDataCache.TraversalCallback<MethodData> {
418 private final ExportedSymbols exportedSymbols;
419 private MethodData found;
421 public ExportedMethodFinder(final ExportedSymbols exportedSymbols) {
422 this.exportedSymbols = exportedSymbols;
426 public boolean traverse(final MethodData methodData) {
428 if (exportedSymbols.isExported(methodData)) {
432 } catch (final IOException e) {
438 public MethodData getFound() {
443 private static final class Standalone extends VM {
444 private Standalone(Appendable out, Bck2Brwsr.Resources resources, StringArray explicitlyExported) {
445 super(out, resources, explicitlyExported);
449 protected void generatePrologue() throws IOException {
450 append("(function VM(global) {var fillInVMSkeleton = function(vm) {");
454 protected void generateEpilogue() throws IOException {
458 + " var extensions = [];\n"
459 + " function replaceAll(s, target, replacement) {\n"
462 + " var indx = s.indexOf(target, pos);\n"
463 + " if (indx === -1) {\n"
466 + " pos = indx + replacement.length;\n"
467 + " s = s.substring(0, indx) + replacement + s.substring(indx + target.length);\n"
470 + " function mangleClass(name) {\n"
471 + " name = replaceAll(name, '_', '_1');\n"
472 + " name = replaceAll(name, '.', '_');\n"
475 + " global.bck2brwsr = function() {\n"
476 + " var args = Array.prototype.slice.apply(arguments);\n"
477 + " var resources = {};\n"
478 + " function registerResource(n, a64) {\n"
479 + " var str = atob(a64);\n"
481 + " for (var i = 0; i < str.length; i++) {\n"
482 + " var ch = str.charCodeAt(i) & 0xff;\n"
483 + " if (ch > 127) ch -= 256;\n"
486 + " if (!resources[n]) resources[n] = [arr];\n"
487 + " else resources[n].push(arr);\n"
489 + " var vm = fillInVMSkeleton({ 'registerResource' : registerResource });\n"
490 + " function initVM() {\n"
491 + " var clsArray = vm['java_lang_reflect_Array'];\n"
492 + " if (clsArray) clsArray(false);\n"
494 + " for (var i = 0; i < extensions.length; ++i) {\n"
495 + " extensions[i](vm);\n"
497 + " vm['registerResource'] = null;\n"
498 + " var knownExtensions = extensions.length;\n"
499 + " var loader = {};\n"
500 + " var loadBytes = function(name, skip) {\n"
501 + " skip = typeof skip == 'number' ? skip : 0;\n"
502 + " var arr = resources[name];\n"
504 + " var arrSize = arr.length;\n"
505 + " if (skip < arrSize) return arr[skip];\n"
506 + " skip -= arrSize;\n"
508 + " var arrSize = 0;\n"
510 + " for (var i = 0; i < args.length; i++) {\n"
511 + " var at = args[i];\n"
513 + " if (typeof at === 'function') ret = at(name, skip);\n"
514 + " else ret = vm['org_apidesign_vm4brwsr_ClassPath'](false).\n"
515 + " loadBytes___3BLjava_lang_String_2Ljava_lang_Object_2II(name, args, i, skip);\n"
516 + " if (ret !== null) return ret;\n"
518 + " while (knownExtensions < extensions.length) {\n"
519 + " vm['registerResource'] = registerResource;\n"
520 + " extensions[knownExtensions++](vm);\n"
521 + " vm['registerResource'] = null;\n"
524 + " var arr = resources[name];\n"
525 + " return (arr && arr.length > arrSize) ? arr[arrSize] : null;\n"
527 + " var reload = function(name, arr, keep) {;\n"
529 + " var attr = mangleClass(name);\n"
530 + " delete vm[attr];\n"
532 + " return vm['org_apidesign_vm4brwsr_VMLazy'](false)\n"
533 + " ['load__Ljava_lang_Object_2Ljava_lang_Object_2Ljava_lang_String_2_3Ljava_lang_Object_2_3B']\n"
534 + " (vm, name, args, arr);\n"
536 + " loader.loadClass = function(name) {\n"
537 + " var attr = mangleClass(name);\n"
538 + " var fn = vm[attr];\n"
539 + " if (fn) return fn(false);\n"
541 + " var arr = loadBytes(replaceAll(name, '.', '/') + '.class');\n"
542 + " return reload(name, arr, true);\n"
543 + " } catch (err) {\n"
544 + " fn = vm[attr];\n"
545 + " if (fn) return fn(false);\n"
549 + " if (vm['loadClass']) {\n"
550 + " throw 'Cannot initialize the bck2brwsr VM twice!';\n"
552 + " vm['loadClass'] = loader.loadClass;\n"
553 + " vm['_reload'] = reload;\n"
554 + " vm['loadBytes'] = loadBytes;\n"
556 + " return loader;\n"
559 " global.bck2brwsr.registerExtension = function(extension) {\n"
560 + " extensions.push(extension);\n"
567 protected String getExportsObject() {
572 protected boolean isExternalClass(String className) {
577 private static final class Extension extends VM {
578 private final StringArray extensionClasses;
580 private Extension(Appendable out, Bck2Brwsr.Resources resources,
581 String[] extClassesArray, StringArray explicitlyExported) {
582 super(out, resources, explicitlyExported);
583 this.extensionClasses = StringArray.asList(extClassesArray);
587 protected void generatePrologue() throws IOException {
588 append("bck2brwsr.registerExtension(function(exports) {\n"
589 + " var vm = {};\n");
590 append(" function link(n) {\n"
591 + " return function() {\n"
592 + " var cls = n['replace__Ljava_lang_String_2CC']"
593 + "('/', '_').toString();\n"
594 + " var dot = n['replace__Ljava_lang_String_2CC']"
595 + "('/', '.').toString();\n"
596 + " exports.loadClass(dot);\n"
597 + " vm[cls] = exports[cls];\n"
598 + " return vm[cls](arguments);\n"
605 protected void generateEpilogue() throws IOException {
610 protected String generateClass(String className) throws IOException {
611 if (isExternalClass(className)) {
612 append("\n").append(assignClass(
613 className.replace('/', '_')))
621 return super.generateClass(className);
625 protected String getExportsObject() {
630 protected boolean isExternalClass(String className) {
631 return !extensionClasses.contains(className);
635 private static void lazyReference(Appendable out, String n) throws IOException {
636 String cls = n.replace('/', '_');
637 String dot = n.replace('/', '.');
639 out.append("\nvm.").append(cls).append(" = function() {");
640 out.append("\n var instance = arguments.length == 0 || arguments[0] === true;");
641 out.append("\n delete vm.").append(cls).append(";");
642 out.append("\n var c = vm.loadClass('").append(dot).append("');");
643 out.append("\n return vm.").append(cls).append("(instance);");