j2js-compiler/README.md

#j2js-compiler

A Java Bytecode to JavaScript Cross-Compiler.

##Installation

1. You need to install this and the following projects

• https://github.com/decatur/j2js-compiler
• https://github.com/decatur/j2js-jre
• https://github.com/decatur/j2js-agent

2. Build all projects. An Eclipse project description is included.

3. Optionally install https://github.com/decatur/j2js-demos

##Usage

java -cp <RUNTIME_CLASSPATH> com.j2js.J2JSCompiler <basedir> <CROSS_COMPILE_CLASSPATH> <entryPointClassName> <targetLocation>

###<RUNTIME_CLASSPATH>

This is the standard Java classpath. The cross-compiler needs the project j2js-compiler, bcel and commons-io on its classpath.

###<basedir>

All non-absolute paths are relative to the basedir.

###<entryPointClassName>

The name of the class to cross-compile. This class must have a method public void main(java.lang.String[]).

The compiler cross-compiles the main method and all other methods which are called from the main method.

###<CROSS_COMPILE_CLASSPATH>

This classpath must contain all classes whose methods are referenced by the main method. In normal operation, this classpath consists of

• the j2js-jre classes directory or jar
• the j2js-agent classes directory or jar
• the classes directory of your personal project

###<targetLocation> All cross-compiled code is stored in the target location. It is one or more JavaScript file starting at 0.js. Only this initial file must be included in your web page with <script src='targetLocation/0.js'/>.

###Example

Suppose the directory layout is

|- j2js-compiler
|- j2js-jre
|- j2js-agent
|- my-project
     |- target
         |- assemblies
             |- 0.js
             |- 1.js
             |- 2.js ...

and you want to cross-compile class org.mydomain.my-project.MyClass. Then

java -cp ../j2js-compiler/libs/commons-io-1.4.jar;^
../j2js-compiler/libs/bcel-5.1.jar;^
../j2js-compiler/target/classes ^
com.j2js.J2JSCompiler . ^
target/classes;../j2js-jre/target/classes;../j2js-agent/target/classes ^
org.mydomain.my-project.MyClass target/assemblies

will create the assemblies.

##Warning The project j2js-jre contains a hand-crafted version of the Java Runtime Environment. Do not substitute the path to this project by a path to Java/jreX/lib/rt.jar.