JSweet：Java到JavaScript的转译器

JSweet利用TypeScript通过使用JavaScript库和框架在Java中编写丰富且响应迅速的Web应用程序。使用JSweet，Java程序被转译（源代码到源代码编译）为TypeScript和JavaScript，以便在浏览器、移动Web视图或Node.js中运行。

• JSweet安全可靠。它为Web应用程序提供类型检查，并生成完全类型检查的JavaScript程序。它基于Oracle的Java编译器（javac）和Microsoft的TypeScript（tsc）。
• JSweet允许你使用你喜欢的JS库（JSweet+Angular2, JSweet+threejs, IONIC/Cordova, ...）。
• JSweet实现了服务器端Java和客户端JavaScript之间的代码共享。JSweet为核心Java库提供了实现，用于代码共享和旧Java代码迁移目的。
• JSweet快速、轻量且与JavaScript完全兼容。生成的代码是普通的JavaScript代码，这意味着与JavaScript相比没有额外开销，并且可以直接与现有的JavaScript程序和库互操作。

它是如何工作的？JSweet依赖于JavaScript API的良好类型描述，称为"糖果"，其中大多数是从TypeScript定义文件自动生成的。这些Java中的API描述可以被视为头文件（类似于C中的*.h头文件），用于连接Java和JavaScript库。现有库有多个糖果来源，你可以轻松为任何库构建糖果（参见更多详情）。

使用JSweet，你可以利用所有Java工具（IDE、Maven等）来编程真正的JavaScript应用程序，使用最新的JavaScript库。

Java -> TypeScript -> JavaScript

这里是使用JSweet的第一个示例。考虑这个简单的Java程序：

package org.jsweet;

import static jsweet.dom.Globals.*;

/**
 * 这是一个非常简单的示例，只显示一个警告框。
 */
public class HelloWorld {
    public static void main(String[] args) {
        alert("你好！");
    }
}

用JSweet转译会得到以下TypeScript程序：

namespace org.jsweet {
    /**
     * 这是一个非常简单的示例，只显示一个警告框。
     */
    export class HelloWorld {
        public static main(args : string[]) {
            alert("你好！");
        }
    }
}
org.jsweet.HelloWorld.main(null);

然后产生以下JavaScript输出：

var org;
(function (org) {
    var jsweet;
    (function (jsweet) {
        /**
         * 这是一个非常简单的示例，只显示一个警告框。
         */
        var HelloWorld = (function () {
            function HelloWorld() {
            }
            HelloWorld.main = function (args) {
                alert("你好！");
            };
            return HelloWorld;
        }());
        jsweet.HelloWorld = HelloWorld;
    })(jsweet = org.jsweet || (org.jsweet = {}));
})(org || (org = {}));
org.jsweet.HelloWorld.main(null);

更多内容请查看在线沙盒。

特性

• Java和TypeScript之间的完整语法映射，包括类、接口、函数类型、联合类型、元组类型、对象类型、字符串类型等。
• 自1.1.0版本以来，广泛支持Java构造和语义（内部类、匿名类、final字段、方法重载、instanceof运算符、静态初始化器等）。
• 超过1000个JavaScript库、框架和插件，用于编写Web和移动HTML5应用程序（JQuery、Underscore、Angular、Backbone、Cordova、Node.js等更多）。
• 一个Maven仓库，包含所有可用库的Maven构件（又称糖果）。
• 支持Java基本API，如J4TS糖果（从GWT的JRE仿真分叉而来）。
• 一个Eclipse插件，便于安装和使用。
• 一个Maven插件，可以从任何其他IDE或命令行使用JSweet。
• 一个Gradle插件，用于将JSweet集成到基于Gradle的项目中。
• 调试模式，可在你喜欢的浏览器中调试Java代码。
• 一组优秀的WEB/移动HTML5示例，帮助你入门并熟悉JSweet和最常见的JavaScript API（在示例部分还有更多示例）。
• 支持捆绑包，以最简单的方式运行生成的程序。
• 支持JavaScript模块（commonjs、amd、umd）。JSweet程序可以在浏览器或Node.js中运行。
• 支持各种EcmaScript目标版本（ES3到ES6）。
• 支持async/await习语。
• ...

更多详情，请参阅语言规范（PDF）。

入门

• 第1步：安装（或检查是否已安装）Git、Node.js和Maven（命令git、node、npm和mvn应该在你的路径中）。
• 第2步：从Github克隆jsweet-quickstart项目：

$ git clone https://github.com/cincheo/jsweet-quickstart.git

• 第3步：运行转译器生成JavaScript代码：

$ cd jsweet-quickstart
$ mvn generate-sources

• 第4步：在浏览器中查看结果：

$ firefox webapp/index.html

• 第5步：编辑项目并开始编程：
  • 查看示例以了解各种用例
  • 获取数百个库（糖果）
  • 参考语言规范以了解更多关于使用JSweet编程的信息
  • Eclipse用户：安装Eclipse插件以获得内联错误报告、保存时构建和易用的配置UI

更多信息请访问http://www.jsweet.org。

示例

• 说明在Java中使用各种框架的简单示例（jQuery、Underscore、Backbone、AngularJS、Knockout）：https://github.com/cincheo/jsweet-examples
• 说明在Java中使用Threejs框架的简单示例：https://github.com/cincheo/jsweet-examples-threejs)
• Node.js + Socket.IO + AngularJS：https://github.com/lgrignon/jsweet-node-example
• 一些入门React.js的简单示例：https://github.com/cincheo/jsweet-examples-react
• JSweet JAX-RS服务器示例（如何在客户端和服务器之间共享Java模型）：https://github.com/lgrignon/jsweet-jaxrs-server-example
• JSweet Cordova / Polymer示例：https://github.com/lgrignon/jsweet-cordova-polymer-example
• JSweet Cordova / Ionic示例：https://github.com/lgrignon/jsweet-cordova-ionic-example
• JSweet Angular 2示例：https://github.com/cincheo/jsweet-angular2-quickstart
• JSweet Angular 2 + PrimeNG：https://github.com/cincheo/jsweet-primeng-quickstart

子项目

这个仓库组织为子项目。每个子项目都有自己的构建过程。

• JSweet转译器：Java到TypeScript/JavaScript的编译器。
• JSweet核心糖果：核心API（JavaScript语言、JavaScript DOM和JSweet语言实用工具）。
• JDK运行时：从GWT的JRE仿真分叉，在JSweet/TypeScript/JavaScript中实现主要的JDK API。
• JSweet糖果生成器：一个从TypeScript定义文件生成Java API并将其打包为JSweet糖果的工具。
• JSweet文档：JSweet文档。

此外，JSweet的一些工具在外部仓库中可用。

• Maven插件
• Gradle插件
• Eclipse插件

如何构建

请查看每个子项目的README文件。

贡献

JSweet使用Git Flow。 你可以fork这个仓库。默认分支是develop。请使用git flow feature start myAwesomeFeature开始工作on something great :) 完成后，你可以提交常规的GitHub拉取请求。

许可证

请阅读LICENSE文件。